tcio
Functions
Mandatory

Functions

DLL_RESULT TC4GetPhysicalValuesIncrement (double *pIncModV, double *pIncModC, double *pIncModP, double *pIncModR, double *pIncSysV, double *pIncSysC, double *pIncSysP, double *pIncSysR)
 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.
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 *  pIncModV,
double *  pIncModC,
double *  pIncModP,
double *  pIncModR,
double *  pIncSysV,
double *  pIncSysC,
double *  pIncSysP,
double *  pIncSysR 
)

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.
No translation-factors for temperatur, dc-link voltage and primary current are delivered by this API-function.

Parameters:
[out]pIncModVincrement factor module voltage
[out]pIncModCincrement factor module current
[out]pIncModPincrement factor module power
[out]pIncModRincrement factor module resistance
[out]pIncSysVincrement factor system voltage
[out]pIncSysCincrement factor system current
[out]pIncSysPincrement factor system power
[out]pIncSysRincrement factor system resistance
Note:
PhysicalModuleVoltage = FactorModuleVoltage * StandardisedModuleVoltage
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 from functions for example:
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs