aoostar-rs/docs/sensor

Sensor Panels

• Sensor panels
• Custom sensor panels
• Configuration

Sensor Modes

Different sensor modes are supported:

• Sensor mode 1: Text
• Sensor mode 2: Circular Progress
• Sensor mode 3: Progress
• Sensor mode 4: Pointer

Sensor Data Sources

The sensor value reading is separated from the asterctl tool, with the exception of some internal sensors:

• Internal date time sensors

Sensor values are provided in separate text files and are automatically read when the file changes.
Only the file data source is supported at the moment; other sources like pipes, sockets, etc. might be supported later.

• Text file data source

Sensor Data Providers

• Proof of concept Linux shell scripts
• aster-sysinfo tool

Sensor Identifier Mapping

The original AOOSTAR-X software uses very weird label identifiers (actually sometimes even a composite key depending on the data source), which are likely based on an internal JSON structure.

To easily use original custom sensor panels with various sensor data sources, a sensor identifier mapping file can be used.

The mapping file is a simple text file with one identifier mapping per line:

• Key = label identifier used in panel definition
• Value = label identifier used in sensor providers

Example:

cpu_temperature: temperature_cpu

This maps the temperature_cpu sensor from the aster-sysinfo tool to the cpu_temperature sensor used in the AOOSTAR-X panel definitions.

Usage example:

asterctl --config monitor.json --sensor-mapping sensor-mapping/sysinfo-to-aoostar.cfg