Connecting long range sensors using LoRa and MQTT

Connecting long range sensors using LoRa and MQTT

This post is written as part of an assignment for the HAN University of Applied Sciences. This is also part of a few other projects I am posting.

Other guides can be found here:
Two Zigbee Networks Joined over a wireguard VPN: Two Zigbee Networks joined over a Wireguard VPN
Controlling Tuya devices locally using Node-Red: Controlling Tuya devices locally using Node-Red

This guide presumes that you have some basic knowledge of using Home-Assistant and that Home-Assistant is already installed. I am not liable for broken devices, broken configuration, thermonuclear war or ANYTHING ELSE. This guide is provided as is. Nonetheless I hope you find it interesting :smiley:

Introduction

Unlike the other posts I made. This isn’t a guide but more of an exploration of what is possible. At this point with my Home-Assistant installation I could add Zigbee devices and Wi-Fi devices and sensors at my own studio and at my parents place which is connected through a VPN. However I couldn’t put sensors in the yard of my parents or put a device at a long-range without an internet connection or Zigbee Signal from either gateways.
That is why I decided to explore with a Point to Point LoRa connection. I Have used used LoRaWAN with The Things Network, but neither my parents place or my own studio have very good coverage of TTN. So I bought two ESP32 modules with a SX1276 Lora chip and went coding.

LoRa

LoRa stands for Long Range and is specifically designed to send data over longer distances upto 5km. It is mostly used by LoRaWAN networks like the things network. More information on LoRa can be found here and more information on The Things Network can be found Here

Goal of this project

The point of using LoRa is to get a longer range. So I wanted to see how far I could get in a semi urban area with some lower power modules.

Modules

I opted to buy two LilyGO TTGO T3 LoRa32 V1.6.1 ESP32 Modules. With some cheap antenna’s from amazon not for extended range but more for antenna placement.

The Project

A few years ago I made a small joke project in where a traffic light was hooked up to fridge. When the fridge would open the traffic light would go to green. When it closes it would cycle back through orange and eventually to Red.
This was controlled by Arduino Nano which which would constantly read a digital pin to check if the fridge light was activated. If the fridge light turned on the pin would go high and the light would turn green.

Hardware

The Hardware consist of a Node and Gateway.

The Node

The Board that controlled the traffic light becomes the node and originally looked like this:

The traffic light itself looks like this and is a leftover from a carnavals project a few years ago:



Traffic_light_red

There are two relays to switch live and neutral wires per light. So there are six relays in total. The Red light has inverted logic because that is light that is almost always on since the fridge is closed most of the time. This is so that there is the least amount of wear on the relays since they are off in a default state.
The relays are controlled using BJT transistors. There are debugging LED’s on the board for programming the board if it is removed from the traffic light.

The relays are controlled in a similair way to this schematic:

This meant that the board was almost ready. Only the pins for it had to be mapped to appropriate pins on the LilyGo.
The pinout for this was changed as follows:

Function Arduino Nano Pin LilyGO Pin
Green light D11 GPIO12
Yellow Light D5 GPIO13
Red light (inverted) D2 GPIO15
Fridge Read Pin A2 GPIO2

After some more soldering with protoboard it looked like this:

The Gateway

The Gateway is just the LilyGo module described earlier that is connected to a Wifi Network.
The Node and Gateway are about 1 km apart from each other. The Gateways job is to translate MQTT message into LoRa messages.

Software Design

There are two pieces of different software written. The Node is in control of traffic light and The Gateway is in control of processing MQTT messages and sending them over LoRa.

The Node

The Node can control the traffic light in three Modes: Manual, Automatic and Flicker

Manual

In the manual mode you can select a color from the Home Assistant color wheel. Green controls the green stoplight, red Controls the red stoplight, and blue controls the yellow stoplight.
The Reason that blue is controlling the yellow light is so that there is finer control after all. There is no blue light in the traffic light so nothing goes to waist. It also easier to code since each light has its own value from 0 to 255
However the lights are binary. This means that they either on or off. So I mapped that above 200 the light is on and below 200 the light is off

