Files
kota-technician-tool/README.md
T
kkallas bfa7edce6f Technician tool v0.8
Imported from the Google Drive folder 004-technician_tool/v0.8.
2026-09-28 19:19:55 +02:00

1.7 KiB
Raw Permalink Blame History

KOTA Sensorbox Technician Tool v0.8

Diagnoza sensorboxa przez USB, wgrywanie firmware z folderu firmware/ i przygotowanie karty SD. Działa na Windows 10/11 i macOS 13 (Ventura) lub nowszym, na Macach z Intelem i Apple Silicon.

Uruchomienie

Windows: dwuklik run_windows.bat.

macOS: dwuklik run_macos.command. Jeśli Finder odpowie, że pliku nie można uruchomić (Google Drive gubi uprawnienie „wykonywalny”), otwórz Terminal i jednorazowo wpisz bash (ze spacją), przeciągnij plik run_macos.command do okna i naciśnij Enter. Na stałe naprawia to: chmod +x run_macos.command.

Przy pierwszym uruchomieniu skrypt proponuje instalację uv (menedżer Pythona, instaluje się tylko dla bieżącego użytkownika) i pobiera biblioteki. Potrzebny jest internet, trwa to 1–2 minuty. Kolejne starty są natychmiastowe. Środowisko jest poza folderem Google Drive: %LOCALAPPDATA%\KotaTechnicianTool\venv-0.8 (Windows), ~/Library/Caches/KotaTechnicianTool/venv-0.8 (macOS).

Sesje, kopie zapasowe flash i ustawienia są w ~/KotaTechnicianTool (Windows: C:\Users\<użytkownik>\KotaTechnicianTool).

Port sensorboxa

  • Windows: COMx - Sensorbox (native USB) [MAC]
  • macOS: /dev/cu.usbmodemXXXX - Sensorbox (native USB) [MAC]

Kabel USB musi przenosić dane (nie tylko ładowanie). Przy restartach z komunikatem o brownout użyj innego portu lub zasilacza.

Firmware

Wgrać można tylko pliki .bin z folderu firmware/. Lista pokazuje datę kompilacji zapisaną w pliku, najnowszy build jest na górze. Nowy build: wrzuć plik do firmware/ i kliknij Refresh list.

Testy (dla zespołu)

uv run --frozen pytest -q

Zmiany: docs/CHANGES-v0.7.md, docs/CHANGES-v0.8.md.