LIBERiot MQTT gateway for the ESP8266 WiFi module
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


LIBERiot MQTT gateway for the ESP8266 WiFi module. This application compiles on Arduino 1.6.5 or newer.

RF interface

This application relies on a panStamp NRG module for the low-power wireless communications. This module runs gswapmodem and transmits any wireless packet received to the ESP8266. After receiving any wireless packet, the ESP8266 module transmits this packet in ASCII format to LIBERiot's MQTT broker and server.

GWAP is the protocol used between low-power wireless motes and gateways. This protocol is open and uses unique 12-byte addresses for each device. This makes each device uniquely identifiable around the globe.


Press the GPIO0 button to put the gateway in Access Point mode. After this connect to the new "LIBERiot WiFi gateway" WiFi network from a computer (password "liberiot") and send a HTTP GET request with the following format: is the default IP address of the gateway when working in access point mode. Simply change "your_ssid" by your router's WiFi SSID and "your_password" by your router's WiFi password. Once done, restart the gateway.

LIBERiot register

In order to register gateways and devices against LIBERiot each user needs a user key. User keys are automatically generated when creating an account from After getting the user key, it needs to be entered into the gateway by means of the following HTTP GET command:

Users also need to set the location of the gateway as follows:


LIBERiot's MQTT broker address is Packets transmitted to this broker have to comply with the packet structure defined by the GWAP protocol.