tcio  V3.74.00
Function description
Functions
Protection

Functions

DLL_RESULT TC42GetQ4LimitOverCurrentAbs (double *pCurrent)
 Get Q4 over current absolute error limit for Q4 operating mode (Q4 over current limit settings are limited to this value)
DLL_RESULT TC42GetQ4LimitOverCurrentError (double *pCurrent)
 Get Q4 over current error limit for Q4 operating mode (will be negative)
DLL_RESULT TC42GetQ4LimitOverCurrentErrorDelay (double *pTime)
 Get Q4 over current error delay for Q4 operating mode.
DLL_RESULT TC42GetQ4LimitOverCurrentWarn (double *pCurrent)
 Get Q4 over current warning limit for Q4 operating mode (negative!)
DLL_RESULT TC42GetQ4LimitOverCurrentWarnDelay (double *pTime)
 Get Q4 over current warning delay for Q4 operating mode.
DLL_RESULT TC42SetQ4LimitOverCurrentError (double Current)
 Set Q4 over current error limit for Q4 operating mode (negative!)
DLL_RESULT TC42SetQ4LimitOverCurrentErrorDelay (double Time)
 Set Q4 over current error delay for Q4 operating mode.
DLL_RESULT TC42SetQ4LimitOverCurrentWarn (double Current)
 Set Q4 over current warning limit for Q4 operating mode (negative!)
DLL_RESULT TC42SetQ4LimitOverCurrentWarnDelay (double Time)
 Set Q4 over current warning delay for Q4 operating mode.
DLL_RESULT TC4GetI2tCurrentParam (double *i2tcurrent, unsigned int *limit, unsigned int *warn)
 This function reads the actual settings for I2t-monitoring on output current.
DLL_RESULT TC4GetMaximas (unsigned int *p_vabs, unsigned int *p_iabs)
 This function is used to get the maximum allowed voltage- and current-limits.
DLL_RESULT TC4GetOvercurrentParam (double *p_limit, unsigned int *p_delay, double *p_warn, unsigned int *p_warndelay)
 These function read the actual protection limits for output-overcurrent (Q1 operating mode only)
DLL_RESULT TC4GetOvervoltageParam (double *p_limit, unsigned int *p_delay, double *p_warn, unsigned int *p_warndelay)
 These function read the actual protection limits for output-overvoltage.
DLL_RESULT TC4SetI2tCurrentParam (double i2tcurrent, unsigned int limit, unsigned int warn)
 This function sets parameters for I2t-monitoring on output-current. Maximum allowed physical value for i2tcurrent: see API-function TC4GetMaximas.
DLL_RESULT TC4SetOvercurrentParam (double limit, unsigned int delay, double warn, unsigned int warndelay)
 These functions set the protection limits for overcurrent on the output stage. Maximum allowed physical value for overcurrent-limit see API-function TC4GetMaximas.
DLL_RESULT TC4SetOvervoltageParam (double limit, unsigned int delay, double warn, unsigned int warndelay)
 These functions set the protection limits for overvoltage on the output stage. Maximum allowed physical value for overvoltage-limit see API-function TC4GetMaximas.

Detailed Description

To protect each TopCon module from overvoltage and overcurrent has limits setted for error and warning.

Attention:
Changing protection limits can cause serious damage to the modules.
Do not change protection limits without contacting Regatron before!

Function Documentation

DLL_RESULT TC42GetQ4LimitOverCurrentAbs ( double *  pCurrent)

Get Q4 over current absolute error limit for Q4 operating mode (Q4 over current limit settings are limited to this value)

Parameters:
[out]pCurrent[A]
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC42GetQ4LimitOverCurrentError ( double *  pCurrent)

Get Q4 over current error limit for Q4 operating mode (will be negative)

Parameters:
[out]pCurrent[A]
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC42GetQ4LimitOverCurrentErrorDelay ( double *  pTime)

Get Q4 over current error delay for Q4 operating mode.

Parameters:
[out]pTime[ms]
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC42GetQ4LimitOverCurrentWarn ( double *  pCurrent)

Get Q4 over current warning limit for Q4 operating mode (negative!)

Parameters:
[out]pCurrent[A]
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC42GetQ4LimitOverCurrentWarnDelay ( double *  pTime)

Get Q4 over current warning delay for Q4 operating mode.

Parameters:
[out]pTime[ms]
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC42SetQ4LimitOverCurrentError ( double  Current)

Set Q4 over current error limit for Q4 operating mode (negative!)

Parameters:
[in]Current[A]
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC42SetQ4LimitOverCurrentErrorDelay ( double  Time)

