Skip to main content

Digital Output (DOUT) activation via pulse command

In some cases, a DOUT must be activated gradually, cycling instead of switching immediately to the active state (0). This method is often used for engine cut‑off while the vehicle is in motion, helping protect the driver, vehicle, and cargo.

Explanation:

There are two options to enable a DOUT as a pulse via command:

  1. Using setiotime followed by setio – since setiotime does not retain the active status, certain details must be considered to ensure the pulse completes correctly and the DOUT remains activated at the end of the process

  2. Using the “immobilizer” command – in this case, it is necessary to include an additional variable: the vehicle’s velocity

Guidelines:

DOUT Pulse Activation Using setiotime Followed by setio (DOUT remains activated):

  1. Configuration Requirement

    1. The DOUT must be configured as “Disabled” type:

  2. Building the setiotime Command

    1. SMS command structure: <password> setiotime <X1> <DOUT1_time1> <Y1> <DOUT1_time2>,<X2> <DOUT2_time1> <Y2> <DOUT2_time2>,<X3> <DOUT3_time1> <Y3> <DOUT3_time2>,<X4> <DOUT4_time1> <Y4> <DOUT4_time2>

    2. Example 1: If the command is associated with DOUT1 and the device has two DOUTs:

      password setiotime 0 2000 1 2000 n=10, → Activates DOUT1 for 2 seconds, then deactivates for 2 seconds. The cycle repeats 10 times. Note: The command ends with a comma. Add as many commas as extra DOUTs exist on the device

    3. Example 2: If the device has four DOUTs and you need to activate DOUT2: password setiotime ,0 2000 1 2000 n=10,, → Same activation/deactivation pattern, applied to DOUT2

    4. Important Considerations:

      1. Avoid sending multiple commands too quickly. If commands are sent in rapid succession, the DOUT may get stuck and the tracking device will require a restart. Always wait for a response before sending the next command

      2. If any DOUT is configured as LED, Buzzer, Blocking, or Jamming block, this command cannot be used

      3. The setiotime command cannot be interrupted once started

  3. Building the setio Command

    1. SMS command structure:

      1. For HCV5/LCV5/Pro5 devices: <password> setio <X1>,<X2>,<X3>,<X4>

        For other devices: <password> setio <X1>,<X2>

      2. Examples:

        Device with two outputs, activating DOUT1: password setio 0,1

        Device with four outputs, activating DOUT1: password setio 0,2,2,2

    2. This SMS command will not work in a couple of conditions:

      1. If a DOUT is configured to Blocking and driver registration is enabled and the registration function is set to Blocking

      2. DOUT activation under conditions is enabled and DOUT is set as an output channel

  4. Integration

    This process can be integrated into your server for automation and control. To avoid future issues with this integration, please ensure that our communication protocols—based on command 7/108 (SMS via GPRS)—are properly implemented.

    If you do not currently have access to these protocols, it will be necessary to request the information from our technical support team. An NDA will be required in order to provide this documentation.

DOUT Pulse Activation Using immobilizer Command:

  1. Configuration Requirement

    1. The DOUT must be configured as “Immobilizer” type:

    2. Pattern example:

    With this type of pattern, the immobilizer DOUT will activate for 5 seconds and then deactivate for 5 seconds. This behavior repeats 10 times, and with each cycle the activation/deactivation duration increases by 2 seconds.

  2. Building the immobilizer Command

    1. SMS command structure: <password> immobilizer <speed>

      <speed> = vehicle speed at which the progressive DOUTs must be toggled (values from 1 to 250)

      Reset command structure: <password> resetimmob

    2. Example - Activate immobilizer at 40 km/h: password immobilizer 40 → This command will arm the DOUT, and when the device velocity is 40 km/h or less, the immobilizer DOUT will be activated

  3. Important Considerations

    1. The immobilizer functionality must be properly configured before using this SMS command

    2. The immobilizer DOUT considers the ignition status

    3. The DOUT velocity can be sourced from CAN or GNSS. If GNSS is used, the device must have a valid GPS fix

    4. If GNSS velocity is zero when the immobilizer command is received, the DOUT will activate continuously (without a pulse pattern)

    5. To deactivate the immobilizer scenario, you must send the resetimmob command

Extra comments:

We recommend handling DOUT activation for engine cut‑off using the immobilizer command. This approach is safer, as once the SMS is sent, the device logic manages the process until the DOUT is fully deactivated.

Tools required:

Name:

Link:

setiotime command

setiotime

setiotime command

setio

immobilizer command

immobilizer

Ruptela protocol

Ruptela Protocol

Related Documentation:

Name:

Link:

SMS command list

SMS Command List

Immobilizer – operating principles

Digital Output Description

Custom – Configuravle DOUT patterns

Digital Output Description

Keywords:

DOUT, pulse activation, SMS, SMS commands, setiotime, setio, immobilizer, velocity, engine, engine cut-off.

Automatically generated fields:

Document#

xxxxx

Created By:

Frank Grau

On:

25/05/2026 16:00:00

Modified By:

Name Surname

On:

dd/mm/yyyy hh:mm:ss

Did this answer your question?