Skip to content

Latest commit

 

History

History
69 lines (48 loc) · 2.97 KB

KST3220-Packet-Types.md

File metadata and controls

69 lines (48 loc) · 2.97 KB

KST3220 Packets Types

Uplink

One payload is sent with both Battery, Switch, and Error packets concatenated.

If the battery length equals 0x01 then the battery will be a percentage based on the Battery Percentage Loopup Table. If the battery length equals 0x02 then the battery will be in mV based on the Battery Voltage Lookup Table.

Check the documentation in the Javascript Parser for more detail.

Example Payload with Battery Percentage: 007801FF00820208F1FFFF0100

Example Payload with Battery Voltage: 0078020BFE00820208F1FFFF0100

Packet Type Key Length Value Decoded Value
Battery (Percentage) 0x0078 0x01 0xFF 100%
Battery (Voltage) 0x0078 0x02 0x0BFE 3.07V
Distance 0x0082 0x02 0x08F1 2289mm
Error 0xFFFF 0x01 0x00 No Error

Downlink

A downlink payload can be sent to change the uplink interval time in minutes. FPort 2 is used for sending a Downlink. Valid range for Uplinks is 0x01 to 0x240. Which equals to 1 minute to 240 minutes (4 hours)

Example: 0100011E = Set Uplink Interval to 30mins

Packet Type Key Length Value Decoded Value
Uplink Interval 0x0100 0x01 0x1E 30 Minutes

Battery Percentage Lookup Table

Voltage Sensed Battery Ranges Percent Remaining
2.70V 0-200 0%
2.75V 201 - 211 5%
2.80V 212 - 221 20%
2.85V 222 - 231 70%
2.90V 232 - 241 85%
2.95V 242 - 253 90%
3.05V 254 - 255 100%

Battery Voltage Lookup Table

Voltage Percent Remaining
Less than 2.70V 0%
2.71V to 2.75V 5%
2.76V to 2.80V 20%
2.81V to 2.85V 70%
2.86V to 2.90V 85%
2.91V to 2.95V 90%
2.96V to 3.0V+ 100%

Error States

Example Key Length Value Notes
0xFFFF0100 0xFFFF 0x01 0x00 No Error
0xFFFF0101 0xFFFF 0x01 0x01 Insufficient Ambient Light Level for Reading
0xFFFF0102 0xFFFF 0x01 0x02 Insufficient Reflective Light Level for Reading
0xFFFF0103 0xFFFF 0x01 0x03 Unknown Error; Cannot Read Distance