damage-report-client-dht

Reports temperature & humidity data of a DHT sensor in a Raspberry Pi to the damage-report service.

Quick Start

This is a single standalone CLI script. I recommend installing it globally:

npm i -g damage-report-client-dht

Start a simulation:

TYPE=22 PIN=4 API_URL=http://locahost:8000 LOCATION_ID=kitchen LOCATION_NAME=Kitchen SIMULATE=1 damage-report-client-dht

Start monitoring sensors (tested on Raspberry Pi only):

TYPE=22 PIN=4 API_URL=http://locahost:8000 LOCATION_ID=kitchen LOCATION_NAME=Kitchen damage-report-client-dht

Environment Variables

• TYPE - (required) - One of 11 or 22 for the DHT11 or DHT22/AM2302 respectively.
• PIN - (required) - The GPIO pin that the sensor is connected to.
• API_URL - (required) - The URL to the damage-report API.
• LOCATION_ID - (required) - ID of the location of the sensor.
• LOCATION_NAME - (optional) - Name of the location of the sensor. Defaults to the location ID.
• TIMEOUT - (optional) - The time (ms) to wait for a signal until starting a new try. Defaults to 5000.
• CRON_PATTERN - (optional) - A cron pattern describing when to update. Defaults to "* * * * *" (every minute).
• SIMULATE - (optional) - Set to "true" to skip reading sensors and send random data instead. Defaults to false.
• LOGGLY_SUBDOMAIN - (optional) - The loggly.com sub domain to log to. If falsy logs go to stdout only.
• LOGGLY_TOKEN - (optional) - A loggly.com access token. If falsy logs go to stdout only.
• CONFIG_PATH - (optional) - Path to a .env-style file to load environment variables from. Defaults to ".env".

.env

Use CONFIG_PATH to specify a .env-style file to be used:

CONFIG_PATH=~/.config/dht-env damage-report-client-dht

Cron Pattern

Cron patterns can be standard unix 5 column or non-standard 6 column. When using 6 columns, the first describes seconds.

See https://en.wikipedia.org/wiki/Cron for reference.

Changelog

See CHANGELOG for a list of changes.