Home

Welcome to the ruuvitag_fw wiki!

These are the firmware projects currently available under ruuvi_examples:

ruuvi_firmware

This includes the firmware which is installed at the factory. It samples the temperature/humidity/air-pressure sensor and accelerometer. It immediately transmits bluetooth packets. The format, frequency and contents of the packets depends on if it is in highres (aka raw) or URL mode. Pressing the B button switches modes.

• In raw mode (as indicated by a faint blinking red LED) packets are sent out which must be interpreted by one of several applications. One of which has been written to collect data in an Influx data base and presented by Grafana.
  

libraries/ruuvi_sensor_formats/sensortag.h creates the packet.

A revised raw format - 05 - was introduced as of version 2.x.x which added Tx power, a movement counter, a measurement sequence number and included the MAC as part of the packet payload(since Apple does not permit application access to the MAC in the packet header.

As of July 2018 raw mode format 03 is transmitted by the firmware loaded at the factory.

Eddystone

core frames:

• UID unique, static ID with a 10-byte Namespace component and a 6-byte Instance component.
• TLM Battery voltage, Temperature, Seconds since reset
• URL max 17 encoded character URL
• EID Ephemeral ID 8 byte
• GATT service

ble_app_beacon

• iBeacon proof-of-concept code.

test_drivers

• For developers, this example is for trying out drivers.

URL mode (as indicated by a faint blinking green LED) a web browser URL is transmitted which invokes a page at the domain ruu.vi. This page interprets the page fragment (text following the '#') which contains encoded data and displays the temperature, humidity and air-pressure. This mode was compatible with Google's "nearby" support built into android devices which google removed in December 2018. Various apps can be used to retrieve the URL and link the page including on IOS nRFconnect(Nordic Semi), BLE scanner (BluePixelTech), blurfaro(phy.net). Be advised that due to the fact that google / android no longer supports "nearby" notifications, this mode will not be available in versions after 2.4.1. Refer to the ruuvi station application available on both android and IOS platforms for the ability to display current sensor reading.