Files
kota-technician-tool/docs/CHANGES-v0.10.md
T
KrzyszurandClaude Opus 5.5 66cb804102 Checklist: verify that sensor data reaches InfluxDB
New guided check "Sensor data in the database (InfluxDB)", also the last
step of the Quick check on the green path. It queries InfluxDB (read
token) for the newest point per measurement of the box and tells apart:
sensor data arrives / status arrives without sensor data / offline now /
never seen / check not possible. Polls every 30 s for up to 4 minutes.
With a stopped RTC in the log it concludes that sensor readings are lost
(stamped 1 Jan 2000): box A4:CB:8F:C9:47:3C sent only device_status and
microphone.

- service/influx.py: query, CSV parsing, classification (no new deps)
- guides: new step type "influx" (host answers via influx_result)
- Settings > InfluxDB access (or KOTA_INFLUX_TOKEN); token never logged
- service status mapping for tech.influx.* findings

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 00:06:48 +02:00

2.2 KiB

Technician tool v0.10 - changes (draft)

  • New tab Wi-Fi (USB): write the Wi-Fi name and password to the box's SD card over the USB cable, without opening the case (firmware usb_console, kota wifi set). Shows each step: command support check, stored, restart in Wi-Fi mode, connected with signal strength (polls kota health). Also reads the stored network (kota wifi get, password never shown) and removes it (kota wifi clear, back to Matter).
  • The password is sent hex-encoded, never written to the session log or the service report.
  • Diagnosis: restarts usb_wifi_set / usb_wifi_clear are intentional (no "unexpected restart"); box self-report shows the stored Wi-Fi network; cmd health replies update the health line.
  • firmware/: merged-binary-v13.bin (usb_console, build 3ae273ec) replaces merged-binary.bin (build 4f10989e, still in git tag v0.9). Note: v13 reports the same version 1.0.16 and compile date as the previous build; the firmware team should bump the version for the next build.
  • error_ids.csv updated from the firmware (E-CON-01).
  • Test that builds the main window (catches start-up errors).
  • New check Sensor data in the database (InfluxDB) (Guided troubleshooting; also the last step of the Quick check on the green path): queries InfluxDB online (read-only) for the box's newest points and tells apart "sensor data arrives", "status arrives but sensor data does not", "offline now" and "never seen". Polls every 30 s for up to 4 minutes. With a stopped RTC in the log it concludes that the sensor readings are lost (they are stamped 1 Jan 2000) - found on box A4:CB:8F:C9:47:3C, which reported only device_status and microphone. The result and the per-measurement times go into the report and the service note.
  • Settings > InfluxDB access...: address, organisation, bucket and a read token (or the KOTA_INFLUX_TOKEN environment variable). Defaults: influx.kota-app.com, org kota, bucket sensorbox. The token is never written to the session log or the service report.
  • macOS: Connect no longer restarts the box (pyserial dropped DTR before RTS, passing through the USB-Serial-JTAG reset state). Windows unchanged.