LoRaWAN Troubleshooting & FAQ

LoRaWAN Troubleshooting & FAQ

Solutions for common LoRaWAN issues — gateway connectivity, device join failures, missing telemetry, downlink delivery problems, and payload decoding errors. Includes a comprehensive FAQ section answering the most common questions.

Gateway Not Connecting

Symptom: Gateway does not appear as online or show any activity in the portal.

Cause Diagnosis Solution
Certificate files not uploaded Check gateway file system for .cert.pem and .private.key Upload both files from the downloaded zip to the gateway
Wrong CUPS / LNS URI Verify gateway config against Settings → Key Vault Copy exact CUPS URI and LNS URI from the portal
Missing Trust Certificate Check if server trust CA is configured on gateway Download and upload the Server Trust Certificate
Firewall blocking port 8443 Test outbound connectivity from gateway Allow outbound TCP 8443 and 443 to AWS endpoints
Wrong EUI registered Compare gateway EUI in portal with physical device label Delete and recreate with correct EUI
Basics Station version too old Check gateway firmware version Update to LoRa Basics Station 2.0.4 or higher
DNS resolution failure Check if gateway can resolve AWS hostnames Configure DNS servers (8.8.8.8 or ISP DNS)

Device Not Joining

Symptom: Device sends join requests but never receives a join accept. Device stays in “Released” status.

Cause Diagnosis Solution
Incorrect DevEUI Compare portal DevEUI with device label (byte order matters) Re-enter DevEUI exactly as shown on device — MSB format
Incorrect AppKey Verify AppKey matches device provisioning Re-enter AppKey from manufacturer documentation
Wrong AppEUI / JoinEUI Some devices use all-zeros AppEUI Try 0000000000000000 if manufacturer doesn’t specify
Frequency mismatch Device frequency plan differs from gateway Ensure both device and gateway use same band (e.g., US915)
Device out of range Check distance and obstacles between device and gateway Move device closer to gateway, ensure line-of-sight where possible
MAC version mismatch Device uses 1.1 but profile set to 1.0.3 Match the MAC version to your device’s actual specification
Regional Parameters mismatch Regional params don’t match device firmware Check device documentation for correct RP version
Gateway offline Gateway not connected to cloud Fix gateway connectivity first (see section above)
Public network — no coverage Device not near Everynet gateway Check coverage map; consider switching to private network

Missing Telemetry

Symptom: Device has joined successfully but no telemetry data appears in Live Data.

Cause Diagnosis Solution
Decoder mismatch Check if decoded JSON attributes match template names Verify decoder output field names exactly match template attribute names
Device not sending uplinks Check Last Communication timestamp Power cycle device or trigger manual uplink (press button if available)
Payload too short / corrupt Check raw payload hex in diagnostics Verify device is sending valid encoded data per its specification
Template attributes don’t match Compare decoded fields with template attribute names Update template attributes to match decoder output (case-sensitive)
Duty cycle limit reached EU868 devices limited to 1% airtime Wait for duty cycle to reset; reduce send frequency

Best Practices

Gateway Deployment:

Mount gateway antenna as high as possible with clear line-of-sight to devices.

Use outdoor-rated gateways for outdoor deployments. Indoor gateways lose 50%+ range through walls.

One gateway can serve hundreds of devices — start with one and add more only if coverage is insufficient.

Device Configuration:

Use OTAA over ABP for security and session key rotation.

Set send interval to the minimum needed for your use case. 15-minute intervals are sufficient for most monitoring.

Use ADR (Adaptive Data Rate) to let the network optimize spreading factor for best battery life.

Keep payloads as small as possible — every byte costs airtime and battery.

Security:

Never reuse AppKeys across devices — each device must have a unique key.

Store gateway certificates securely — if compromised, delete and recreate the gateway.

Use OTAA to ensure session keys rotate on each join, limiting exposure from any single key compromise.

Monitoring:

Set up event rules to alert when Last Communication exceeds expected interval.

Monitor RSSI and SNR values in gateway logs to detect range degradation early.

Plan battery replacement schedules based on device transmit interval and payload size.

Frequently Asked Questions

Q: Do I need my own gateway?

Not necessarily. /IOTCONNECT™ supports public networks (Everynet). If coverage exists in your area, you can use public infrastructure without owning a gateway. Check the coverage map in the portal.

Q: Can one gateway support multiple devices?

Yes. A single LoRaWAN gateway can simultaneously serve hundreds to thousands of devices. The limiting factor is airtime (duty cycle) rather than device count.

Q: How often should devices send telemetry?

Depends on your use case. Most environmental sensors send every 5-15 minutes. Asset trackers may send every 1-5 minutes during movement. Consider battery life — more frequent = shorter battery.

Q: What are Device Classes A, B, and C?

Class A: Lowest power, device only listens briefly after each uplink. Class B: Scheduled listen slots via beacons. Class C: Always listening (mains-powered devices). Most battery sensors are Class A.

Q: What happens if the gateway goes offline?

Devices continue transmitting but data is lost (no buffering at the gateway level). When the gateway reconnects, new uplinks will flow again. Consider multiple gateways for redundancy in critical applications.

Q: Why is my device not joining?

The top 3 causes: 1) DevEUI byte order is reversed (LSB vs MSB), 2) AppKey doesn’t match what’s provisioned in the device, 3) Device and gateway are on different frequency bands.

Q: What’s the maximum range?

Up to 15km in rural open terrain, 2-5km in urban environments. Range depends on antenna height, obstacles, interference, and spreading factor. Higher SF = longer range but slower data rate.

Q: Can I send commands to a sleeping (Class A) device?

Yes, but the command is queued and only delivered when the device next sends an uplink. If the device sends every 15 minutes, you may wait up to 15 minutes for delivery.

Q: What’s the difference between Public and Private network?

Public: Uses shared Everynet infrastructure, no gateway needed, OTAA only, requires coverage. Private: Your own gateway, OTAA or ABP, full control, works anywhere you place the gateway.

Q: How do payload encoding and decoding work?

Devices send compact binary payloads (not JSON) to save power. /IOTCONNECT™ Lambda automatically decodes binary to JSON using the configured decoder for your template. You configure which bytes map to which attributes.

ⓘ RESOURCES

Supported Gateways: AWS Device Catalog — LoRaWAN Gateways
Supported Devices: LoRaWAN Device Examples
LoRa Basics Station: GitHub — LoRa Basics Station
LoRaWAN Specification: LoRa Alliance Documentation