Welcome, friend.

You've entered the RuuviTag configuration page.

By following these simple instructions, you can easily set-up your RuuviTag sensor beacon to do many different things.

Right now, we are offering three ready-made firmware applications for you to use:

Getting Started

RuuviTag works out of the box:

As you can see, by default, RuuviTag+ is a weather station. However, it's only one of the uses RuuviTag is capable to. Read on to learn more.

Note that RuuviTag Basic devices without sensors come with Eddystone firmware pre-installed.

Weather Station

This super simple but still extremely capable firmware application turns your RuuviTag+ to a remote temperature / relative humidity / air pressure meter. RuuviTag Basic will work as a remote thermometer.

The application broadcasts all these environmental variables continuously (2 times every second) and all the nearby Bluetooth® Low Energy devices can hear them - without needing to pair or connect.

- How is this possible?

The Physical Web is the answer. RuuviTag transmits simple URL addresses which have sensor data encoded into them.

Android phones running KitKat (4.4) and above recently gained a feature called Nearby Notifications. It helps a nearby Ruuvi Weather Station to show up on your phone's notification bar.

In addition, also Google Chrome (on both Android and iOS) has a support feature for the Physical Web. You can make sure it's on by following these self-explanatory instructions.

An alternative way to see these readings is to use a beacon scanner. Many are available and the one we love is nRF Connect. It's available on both Android and iOS. You can also try Beacon Toy

Weather Station works both on RuuviTag+ and RuuviTag Basic devices, however temperature readings on RuuviTag Basic are less accurate. Humidity shows 0 and air pressure shows 655 hPa on RuuviTag basic.

The Weather Station sends rounded sensor values and does not include accelerometer data. Those who want to build their own application can switch to high-precision SensorTag mode by pressing button B. Both of the LEDs light up on button press and the red LED blinks roughly once a second in the SensorTag mode. Just press the button again to return to the Weather Station mode where the green LED blinks roughly once in five seconds. For more details about the SensorTag mode please refer to data format specification.

For more detailed info on how the Weather Station works, feel free to explore the code on our GitHub organization or chat on our forum. Everything is open-source and fellow-Ruuvi-hackers are friendly.

If you're experiencing any problems, check Troubleshooting.

Eddystone™

RuuviTag has sensors, yes, but it's also a powerful Bluetooth® proximity beacon.

With CE/FCC/RoHS/IP67 certifications and up to 1km open-air range it's ready to be used in numerous beacon deployment and industrial-grade solutions.

Eddystone is an open beacon format from Google. RuuviTag provides full support for Eddystone, including:

  • The core Eddystone frames: -UID, -TLM, -URL
  • Eddystone Ephemeral ID (EID)
  • The Eddystone GATT service, for easy configuration

There are several ways to configure the beacon:

The default unlock code is: 0x00112233445566778899aabbccddeeff

An example showing how to use beacons to have some fun:

If you're experiencing any problems, check Troubleshooting.

Espruino

Would you like to create something special with your RuuviTags but learning curve to low-level C programming sounds a bit deep? Don't worry. It's possible to tinker with the Tag using JavaScript:

RuuviTag is officially supported by Espruino. Read more: espruino.com/ruuvitag.

Espruino is an open-source project. If you run Espruino on RuuviTag and love it, please consider to donate. They've got also cool hardware products to sell. For example, Puck.js, which is similar to RuuviTag but with different sensors and properties.

If you're experiencing any problems, check Troubleshooting.

Updating the Firmware

No external programming tools or any previous knowledge are required to update the firmware. DFU OTA (Device Firmware Update Over-the-Air) can be done wirelessly.

It's also safe. So far we haven't been able to brick a single RuuviTag by updating OTA.

OFFICIAL RUUVI DISTRIBUTION PACKAGES:

Updating the firmware can be done using nRF Connect on Android and nRF Toolbox on iOS.

Android:

iOS:

If you're experiencing any problems, check Troubleshooting.

Troubleshooting

  1. My RuuviTag isn't starting.
    1. Did you remove a resist between battery and battery clip?
  2. I can't see any notifications.
    1. Have you enabled Bluetooth and location on your phone?
    2. Did you follow these instructions?
    3. Check the Physical Web FAQ.
  3. I can't connect to the Weather Station / I don't see the URL
    1. The Weather Station firmware isn't connectable. It broadcasts only. However, it will gain new features soon.
    2. The green light should blink briefy roughly once per 5 seconds. If the red light is blinking once per second (once per 5 seconds in basic) you're in high-precision SensorTag mode. Press B to return the Weather Station mode.
  4. I can't enter the bootloader nor update the FW.
    1. Did you keep the boot button (B) pressed while you pressed the reset button? Try again.
    2. Are you using iOS? nRF Connect's iOS version doesn't have OTA DFU support yet. Use nRF Toolbox instead. If still having problems, find an Android phone. We've also experienced some issues with the iOS version of the nRF Toolbox.
  5. I cannot configure Eddystone.
    1. Did you flash the correct distribution package?
    2. Did you press the button B to enter the configuration mode?
    3. Did you use the correct unlock code? The web tool expects 0x before the code itself but the Android app doesn't.
  6. I have problems with Espruino.
    1. Espruino has its own active support forum where many topics are discussed.
    2. However, if your problem is clearly related to running Espruino on RuuviTag, please ask on our forum. This is mainly because we don't want to increase Espruino team's workload with questions related to third-party hardware platforms.
    3. Check also this and this.

If these troubleshooting solutions didn't help or you're experiencing different problems, please feel free to ask on our forum. Probably someone else is having same kind of issue(s) and our public forum can help, assist or even find better solutions for you!

Contributing

RuuviTag is open-source. Even the hardware is open. If you would like to contribute the ongoing projects, this is how you can do it. We have four main channels:

  • GitHub
    • Where all the software and hardware files can be found.
  • Forum
    • A place where questions can be easily asked. You can also showcase your own project!
  • Slack
    • The team is for real time discussion and is invite only. Everyone is welcome, but you need to request an invite by sending an informal email to slack@ruuvi.com.
  • Trello
    • A simple TODO list for the firmware development.

To help, these are sample paths that can be followed:

  1. Check Trello
  2. Look for a task
  3. Request an invite to Slack
  4. Say hi to the team on #ruuvitag
  5. Offer your help
  6. Assign a task on Trello
  7. Make a pull request

Or:

  1. Request an invite to Slack
  2. Ask how could you help

Or:

  1. Build something using RuuviTags (it can be anything!)
  2. Showcase it on the forum
  3. See what happens

Or:

  1. Find a bug on GitHub
  2. Create an issue or even better: fix it and make a pull request