![]() |
tcio
V3.74.00
Function description
|
Functions | |
DLL_RESULT | TC4GetPhysicalValuesIncrement (double *vinc, double *iinc, double *pinc, double *rinc, double *vsinc, double *isinc, double *psinc, double *rsinc) |
Gets the factors to calculate the physical values intern in the API. This function has to be called at least once after DLL-initialisation. It not only returns device information it also calculates important values that will be used from API-functions working with physical values. Every time you connect to a other module you must call TC4GetPhysicalValuesIncrement again as physical module values could be different. This must also be performed when changing connection from a master to a slave or vice versa. After calling this function be sure to also call API-function TC4SetModuleSelector with the selector-argument set to 64. Otherwise in multi-unit operation some API-functions called on TopCon Master will return module-values instead of system-values. This API-function can be used to translate between stardardised and physical values. As compared to API-functions TC4GetPhysicalValues and TC4GetSystemPhysicalValues division by 4000 has already been performed here. However only output values for voltage, current, power and resistance (either module- or system-values) can be translated that way. No translation-factors for temperatur, dc-link voltage and primary current are delivered by this API-function. | |
DLL_RESULT | TC4SetModuleSelector (unsigned int selector) |
Set the ModuleSelector to 64. This ensures that in multi-unit operation a TopCon Master will return system-values. |
These functions must be called after connection to a device has been established.
DLL_RESULT TC4GetPhysicalValuesIncrement | ( | double * | vinc, |
double * | iinc, | ||
double * | pinc, | ||
double * | rinc, | ||
double * | vsinc, | ||
double * | isinc, | ||
double * | psinc, | ||
double * | rsinc | ||
) |
Gets the factors to calculate the physical values intern in the API.
This function has to be called at least once after DLL-initialisation. It not only returns device information it also calculates important values that will be used from API-functions working with physical values.
Every time you connect to a other module you must call TC4GetPhysicalValuesIncrement again as physical module values could be different. This must also be performed when changing connection from a master to a slave or vice versa.
After calling this function be sure to also call API-function TC4SetModuleSelector with the selector-argument set to 64. Otherwise in multi-unit operation some API-functions called on TopCon Master will return module-values instead of system-values.
This API-function can be used to translate between stardardised and physical values. As compared to API-functions TC4GetPhysicalValues and TC4GetSystemPhysicalValues division by 4000 has already been performed here.
However only output values for voltage, current, power and resistance (either module- or system-values) can be translated that way. No translation-factors for temperatur, dc-link voltage and primary current are delivered by this API-function.
[out] | vinc | FactorDeviceVoltage |
[out] | iinc | FactorDeviceCurrent |
[out] | pinc | FactorDevicePower |
[out] | rinc | FactorDeviceResistance |
[out] | vsinc | FactorSystemVoltage |
[out] | isinc | FactorSystemCurrent |
[out] | psinc | FactorSystemPower |
[out] | rsinc | FactorSystemResistance |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs DLL_RESULT TC4SetModuleSelector | ( | unsigned int | selector | ) |
Set the ModuleSelector to 64. This ensures that in multi-unit operation a TopCon Master will return system-values.
[in] | selector | 64: for getting system-values 0: getting device-values 1…63: getting slave-values |
DLL_SUCCESS
for success or DLL_FAIL
or other value if an error occurs