Flicker

Flicker is essentially the same as the manual mode only that the light flickers at the selected color with an interval of 1 second.

Automatic

The Automatic mode is the original function of the traffic light. This means when the fridge is opened it turns green and when it closes it turns the light to orange and then red on an interval of 2 seconds.

Counting how many times the fridge has opened

Whenever the fridge is opened it stores it in ringbuffer. When the transmit interval occurs for LoRa it sends back a ping that the fridge has opened. This is then turned back into a MQTT message and registered by node red to the a virtual sensor.

The Gateway

The Gateway checks if there is an MQTT message

Software implementation

Node-RED and Home Assistant

For this to be controlled from Home Assistant I wanted to control it from MQTT. But since I don’t really like the normal MQTT Light implementation I opted to use A virtual light in combination with Node-Red. See my guide on controlling Tuya light were I basically did the same thing. But in short I created a fake light and sensor with the virtual HACS plugin you can find here
The config for the virtual light looks like this:

- platform: virtual
  name: Sociale Leven Stoplicht
  initial_value: "on"
  initial_brightness: 100
  support_color: true
  initial_color: [0, 100]
  support_effect: true
  initial_effect: "Automatic"
  initial_effect_list: ["Automatic", "Flicker", "Manual"]

The config for the virtual sensor looks like this:

- platform: virtual
  name: "Sociale Leven Koelkast"
  initial_value: 0
  initial_availability: true
  unit_of_measurement: "x Opened"

From here I created Node-Red Flow:


This flow can be found in my github here

For example if I set it to the mode to manual and choose green as a color it sends the following JSON:

{
   "state":"on",
   "mode":"Manual",
   "red":false,
   "green":true,
   "yellow":false
}

In the reverse direction a single message is incremented by a counter in Node-RED and that updates the virtual sensor.

Node

The nodes implementation can be found in my github repository here.\

Unpacking LoRa messages

void loop() 
{
  if (millis() - lastSendTime > transmitIntervalMs) {
    TransmitFridgeOpened();
    lastSendTime = millis();            // timestamp the message
  }
  CheckForPacket();
}

Unpacking LoRa Messages looks like this:

void CheckForPacket()
{
  if (LoRa.parsePacket()) 
  {
    unpackedMessage_t unpackedMessage;
    uint8_t message = 0;
    while (LoRa.available()) 
    {
      message = (uint8_t)LoRa.read();
      unpackedMessage = ParseLoraMessage(message);
    }
    if(unpackedMessage.mode == AUTOMATIC)
    {
      SetStopLightAutomatic();
    }
    if(unpackedMessage.mode == FLICKER)
    {
      SetStopLightFlicker(unpackedMessage.color.red, unpackedMessage.color.yellow, unpackedMessage.color.green, 1000);
    }
    if(unpackedMessage.mode == MANUAL)
    {
      SetStopLightColors(unpackedMessage.color.red, unpackedMessage.color.yellow, unpackedMessage.color.green);
    }
  }
}

The main loop is checking constantly if a LoRa packet has arrived or if it needs to send a LoRa packet. If a LoRa packed arrived it unpacks it. A LoRa packet consists of a singular byte and looks like the following:\

Bit 8 7 6 5 4 3 2 1
Data Empty Mode Green Yellow Red

All data fits into 5 bits. For every light a 1 represents on and 0 means off.
The modes are encoded as follows:

  • 00 for automatic
  • 01 for manual
  • 10 for flicker
  • 11 is invalid.

Automatic Mode

