Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/leonvogt/sensor_dashboard

Last synced: 2 days ago
JSON representation

Host: GitHub
URL: https://github.com/leonvogt/sensor_dashboard
Owner: leonvogt
License: mit
Created: 2023-02-18T12:25:39.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2024-06-26T19:31:21.000Z (5 months ago)
Last Synced: 2024-06-27T00:00:41.659Z (5 months ago)
Language: Ruby
Homepage: https://sensor-dashboard.dev-box.ch/
Size: 1.78 MB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: License

Awesome Lists containing this project

README

# Sensor Dashboard
[![View performance data on Skylight](https://badges.skylight.io/typical/GM3F6Hj9avEh.svg)](https://oss.skylight.io/app/applications/GM3F6Hj9avEh)
[![View performance data on Skylight](https://badges.skylight.io/problem/GM3F6Hj9avEh.svg)](https://oss.skylight.io/app/applications/GM3F6Hj9avEh)

Sensor Dashboard is a web application that allows users to view sensor data from a variety of sources.
The application is built using Ruby on Rails.
There is also a [mobile app](https://github.com/leon-vogt/sensor_dashboard_android) in development.

## Data model
The idea is to have devices that have sensors attached to them.
Therefore a device can have multiple sensors that collect data and send it to the server.
Each sensor has a type (like temperature, humidity, pressure, etc.) and can define a chart type (line, bar, etc.).

## Installation
1. Install the dependencies:
```bash
bundle install
yarn install
```

2. Create the database:
```bash
rails db:create
rails db:migrate
rails db:seed (optional)
```

3. Make sure redis is installed and running on your system.
```bash
redis-server --daemonize yes
```

To start the webserver, sidekiq, yarn watch and tailwind watch run:
```bash
bin/dev
```

## Sensor Measurement Types
The following sensor measurement types are currently supported:
- Temperature
- Humidity
- Pressure
- CO2
- VOC
- Altitude
- Gas
- Light
- Sound
- Vibration
- Ethanol
- pH
- EC (Conductivity)
- Hz (General frequency)

## API
### External API
Sensor Dashboard provides an public API to send sensor data to the server.
After creating a device you can create an Access Token, which is used to authenticate the request.

### Internal API
For the Turbo Native mobile app there is an internal API, which is used to get things like the PathConfiguration.