How Do I decode an Ultrasonic Level Sensor Event?

How Do I decode an Ultrasonic Level Sensor Event?

The Ultrasonic Level Sensor will generate events if the measured distance rises above or falls below the configured thresholds.
 
Byte 0: 7-4
Byte 0: 3-0
Byte 1
Byte 2 
 
Byte 3 and 4
Protocol version



(4 bits)
Counter




(4 bits)
Message Type Code




0x10
Ultrasonic Level Sensor Event Payload



(0x03 in the example below)
Current distance in millimeters



(0x20C9 in the example below)
 
Protocol Definition
              First 4 bits are defined by Radio Bridge for the protocol
              Next 4 bits are a counter that goes from 0 to F (Hex) and repeats
             
Message Type Code
              0x10 represents the Ultrasonic Level Sensor Message Type Code                            
 
Ultrasonic Level Sensor Event
              Byte 2                         Description
                   0x00                              Periodic Report
                   0x01                              Distance has risen above upper threshold
                   0x02                              Distance has fallen below lower threshold
                   0x03                                Report on change increase
                   0x04                              Report on change decrease
 
Byte 3 & 4
              Distance in mm
 
Example of Ultrasonic Level Sensor Event Message
 
10 10 03 20C9
1                                 Protocol Version (currently always 0x1)
0                                 Packet Counter (increments by 1 each message and wraps from 0xF to 0x0)
10                               Message Type Code (0x10 = Ultrasonic Level Sensor Identifying value)
03                               Ultrasonic Level Sensor Event Payload (0x03 = Report on change increase)
20C9                          Distance in mm (0x20C9 = 8393 mm)
 
The Radio Bridge Console will generate the following output for this message:
Ultrasonic Level Event: Report on change increase
Distance: 8393 mm



    • Related Articles

    • How do I encode a Configuration Downlink for a MAXBOTIX Ultrasonic Level Sensor?

      NOTE:  All downlinks must contain a total of (8) bytes, padded with zeros at the end when necessary. Also note that if the configuration settings exceed the maximum ratings on the sensor, the sensor may not report an event. See User Manual ...

    • How do I decode a Dry Contact Sensor Event?

      The wireless Dry Contact Sensor detects a connection between two wires. When the wires are either shorted or opened, the Dry Contact Sensor will generate an event.   Byte 0: 7-4 Byte 0: 3-0 Byte 1 Byte 2    Protocol version     (4 bits) Counter       ...

    • How do I decode a Water Rope Sensor Event?

      The Water Rope Sensor will generate events when the presence of water or another liquid is detected   Byte 0: 7-4 Byte 0: 3-0 Byte 1 Byte 2    Byte 3 Protocol version     (4 bits) Counter       (4 bits) Message Type Code     (0x08) Water Rope Sensor ...

    • How do I decode a Water Leak Sensor event?

      The Water Leak Sensor will generate events when water (or another liquid) is present, and then give a value representing the relative measurement of the resistance between the probes of the sensor. The Water Leak Sensor uses that resistance to ...

    • How do I decode a Voltage Sensor event?

      The Voltage Sensor will generate events if the measured value rises above or falls below the configured thresholds.   Byte 0: 7-4 Byte 0: 3-0 Byte 1 Byte 2    Byte 3 & 4 Protocol version     (4 bits) Counter       (4 bits) Message Type Code     ...