Set Q4 over current error delay for Q4 operating mode.

Parameters:
[in]Time[ms]
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC42SetQ4LimitOverCurrentWarn ( double  Current)

Set Q4 over current warning limit for Q4 operating mode (negative!)

Parameters:
[in]Current[A]
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC42SetQ4LimitOverCurrentWarnDelay ( double  Time)

Set Q4 over current warning delay for Q4 operating mode.

Parameters:
[in]Time[ms]
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4GetI2tCurrentParam ( double *  i2tcurrent,
unsigned int *  limit,
unsigned int *  warn 
)

This function reads the actual settings for I2t-monitoring on output current.

Parameters:
[out]i2tcurrentActual nominal current [A]
[out]limitActual I2t error-limit [A2s]
[out]warnActual I2t warning-limit [A2s]
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4GetMaximas ( unsigned int *  p_vabs,
unsigned int *  p_iabs 
)

This function is used to get the maximum allowed voltage- and current-limits.

Parameters:
[out]p_vabsMaximum allowed voltage limit
[out]p_iabsMaximum allowed current limit
Attention:
These values are not physical values - so translate to correct physical values
Note:
Setting protection limits on a single master unit: treat p_vabs und p_iabs as module-values.
Setting procetions limits in multi-unit operation treat p_vabs und p_iabs as system-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 TC4GetOvercurrentParam ( double *  p_limit,
unsigned int *  p_delay,
double *  p_warn,
unsigned int *  p_warndelay 
)

These function read the actual protection limits for output-overcurrent (Q1 operating mode only)

Parameters:
[out]p_limitActual overcurrent error level
[out]p_delayActual delay for the error level in [50us]
[out]p_warnActual overcurrent warning level
[out]p_warndelayActual delay for the warning level in [50us]
Attention:
The p_limit and p_warn are not physical values - so translate to correct physical values
Note:
These current limits only apply to Q1 operating mode. To set protection limits for Q4 operating mode use the corresponding Q4 protection function.
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 TC4GetOvervoltageParam ( double *  p_limit,
unsigned int *  p_delay,
double *  p_warn,
unsigned int *  p_warndelay 
)

These function read the actual protection limits for output-overvoltage.

Parameters:
[out]p_limitActual overvoltage error level
[out]p_delayActual delay for the error level in [50us]
[out]p_warnActual overvoltage warning level
[out]p_warndelayActual delay for the warning level in [50us]
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4SetI2tCurrentParam ( double  i2tcurrent,
unsigned int  limit,
unsigned int  warn 
)

This function sets parameters for I2t-monitoring on output-current. Maximum allowed physical value for i2tcurrent: see API-function TC4GetMaximas.

Parameters:
[in]i2tcurrentNominal current [A]
[in]limitError-limit for I2t-sum
[in]warnWarning limit for I2t-sum
Precondition:
Remote control input must be set to RS232 (this API)
Note:
Setting I2t-parameters on a TopCon Master will automatically transfers them to all connected Slaves.
Setting I2t-parameters on a TopCon Slave will have no effect.
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4SetOvercurrentParam ( double  limit,
unsigned int  delay,
double  warn,
unsigned int  warndelay 
)

These functions set the protection limits for overcurrent on the output stage. Maximum allowed physical value for overcurrent-limit see API-function TC4GetMaximas.

Parameters:
[in]limitovercurrent error level
[in]delaydelay for error level in [50us]
[in]warnovercurrent warning level
[in]warndelaydelay for warning level in [50us]
Precondition:
Remote control input must be set to RS232 (this API)
Note:
Setting overcurrent parameters on a TopCon Master will automatically transfers them to all connected Slaves.
Setting overcurrent parameters on a TopCon Slave will have no effect.
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs
DLL_RESULT TC4SetOvervoltageParam ( double  limit,
unsigned int  delay,
double  warn,
unsigned int  warndelay 
)

These functions set the protection limits for overvoltage on the output stage. Maximum allowed physical value for overvoltage-limit see API-function TC4GetMaximas.

Parameters:
[in]limitovervoltage error level
[in]delaydelay for error level in [50us]
[in]warnovervoltage warning level
[in]warndelaydelay for warning level in [50us]
Precondition:
Remote control input must be set to RS232 (this API)
Note:
Setting overvoltage parameters on a TopCon Master will automatically transfers them to all connected Slaves.
Setting overvoltage parameters on a TopCon Slave will have no effect.
Returns:
DLL_SUCCESS for success or DLL_FAIL or other value if an error occurs