Skip to content

disk91/WioHeliumMonitor

Repository files navigation

Beta Open

WioHeliumMonitor

The purpose of this project is to monitor your Helium Hotspot and be alarmed when it is not working correctly.

The solution currently ping the miner over the LAN and ping Internet to make sure the Hotspot is connected to the LAN and have an access to Internet. It get the hotspot status from watchium application. It also communicate over LoRaWan to test the Hotspot LoRa communication. LoRaWan is also used to report status when the WAN is not working.

Wio Helium Monitor

Information are reported to Watchium Application for monitoring and alarming your hotspot from your smartphone.

All the Watchium User can use the WiFi information report. Watchium Silver & Gold user have the LoRaWan report enable. Watchium automatically distribute the LoRaWan credential and supports the communication costs.

See the setup process above.

Requirements

The project uses a WIO Terminal you need to make some specific stuffs:

It can be use without a LoRa-E5 board, in this case, only the WiFi verification will be possible. To verify the LoRaWan communication, you need one of the following options:

  • LoRa-E5 chassis from Seeedstudio
  • Grove-E5 from Seeedstudio (connected on one of the two connectors)

If you want to use it from sources, you also need to make some modification on Arduino stack:

  • Modifiy the native libraries to fix Arduino stuff:
    • the ping.c file in the libraries according to the ping.cpp content in this archive (bugfix)
    • the erpc_port_freertos file according to ping.cpp content (garbage collection hack)
  • Needed libraries
    • QRcode from Richard More

Setup WioHeliumMonitor

  • Before flashing the pre-built firmware, make sure you have the latest Wio WiFi firmware (see above).
  • The setup screen is automatically displayed, use the button if you need to change the setup.

Wio Helium Monitor Setup

  • With you smartphone / Pc, connect to the Wio Helium Monitor

Wio Helium Monitor Setup

Wio Helium Monitor Setup

Wio Helium Monitor Setup

  • Enter the WiFi informations and the IP of the Hotspot on the local network

Wio Helium Monitor Setup

  • Submit the configuration, the Wio Helium monitor will reboot and start working

Associate with Watchium Application

  • Once you have created your account on Watchium, add your account and sync it to show you hotspots.

  • You can select the Hotspot to associate with the Wio Helium Monitor

Wio Helium Monitor Setup

  • Then select the hotspot menu

Wio Helium Monitor Setup

  • Select the Wio Helium Monitor entry and follow the instruction

Wio Helium Monitor Setup

  • You can display the Wio Helium Monitor ID as a QR Code

Wio Helium Monitor Setup

Coming later

  • store WiFi configuration in an external flash for seamless upgrade

Known problems

  • WiFi network names & password with UTF8 or unusual characters is not supported
  • The device will restart when the watchium server is not reachable. This is due to the Arduino stack never returning when the target server can't be reached. The bypass solution I found has side effect I was not able to debug in a short period of time.

Changelog

Version 1.0 - 2022-05-15

  • Ready to be used, all features described above.

About

Monitor your Helium hotspot with a Wio Terminal

Resources

Stars

Watchers

Forks

Packages

No packages published