Skip to main content
FW version: Stable

Contactor control

Contactor output (DOUT) hardware on a siliXcon device is a power output with PWM capability (low side switch). Although it can be used for various purposes, primary intention is to drive contactor coils. Some of our devices feature current measurement and short-circuit protection on the contactor outputs.

info

The following variables are located in the /common/contactoX folder, where X is the contactor number.

warning

Do not connect capacitive load to the DOUT output, as the in-rush current might damage the circuitry.

Parameters

contactor

attack [-V / +%]

Voltage value during contactor startup, applied for attacktime milliseconds.

  • Positive value: Set the duty cycle (voltage) as percentage from battery voltage.
  • Negative value: Set the duty cycle (voltage) to match exact voltage.
Example

attack = 10; battery voltage = 50V voltage on the coil will be 10% from 50V : 5V

attack = -10; voltage on the coil will be 10V (as long as the battery voltage is greater than 10V)

hold [-V / +%]

Contactor voltage after startup, applied after attacktime elapsed.

  • Positive value: Set the duty cycle (voltage) as percentage from battery voltage.
  • Negative value: Set the duty cycle (voltage) to match exact voltage.

attacktime [ms]

When the contactor is closed, attack value is used during attacktime. After that hold value is used.

opts

Option flags for the contactors. This is bitwise parameter.

BitDescription
0Close on driver init
1Open on driver or cmio error
2Ramp on start

retrytim [ms]

When overcurrent protection triggers, the power switch is relaxed. After the time specified with retrytim, the switch is engaged again automatically. To disable automatic retry, set this parameter to zero.

info

Only present on devices with DOUT equipped with sort circuit protection capability.


States

current [mA]

Actual current on the contactor.

note

Only present on devices with DOUT equipped with current measurement capability.


Shell commands

cont [contactor number] [cmd]

You can manually engage/disengage the contactors with this command. This works also for driving DOUTs directly.

If you run the command with only single argument (contactor number), you will receive the actual contactor duty cycle (or 1,0 for DOUTs).

cmdDescription
0switch off the contactor
1switch on the contactor
note

If Close on driver initialization is enabled, command will not work on this contactor.