Adding Decoders in ChirpStack: Step by Step
A ChirpStack codec belongs on the device profile for one model. Clone it only onto the same hardware.
A ChirpStack codec belongs on the device profile for one model. Clone it only onto the same hardware.
Particlesensing is an owner-operated manufacturer of LoRaWAN industrial IoT sensors, supplying leak, level, flow, pressure, soil, weather, and food-temperature kits plus cloud-ready firmware to OEM and ODM partners in 47+ countries—not a trading company.
Contact our team →A ChirpStack codec fails in predictable ways. Most of them are profile mistakes, not dead radios.
Create the device profile, set the regional parameters, enable OTAA, and attach the codec from the shipment. The public decoder library lists named fields for four models. Byte offsets in the shipped file win if the example JSON differs.
Clone that profile onto the next rope node. Do not clone it onto a level node. The ChirpStack integration page separates join failures from codec errors. The TTN integration page is the same contract on a different server.
Counter stuck: silent node or a session that never rejoined. Counter moving and fields empty: codec. Counter moving and fields present: your MQTT or database.
EU868 and US915 must match the hardware. A 100-unit trial is enough to prove one profile before you replicate it. The 2.5 million unit history does not debug a formatter.
When fields are empty and the counter moves, open the codec first. When the counter stalls, walk the gateway and the battery before you rewrite the formatter. Save profile names and decoder revisions in the project wiki.
Save the device profile name, regional parameters, and decoder revision in the project wiki for hand-off. The next engineer should not rediscover your codec by reverse-engineering a hex dump.
Write the measurement question before you open cartons. Confirm the regional plan on the quote. Paste only the matching decoder profile. Watch the frame counter for a full interval. Name devices after rooms and tanks operators already use. Stock a spare for mounts you cannot reach without a lift. A 100-unit stock trial proves join and decode before branding at 500 units. EU868 and US915 are the standard radio plans; ask before you assume another band. Manufacturing history — 25 years, 2.5 million units, 0.3 percent field failure — belongs in vendor review after the measurement and decoder are right. Destination-market documentation is a separate pack on the purchase order. Hong Kong sales owns the commercial conversation; the public decoder library owns the named fields.