refactor: project structure (#9)

Split up project into multiple crates and use a Cargo workspace.
2025-08-28 09:03:30 +02:00
parent f0128197d9
commit d98cd89c48
71 changed files with 672 additions and 401 deletions
@@ -0,0 +1,98 @@
+# Sensor Mode 3 Progress
+
+A progress sensor crops a progress image based on the corresponding sensor value and alpha-blends it with the panel image.
+
+Sensor configuration fields:
+- `mode`: 3 (for progress)
+- `label`: label identifier, also used as sensor value data source identifier
+- `direction`: 1 = left to right, 2 = right to left, 3 = top to bottom, 4 = bottom to top
+- `x`, `y`: position on the panel
+- `pic`: progress image to crop and overlay
+- `minValue`, `maxValue`: clamp sensor value to this range
+
+## Example
+
+Example `panel.json` with two "progress" indicator sensor and the following (partial) background image in `img`:
+
+<img src="img/sensor_mode3_background.png" alt="sensor mode 3 background image example">
+
+The background image and sensor definitions are taken from the default system panel configuration in the AOOSTAR-X app.
+
+```json
+{
+  "name": "Progress test panel",
+  "img": "background.png",
+  "sensor": [
+    {
+      "mode": 3,
+      "name": "SSD 4 usage",
+      "label": "storage_ssd4_usage",
+      "x": 400,
+      "y": 45,
+      "direction": 1,
+      "value": "35",
+      "minValue": 0,
+      "maxValue": 100,
+      "pic": "progress.png"
+    },
+    {
+      "mode": 3,
+      "name": "SSD 5 usage",
+      "label": "storage_ssd5_usage",
+      "x": 400,
+      "y": 106,
+      "direction": 1,
+      "value": "80",
+      "minValue": 0,
+      "maxValue": 100,
+      "pic": "progress.png"
+    },
+    {
+      "mode": 1,
+      "name": "SSD 4 temp",
+      "label": "storage_ssd4_temperature",
+      "x": 580,
+      "y": 70,
+      "direction": 1,
+      "value": "34",
+      "fontFamily": "HarmonyOS_Sans_SC_Bold",
+      "fontSize": 24,
+      "textAlign": "center",
+      "integerDigits": -1,
+      "decimalDigits": 0,
+      "unit": " ℃"
+    },
+    {
+      "mode": 1,
+      "name": "SSD 5 temp",
+      "label": "storage_ssd5_temperature",
+      "x": 580,
+      "y": 130,
+      "direction": 1,
+      "value": "35",
+      "fontFamily": "HarmonyOS_Sans_SC_Bold",
+      "fontSize": 24,
+      "textAlign": "center",
+      "integerDigits": -1,
+      "decimalDigits": 0,
+      "unit": " ℃"
+    }
+  ]
+}
+```
+
+Progress image `"pic": "progress.png"`:
+
+![progress graphic](img/progress.png)
+
+The following graphic is rendered for progress example above:
+
+<img src="img/sensor_mode3.png" alt="sensor mode 3 example">
+
+
+## Known Issues
+
+Progress sensor rendering has been reverse engineered from the AOOSTAR-X app. Not all options are supported.
+
+- Work in progress, not yet fully tested
+- `widht`, `height` should be considered and auto-resized as for mode 4