Tools for home climate monitoring
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
ambient7-analysis
ambient7-webapp
ambient7-webui
config
core
grafana
influxdb-client
influxdb
mt8057-agent
project
rdbms-service
.gitignore
.travis.yml
CHANGELOG.md
LICENSE.txt
README.md
build.sbt
scalastyle-config.xml

README.md

ambient7

Components:

  • mt8057-agent agent for co2 concentration & temperature measurements. Can be used sepparatly.
  • ambient7-analysis
  • ambient7-analysis - additional data analisis, scheduled by crontab or similar
  • ambient7-webapp - JSON APIs
  • ambient7-webui - Web based UI
  • influxdb-client, core, rdbms-service - code shared beetwen other components
  • influxdb as a timeseries db
  • grafana for data explorations (optional)

Build Status Coverage Status

Downloads

mt8057-agent

Agent for sending results from Masterkit MT8057 CO2 detector (with ZyAura ZG01C module onboard).

Can be used sepparatly without other ambient7 parts as all-in-one fat jar (jre 1.8+).

Supports various result writers:

  • console
  • interactive
  • InfluxDB API

Platforms

Supported platforms:

  • Mac OS X 10.10+
  • Linux amd64

Theoretically supported but never tested (all platforms supported by hid4java):

  • Linux ARM
  • Linux x86
  • Linux x86_64
  • Windows 32/64
  • Mac OS X 10.5 - 10.9

Usage

java -jar ambient7-mt8057-agent-x.x.x.jar --writers=console

java -jar ambient7-mt8057-agent-x.x.x.jar --writers=interactive

java -jar ambient7-mt8057-agent-x.x.x.jar --writers=influxdb \
    --influxdb-database=ambient7 \
    --influxdb-baseurl=http://localhost:8086/ \
    --influxdb-user=user --influxdb-password=123

For more options:

java -jar ambient7-mt8057-agent-x.x.x.jar --help

ambient7-analysis

Tools for counting aggregates based on data collected in InfluxDb that cannot be counted by InfluxDb itself.

java -jar ambient7-analysis-x.x.x.jar --help

Init or migrate DB

java -jar ambient7-analysis-x.x.x.jar --config=ambient7.conf init-db

Co2 hourly report

Add to crontab or any other scheduler the command:

java -jar ambient7-analysis-x.x.x.jar --config=ambient7.conf aggregate-co2

Changelog

See CHANGELOG.md

License

Apache 2.0