https://github.com/frostmar/rtl433-webmon

web front end for a software defined radio reading 433MHz sensors
https://github.com/frostmar/rtl433-webmon

temperature

Last synced: 3 months ago
JSON representation

web front end for a software defined radio reading 433MHz sensors

• Host: GitHub
• URL: https://github.com/frostmar/rtl433-webmon
• Owner: frostmar
• License: gpl-3.0
• Created: 2016-06-29T22:47:32.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2023-01-08T00:09:37.000Z (about 2 years ago)
• Last Synced: 2024-08-02T15:52:34.541Z (6 months ago)
• Topics: temperature
• Language: JavaScript
• Homepage:
• Size: 766 KB
• Stars: 7
• Watchers: 3
• Forks: 0
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# rtl433-webmon

Web front end for a software defined radio reading various sensors.  

Serves a simple webpage, using websockets and Angular to display live

data received from the sensors.

Uses [rtl_433](https://github.com/merbanan/rtl_433) to receive and decode sensors transmissions

### Inputs:

- 433MHz temperature/humidity sensors that can be received and decoded by rtl_433

- PMS5003 air quality particulates sensor via serial port

- temperature/humidity device polled from Samsung SmartThings cloud

### Logging:

- Readings logged every 5mins to AWS CloudWatch

### Web Display:

Immediate readings for 

- Temperature and humidity (%RH)

- Electrical Power (Watts)

- Electricity used so far today (kWh)

- Air Quality (PM2.5 and PM10 counts)

![screenshot](./screenshot.png)

### Setup

- Make your copy of each `secret_config/*.json.template` file as `secret_config/*.json` and fill in the necessary values.

- Build or install [rtl_433](https://github.com/merbanan/rtl_433), and ensure that `rtl_433` can successfully find and read your software defined radio device (eg. an RTL2832-based USB TV dongle).

- Edit `devices: [...]` in `index.js` to include the 433MHz device models you wish to receive (rtl_433 -R parameters)

### Running

Run in the foreground: `npm start`

Or run as a daemon (uses [`forever`](https://github.com/foreverjs/forever)):  

`npm run daemon-start`  

`npm run daemon-stop`  

Debug logging is output by setting environment variable `DEBUG` with named loggers eg: `DEBUG=webmon npm start`