Field contract
After decode, dashboards should show open/closed, battery millivolts, and a frame counter. Mount the reed on the frame and the magnet on the leaf within the datasheet gap.
Correlate door openings with temperature or leak alarms in your application logic. The decoder only reports contact state.
Named fields
| Field | Type | Notes |
|---|---|---|
| open | boolean | True when the magnet gap exceeds the reed threshold |
| battery_mv | integer | Battery millivolts |
| fcnt | integer | Frame counter |
Example after decode
{
"open": true,
"battery_mv": 3350,
"fcnt": 12
}Byte offsets live in the decoder file shipped with the kit. If the first uplink disagrees with this example, trust the shipment file and the factory functional-test record.
Related pages
FAQ
Is open the same as wet?
No. Door contacts report open/closed. Leak kits report wet/dry. Keep separate device profiles.
Typical magnet gap?
Confirm on the datasheet; many installs stay within about 15 mm. Larger gaps cause false opens.
Heartbeats?
Hourly heartbeats are common so a silent node is obvious even when the door stays closed.
Where do I paste the codec?
ChirpStack device profile or TTN payload formatter. See the integration pages for the click-path.