tcio
 All Functions Groups Pages
Functions
Actual Values

Functions

DLL_RESULT TC42GetQ4CurrentAct (double *pCurrent)
 Get actual current in sinking operation (Q4). Reads zero in Q1 operation.
Use function GetCurrentAct instead to get actual current in bidirectional operation (Q1 and Q4) More...
 
DLL_RESULT TC4GetCurrentAct (double *pCurrentAct)
 
DLL_RESULT TC4GetDCLinkDigital (int *pDCLinkVoltage)
 This function reads the actual dc-link voltage. More...
 
DLL_RESULT TC4GetIPrimDigital (int *pPrimaryCurrent)
 This function reads the actual transformer primary current. More...
 
DLL_RESULT TC4GetPowerAct (double *pPowerAct)
 
DLL_RESULT TC4GetPowerActSense (double *pPowerActSense)
 Gets sense output power, depends on ModuleSelector. More...
 
DLL_RESULT TC4GetResistanceAct (double *pResistanceAct)
 
DLL_RESULT TC4GetSenseDigital (int *pSenseVoltage)
 This function reads the actual value of the sense input voltage. More...
 
DLL_RESULT TC4GetSenseEnable (char *pSenseEnable)
 check usage of voltage-sense-input More...
 
DLL_RESULT TC4GetSenseSupported (unsigned int *pSupported)
 function to determine whether sense functionality is installed More...
 
DLL_RESULT TC4GetSystemDigital (int *pRMBSystemVoltage, int *pRMBSystemCurrent)
 This function reads actual values of an externally connected Remote Measure Box (RMB). This RMB is not shipped with TopCon by default. More...
 
DLL_RESULT TC4GetTempDigital (int *pIgbtTemp, int *pRectifierTemp)
 This function reads the actual heat sink temperature of IGBT and rectifier. More...
 
DLL_RESULT TC4GetVoltageAct (double *pVoltageAct)
 
DLL_RESULT TC4GetVoltageActSense (double *pVolategeActSense)
 Gets sense output voltage, depends on ModuleSelector. More...
 
DLL_RESULT TC4SetSenseEnable (char senseEnable)
 set usage of voltage-sense-input More...
 

Detailed Description

This group delivers information about actual values like output voltage, output current, internal temperatures, supply voltages and other measured values.

Function Documentation

DLL_RESULT TC42GetQ4CurrentAct ( double *  pCurrent)

Get actual current in sinking operation (Q4). Reads zero in Q1 operation.
Use function GetCurrentAct instead to get actual current in bidirectional operation (Q1 and Q4)

Parameters
[out]pCurrent[A]
Returns
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4GetCurrentAct ( double *  pCurrentAct)
Parameters
[out]pCurrentActActual current value [A]
Returns
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4GetDCLinkDigital ( int *  pDCLinkVoltage)

This function reads the actual dc-link voltage.

Parameters
[out]pDCLinkVoltageActual dc.link voltage
Attention
These values is not a physical value - so translate to correct physical value.
See Also
chapter Translate between standardised values and physical values
Returns
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4GetIPrimDigital ( int *  pPrimaryCurrent)

This function reads the actual transformer primary current.

Parameters
[out]pPrimaryCurrentActual transformator primary current
Attention
These values is not a physical value - so translate to correct physical value.
See Also
chapter Translate between standardised values and physical values
Returns
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4GetPowerAct ( double *  pPowerAct)
Parameters
[out]pPowerActActual power value [kW]
Returns
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4GetPowerActSense ( double *  pPowerActSense)

Gets sense output power, depends on ModuleSelector.

Parameters
[out]pPowerActSenseActual voltage value [kW]
Returns
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4GetResistanceAct ( double *  pResistanceAct)
Parameters
[out]pResistanceActActual simulated resistance value
Note
resistance is not measured - this will just read the set value
Returns
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4GetSenseDigital ( int *  pSenseVoltage)

This function reads the actual value of the sense input voltage.

Parameters
[out]pSenseVoltageActual sense voltage value
Attention
This value is not a physical value - so translate to correct physical value.
See Also
chapter Translate between standardised values and physical values or TC4GetVoltageActSense and TC4GetPowerActSense
Returns
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4GetSenseEnable ( char *  pSenseEnable)

check usage of voltage-sense-input

Parameters
[out]pSenseEnable1: Enabled
0: Disabled
Attention
check proor if sense is supported
See Also
Check if sense is supported TC4GetSenseSupported
Returns
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4GetSenseSupported ( unsigned int *  pSupported)

function to determine whether sense functionality is installed

Parameters
[out]pSupported1: Enabled
0: Disabled
Returns
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4GetSystemDigital ( int *  pRMBSystemVoltage,
int *  pRMBSystemCurrent 
)

This function reads actual values of an externally connected Remote Measure Box (RMB). This RMB is not shipped with TopCon by default.

Parameters
[out]pRMBSystemVoltageActual RMB-voltage
[out]pRMBSystemCurrentActual RMB-current
Attention
These values are not physical values - so translate to correct physical values and treat vsystem und isystem as system-values.
Note
Calling this function on a TopCon Slave will always deliver values of 0 as an RMB will always be connected to a TopCon Master. The RMB functionality is obsolete and not supported on CTR4.20 devices (devices with firmware 4.2x.yy).
See Also
chapter Translate between standardised values and physical values
Returns
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4GetTempDigital ( int *  pIgbtTemp,
int *  pRectifierTemp 
)

This function reads the actual heat sink temperature of IGBT and rectifier.

Parameters
[out]pIgbtTempActual IGBT heat sink temperature
[out]pRectifierTempActual rectifier heat sink temperature
Attention
These values are not physical values - so translate to correct physical values.
See Also
chapter Translate between standardised values and physical values
Returns
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4GetVoltageAct ( double *  pVoltageAct)
Parameters
[out]pVoltageActActual voltage value [V]
Returns
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4GetVoltageActSense ( double *  pVolategeActSense)

Gets sense output voltage, depends on ModuleSelector.

Parameters
[out]pVolategeActSenseActual voltage value [V]
Returns
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4SetSenseEnable ( char  senseEnable)

set usage of voltage-sense-input

Parameters
[in]senseEnable1: Enabled
0: Disabled
Attention
check proor if sense is supported
See Also
Check if sense is supported TC4GetSenseSupported
Returns
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs