LWPM Comfort Module

Instrukcja jest przygotowana w oparciu o system Debian/Ubuntu.
W innych systemach będzie podobnie, choć polecenia mogą być inna. Nazwy pakietów również mogą się różnić

• python3.5+

1. Instalujemy następujące pakiety w systemie: python3-pip

apt-get install python3-pip

2. instalujemy pakiety pythona: flask, flask-cors, pyserial

pip3 install flask
pip3 install flask-cors
pip3 install pyserial

Plik lcm-service.py pobieramy z tego adresu: https://files.lwpm.eu/LWPMComfortModule/lcm_service.py i uruchamiamy z konsoli:

./lcm_service.py

Opcjonalne parametry:
–debug - wyświetlanie informacji debugowych usługi
–debug-uart - zrzut całej komunikacji UART do konsoli
–ssl - użycie szyfrowanej komunikacji z usługą
–dump - zrzut całej komunikacji HTTP do konsoli

Uzyskując bezpośredni dostęp do CAN samochodu, trzeba uważać! Przez CAN przesyłanych jest mnóstwo danych, których znaczenia nikt poza GM nie zna. Wysyłając przypadkowe dane na CAN można wprowadzić jakiś moduł/sterownik w nieokreślony stan, z którego może być go później trudno wyprowadzić! Zwykle odłączenie zasilania (akumulatora) pomaga.
Nie odpowiadam za jakiekolwiek szkody spowodowane bezpośrednim dostępem do CAN.

wszystkie narzędzia były sprawdzane/testowane tylko w systemie Linux/Debian i tutaj powinny działać. Wymagania od strony Linuxa:

1. SocketCAN (każda nowsza dystrybucja posiada wbudowaną obsługę)
2. Python 3.4+
3. pakiety Pythona: pyserial, python-can
4. interfejs/kabel OP-COMa, testowane tylko z oprogramowaniem 1.59. Samego OP-COMa nie potrzebujemy.

Możemy także wykorzystać gotową maszynę wirtualną Linuxa i uruchomić ją z VirtualBox
Maszynę pobieramy z https://mega.nz/file/YXxVjYLB#MX5TJBJFsxWFL7ovvLTF-LcP08oQ0U4IhAPNni07XEY

Maszynę importujemy do VirtualBoxa i uruchamiamy

login: osboxes
hasło: lwpm
hasło roota: lwpm

Wszystkie wymagane pliki są dostępne w katalogu /home/osboxes/opel, natomiast wszystkie narzędzia są tekstowe, a więc wszystko wykonujemy z terminala.

Jeśli jednak chcesz sam przygotować sobie system, zakładam, że wiesz jak go skonfigurować:

1. instalujemy python3.4+
2. instalujemy can-utils (apt-get install can-utils)
3. instalujemy pip (apt-get install python3-pip)
4. instalujemy pyserial oraz python-can (pip3 install pyserial && pip3 install python-can)

W innych systemach niż Debian/Ubuntu polecenia mogą być inne.

Pierwszym krokiem do zrobienia jest uruchomienie vcan_init, który stworzy wirtualne interfejsy (LSCAN, MSCAN, HSCAN) w Linuxie. Będą one używane do dostępu do fizycznych CANów w samochodzie.

a więc logujemy się w systemie, uruchamiamy terminal, przechodzimy do katalogu opel (cd opel) i wpisujemy:

sudo ./vcan_init

potwierdzamy hasłem roota (lwpm)
W tym momencie mamy już utworzone wirtualne interfejsy CAN, z których już teraz możemy korzystać.

Następnym krokiem jest podłączenie do maszyny wirtualnej interfejsu OP-COMa i podpięcie go pod któryś z CANów. Służy do tego program opcom.py, który uruchamiamy następująco:

./opcom.py /dev/ttyUSB0 lscan

aby połączyć interfejs OP-COMa z naszym wirtualnym CANem (LSCAN)
aby podłaczyć się do mscan wpisujemy odpowiednio

./opcom.py /dev/ttyUSB0 mscan

analogicznie robimy to dla HSCAN

./opcom.py /dev/ttyUSB0 hscan

W przypadku HSCAN OP-COM bardzo szybko się zawiesi ze względu na zbyt dużą ilość danych, których nie jest on w stanie przetworzyć, dlatego wywołujemy program z odpowiednim filtrowaniem przychodzących pakietów, np:

./opcom.py /dev/ttyUSB0 hscan filter:-1,-1,7DF,7E0,5E8,7E8

w ten sposób będziemy przechwytywać tylko komunikację ze sterownikiem silnika (ECU)
Pierwsze dwa parametry filtru to maska bitowa. Nie końca wiem jak jej używać, dlatego używamy -1,-1, aby odfiltrować wszystko, natomiast kolejne wartości to już konkretne identyfikatory PIDów, które potrzebujemy. Możemy podać maksymalnie 6 identyfikatorów!

Skoro mamy już połączony samochód z naszym komputerem, możemy podejrzeć co się w nim dzieje :)
najważniejsze polecenia to cansniffer oraz candump

candump lscan
cansniffer lscan

pierwszy z nich wypisuje na ekranie wszystkie przychodzące pakiety, natomiast drugi robi dokładnie to samo, z tym, że grupuje je wg identyfikatora pokazując tylko to co się zmieniło. Warto poczytać pomoc do tych poleceń, aby uzyskać lepszą prezentację danych (użyj parametru –help).
Najważniejsze wywołania to:

candump -a -c lscan
candump -l lscan

Pierwszy wypisuje pakiety w kolorze i pokazując zawarte w nich teksty
drugi zapisuje wszystkie pobranie pakiety do pliku np w celu dalszej ich analizy

Do wysyłania pakietów na CAN mamy w zasadzie dwa najważniejsze programy: cansend oraz canplayer Za pomocą canplayer możemy wysłać na CAN poprzednio zapisane pakiety,
natomiast za pomocą candump możemy wysłać konkretny pakiet na CAN, np:

cansend mscan 223#00772823

polecenie to wyśle pakiet o identyfikatorze 223 i długości 4 bajtów na MSCAN.

w załącznikach programy vcan_init, opcom.py oraz instrukcja instalacji przygotowana przez Łukasza Ostapiuk