wszystkie

<informacje o akcji> <ilość powtórzeń> <początek> <koniec> <pętla>

<informacje o akcji> = <długość informacji> <informacje>[*]
<informacje> = <typ danych> <długość danych> <dane>

<typ danych> == 1

TODO:

<typ danych> == 2

Kalkulator posiada:

• dwa rejestry: a oraz b
• 4 wartości tymczasowe (dostępne przez polecenia 10-13)

Generalnie <dane> to ciąg instrukcji dla “kalkulatora” z dwoma wartościami, działającego na zasadzie RPN (Odwrotna notacja polska). Wynik ostatnich obliczeń porównywany jest do 0 i na tej podstawie jest określane, czy akcja zostanie wykonana, czy nie. Wartości są ładowane do pola nr 2 po przesunięciu wartości z pola 2 na pole 1, czyli: LOAD = <1> ← <2>; <2> = wartość. Obie liczby to 32-bitowe liczby ze znakiem.

<dane> = <rozmiar> <index> <flagi> <start> <stop> <instrukcja>[*]

<rozmiar> - długość danych akcji (w bajtach)

<index> - indeks informacji o aktualnym stanie obliczeń (0..3). W tym miejscu jest przechowywana np informacja o aktualnej liczbie prawidłowych obliczeń, czy aktualnym stanie akcji.

<flagi> - wartości bitowe zmieniające zachowanie kalkulatora

01 - w przypadku jakiegokolwiek błędu, obliczenia zostaną potraktowane jako prawidłowe

<start> - ilość wymaganych poprawnych obliczeń aby uruchomić akcję.

<stop> - ilość wymaganych poprawnych obliczeń aby zakończyć działającą akcję

<instrukcja>:

// pobranie liczby
00 - Load 0
01 - Load 1
02 - Load -1
03 - Load Signed Byte <aa>
04 - Load Unsigned Byte <bb>
05 - Load Signed Word <aa bb>
06 - Load Unsigned Word <aa bb>
07 - Load Double Word = <aa bb cc dd>
// zapisanie wartości
10 <xx> - zapisz a na pozycji xx [x: 0..3]
11 <xx> - zapisz b na pozycji xx [x: 0..3]
14 <xx> - zapisz wartość z pozycji xx [x: 0..3] do a
15 <xx> - zapisz wartość z pozycji xx [x: 0..3] do b
// pobranie danych
20 - standard <aa>
  <aa>:
     00 - prędkość
     01 - obroty silnika
     02 - temperatura
21 - OBDII <aa> (4 najmłodsze bajty)
22 - ECUInfo <aa> (4 najmłodsze bajty)
// konwersja danych
30 - extend signed byte
31 - extend unsigned byte
32 - extend signed word
33 - extend unsigned word
34 - extend bit
// instrukcje
40 - exchange a <==> b
41 - b = b + a
42 - b = b - a
43 - b = b * a
44 - b = b / a
45 - b = b << a
46 - b = b >> a
47 - b = b & a
48 - b = b | a
49 - b = b ^ a
4A - b = ~b
4B - b = (b && a) ? 1 : 0
4C - b = (b || a) ? 1 : 0
4D - b = (b != a) ? 1 : 0
4E - b = !b
// porównanie, wynik porównania zapisywany jest w b: 1 - gdy warunek prawdziwy, 0 gdy fałszywy
F0 - b == 0
F1 - b != 0
F2 - b < 0
F3 - b <= 0
F4 - b > 0
F5 - b >= 0

FF - koniec obliczeń, zwróć wynik (b)

Rozmiar: 1 bajt

to domyślna ilość powtórzeń wykonania pętli w przypadku gdy wartość nie jest podana przy uruchomieniu akcji. Zwykle jest to 0.

Polecenia wykonane przy uruchomieniu/włączeniu akcji.

<długość> [<polecenie 1>, <polecenie 2>, ....]

długość (1 bajt) - ilość bajtów w początku akcji. Wartość zawsze obecna, nawet jeśli jest to 0
polecenie n - lista poleceń do wykonania. Długość polecenia jest zmienna i zależy od rodzaju polecenia. Opisane w dalszej części.

Polecenia wykonane przy wyłączeniu/zakończenie akcji.

<długość> [<polecenie 1>, <polecenie 2>, ....]

długość (1 bajt) - ilość bajtów w końcu akcji. Wartość zawsze obecna, nawet jeśli jest to 0
polecenie n - lista poleceń do wykonania. Długość polecenia jest zmienna i zależy od rodzaju polecenia. Opisane w dalszej części.

Polecenia wykonywane w trakcie trwania pętli. Powtarzane w trakcie każdego wykonania akcji

<ilość poleceń> [<polecenie 1>, <polecenie 2>, ....]

ilość poleceń (1 bajt) - ilość poleceń do wykonania. Wartość zawsze obecna, nawet jeśli jest to 0
polecenie n - lista poleceń do wykonania. Długość polecenia jest zmienna i zależy od rodzaju polecenia. Opisane w dalszej części.

Przykład (najprostsza akcja, która nic nie robi):

00 00 00 00 00

Ogólny format polecenia:

<rodzaj polecenia> [<parametr 1>, <parametr 2>, ...]

Rodzaje poleceń: (1 bajt)

• 00 - krótka pauza
• 01 - długa pauza
• 02 - sterowanie pinami I/O / PWM
• 03 - zmiana parametru w konfiguracji modułu
• 04 - zapis konfiguracji modułu do pamięci
• 05 - restart modułu
• 08 - uruchomienie innej akcji
• 09 - sterowanie akcją w tle
• 10 - wysłanie tekstu do wyświetlacza
• 11 - sterowanie głośnością radia
• 12 - otwórz Video
• 13 - zamknij menu modułu
• 14 - pokaż okno dialogowe
• 15 - ustaw automatyczne otwieranie okna czujników parkowania
• 2F - ustawienie sposobu wykonywania poleceń
• 30 - wysłanie pakietu na CAN
• 31 - oczekiwanie na pakiet CAN i odesłanie go zmodyfikowanego przez OR
• 32 - oczekiwanie na pakiet CAN i odesłanie go zmodyfikowanego przez AND
• 33 - oczekiwanie na pakiet CAN i odesłanie go zmodyfikowanego przez XOR
• 34 - oczekiwanie na pakiet CAN i odesłanie go zmodyfikowanego przez MOV
• 40-5F - sterowanie modułami na LSCAN przez GMLan (240 - 25F)
• 60-6F - sterowanie modułami na MSCAN przez GMLan (240 - 25F)
• 80-9F - sterowanie modułami na HSCAN przez GMLan (240 - 25F)
• A0-BF - wysłanie polecenia do modułu na LSCAN przez GMLan (240 - 25F)
• C0-DF - wysłanie polecenia do modułu na MSCAN przez GMLan (240 - 25F)
• E0-FF - wysłanie polecenia do modułu na HSCAN przez GMLan (240 - 25F)

Format polecenia:

00 <xx>

gdzie

<xx> - czas w ms

Format polecenia:

01 <xxxx>

gdzie

<xxxx> - czas w ms

Format polecenia:

02 <pin> <dane>

gdzie

<pin> - wyjście do ustawienia

dozwolone wartości:

00 - C2D
01 - UART_TX
02 - UART_RX
03 - LED-
04 - AUX1
05 - AUX2
06 - AUX3
F0 - inicjalizacja PWM
F1 - sterowanie PWM1
F2 - sterowanie PWM2

Zawartość pola <dane> zależą od wartości pola <pin>.
Dla wartości 00 - 06 (maska bitowa):

0x01 - ustaw 1 na wyjściu
0x02 - ustaw wyjście jako push-pull (0x00 - open-drain)
0x04 - zmień wartość wyjścia na przeciwną (0 na 1, 1 na 0)

użycie pinów UART_TX lub UART_RX wyłącza komunikację po UART do momentu restartu modułu.
Dla wartości F0 - inicjalizacja PWM:

<xx> <yyyy>

gdzie:

<xx> - parametry wyjść, bitowo:
0x01 - włączone jedno wyjście (PWM1 na pinie AUX2)
0x02 - włączone dwa wyjścia (PWM1 na pinie AUX2 oraz PWM2 na pinie AUX1).
       nie ma możliwości włączenie tylko AUX2!
0x40 - ustawienie PWM1 jako push-pull (normalnie jest open-drain)
0x80 - ustawienie PWM2 jako push-pull (normalnie jest open-drain)

<xxxx> - czas syklu PWM w ms
Np gdy chcemy ustawić na 10ms stan 1, 40ms stan 0 - wpisujemy tutaj wartość 50 (0032)

Inicjalizacja PWM musi być użyta przed sterowaniem PWM - dla obu PWM ustawiane są te same czasy!
Dla wartości F1 oraz F2:

<xx> - wypełnienie sygnału PWM (0x00 - 0xFF -> 0..100%)

Przykład:
chcemy wygenerować sygnał PWM o parametrach:
10ms jako logiczne 1 (5V), 60ms jako logiczne 0 (0V)
liczymy czas cyklu: 10 + 60 = 70. Polecenie wygląda następująco:

02 F0 41 0046
wyjście PWM1 (na AUX2), push-pull, z czasem cyklu 70ms

następnie liczymy wypełnienie:

10 / (10 + 60) =~ 0,14
0,14 * 255 = ~36 = 0x24

wysyłamy polecenie:

02 F1 24

03 04 0234 00112233

Powyższy przykład w pisze w konfigurację w pole o identyfikatorze wartość 4 bajów
oznacza to wpis w konfigurację

234=00112233

zmiana nie jest wpisywana do pamięci stałej, zostanie aktywna do wyłączenia modułu
Zapisania zostanie przy zapisie konfiguracji inną akcją lub poprzez zmiany w module (ECUInfo, OBD)
UWAGA: nie wszystkie parametry można zmieniać w ten sposób! Jednak jest to zdecydowana większość parametrów dostępna w konfiguracji (liczbowe, struktury) Nie można zmieniać w ten sposób np definicji akcji, nazw akcji - ogólnie napisów. W razie wątpliwości - pytaj

Poprawność danych nie jest weryfikowana! Ostrożność wysoce zalecana!

04

polecenie zapisuje bieżącą konfigurację do modułu

05

restart modułu

08 xx aabb

gdzie:

xx - identyfikator akcji wbudowanej (opisane pod koniec tej strony)
aabb - parametry wykonania akcji (zależne od typu akcji)

UWAGA: nie wszystkie akcje wbudowane można w tej sposób uruchomić, tylko te najprostsze

09 xy

gdzie:

x - numer akcji (0..3)
y - polecenie: 0 - stop, 1 - start, 2 - przełącz

10 xxxx yy <tekst>

gdzie:

xxxx - identyfikator pola na wyświetlaczu
yy - długość tekstu w bajtach
<tekst> tekst zakodowany w UTF-8

11 xx yy

gdzie:

xx - tryb sterowania: 
     1 - ustaw poziom <yy>
     2 - zwiększ poziom o <yy>
     3 - zmniejsz poziom o <yy>
     4 - zapisz aktualny poziom głośności, <yy> - bez znaczenia
     5 - przywróć poprzednio zapisany poziom głośności, <yy> - bez znaczenia

UWAGA: polecenia 1-3 automatycznie zapisują poziom głośności

yy - głośność do ustawienia (wartość ze znakiem)

gdy wartość wykroczy poza zakres obsługiwany przez radio, zostanie ustawiona ostatnia dozwolona wartość

