tcio  V3.74.00
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 *p_iact)
DLL_RESULT TC4GetDCLinkDigital (unsigned int *vz)
 This function reads the actual dc-link voltage.
DLL_RESULT TC4GetIPrimDigital (unsigned int *iprim)
 This function reads the actual transformer primary current.
DLL_RESULT TC4GetPowerAct (double *p_pact)
DLL_RESULT TC4GetResistanceAct (double *p_ract)
DLL_RESULT TC4GetSenseDigital (unsigned int *vsense)
 This function reads the actual value of the sense input voltage.
DLL_RESULT TC4GetSystemDigital (unsigned int *vsystem, unsigned int *isystem)
 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 (unsigned int *igbttemp, unsigned int *recttemp)
 This function reads the actual heat sink temperature of IGBT and rectifier.
DLL_RESULT TC4GetVoltageAct (double *p_vact)

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 *  p_iact)
Parameters:
[out]p_iactActual current value [A]
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4GetDCLinkDigital ( unsigned int *  vz)

This function reads the actual dc-link voltage.

Parameters:
[out]vzActual 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 ( unsigned int *  iprim)

This function reads the actual transformer primary current.

Parameters:
[out]iprimActual 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 *  p_pact)
Parameters:
[out]p_pactActual power value [kW]
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4GetResistanceAct ( double *  p_ract)
Parameters:
[out]p_ractActual 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 ( unsigned int *  vsense)

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

Parameters:
[out]vsenseActual 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
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4GetSystemDigital ( unsigned int *  vsystem,
unsigned int *  isystem 
)

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

Parameters:
[out]vsystemActual RMB-voltage
[out]isystemActual 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 ( unsigned int *  igbttemp,
unsigned int *  recttemp 
)

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

Parameters:
[out]igbttempActual IGBT heat sink temperature
[out]recttempActual 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 *  p_vact)
Parameters:
[out]p_vactActual voltage value [V]
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs