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

1. Dioda statusu na Raspberry Pi: Czerwona dioda oznacza zasilanie. Zielona powinna migać nieregularnie – oznacza to pracę systemu operacyjnego i odczyt z karty pamięci.
2. Brak sieci Wi-Fi: Sprawdź nazwę sieci i adres bramy zapisane w obrazie lub konfiguracji MCS. Potem zrestartuj stację i upewnij się, że antena Wi-Fi nie jest zasłonięta przez metalowe lub karbonowe elementy.
3. 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.
4. Moduł RadioMaster Nomad miga na pomarańczowo: Oznacza to stan RF Idle (brak pakietów z RPi). Sprawdź w WebUI, czy usługa MCS jest uruchomiona i czy port /dev/ttyUSB0 jest aktywny.

💾 2. Przygotowanie karty microSD

Jeśli masz obraz MCS, wgraj go przez Raspberry Pi Imager i sprawdź opublikowaną dla niego sumę SHA-256. Po starcie odczytaj nazwę sieci, adres bramy i dane dostępu z konfiguracji tego obrazu. Nie publikuj ani nie używaj obrazu z pustym hasłem SSH lub automatycznym logowaniem administracyjnym.

---

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. Diagnostyka Mostków Szeregowych i Modułów RF USB (Nomad)

Sprawdzenie stanu mostka CP2102 modułu ExpressLRS po wpięciu do portu USB:

# Weryfikacja wykrycia kontrolera USB przez jądro:
dmesg | grep -iE 'ttyusb|cp210x|silicon'

# Sprawdzenie uprawnień portu (powinna być grupa dialout):
ls -la /dev/ttyUSB*

# Podgląd surowego strumienia bajtów CRSF (115200 bps):
python3 -m serial.tools.miniterm /dev/ttyUSB0 115200

3. Logi demona MCS (systemd)

sudo journalctl -u rcsim_mcs.service -f -n 100

Szukaj komunikatów o wyjątkach Pythona (Traceback) oraz błędach połączenia z mostkiem szeregowym (SerialException).