In the original implementation of the traffic light. The loop would constantly check if the fridge had opened. Since the loop is now fully occupied by checking if there is LoRa packet this is no longer possible.
This functionality is now rewritten on a interrupt bases. And it works like this:
The fridge detection pin is connected to an interrupt service routine that checks when the pin rises. To mitigate noise there is FreeRTOS timer of 20ms. After these 20ms have passed a function is called to check if the Pin is still high. This is done because sometimes there can be noise which will trigger the pin. This noise can for example be created by switching on and off devices which inducts current into the wire that runs from the fridge to the traffic light. It essentially a software debounce function.

A Timing diagram looks like this:

The checking for closing the fridge works in the same way, but there HIGH and LOW states are switched. The Red Light activates after two second timer so there is no debounce implementation for that

Manual Mode

Manual mode sets the corresponding bits for red, yellow and green to the output.

Flicker

Flicker does the same as manual. But it alternates between off and on states by invoking a FreeRTOS timer which will switch the state when the timer times out.

The Gateway

The Job of the Gateway is to listen for MQTT Messages and Listen For Lora Messages that it can receive. Once it finds an MQTT Message it will translate from the JSON mentioned above to the single byte discussed above.
MQTT message are received on interrupt bases. Once A message is received it will parse it. The parsing function looks like this:

uint8_t parseToByte(mqttMessage_t inComingMessage)
{
    const static uint8_t redBitMaskOn    = 0b00000001;
    const static uint8_t yellowBitMaskOn = 0b00000010;
    const static uint8_t greenBitMask    = 0b00000100;
    
    
    const static uint8_t AutomaticModeBitMaskOn     = 0b00000000;
    const static uint8_t ManualModeBitMaskOn        = 0b00001000;
    const static uint8_t FlickerModeBitMaskOn       = 0b00010000;

    const static uint8_t offMessage = ManualModeBitMaskOn;

    uint8_t DataByte = 0b00000000;
    if(inComingMessage.state == ON)
    {
        if(inComingMessage.color.green == true)
        {
            DataByte = DataByte | greenBitMask;
        }
        if(inComingMessage.color.red == true)
        {
            DataByte = DataByte | redBitMaskOn;
        }
        if(inComingMessage.color.yellow == true)
        {
            DataByte = DataByte | yellowBitMaskOn;
        }

        switch (inComingMessage.mode)
        {
            case AUTOMATIC:
                DataByte = AutomaticModeBitMaskOn;
                break;
            case MANUAL:
                DataByte = DataByte | ManualModeBitMaskOn;
                break;
            case FLICKER:
                DataByte = DataByte | FlickerModeBitMaskOn;
                break;
            default:
                DataByte = offMessage;
                break;
        }
    }
    else
    {
        DataByte = offMessage;
    }
    return DataByte;
}

At the top some bitmasks are seen. These bitmasks are set depending on the data in the JSON that is received. It is then translated to a single byte of data. Since LoRa is very low bandwidth we cannot send entire strings across it
If you want a deeper dive into the code it can be found on my github page. Note that I will probably be updating the code over the following weeks to tweak some things here and there.

Youtube Videos

I Have posted some unlisted youtube videos of it working:
Changing the color of the traffic light
Counting the number of times the fridge opens

LoRa Spectrum and Legality

Since you are sending over a free part of the frequency spectrum there are limitations on how much power you can use on the band. The restrictions in the Netherlands for 868MHz band are a max sending power of 25mW and only sending at 1% duty cycle. This is to ensure that the band is not to crowded. The 1 km was at the edge of what I could reach. Since I couldn’t put the antenna outside of the buildings I had to resort to a spreading factor of 10 at the maximum sending power. However with a standard pre-amble of 12.25 and one byte this means that I could only send 1 Message per 24 seconds. If you copy this project keep this in mind. I am not liable for you breaking broadcasting laws in your country

Short comings/future additions of this Project

Since I didn’t make use of LoRaWAN. There is no encryption and technically anyone can listen or sabotage the message stream. There is also no addressing. So if anyone is using the same frequency band and channel you can get garbage data. This can be mitigated by implementing some form of addressing and maybe even encryption.

5 Likes