sw: Reorganize and improve tools

- Rename melexis.py -> amsky01_viewer.py (GUI viewer)
- Rename sensor_viewer.py -> amsky01_cli.py (CLI viewer)
- Remove debug_sensor.py (obsolete)
- Add sw/README.md with tool descriptions
- Update amsky01_viewer.py:
  - Add --debug flag for serial communication logging
  - Add buffer for handling split thrmap messages
  - Update  to include SQM parameter
  - Update  to include dew point
  - Rename  to
- Update CI: Run firmware build only on fw/ changes

Author: roman-dvorak

.github/workflows/platformio-build.yml

@@ -2,7 +2,13 @@ name: PlatformIO CI
 
 on:
   push:
+    paths:
+      - 'fw/**'
+      - '.github/workflows/platformio-build.yml'
   pull_request:
+    paths:
+      - 'fw/**'
+      - '.github/workflows/platformio-build.yml'
   release:
     types: [ created, published ]
   workflow_dispatch:

sw/README.md

@@ -0,0 +1,84 @@
+# AMSKY01 Software Tools
+
+Nástroje pro práci se senzory AMSKY01 (MLX90641, SHT4x, TSL2591).
+
+## Nástroje pro real-time monitoring
+
+### `amsky01_viewer.py`
+GUI vizualizátor s PyQt/PyQtGraph pro zobrazení dat v reálném čase:
+- IR teplotní mapa z MLX90641 (12×16 pixelů)
+- Teplota a vlhkost ze SHT4x včetně dew pointu
+- Osvětlení z TSL2591 včetně SQM
+- Parametry senzorů (Vdd, Ta, rohy IR mapy)
+
+**Použití:**
+```bash
+python amsky01_viewer.py --port /dev/ttyACM0 --baud 115200
+python amsky01_viewer.py --port /dev/ttyACM0 --debug  # s výpisem komunikace
+```
+
+**Závislosti:** `pyserial`, `numpy`, `pyqtgraph`, `PyQt5`
+
+---
+
+### `amsky01_cli.py`
+CLI viewer s curses rozhraním + automatické logování do CSV:
+- Real-time zobrazení senzorových dat v terminálu
+- Automatické ukládání dat do CSV souborů
+- Rotace log souborů každých 10 minut
+
+**Použití:**
+```bash
+python amsky01_cli.py --port /dev/ttyACM0 --baud 115200
+```
+
+**Závislosti:** `pyserial`, `curses`
+
+---
+
+## Nástroje pro analýzu logů
+
+### `plot_logs.py`
+Vykreslování grafů z uložených CSV logů:
+- Podpora více souborů současně
+- Interaktivní režim s auto-refresh
+- Export do PNG
+
+**Použití:**
+```bash
+python plot_logs.py sensor_logs/latest.csv
+python plot_logs.py --interactive --refresh 30 sensor_logs/*.csv
+python plot_logs.py --output myplot.png sensor_logs/data.csv
+```
+
+**Závislosti:** `pandas`, `matplotlib`, `numpy`
+
+---
+
+### `plot_latest.sh`
+Bash wrapper pro rychlé vykreslení logů:
+```bash
+./plot_latest.sh              # Vykreslí nejnovější log
+./plot_latest.sh --all        # Vykreslí všechny logy
+./plot_latest.sh specific.csv # Vykreslí konkrétní soubor
+```
+
+---
+
+## Formát UART zpráv
+
+Zařízení komunikuje přes UART rychlostí 115200 baud (konfigurovatelné). Zprávy:
+
+- `$thrmap,<192 hodnot>` - IR teplotní mapa (12×16 pixelů)
+- `$cloud,<TL>,<TR>,<BL>,<BR>,<CENTER>` - Rohy a střed IR mapy
+- `$cloud_meta,<Vdd>,<Ta>` - Napětí a teplota MLX90641
+- `$hygro,<temp>,<humidity>,<dew_point>` - Teplota, vlhkost, rosný bod
+- `$light,<lux>,<full>,<ir>,<gain>,<int_time>,<sqm>` - Osvětlení a SQM
+
+---
+
+## Instalace závislostí
+
+```bash
+pip install pyserial numpy pyqtgraph PyQt5 pandas matplotlib
+```

