tcio
 All Functions Groups Pages
Functions
System Configuration

Functions

DLL_RESULT TC4GetSystemConfig (unsigned int *p_numserie, unsigned int *p_numpara, unsigned int *p_nummulti)
 This function reads the actual preset system configuration. More...
 
DLL_RESULT TC4GetSystemConfigDetected (unsigned int *p_numserie, unsigned int *p_numpara, unsigned int *p_nummulti)
 This function reads the actually detected number of modules by theTopCon Master. More...
 
DLL_RESULT TC4SetSystemConfig (unsigned int p_numserie, unsigned int p_numpara, unsigned int p_nummulti)
 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. More...
 

Detailed Description

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

Function Documentation

DLL_RESULT TC4GetSystemConfig ( unsigned int *  p_numserie,
unsigned int *  p_numpara,
unsigned int *  p_nummulti 
)

This function reads the actual preset system configuration.

Parameters
[out]p_numseriePreset number of modules in series-operation.
[out]p_numparaPreset number of modules in parallel-operation
[out]p_nummultiPreset 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 *  p_numserie,
unsigned int *  p_numpara,
unsigned int *  p_nummulti 
)

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

Parameters
[out]p_numserieDetected number of modules in series operation
[out]p_numparaDetected number of modules in parallel operation
[out]p_nummultiDetected 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  p_numserie,
unsigned int  p_numpara,
unsigned int  p_nummulti 
)

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]p_numserienumber of modules in series operation [1...8]
[in]p_numparanumber of muldues in parallel operation [1...8]
[in]p_nummultinumber 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