tcio  V3.77.07
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 *pI2tCurrent, unsigned int *pLimit, unsigned int *pWarn)
 This function reads the actual settings for I^2t-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 TC4GetOvervoltageParam (double *pLimit, unsigned int *pDelay, double *pWarn, unsigned int *pWarnDelay)
 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 I^2t-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 *  pI2tCurrent,
unsigned int *  pLimit,
unsigned int *  pWarn 
)

This function reads the actual settings for I^2t-monitoring on output current.

Parameters:
[out]pI2tCurrentActual nominal current [A]
[out]pLimitActual I^2t error-limit [A^2s]
[out]pWarnActual I^2t warning-limit [A^2s]
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 TC4GetOvervoltageParam ( double *  pLimit,
unsigned int *  pDelay,
double *  pWarn,
unsigned int *  pWarnDelay 
)

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

Parameters:
[out]pLimitActual overvoltage error level
[out]pDelayActual delay for the error level in [50us]
[out]pWarnActual overvoltage warning level
[out]pWarnDelayActual 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 I^2t-monitoring on output-current. Maximum allowed physical value for i2tcurrent see API-function TC4GetMaximas.

Parameters:
[in]i2tCurrentNominal current [A]
[in]limitError-limit for I^2t [A^2s]
[in]warnWarning limit for I^2t [A^2s]
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) 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