DVL triggering🔗
The DVL has different options for triggering acoustic pings to perform a velocity measurement. Triggering can be useful when you need to synchronize the DVL with other sensors.
| Model | Software triggering | Hardware triggering |
|---|---|---|
| A50/A125 | Yes | No |
| A100/A250 | Yes | Yes |
Hardware triggering🔗
Use the RS232 RX line of the DVL to trigger a ping after enabling hardware triggering in the configuration.
Hardware triggering must be enabled first
Hardware triggering is disabled by default. Until it is enabled, trigger pulses on the RX line are ignored and no ping is sent. Enable it with the hardware trigger setting in the web GUI, or with the hardware_trigger_enabled parameter over the TCP JSON API or serial protocol. The setting is kept across reboots.
The DVL measures the width of a positive pulse on the RX wire. The wire idles at a negative voltage. A pulse that goes positive and returns to negative after 78.1 µs ± 4.3 µs is recognized as a trigger. The ping is triggered when the pulse ends, that is when the wire returns to the idle negative level.
For a connection configured as 115200 baud, 8N1, this pulse corresponds to transmitting a "NUL" ASCII character (0x00, Ctrl + @). On the RS232 wire the start bit and the eight zero data bits are all positive, so they keep the wire positive for nine bit times, and the stop bit returns it to the idle level:
Because the trigger is defined by its pulse width, sending a NUL character at another baud rate does not produce a valid trigger. The tolerance of ± 4.3 µs is half a bit time at 115200 baud.
Voltage levels are RS232
The drawing shows the voltage on the RS232 wire, which is what you see with an oscilloscope. RS232 idles at a negative voltage and a 0 bit is a positive voltage. If you drive the trigger from a UART logic output, you need an RS232 transceiver in between. In logic terms the pulse is a low period of 78.1 µs, and the trigger is the rising edge at the end of it.
The trigger can be sent as often as needed. If the DVL is already transmitting or receiving, incoming trigger signals are discarded.
Hardware triggering works even when the serial output is disabled, which is the default on DVL A100/A250. Disabling the serial output stops only the report stream, not the RX line.
Warning
Acoustics must be enabled. Hardware triggering will not work while acoustics are disabled.
Software triggering🔗
Software triggering is available for all DVL models. It triggers a ping over the TCP JSON API or serial protocol. Acoustics must be disabled for this to work.
Software triggering differs from hardware triggering because it is sent as a request to the DVL and placed in a ping queue. The queue can store up to 15 requests, which are executed one after another until the queue is empty.
See the software ping command in Commands.
Because this method depends on the internal state of the DVL, the ping queue, and Ethernet jitter if Ethernet is used, the exact ping time is less predictable than with hardware triggering.
Warning
Disable acoustics before using software triggering. This is different from hardware triggering.