README.md

Building a RuuviTag weather monitoring dashboard using AWS IOT

What you'll need for this:

• An AWS account https://console.aws.amazon.com
• A RuuviTag device https://shop.ruuvi.com
• A Raspberry Pi device. I have tested the setup with Raspberry Pi Zero W 2 which has WiFi and Bluetooth connectivity https://www.raspberrypi.com/products/raspberry-pi-zero-2-w/

Setup

1. RuuviTag

Just unbox the Ruuvitag and verify the functionality with RuuviStation mobile application.

2. Raspberry Pi

Check out the headless setup instructions https://www.raspberrypi.com/documentation/computers/configuration.html#set-up-a-headless-raspberry-pi.

Note: You might want to login using SSH keys instead of the default username/password combo.

3. Setup this repository to Raspberry Pi device

1. Install Node.js

   • Use NVM https://github.com/nvm-sh/nvm

2. git clone https://github.com/markusl/ruuvitag-aws-iot-monitoring.git

3. Install the prerequisites:

   cd app-v2/
   sudo apt-get install libudev-dev libusb-1.0-0-dev
   npm install

4. Enable bluetooth access without sudo (https://github.com/sandeepmistry/noble#running-on-linux)

   sudo setcap cap_net_raw+eip $(eval readlink -f `which node`)

5. (Optional) Enable automatic startup on boot: sudo nano /etc/rc.local and add

   PATH=$PATH:/home/pi/.nvm/versions/node/v20.11.0/bin && cd /home/pi/ruuvitag-aws-iot-monitoring/app-v2 && sh start-monitoring.sh &

4. Configure AWS IoT device

Open awsiot/bin/awsiot.ts and configure the relevant RuuviTag id's for AWS IoT event rules.

Then deploy the AWS IoT cloud infrastructure:

cd awsiot/
npm i -g aws-cdk
npm install

# Deploy the IoT device configuration
cdk deploy AwsIotStack # Note the IotEndpointAddress in outputs

# Deploy the CloudWatch dashboard
cdk deploy AwsIotDashboardStack

5. Configure and run the application

1. Go to AWS Secrets Manager in AWS Console and look for RaspberryPi-Credentials.
2. Use the Retrieve Secret Value button to get certificatePem, privateKey and publicKey.
3. Configure proper keys under keys.
4. Update proper endpoint (output from AwsIotStack deployment) and client id in start-monitoring.sh

Run the application:

sudo apt-get install screen
screen app-v2/start-monitoring.sh

6. Configure CloudWatch dashboard for sharing

You can share the created dashboard publicly in the AWS CloudWatch console.