tcio  V3.74.00
Function description
Functions
Mandatory

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.

Detailed Description

These functions must be called after connection to a device has been established.

Attention:
Failing to do so can result in incorrect physical values.
This may result in damage to an attached load, e.g. if a higher voltage than intended is present at the output (due to incorrect setting values)

Function Documentation

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.

Parameters:
[out]vincFactorDeviceVoltage
[out]iincFactorDeviceCurrent
[out]pincFactorDevicePower
[out]rincFactorDeviceResistance
[out]vsincFactorSystemVoltage
[out]isincFactorSystemCurrent
[out]psincFactorSystemPower
[out]rsincFactorSystemResistance
Note:
PhysicalDeviceVoltage = FactorDeviceVoltage * StandardisedDeviceVoltage You can also use API-function TC4GetPhysicalValuesIncrement to translate between standardised values and physical module- or sytem-values. In that case you can skip the "divide by 4000" step, as this has already been done in that API-function.
Returns:
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.

Parameters:
[in]selector64: for getting system-values
0: getting device-values
1…63: getting slave-values
Note:
To take the values off of from function for example TC4GetPhysicalValues(…) or TC4GetVoltageRef(…)
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs