tcio
Functions
System Configuration

Functions

DLL_RESULT TC4GetSystemConfig (unsigned int *pNumSeries, unsigned int *pNumParallel, unsigned int *pNumMultiLoad)
 This function reads the actual preset system configuration.
DLL_RESULT TC4GetSystemConfigDetected (unsigned int *pNumSeries, unsigned int *pNumParallel, unsigned int *pNumMultiLoad)
 This function reads the actually detected number of modules by theTopCon Master.
DLL_RESULT TC4SetSystemConfig (unsigned int numSeries, unsigned int numParallel, unsigned int numMultiLoad)
 This function sets the desired system configuration.
These settings only take effect after a restart, so after calling this function make sure the parameters are saved to non-volatile memory by calling API-function TC4StoreParameters. Then power off the system and turn it on again.

Detailed Description

These functions are used to configure TopCon for single-master or multi-unit operation.


Function Documentation

DLL_RESULT TC4GetSystemConfig ( unsigned int *  pNumSeries,
unsigned int *  pNumParallel,
unsigned int *  pNumMultiLoad 
)

This function reads the actual preset system configuration.

Parameters:
[out]pNumSeriesPreset number of modules in series-operation.
[out]pNumParallelPreset number of modules in parallel-operation
[out]pNumMultiLoadPreset number of modules in multiload-operation .
Note:
If called on a TC.MAC device the function will deliver the number of sub-systems instead of number of modules.
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4GetSystemConfigDetected ( unsigned int *  pNumSeries,
unsigned int *  pNumParallel,
unsigned int *  pNumMultiLoad 
)

This function reads the actually detected number of modules by theTopCon Master.

Parameters:
[out]pNumSeriesDetected number of modules in series operation
[out]pNumParallelDetected number of modules in parallel operation
[out]pNumMultiLoadDetected number of modules in multiload operation
Note:
Calling this function on a TopCon Slave will return unreliable results.
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4SetSystemConfig ( unsigned int  numSeries,
unsigned int  numParallel,
unsigned int  numMultiLoad 
)

This function sets the desired system configuration.
These settings only take effect after a restart, so after calling this function make sure the parameters are saved to non-volatile memory by calling API-function TC4StoreParameters. Then power off the system and turn it on again.

Parameters:
[in]numSeriesnumber of modules in series operation [1...8]
[in]numParallelnumber of muldues in parallel operation [1...8]
[in]numMultiLoadnumber of modules in multiload operation [1...64]
Attention:
After powerup make sure you call the initialising functions
Note:
Setting system configuration is only required on a TopCon Master or TC.MAC.
Slaves automatically adjust their operation mode on next login (powerup).
If called on a TC.MAC this function will configure the number of sub-systems instead of number of modules.
See also:
chapter DLL initialisation and please see TopCon manual for a list of allowed combinations
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs