Skip to content

Publish RuuviTag sensor data with LoRaWAN

License

MIT, CC-BY-4.0 licenses found

Licenses found

MIT
LICENSE-CODE.txt
CC-BY-4.0
LICENSE-DOCS.txt
Notifications You must be signed in to change notification settings

rroemhild/ruuvitag-lorawan

Repository files navigation

Publish RuuviTag sensor data with LoRaWAN

This repository contains the up to date snippets for the Publish RuuviTag sensor data on The Things Network tutorial.

This PoC uses settings specifically for connecting to LoRaWAN networks within the European 868 MHz region. For other regions usage, please see the settings.py and lib/lorawan.py file for relevant sections that need to be changed.

Data Format

For each RuuviTag we send 8 bytes. The RuuviTag ID is the index from the mac address in the settings.py list. We match this later in the decoder.

Offset Description
0 Tag ID (8bit)
1-2 Temperature in 0.005 degrees (16bit signed)
3-4 Humidity in 0.0025% (16bit unsigned)
5-6 Batter voltage + 1600 (16bit unsigned)
7-8 RSSI * -1 (8bit)

In example for 2 RuuviTags the following payload will be send:

b'\x00\x05$\x8e\xf8\x04\x8f[\x01\x11d/@\x05\rB'
ID Temp Humid Voltage RSSI ID Temp Humid Voltage RSSI
00 0524 8EF8 048F 5B 01 1164 2F40 050D 42

Read more about the data format used in this project in the Ruuvi Sensor Data Format 5 Protocol Specification.

Payload Format Decoder

Example payload format decoder for the The Things Network Console. The var map is used to identify each Ruuvitag by name. The oder must match the order in the RUUVITAG list in the settings.py.

var map = ["outdoor", "livingroom"];

function Decoder(bytes, port) {
  var ruuvitags = {};
  var tags = bytes.length / 8;

  for (i=0;i<tags;i+=1) {
    var temperature = (bytes[1] << 8) | bytes[2];
    var humidity = (bytes[3] << 8) | bytes[4];
    var battery = (bytes[5] << 8) | bytes[6];
    var rssi = bytes[7];

    var name = map[bytes[0]];
    ruuvitags[name] = {
        "humidity": parseFloat((humidity * 0.0025).toFixed(2)),
        "temperature": parseFloat((temperature * 0.005).toFixed(2)),
        "battery": battery + 1600,
        "rssi": rssi * -1
    };

    bytes.splice(0, 8);
  }

  return ruuvitags;
}

// TTNv3
function decodeUplink(input) {
  return {
    data: Decoder(input.bytes, input.fPort),
    warnings: [],
    errors: []
  };
}

Releases

No releases published

Packages

No packages published

Languages