Files
aoostar-rs/docs/sensor/README.md
T
Markus Zehnder 7ac543e644 feat: sensor identifier mapping
Closes #18
2025-09-17 21:23:11 +02:00

1.7 KiB

Sensor Panels

Sensor Modes

Different sensor modes are supported:

Sensor Data Sources

The sensor value reading is separated from the asterctl tool.

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.

Sensor Data Providers

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