Rozdział 5: Troubleshooting i Logi Systemowe
Część 1: Przyjazna Encyklopedia (Dla Każdego)
Co zrobić, gdy auto nie jedzie lub WebUI nie chce się załadować? Oto szybka procedura diagnostyczna dla operatora.
🔍 1. Szybka diagnostyka krok po kroku
- Dioda statusu na Raspberry Pi: Czerwona dioda oznacza zasilanie. Zielona powinna migać nieregularnie – oznacza to pracę systemu operacyjnego i odczyt z karty pamięci.
- Brak sieci Wi-Fi: Jeśli na telefonie nie widzisz sieci
RCSIM_MCS_AP, zrestartuj zasilanie modelu. Upewnij się, że antena Wi-Fi na RPi 5 nie jest zasłonięta przez metalowe elementy podwozia lub karoserię z włókna węglowego. - Pedały kierownicy nie reagują: Upewnij się, czy kabel USB jest mocno wpięty. Spróbuj przepiąć kierownicę do innego portu USB i ponownie przejść proces w kreatorze kalibracji w WebUI.
Część 2: Inżynieryjny Deep Dive (Dla Specjalistów)
Zaawansowana diagnostyka i analiza logów systemowych wymaga zalogowania się na komputer pokładowy RPi 5 za pomocą protokołu SSH (port domyślny 22).
1. Diagnostyka Wejść USB (evtest)
Aby zweryfikować, czy jądro Linux poprawnie wykrywa zdarzenia z kierownicy USB na poziomie warstwy sprzętowej, użyj narzędzia evtest:
sudo apt install evtest
sudo evtest /dev/input/event2
Jeśli przy kręceniu kierownicą konsola wypisuje struktury zdarzeń (np. code 0 (ABS_X), value 32768), warstwa sprzętowa i sterowniki jądra działają poprawnie, a błąd leży po stronie konfiguracji aplikacji w WebUI.
2. Logi Demona Głównego (Systemd / Docker)
W zależności od metody wdrożenia oprogramowania pokładowego MCS:
- Jeśli aplikacja działa w kontenerze Docker:
docker logs rcsim_embedded -f --tail 100 - Jeśli aplikacja działa bezpośrednio na hoście jako usługa systemd:
sudo journalctl -u rcsim_mcs.service -f -n 100
Szukaj komunikatów o wyjątkach Pythona (Traceback), błędach połączenia z mostkiem RP2350 (SerialException) oraz błędach alokacji I2C/SPI (OSError: [Errno 121] Remote I/O error).