przełącz CID w tryb Video

brak parametrów

zamknij menu modułu, odpowiada naciśnięciu przycisku MAIN na CD70/DVD90

brak parametrów

pokaż na ekranie okienko dialogowe

parametry: <xx> <yyyy> <zzzz> <aa> <tytuł> <bb> <wiadomość>
<xx> - typ okienka:
  01 - zwykłe okienko z małą ikonką
  05 - okienko z dużym obrazkiem
<yyyy> - ikonka do pokazania
  0000 - brak ikonki
  3300 - ostrzeżenie (wykrzyknik)
  3400 - informacja
  5300 - SOS
  FE07 - samochód
<zzzz> - czas automatycznego ukrycia okienka w ms. 0000 - okienko nie zostanie automatycznie ukryte
<aa> <tytuł> - tytuł komunikaty
  <aa> - długość w bajtach
  <tytuł> - tytuł do wyświetlenia zakodowany w UTF-8
<bb> <wiadomość> - treść widomości
  <bb> - długość w bajtach
  <wiadomość> - wiadomość do wyświetlenia zakodowany w UTF-8

przykład:

14 01 3300 03E8 03 616263 04 31323334
komunikat z trójkątem ostrzegającym, ukrywany automatycznie po 1000ms, tytuł: abc, treść: 1234

Ustawia opcję automatycznego pokazywania okna czujników parkowania (tymczasowo, to czasu wyłączenia silnika)
przykład:

15 00

dostępne wartości:

00 - automatyczne pokazywanie włączone
01 - automatyczne pokazywanie wyłączone

Ustawia sposób wykonywania poleceń w akcji
Domyślnie ustawiane są następujące flagi:

• przed początkiem akcji: 01
• przed pierwszym wykonaniem pętli: 00
• przed końcem akcji: 01

Dostępne flagi:

01 - wykonywanie akcji nie może być niczym przerwane
     (przez guzik na kierownicy, przez pilota ani przez zmianę pozycji kluczyka)
02 - nie czekaj na potwierdzenie polecenia. 
     Moduł nie będzie czekał na potwierdzenie wysłania polecenia do modułu. 
     Daje to możliwość szybszego działania akcji, jednak należy zapewnić przerwę pomiędzy poleceniami do tego samego modułu.

polecenie wysyła dowolny pakiet na CAN

30 xyyy zz <dane>

gdzie:

x - sieć CAN: 0 - LSCAN, 1 - MSCAN, 2 - HSCAN
yyy - identyfikator pakietu
zz - długość pkaietu w bajtach (0..8)
<dane> - dane w pakiecie do wysłania

przykład:

30 1234 03 013342

wykona:

cansend mscan 234#013342

polecenie czeka na pakiet o określonym ID a następnie odsyła ten pakiet odpowiednio zmieniony

31 xyyy zz <dane>

gdzie:

x - sieć CAN: 0 - LSCAN, 1 - MSCAN, 2 - HSCAN
yyy - identyfikator pakietu
zz - długość danych do zmodyfikowania w bajtach
<dane> - sposób modyfikacji danych, pakiet[i] = packet[i] OR dane[i]

przykład:

31 1234 03 000001

oczekuje na pakiet na MSCAN o identyfikatorze #234, a następnie go odeśle
otrzymany pakiet:

234#1020304050

odesłany pakiet:

234#1020314050

polecenie czeka na pakiet o określonym ID a następnie odsyła ten pakiet odpowiednio zmieniony

32 xyyy zz <dane>

gdzie:

x - sieć CAN: 0 - LSCAN, 1 - MSCAN, 2 - HSCAN
yyy - identyfikator pakietu
zz - długość danych do zmodyfikowania w bajtach
<dane> - sposób modyfikacji danych, pakiet[i] = pakiet[i] AND dane[i]

