The LoRaWAN region configured on the device (Harvestree Toolbox, USB) must match the device profile and gateway channel plan on your network server. Mismatch is a common cause of join failure or missing uplinks.
| Item | Value |
|---|---|
| Class / MAC | Class A · LoRaWAN 1.0.3 (RP002-1.0.3) |
| Activation | OTAA — DevEUI + JoinEUI + AppKey |
| App uplink | FPort 1 · reference decoder harvestree_decoder.js (on the LNS and/or in your integration service) |
| Regions | AS923-1 · AU915 · EU868 · IN865 · US915 |
Region matrix
| Device region (Toolbox) | LNS device profile | Channel plan on device | LNS / gateway alignment |
|---|---|---|---|
| EU868 | MAC 1.0.3 · EU868 | Default EU868 125 kHz | Standard EU868 gateway profile |
| IN865 | MAC 1.0.3 · IN865 | Default IN865 125 kHz | Standard IN865 gateway profile (865–867 MHz) |
| US915 | MAC 1.0.3 · US915 | Hybrid sub-band 1 (factory): ch 0–7 + 64 | Match gateway/LNS to device plan (table below) |
| AU915 | MAC 1.0.3 · AU915 | Hybrid sub-band 1 (factory): ch 0–7 + 64 | Match gateway/LNS to device plan (table below) |
| AS923 | MAC 1.0.3 · AS923-1 | AS923-1 channel plan | Use AS923-1 on the LNS (not AS923-2/3/4 unless device/Toolbox match) |
US915 / AU915 — channel plans
Channel plan is set in Toolbox → Network. Factory delivery uses hybrid sub-band 1. Other plans select the standard full plan or hybrid sub-bands 2..8.
| Plan | 125 kHz channels | 500 kHz |
|---|---|---|
| Hybrid sub-band 1 (factory default) | 0 – 7 | 64 |
| Standard full plan | 0 – 63 | 64 – 71 |
| Hybrid sub-band 2..8 | Eight consecutive channels of that sub-band | One 500 kHz channel for that sub-band |
US915 / AU915
Factory / legacy delivery uses hybrid sub-band 1 (channels 0–7 + 64). If gateways use another sub-band, joins fail or uplinks are missed. Prefer explicit STD / SB2–SB8 plans (26.9+) when needed and align the LNS profile.
DR limits
IN/EU: DR0–5 · US915: DR1–3 · AU915 / AS923-1: DR3–5 (dwell / regional rules).
Identifiers
| Field | Source | Notes |
|---|---|---|
| DevEUI | Device label / USB read | 8 bytes, unique per unit |
| JoinEUI (AppEUI) | Factory or Toolbox | If user JoinEUI is zero, factory value is used |
| AppKey | Factory or Toolbox | If user AppKey is zero, factory value is used |
| serial_number | Uplink bytes 5–7 | 24-bit little-endian application ID in payload |
- Create one device profile per LoRaWAN region you deploy.
- Keep the reference decoder aligned with the firmware family — on the LNS when it hosts codecs, and/or in your integration service (latest recommended).
- Join is attempted when storage voltage reaches
voltage_limit; retry interval 300 s while waiting. Regional duty-cycle backoff remains active.