tcio
 All Functions Groups Pages
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) More...
 
DLL_RESULT TC42GetQ4LimitOverCurrentError (double *pCurrent)
 Get Q4 over current error limit for Q4 operating mode (will be negative) More...
 
DLL_RESULT TC42GetQ4LimitOverCurrentErrorDelay (double *pTime)
 Get Q4 over current error delay for Q4 operating mode. More...
 
DLL_RESULT TC42GetQ4LimitOverCurrentWarn (double *pCurrent)
 Get Q4 over current warning limit for Q4 operating mode (negative!) More...
 
DLL_RESULT TC42GetQ4LimitOverCurrentWarnDelay (double *pTime)
 Get Q4 over current warning delay for Q4 operating mode. More...
 
DLL_RESULT TC42SetQ4LimitOverCurrentError (double Current)
 Set Q4 over current error limit for Q4 operating mode (negative!) More...
 
DLL_RESULT TC42SetQ4LimitOverCurrentErrorDelay (double Time)
 Set Q4 over current error delay for Q4 operating mode. More...
 
DLL_RESULT TC42SetQ4LimitOverCurrentWarn (double Current)
 Set Q4 over current warning limit for Q4 operating mode (negative!) More...
 
DLL_RESULT TC42SetQ4LimitOverCurrentWarnDelay (double Time)
 Set Q4 over current warning delay for Q4 operating mode. More...
 
DLL_RESULT TC4GetI2tCurrentParam (double *pI2tCurrent, unsigned int *pLimit, unsigned int *pWarn)
 This function reads the actual settings for I^2t-monitoring on output current. More...
 
DLL_RESULT TC4GetMaximas (unsigned int *p_vabs, unsigned int *p_iabs)
 This function is used to get the maximum allowed voltage- and current-limits. More...
 
DLL_RESULT TC4GetOvercurrentParam (double *pLimit, unsigned int *pDelay, double *pWarn, unsigned int *pWarnDelay)
 These function read the actual protection limits for output-overcurrent. More...
 
DLL_RESULT TC4GetOvervoltageParam (double *pLimit, unsigned int *pDelay, double *pWarn, unsigned int *pWarnDelay)
 These function read the actual protection limits for output-overvoltage. More...
 
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. More...
 
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. More...
 
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. More...
 

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 TC4GetOvercurrentParam ( double *  pLimit,
unsigned int *  pDelay,
double *  pWarn,
unsigned int *  pWarnDelay 
)

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

Parameters
[out]pLimitActual overcurrent error level
[out]pDelayActual delay for the error level in [50us]
[out]pWarnActual overcurrent 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 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