polecenie czeka na pakiet o określonym ID a następnie odsyła ten pakiet odpowiednio zmieniony

33 xyyy zz <dane>

gdzie:

x - sieć CAN: 0 - LSCAN, 1 - MSCAN, 2 - HSCAN
yyy - identyfikator pakietu
zz - długość danych do zmodyfikowania w bajtach
<dane> - sposób modyfikacji danych, pakiet[i] = pakiet[i] XOR dane[i]

polecenie czeka na pakiet o określonym ID a następnie odsyła ten pakiet odpowiednio zmieniony

34 xyyy zz <dane>

gdzie:

x - sieć CAN: 0 - LSCAN, 1 - MSCAN, 2 - HSCAN
yyy - identyfikator pakietu
zz - długość danych do zmodyfikowania w bajtach
<dane> - sposób modyfikacji danych, pakiet[i] = dane[i]

polecenie wysyła polecenie sterujące (AE - Device Control) do urządzenia GMLan na sieci LSCAN
przykład:

47 03 020101

wykona:

cansend lscan 247#04AE020101

polecenie wysyła polecenie sterujące (AE - Device Control) do urządzenia GMLan na sieci MSCAN
przykład:

67 03 020101

wykona:

cansend mscan 247#04AE020101

polecenie wysyła polecenie sterujące (AE - Device Control) do urządzenia GMLan na sieci HSCAN
przykład:

87 03 020101

wykona:

cansend hscan 247#04AE020101

polecenie wysyła dowolne polecenie do urządzenia GMLan na sieci LSCAN
przykład:

A7 04 3301012213

wykona:

cansend lscan 247#043301012213

polecenie wysyła dowolne polecenie do urządzenia GMLan na sieci MSCAN
przykład:

C7 04 3301012213

wykona:

cansend mscan 247#043301012213

polecenie wysyła dowolne polecenie do urządzenia GMLan na sieci HSCAN
przykład:

E7 04 3301012213

wykona:

cansend hscan 247#043301012213

• 01 - otwórz bagażnik
• 02 - otwórz szyby
• 03 - zamknij szyby
• 04 - sterowanie trybem SPORT
• 05 - wyczyść błędy
• 08 - sterowanie DDS
• 09 - zatrzymanie szyb
• 0A - odtwórz dźwięk z CIM
• 0B - otwórz drzwi (CZ)
• 0C - zamknij drzwi (CZ)
• 10 - sterowanie akcją w tle
• 11 - sterowanie głośnością radia
• 20 - otwórz menu modułu
• 21 - otwórz ustawienia modułu/przełącz stronę
• 22 - otwórz ekran silnika
• 23 - otwórz ekran stanu DPF
• 24 - otwórz ekran czujników parkowania
• 25 - otwórz menu ECUInfo
• 26 - otwórz menu OBD2
• 27 - otwórz menu Video
• 28 - otwórz menu listy akcji
• 70 - zasymuluj naciśniecie przycisku
• 80-9F - własne zdefiniowane akcje
• A0-BF - akcje wbudowane

TODO:

TODO:

TODO:

TODO:

TODO:

TODO:

TODO:

TODO:

TODO:

TODO:

TODO:

TODO:

TODO:

TODO:

TODO:

TODO:

TODO:

TODO:

TODO:

TODO:

TODO:

TODO:

• konfigurator
• v0.2x6
• v0.2x7
• v0.2x8
• v0.2x9
• v0.2x10
• v0.4
• v0.4x1
• v0.4a
• v0.5
• v0.5a
• v0.5c
• v0.6
• v0.6a
• v0.6b
• v0.6c
• v0.6d
• v0.7
• v0.7a
• v0.7b
• v0.7c
• v0.8
• v0.8a
• v0.8b
• v0.8c
• v0.8d
• v0.8e
• v0.8f
• v0.8g
• v0.8h
• v0.8i

Najbliższa wersja:

• v0.9-pre
• lcm-next
• błędy