tcio  V3.77.07
Function description
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.
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.
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.

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