WS-RUN-SENSORS(1)

NAME
ws-run-sensors - run sensor data collection for WildlifeSystems

SYNOPSIS
ws-run-sensors

DESCRIPTION
ws-run-sensors collects data from sensors attached to WildlifeSystems nodes. It reads configuration from /etc/ws/sensors.conf and manages sensor hardware interfaces.

This command is typically run by a systemd timer (ws-sensors.timer) rather than invoked directly.

ACTIONS
The following actions can be configured in the run array of the configuration file:

sensor-read
    Read data from a sensor. Requires sensor and sensor_type fields. The result is stored internally for use by subsequent actions. The deprecated name sensor_read is still accepted but will emit a warning.

process-data
    Process the most recent sensor data. If a script field is provided, the sensor data is piped through the script and the result replaces the stored sensor data. If no script is specified, the data is passed through unchanged. This action is typically placed between sensor-read and upload-delete to transform or enrich data before output.

sleep
    Pause execution for the number of seconds given by the duration field.

upload-delete
    Output the stored sensor data using the specified method (either file or script ).

FILES

/etc/ws/sensors.conf
    JSON configuration file for sensor collection.

/var/log/ws-run-sensors.log
    Standard output log file.

/var/log/ws-run-sensors-error.log
    Error log file.

SEE ALSO
ws-upload(1), ws-heartbeat(1)

AUTHOR
Ed Baker <ed@ebaker.me.uk>

COPYRIGHT
Copyright © 2024-2026 Ed Baker. License GPLv2+: GNU GPL version 2 or later.