Skip to content

disk91/WioLoRaWANFieldTester

Repository files navigation

Wio Terminal LoRaWAN Field Tester

LoRaWan tester

What's is it about

When deploying a LoRaWAN network you want to know your gateway coverage and measure the radio performance in different places. When deploying Helium network you particularly want to know how many Hotspot around can be touched for a given position. Then you want to enrich the network mappers to know and share the real network coverage.

There are some existing tools for such application but the cost is about $200. The idea of this project is to propose a simple tool you can build on your own with low cost hardware to fulfil this purpose.

The solution is based on low cost products, easy to find for about $50:

The solution also supports ready for use hardware:

============================

If you are using a Seeed bundle, it is already setup, you don't need to do anything more

============================

How it works

To get a better understanding on how WioLoRaWANFieldTester works, read this page.

Features

  • Easy selection for Power / Sf / max retries
  • Duty cycle status display
  • Last setting flash memory backup
  • Graph selection display
    • Rx Rssi - acked Rssi level
    • Rx Snr - acked Snr level
    • Retries - number of retry before getting a ack
    • Tx Rssi - network side Rssi
    • Hotspots - network side hotspot
    • Distance - hotspot distance (in progress)
    • GPS status - current GPS status
  • Manual / Automatic mode switch
  • Display last frame information
  • Network side RSSI / SNR / #of station
  • Your favourite network splash screen (select in config.h)
  • Screen shot and user guide
  • RFM95 Schematics
  • GPS position reporting with Helium mapper integration
  • LiPo charging mode detection
  • PCB available
  • Enclosure available
  • Serial port LoRaWan setup configuration
  • End-user setup screen
  • Setup with Cargo (helium tracking platform)
  • Ready for industrial production with credential commissioning
  • Support firmware upgrade w/o credential loss (LoRa-E5 only)
  • Reduce uplink messages when device is not moving / out of coverage
  • Discovery Mode - allow to see hotspot communications on a map (external website)
  • Works with TTN and Helium
  • Lock key & switched screen off mode
  • Bip on Join, Tx and Rx success

Coming later features

  • sdcard data storage

Get your own device

The WioLoRaWANFieldTester board can be

Quick installation and setup

Read and follow the steps in WioLoRaWANFieldTester configuration documentation

Use it

Read the User Guide documentation

Troubleshooting

All frame "LOST" in US915 SF10 (fixed in current version)

The US915 SF10 is restricting the size of uplink and downlink. Uplink is adapted but donwlink frame is currently too large. The Uplink are correctly sent but the "LOST" status is indicated when the Downlink is not received. So "LOST" is always displayed. Do not use SF10 in US915 if you want to get the uplink information. This will be fixed in a later version. Mapper and tracker features are working correclty even this.

I can't change the factory setting

The Seeed bundle comes with ready to use credentials. You don't need to setup your device. If you want to move your device out of the factory credential and move the device to your own console account or TTN, you can follow the documentation here. Once done, you won't be able to rollback to factory settings.

GPS never fixing (even outdoor)

Some of the LoRa-E5 chassis have an incorrect default UART speed at 115200. To reset it to the normal value, flash the firmware Gps_Reset_To_9600bps. Then you wait for about 1 minute and then reflash the latest version. This should fix it.

Contribute to development

Read the developer documentation