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>
27 lines
2.2 KiB
Markdown
27 lines
2.2 KiB
Markdown
# 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.
|