sw/sensor_viewer.py sw/amsky01_cli.pysw/sensor_viewer.py renamed to sw/amsky01_cli.py

@@ -2,10 +2,10 @@
 
 Zobrazuje:
 - IR mapu z MLX90641 ($thrmap)
-- Ta/Vdd z MLX90641 ($thr_parameters)
+- Ta/Vdd z MLX90641 ($cloud_meta)
 - rohy/střed z MLX90641 ($cloud)
 - teplotu a vlhkost ze SHT4x ($hygro)
-- osvětlení z TSL2591 ($light)
+- osvětlení z TSL2591 ($light) včetně SQM
 
 Závislosti:
     pip install pyserial numpy pyqtgraph PyQt5
@@ -47,44 +47,46 @@ def parse_thrmap(line: str):
 
 
 def parse_hygro(line: str):
-    """$hygro,<temp>,<humidity>"""
+    """$hygro,<temp>,<humidity>,<dew_point>"""
     line = line.strip()
     if not line.startswith("$hygro,"):
         return None
     parts = line.split(",")
-    if len(parts) < 3:
+    if len(parts) < 4:
         return None
     try:
         temp = float(parts[1])
         rh = float(parts[2])
+        dew_point = float(parts[3])
     except ValueError:
         return None
-    return temp, rh
+    return temp, rh, dew_point
 
 
 def parse_light(line: str):
-    """$light,normalized_lux,full_raw,ir_raw,gain,integration_time"""
+    """$light,normalized_lux,full_raw,ir_raw,gain,integration_time,sqm"""
     line = line.strip()
     if not line.startswith("$light,"):
         return None
     parts = line.split(",")
-    if len(parts) < 6:
+    if len(parts) < 7:
         return None
     try:
         lux = float(parts[1])
         full_raw = float(parts[2])
         ir_raw = float(parts[3])
         gain = parts[4]
         itime = parts[5]
+        sqm = float(parts[6])
     except ValueError:
         return None
-    return lux, full_raw, ir_raw, gain, itime
+    return lux, full_raw, ir_raw, gain, itime, sqm
 
 
-def parse_thr_parameters(line: str):
-    """$thr_parameters,<vdd>,<ta>"""
+def parse_cloud_meta(line: str):
+    """$cloud_meta,<vdd>,<ta>"""
     line = line.strip()
-    if not line.startswith("$thr_parameters,"):
+    if not line.startswith("$cloud_meta,"):
         return None
     parts = line.split(",")
     if len(parts) < 3:
@@ -117,11 +119,13 @@ def parse_cloud(line: str):
 
 
 class MainWindow(QtWidgets.QMainWindow):
-    def __init__(self, ser: serial.Serial, vmin=None, vmax=None, parent=None):
+    def __init__(self, ser: serial.Serial, vmin=None, vmax=None, debug=False, parent=None):
         super().__init__(parent)
         self.ser = ser
         self.vmin = vmin
         self.vmax = vmax
+        self.debug = debug
+        self.line_buffer = ""  # Buffer pro neúplné řádky
 
         self.setWindowTitle("AMSKY01 / MLX90641 vizualizátor")
 
@@ -167,20 +171,24 @@ def make_label():
         # Hygro
         self.lbl_temp = make_label()
         self.lbl_rh = make_label()
+        self.lbl_dew = make_label()
         form.addRow("SHT4x T [°C]", self.lbl_temp)
         form.addRow("SHT4x RH [%]", self.lbl_rh)
+        form.addRow("Dew Point [°C]", self.lbl_dew)
 
         # Light
         self.lbl_lux = make_label()
         self.lbl_full = make_label()
         self.lbl_ir = make_label()
         self.lbl_gain = make_label()
         self.lbl_itime = make_label()
