tcio  V3.77.07
Function description
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)
DLL_RESULT TC4GetCurrentAct (double *pCurrentAct)
DLL_RESULT TC4GetDCLinkDigital (int *pDCLinkVoltage)
 This function reads the actual dc-link voltage.
DLL_RESULT TC4GetIPrimDigital (int *pPrimaryCurrent)
 This function reads the actual transformer primary current.
DLL_RESULT TC4GetPowerAct (double *pPowerAct)
DLL_RESULT TC4GetPowerActSense (double *pPowerActSense)
 Gets sense output power, depends on ModuleSelector.
DLL_RESULT TC4GetResistanceAct (double *pResistanceAct)
DLL_RESULT TC4GetSenseDigital (int *pSenseVoltage)
 This function reads the actual value of the sense input voltage.
DLL_RESULT TC4GetSenseEnable (char *pSenseEnable)
 check usage of voltage-sense-input
DLL_RESULT TC4GetSenseSupported (unsigned int *pSupported)
 function to determine whether sense functionality is installed
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.
DLL_RESULT TC4GetTempDigital (int *pIgbtTemp, int *pRectifierTemp)
 This function reads the actual heat sink temperature of IGBT and rectifier.
DLL_RESULT TC4GetVoltageAct (double *pVoltageAct)
DLL_RESULT TC4GetVoltageActSense (double *pVolategeActSense)
 Gets sense output voltage, depends on ModuleSelector.
DLL_RESULT TC4SetSenseEnable (char senseEnable)
 set usage of voltage-sense-input

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