diff --git a/README.md b/README.md index a4c6a37..b5aa684 100644 --- a/README.md +++ b/README.md @@ -6,7 +6,7 @@ Działa na Windows 10/11 i macOS 13 (Ventura) lub nowszym, na Macach z Intelem i Repozytorium: https://gitea.kota-app.com/kkallas/kota-technician-tool (dostęp nadaje właściciel repozytorium). **Instrukcja krok po kroku ze zrzutami ekranu: [docs/INSTRUKCJA_TECHNIKA.md](docs/INSTRUKCJA_TECHNIKA.md).** -Box podłączaj kablem USB 2.0 z wtyczką typu A, bezpośrednio do portu USB-A komputera. +Box podłączaj tak, żeby po drodze była wtyczka USB 2.0 typu A (do komputera albo do huba). ## Dla technika: dwa pliki diff --git a/docs/INSTRUKCJA_TECHNIKA.md b/docs/INSTRUKCJA_TECHNIKA.md index 90ed3f8..4e61b35 100644 --- a/docs/INSTRUKCJA_TECHNIKA.md +++ b/docs/INSTRUKCJA_TECHNIKA.md @@ -3,11 +3,11 @@ Program służy do sprawdzenia sensorboxa przez USB, podłączenia go do Wi-Fi bez otwierania obudowy, wgrania firmware i przygotowania karty SD. Działa na Windows 10/11 i macOS 13 lub nowszym. -> ⚠️ **Box podłączaj zawsze kablem USB 2.0 z wtyczką typu A (prostokątną) po stronie komputera, -> bezpośrednio do portu USB-A w komputerze.** -> Nie używaj hubów, stacji dokujących, monitorów z USB ani przejściówek USB-C. -> Przy innych połączeniach box często nie jest widoczny w systemie („Unknown USB Device”) -> albo restartuje się przez spadki napięcia. Kabel musi przenosić dane – kabel „tylko do ładowania” nie zadziała. +> ⚠️ **Między boxem a komputerem musi być po drodze wtyczka USB 2.0 typu A (prostokątna).** +> Może to być kabel USB 2.0 A wpięty do komputera albo do huba – hub jest w porządku. +> Połączenie wyłącznie przez USB-C (kabel USB-C–USB-C, przejściówka USB-C bez odcinka USB 2.0 A) +> często kończy się tym, że box nie jest widoczny w systemie („Unknown USB Device”) albo restartuje się przez +> spadki napięcia. Kabel musi przenosić dane – kabel „tylko do ładowania” nie zadziała. --- @@ -62,7 +62,8 @@ Po uruchomieniu otwiera się zakładka **Quick start** ze skróconą instrukcją 1. Włącz box włącznikiem z tyłu obudowy (**ON**). Samo zasilanie z laptopa może nie wystarczyć, szczególnie przy słabej baterii. -2. Podłącz box **kablem USB 2.0 typu A bezpośrednio do portu USB-A komputera** (patrz ostrzeżenie na górze). +2. Podłącz box tak, żeby **po drodze była wtyczka USB 2.0 typu A** – do portu USB-A komputera albo do huba + (patrz ostrzeżenie na górze). 3. Na liście portów box widać jako: - Windows: `COMx - Sensorbox (native USB) [MAC]` - macOS: `/dev/cu.usbmodemXXXX - Sensorbox (native USB) [MAC]` @@ -144,7 +145,7 @@ najnowszy firmware (rozdział 7). 4. Kliknij **Start flashing**. Nie odłączaj kabla, dopóki nie pojawi się **„Success”** – program sam uruchomi box ponownie i sprawdzi, czy działa nowy firmware. -Jeśli wgrywanie nie może się połączyć: inny port/kabel (USB 2.0 A, bez huba), zamknij inne programy używające +Jeśli wgrywanie nie może się połączyć: inny port/kabel (z wtyczką USB 2.0 A po drodze), zamknij inne programy używające portu. Ostateczność (trzeba otworzyć obudowę): przytrzymaj **BOOT**, naciśnij i puść **RESET**, puść **BOOT**, kliknij Start jeszcze raz. @@ -193,7 +194,7 @@ Mała dioda obok (heartbeat): miga raz na sekundę = online, podwójnie = offlin | Objaw | Przyczyna | Co zrobić | |---|---|---| -| Boxa nie ma na liście portów | Zły kabel, hub, przejściówka USB-C, box wyłączony | **Kabel USB 2.0 typu A bezpośrednio do komputera**, włącznik ON, odłącz i podłącz ponownie. W Windows sprawdź Menedżer urządzeń – „Unknown USB Device” oznacza problem z kablem/portem/zasilaniem. | +| Boxa nie ma na liście portów | Brak wtyczki USB 2.0 A po drodze (samo USB-C), kabel tylko do ładowania, box wyłączony | **Połączenie z wtyczką USB 2.0 typu A** (do komputera lub huba), kabel z transmisją danych, włącznik ON, odłącz i podłącz ponownie. W Windows sprawdź Menedżer urządzeń – „Unknown USB Device” oznacza problem z kablem/portem/zasilaniem. | | Diagnoza: „Power supply voltage drops (brown-out)”, box się restartuje | Za słabe zasilanie | Włącznik boxa ON, inny port USB-A, zasilacz; naładuj baterię | | „The box does not answer USB commands” (Wi-Fi USB) | Stary firmware | Wgraj najnowszy firmware (App only) | | „Clock chip was stopped at start-up” | Pusta bateria zegara RTC | Zegar ustawi się sam po połączeniu z internetem; przy powtórce wymień baterię pastylkową | diff --git a/docs/img/01_quick_start.png b/docs/img/01_quick_start.png index 177c984..73029c1 100644 Binary files a/docs/img/01_quick_start.png and b/docs/img/01_quick_start.png differ diff --git a/docs/img/05_flash.png b/docs/img/05_flash.png index 392d8d1..f99aa54 100644 Binary files a/docs/img/05_flash.png and b/docs/img/05_flash.png differ diff --git a/kota_tech/flash/runner.py b/kota_tech/flash/runner.py index ae596f6..1abd04b 100644 --- a/kota_tech/flash/runner.py +++ b/kota_tech/flash/runner.py @@ -26,7 +26,7 @@ HINTS = [ "The box did not enter flashing mode by itself. Open the case, hold the BOOT button, press and release RESET, " "release BOOT, then press Start again."), (re.compile(r"device reports readiness to read but returned no data|The port disappeared|device disconnected", re.I), - "The USB connection dropped. Use a short data-capable USB cable directly on the laptop (no hub) and try again."), + "The USB connection dropped. Use a data-capable cable with a USB 2.0 type-A plug on the way to the laptop (not USB-C only) and try again."), (re.compile(r"Invalid head of packet|timed out", re.I), "Communication errors. Try another USB cable or port."), ] diff --git a/kota_tech/ui/cheatsheet.py b/kota_tech/ui/cheatsheet.py index 9f1fb1d..7928b5f 100644 --- a/kota_tech/ui/cheatsheet.py +++ b/kota_tech/ui/cheatsheet.py @@ -54,8 +54,8 @@ HINTS = [ STEPS = [ "Switch the sensorbox power switch ON.", - "Connect the box with a USB 2.0 cable with a type-A plug, directly to a USB-A port of the laptop " - "(no hub, dock or USB-C adapter; the cable must carry data).", + "Connect the box so that a USB 2.0 type-A plug is on the way to the laptop (into the laptop or a " + "hub; USB-C only often fails). The cable must carry data.", "Open the Serial monitor tab, choose the sensorbox port, press " "Connect.", "Press Reset & capture to record a full boot log from the first line.", diff --git a/kota_tech/ui/flash_tab.py b/kota_tech/ui/flash_tab.py index 1accf88..0ae4e7b 100644 --- a/kota_tech/ui/flash_tab.py +++ b/kota_tech/ui/flash_tab.py @@ -36,7 +36,7 @@ BACKUP_DIR = SESSIONS_DIR.parent / "backups" VERIFY_TIMEOUT_MS = 45_000 HELP = ( - "If flashing cannot connect: use a data-capable USB cable directly on the laptop, close " + "If flashing cannot connect: use a data-capable cable with a USB 2.0 type-A plug on the way, close " "other programs using the port, then retry. Last resort (case must be opened): hold BOOT, " "press and release RESET, release BOOT, and press Start again." )