+        self.lbl_sqm = make_label()
         form.addRow("Lux", self.lbl_lux)
         form.addRow("TSL full", self.lbl_full)
         form.addRow("TSL IR", self.lbl_ir)
         form.addRow("TSL gain", self.lbl_gain)
         form.addRow("TSL int", self.lbl_itime)
+        form.addRow("SQM [mag/arcsec²]", self.lbl_sqm)
 
         # IR senzor parametry
         self.lbl_vdd = make_label()
@@ -210,12 +218,21 @@ def make_label():
 
     def poll_serial(self):
         try:
-            # Čti všechny dostupné řádky
+            # Čti všechny dostupné data
             while self.ser.in_waiting:
-                line = self.ser.readline().decode(errors="ignore")
-                if not line:
+                chunk = self.ser.read(self.ser.in_waiting).decode(errors="ignore")
+                if not chunk:
                     break
-                self.process_line(line)
+                
+                # Přidej do bufferu
+                self.line_buffer += chunk
+                
+                # Zpracuj kompletní řádky
+                while "\n" in self.line_buffer:
+                    line, self.line_buffer = self.line_buffer.split("\n", 1)
+                    if self.debug:
+                        print(f"< {line}")
+                    self.process_line(line + "\n")
         except serial.SerialException as e:
             print(f"Serial error: {e}")
 
@@ -233,24 +250,26 @@ def process_line(self, line: str):
         if s.startswith("$hygro,"):
             v = parse_hygro(s)
             if v is not None:
-                t, rh = v
+                t, rh, dew = v
                 self.lbl_temp.setText(f"{t:.2f}")
                 self.lbl_rh.setText(f"{rh:.2f}")
+                self.lbl_dew.setText(f"{dew:.2f}")
             return
 
         if s.startswith("$light,"):
             v = parse_light(s)
             if v is not None:
-                lux, full_raw, ir_raw, gain, itime = v
+                lux, full_raw, ir_raw, gain, itime, sqm = v
                 self.lbl_lux.setText(f"{lux:.2f}")
                 self.lbl_full.setText(f"{full_raw:.0f}")
                 self.lbl_ir.setText(f"{ir_raw:.0f}")
                 self.lbl_gain.setText(gain)
                 self.lbl_itime.setText(itime)
+                self.lbl_sqm.setText(f"{sqm:.2f}")
             return
 
-        if s.startswith("$thr_parameters,"):
-            v = parse_thr_parameters(s)
+        if s.startswith("$cloud_meta,"):
+            v = parse_cloud_meta(s)
             if v is not None:
                 vdd, ta = v
                 self.lbl_vdd.setText(f"{vdd:.3f}")
@@ -301,6 +320,7 @@ def main():
     parser.add_argument("--baud", type=int, default=115200, help="baudrate (default 115200)")
     parser.add_argument("--vmin", type=float, default=None, help="min. teplota pro barevnou škálu")
     parser.add_argument("--vmax", type=float, default=None, help="max. teplota pro barevnou škálu")
+    parser.add_argument("--debug", action="store_true", help="zobraz všechny zprávy na seriové lince")
 
     args = parser.parse_args()
 
@@ -312,12 +332,15 @@ def main():
 
     # Po startu automaticky zapni režim streamování heatmapy
     try:
-        ser.write(b"thrmap_on\n")
+        cmd = b"thrmap_on\n"
+        ser.write(cmd)
+        if args.debug:
+            print(f"> {cmd.decode().rstrip()}")
     except serial.SerialException:
         pass
 
     app = QtWidgets.QApplication(sys.argv)
-    win = MainWindow(ser, vmin=args.vmin, vmax=args.vmax)
+    win = MainWindow(ser, vmin=args.vmin, vmax=args.vmax, debug=args.debug)
     win.resize(900, 500)
     win.show()