SIO

From Atariki

(Różnice między wersjami)
Jump to: navigation, search
Wersja z dnia 19:14, 24 maj 2024
Mono (Dyskusja | wkład)
(obsluga rozkazu 'W' i komentarze + kod atari)
← Previous diff
Wersja z dnia 19:25, 24 maj 2024
Mono (Dyskusja | wkład)
(Przykłady kodów źródłowych służących do komunikacji pomiędzy Atari i mikrokontrolerem z wykorzystaniem protokołu SIO - styl.)
Next diff →
Linia 312: Linia 312:
== Przykłady kodów źródłowych służących do komunikacji pomiędzy Atari i mikrokontrolerem z wykorzystaniem protokołu SIO == == Przykłady kodów źródłowych służących do komunikacji pomiędzy Atari i mikrokontrolerem z wykorzystaniem protokołu SIO ==
-Kod urządzenia peryferyjnego o identyfikatorze $40 obsługujący rozkaz 'W' ($57), który odbiera 8 bajtów danych i realizuje jakąś operację.+Urządzenie peryferyjne o identyfikatorze $40 obsługujące rozkaz 'W' ($57), dla którego odbiera 8 bajtów danych i realizuje jakąś operację.
=== Kod dla Atari === === Kod dla Atari ===
Linia 496: Linia 496:
} }
</pre> </pre>
- 
==Zobacz też== ==Zobacz też==

Wersja z dnia 19:25, 24 maj 2024

Serial Input/Output. W założeniach jest to rezydujący w ROM-ie podsystem niskopoziomowych procedur blokowego dostępu do urządzeń szeregowych, to jest przede wszystkim stacji dysków, drukarek, modemów i magnetofonu. Wszystkie te urządzenia podłącza się w Atari do gniazda SIO.

W serii XL do podsystemu SIO dodano także niskopoziomową (blokową) obsługę urządzeń podłączanych do szyny równoległej (PBI), czyli tak zwanych nowych urządzeń.

Spis treści

Sposób użycia

Żądaną operację definiuje się ustawiwszy przedtem odpowiednie zmienne w bloku DCB (Device Control Block, $0300), a następnie wywołuje skokiem JSR pod JSIOINT $E459, co jest punktem wejściowym interfejsu szeregowo-równoległego. Przy powrocie rejestr Y zawiera wartość 1 w przypadku powodzenia, bądź ujemny kod błędu.

Struktura DCB

AdresEtykietaWielkośćZnaczenie
$0300DDEVICBajtIdentyfikator urządzenia (zob. niżej).
$0301DUNITBajtNumer urządzenia; w przypadku stacji dysków numer napędu.
$0302DCMNDBajtKomenda dla urządzenia.
$0303DSTATSBajtPrzed wywołaniem SIO należy ustawić tu rodzaj operacji ($40 odczyt, $80 zapis, $C0 zapis i odczyt, $00 brak transferu danych). Po powrocie z systemu znajduje się tu status operacji (kod błędu).
$0304DBUFADwa bajtyAdres bufora. Przy operacji zapisu i odczytu jednocześnie (DSTATS = $C0) bufor na odczytywane dane znajduje się w tym samym miejscu, co bufor danch przeznaczonych do zapisu.
$0306DTIMLOBajt

Czas oczekiwania na pozytywną odpowiedź urządzenia, tzw. timeout. Oblicza się to jak następuje: wartość DTIMLO mnożona jest przez 64, w wyniku czego otrzymujemy liczbę "ramek" VBL do odczekania. Zwiększenie DTIMLO o jeden powoduje wydłużenie czasu oczekiwania o 1,28 sek. w systemie PAL i o 1,067 sek. w systemie NTSC. Wartość "0" oznacza 256 jednostek.

Typowo ustawia się tu wartość z zakresu od $06 do $08 (zależnie od kaprysu programisty) dla wszystkich operacji oprócz formatowania. Właściwą wartość timeout dla formatowania urządzenie przesyła w bloku statusu, w odpowiedzi na komendę READ STATUS ("S", zob. niżej).

$0307DUNUSEBajtBajt nieużywany, zarezerwowany do przyszłych zastosowań.
$0308DBYTDwa bajtyWielkość bufora; musi być zgodna z wielkością transmitowanego bloku danych. Zero oznacza 64 kilobajty.
$030ADAUX1BajtPierwszy bajt pomocniczy. W operacjach dyskowych młodszy bajt numeru sektora.
$030BDAUX2BajtDrugi bajt pomocniczy. W operacjach dyskowych starszy bajt numeru sektora.

Wykaz urządzeń

Komenda wysyłana do urządzenia formowana jest w strukturze CFB (Command Frame Buffer, $023A) składającej się z:

  • CDEVIC
  • CCMND
  • CAUX1
  • CAUX2

a uzupełnianej na podstawie DCB.

Istnieje pięć urządzeń zdefiniowanych przez Atari. Właściwy identyfikator urządzenia (CDEVIC) zestawiany jest przez system z kodu urządzenia (DDEVIC) i jego numeru indywidualnego (DUNIT). Wartości te są dodawane, po czym jeszcze odejmuje się 1. Dlatego stację dysków nr 1 można wywołać też jako DDEVIC=$32 i DUNIT=0, liczy się wynik wspomnianego dodawania (CDEVIC). UWAGA: jest to tzw. "nieudokumentowana" cecha procedur szeregowych OS-u, inne urządzenia (jak np. nowe urządzenia) mogą tego nie robić.

DDEVICCDEVICOpis
$31$31-$3Fdyskowa pamięć masowa (stacja dysków, twardy dysk)
$40$40-$43drukarka
$4F$4Fbus master (moduł 1090)
$50$50-$53port szeregowy RS-232C
$60$60magnetofon kasetowy

Przypisanie identyfikatorów do poszczególnych urządzeń jest niezbyt konsekwentne, np. CDEVIC=$31 to stacja dysków numer 1, ale CDEVIC=$41 to drukarka numer 2.

Urządzeniem, które na podanej powyżej liście jest wyjątkowe, jest magnetofon kasetowy. Jest to jedyne "nieinteligentne" urządzenie peryferyjne, to jest nie zawierające własnego procesora. Wszystkie zadania związane z wysyłaniem danych na magnetofon i odbiorem z niego wykonuje system operacyjny komputera. W odróżnieniu od innych urządzeń, magnetofon okupuje tylko identyfikator $60, a wartość DUNIT jest ignorowana - w związku z tym kody urządzeń od $61 do $6F są (na razie) wolne.

Wartości CDEVIC powyżej $7F są zarezerwowane dla pewnych rozszerzeń protokołu SIO, patrz niżej.

Ponieważ identyfikator jest częścią wysyłanej do urządzenia komendy, więc budując własne urządzenie można posłużyć się identyfikatorem spoza powyżej wyszczególnionych:

DDEVICCDEVICOpis
$20$20IDE Plus, SIDE
$45$45Smart Device ( APE Time i URL Submit)
$5A$5AATR 8000
$61$61AtariSIO, DOS2DOS
$70$70Atari ASPI (zob. ASPI)
$71-$74$71-$74SDrive
$71$70SIO2USB [1]
$73$72-$75Sio2SD

Wykazy komend

Blok statusu

Blok statusu przysyłany na komendę żądania statusu ($53) ma strukturę w dużym stopniu zależną od urządzenia. Są to dwa lub cztery bajty, a ich znaczenie dla poszczególnych urządzeń jest opisane poniżej. W pierwszym bajcie statusu obowiązuje jednolity dla wszystkich urządzeń podział na dwie grupy bitów:

  • bity 0-2 sygnalizują status komunikacji pomiędzy komputerem a urządzeniem
  • bity 3-7 sygnalizują status wewnętrzny urządzenia

Stacja dysków

BajtZnaczenie
0
  • bit 0 = 1 - wydana ostatnio komenda nie została rozpoznana
  • bit 1 = 1 - przesłany ostatnio blok danych był błędny (błąd sumy kontrolnej)
  • bit 2 = 1 - ostatnia operacja nie powiodła się (np. próbowano odczytać wadliwy sektor)
  • bit 3 = 1 - dyskietka jest zabezpieczona przed zapisem
  • bit 4 = 1 - kręci się silnik obracający dyskietkę
  • bit 5 = 1 - sektory 256-bajtowe (128-bajtowe w przeciwnym wypadku)
  • bit 6 = 0 - zarezerwowany
  • bit 7 = 1 - praca w średniej gęstości

W przypadku interfejsu KMK/JŻ IDE znaczenie mają tylko bity 3 i 5, reszta jest zawsze wyzerowana.

1

Kopia rejestru statusu kontrolera WD 1772 (lub kompatybilnego), wszystkie bity są poddane inwersji.

  • bit 0 = 1 - BUSY
  • bit 1 = 1 - DRQ (Data Request)
  • bit 2 = 1 - Track 0 not found
  • bit 3 = 1 - CRC error
  • bit 4 = 1 - Record not found
  • bit 5 = 1 - Seek complete
  • bit 6 = 1 - Write protected
  • bit 7 = 1 - Not ready

Interfejs IDE KMK/JŻ zwraca zamiast tego zawartość rejestru ERROR kontrolera IDE:

  • bit 0 = 1 - Data Address Mark not found
  • bit 1 = 1 - Track 0 not found
  • bit 2 = 1 - Aborted command
  • bit 3, zarezerwowany
  • bit 4 = 1 - ID not found
  • bit 5, zarezerwowany
  • bit 6 = 1 - ECC error
  • bit 7 = 1 - Bad sector

Podobnie jak powyżej wszystkie bity są poddane inwersji (EOR #$FF).

2Maksymalny czas oczekiwania na wykonanie komendy (timeout) przewidziany dla operacji dyskowej. Najdłużej trwa formatowanie, zalecaną wartością jest 240.
3Nie używany.

Drukarka

BajtZnaczenie
0
  • bit 0 = 1 - wydana ostatnio komenda nie została rozpoznana
  • bit 1 = 1 - przesłany ostatnio blok danych był błędny (błąd sumy kontrolnej)
  • bit 7 = 1 - drukarka jest programowalna (w drukarkach Atari ten bit jest skasowany)
Pozostałe bity są zarezerwowane.
1DAUX2 przesłanej ostatnio komendy
2Maksymalny czas oczekiwania na wykonanie komendy (timeout) przewidziany dla tej drukarki
3Nie używany.

RS-232 (Atari 850)

Blok statusu portu RS-232 ma dwa bajty (w pozostałych urządzeniach - cztery).

BajtZnaczenie
0
  • bit 0 = 1 - wydana ostatnio komenda nie została rozpoznana
  • bit 1 = 1 - przesłany ostatnio blok danych był błędny (błąd sumy kontrolnej)
  • bit 2, zarezerwowany
  • bit 3, zarezerwowany
  • bit 4 = 1 - przepełnienie bufora RS-232
  • bit 5 = 1 - błąd parzystości RS-232
  • bit 6 = 1 - na porcie RS-232 wystąpił nadmiar bitów (overrun)
  • bit 7 = 1 - na porcie RS-232 wystąpiło zakłócenie transmisji szeregowej (framing error)
1
  • bit 0 = 1 - RCV (czyli RX) ustawione
  • bit 1, zarezerwowany
  • bit 2, kopia bitu 3
  • bit 3 = 1 - CRX (czyli DCD) ustawione
  • bit 4, kopia bitu 5
  • bit 5 = 1 - CTS ustawione
  • bit 6, kopia bitu 7
  • bit 7 = 1 - DSR ustawione

Magnetofon kasetowy

Przyjmuje się, że magnetofon, jako urządzenie "nieinteligentne", jest zawsze podłączony i gotowy do pracy, a więc nie zachodzi potrzeba sprawdzania jego statusu. W związku z tym funkcja READ STATUS ($53) nie jest dla magnetofonu zaimplementowana.

Blok PERCOM

Blok PERCOM jest to 12 bajtów informacji o konfiguracji stacji dysków. Odczyt przeprowadza się komendą $4E ("N"), a zapis - komendą $4F ("O").

BajtOpis
0Liczba ścieżek na dyskietce; w praktyce dla stacji dysków spotyka się wartości najczęściej 40 lub 80, rzadziej 35 lub 77. Partycje twardego dysku zwracają 1.
1Szybkość przesuwu głowicy ze ścieżki na ścieżkę:
  • 0 - 30 ms
  • 1 - 20 ms
  • 2 - 12 ms
  • 3 - 6 ms

W praktyce stacje przeważnie ignorują przesłaną wartość. W przypadku twardego dysku jest ona bez znaczenia (kontroler KMK/JŻ zwraca w tym bajcie numer wersji wewnętrznego oprogramowania)

2STARSZY bajt liczby sektorów na ścieżce.
3MŁODSZY bajt liczby sektorów na ścieżce.
4Liczba aktywnych stron dyskietki zmniejszona o 1 albo najstarszy bajt liczby sektorów partycji twardego dysku (patrz niżej).
5
  • bit 0 - zarezerwowany
  • bit 1 = 1, dyskietka ośmiocalowa; 5,25 cala w przeciwnym wypadku
  • bit 2 = 1, gęstość MFM, FM w przeciwnym wypadku
  • bit 3 = 1, dysk nie ma "stron", a zamiast liczby stron jest podany najstarszy bajt całkowitej liczby sektorów dysku (partycji twardego dysku)

Pozostałe bity są zarezerwowane i powinny być wyzerowane.

6STARSZY bajt wielkości sektora (w bajtach)
7MŁODSZY bajt wielkości sektora (w bajtach)
8

Niewykorzystany, zapisuje się - i przeważnie odczytuje - jako $FF. W oryginalnych stacjach PERCOM bajt ten sygnalizował stan niektórych funkcji kontrolera stacji i służył do ich wybierania:

  • bit 0 = 1, sektory fizyczne na ścieżce numerowane są od 0, a nie od 1.
  • bit 1 = 1, sektory fizyczne 1,2,3 mają pełne rozmiary.
  • bit 2, zarezerwowany
  • bit 3, zarezerwowany
  • bit 4, zarezerwowany
  • bit 5, zarezerwowany
  • bit 6 = 0, napęd stacji jest odłączony (wyjęty).
  • bit 7 = 1, napęd 80-ścieżkowy pracuje w trybie 40-ścieżkowym.

W praktyce większość stacji nie ustawia tych bitów zgodnie z powyższym opisem.

9Niewykorzystane, na ogół 0.
10Niewykorzystane, na ogół 0.
11Niewykorzystane, na ogół 0.

Protokół transmisji

Połączenia równoległe

Protokół transmisji urządzeń podłączanych do szyny równoległej jest zależny od programu obsługi urządzenia zawartego w jego pamięci ROM. System operacyjny tego nie definiuje.

Połączenia szeregowe

Podziału poszczególnych bajtów na bity i wyemitowania ich na złącze szeregowe tudzież przyjmowania pojedynczych bitów i scalania ich w bajty dokonuje sprzętowo układ POKEY (quod vide).

Opis przebiegu komunikacji

Przebieg komunikacji pomiędzy komputerem a urządzeniem jest następujący:

1) komputer ustawia linię COMMAND portu SIO;

2) komputer formuje czterobajtowy blok komendy, tzw. Command Frame. Command Frame składa się kolejno z (bajt 1) dodanych do siebie wartości DDEVIC i DUNIT, odjąć 1; (bajt 2) wartości DCMND; (bajt 3) wartości DAUX1; (bajt 4) wartości DAUX2;

3) komenda jest wysyłana do urządzenia razem z dołączoną na końcu sumą kontrolną; czas pomiędzy ustawieniem linii COMMAND a rozpoczęciem wysyłania komendy musi być nie mniejszy niż 750 usec i nie większy niż 1600 usec.

4) komputer kasuje linię COMMAND portu SIO (nie wcześniej niż po 650 usec i nie później niż 950 usec po wysłaniu ostatniego bitu komendy) i czeka na odpowiedź;

5) urządzenie przyjmuje komendę; jeśli urządzenie stwierdziło w komendzie błąd sumy kontrolnej, nie reaguje; jeśli komenda jest nierozpoznana, albo nieprawidłowe są jej parametry (np. nie istnieje sektor o podanym numerze), odpowiedzią jest $4E ("N", jak Negative Acknowledge) i na tym transmisja się kończy; jeśli komenda jest urządzeniu znana a parametry prawidłowe, odpowiedzią jest $41 ("A", jak Acknowledge). Urządzenie musi rozpocząć wysyłanie odpowiedzi w czasie od 0 do 16 msec. od skasowania linii COMMAND przez komputer;

Dalszy przebieg jest zależny tego, czy dana komenda wymaga przesłania dodatkowego bloku danych do/z urządzenia. Możliwe są 3 sytuacje: brak transmisji danych; odczyt danych z urządzenia; zapis danych do urządzenia.

6a) Jeśli komenda nie wymaga transmisji bloku danych, urządzenie podejmuje próbę wykonania operacji; jeśli się to nie uda, wysyła kod $45 ("E", jak Error); w przeciwnym wypadku przesyłany jest kod $43 ("C", jak Complete); na tym transmisja się kończy.

6b) jeśli komenda polega na odczycie bloku danych, urządzenie podejmuje próbę wykonania operacji; jeśli się to nie uda (np. nie można odczytać sektora z powodu uszkodzenia nośnika), wysyła kod $45 ("E", jak Error); w przeciwnym wypadku przesyłany jest kod $43 ("C", jak Complete); następnie w obydwu przypadkach urządzenie natychmiast wysyła blok danych zakończony sumą kontrolną i na tym transmisja się kończy.

6c) jeśli to jest zapis bloku danych, komputer przesyła blok danych plus sumę kontrolną do urządzenia. Po jego przyjęciu, jeśli blok danych jest poprawny, urządzenie odpowiada kodem $41 ("A") i przystępuje do np. zapisania danych na nośnik. W przeciwnym wypadku, jeśli w nadesłanym bloku danych urządzenie stwierdzi błąd sumy kontrolnej lub inne nieprawidłowości, odpowiada kodem $4E ("N") lub nie odpowiada w ogóle, a blok danych ignoruje (należy tu jednak mieć na względzie, że Atari zasygnalizuje wtedy błąd timeout-u $8A). W następnej fazie urządzenie informuje komputer o wykonaniu kodem "C" lub "E" o znaczeniu jak powyżej, i na tym transmisja się kończy. Przesłanie bloku danych musi rozpocząć się nie wcześniej niż 1000 usec. i nie później niż 1800 usec. po przesłaniu ostatniego bitu potwierdzeniu przyjęcia komendy (pierwszym "A"). Rozpoczęcie przesłania potwierdzenia otrzymania bloku ("A" lub "N") musi nastąpić w czasie od 850 usec. do 16 msec. po przesłaniu ostatniego bitu bloku danych.

We wszystkich 3 przypadkach transmisja potwierdzenia końcowego ("C" lub "E") z urządzenia musi rozpocząć się nie wcześniej niż po 250 usec. i nie później niż po 255 sekundach - czyli po 4 minutach i 15 sekundach - od przesłania ostatniego bitu potwierdzenia komendy ("A") (6a, 6b) lub od odebrania ostatniego bitu bloku danych (6c).

Konieczność odebrania bloku danych z urządzenia podczas operacji odczytu, nawet po ustaleniu że operacja została wykonana błędnie (kod "E") może tłumaczyć fakt, że po operacji formatowania dysku stacje dysków wysyłają listę błędnych sektorów (rozmiar odbieranego bloku danych ustalany jest w DBYT).

Schemat wymiany danych

W fazie oznaczonej jako wykonanie urządzenie dokonuje niezbędnych czynności (np. stacja dysków wyszukuje żądany sektor na dyskietce i odczytuje go, albo zapisuje), a komputer czeka.

Potwierdzenia przesyłane są bez sum kontrolnych.

Tylko komenda
  • komputer --> komenda 4 B + suma kontrolna --> urządzenie
  • komputer <-- potwierdzenie 'A' <-- urządzenie
  • wykonanie
  • komputer <-- potwierdzenie 'C' <-- urządzenie
  • koniec
Odczyt
  • komputer --> komenda 4 B + suma kontrolna --> urządzenie
  • komputer <-- potwierdzenie 'A' <-- urządzenie
  • wykonanie
  • komputer <-- potwierdzenie 'C' <-- urządzenie
  • komputer <-- blok danych + suma kontrolna <-- urządzenie
  • koniec
Zapis
  • komputer --> komenda 4 B + suma kontrolna --> urządzenie
  • komputer <-- potwierdzenie 'A' <-- urządzenie
  • komputer --> blok danych + suma kontrolna --> urządzenie
  • komputer <-- potwierdzenie 'A' <-- urządzenie
  • wykonanie
  • komputer <-- potwierdzenie 'C' <-- urządzenie
  • koniec
Zapis i odczyt
  • komputer --> komenda 4 B + suma kontrolna --> urządzenie
  • komputer <-- potwierdzenie 'A' <-- urządzenie
  • komputer --> blok danych + suma kontrolna --> urządzenie
  • komputer <-- potwierdzenie 'A' <-- urządzenie
  • wykonanie
  • komputer <-- potwierdzenie 'C' <-- urządzenie
  • komputer <-- blok danych + suma kontrolna <-- urządzenie
  • koniec

Magnetofon

Powyższe schematy dotyczą wszystkich urządzeń SIO za wyjątkiem magnetofonu. Magnetofon nie zawiera w sobie mikroprocesora, jest urządzeniem "nieinteligentnym". Transmisja jest w całości obsługiwana przez komputer, który wysyła (i przyjmuje) bloki danych, tzw. rekordy, zawierające każdy po 128 bajtów danych, bajt sumy kontrolnej oraz bajt rodzaju rekordu i dwa dodatkowe bajty służące do pomiaru równomierności przesuwu taśmy - łącznie 132 bajty.

Rozszerzenia SIO

Systemy turbo do stacji dysków

Standardowa szybkość wymiany danych ze stacją dysków - 19200 bps - szybko okazała się dalece niewystarczająca. Ponieważ, jak napisano powyżej, możliwości układu POKEY pozwalają uzyskać znacznie więcej, wkrótce powstało kilka, różnych niestety, systemów "turbo".

Rozszerzone adresowanie sektorów (KMK/JŻ IDE)

Kontroler KMK/JŻ IDE wykorzystuje bajt DUNUSE ($0307) bloku DCB jako najstarszy bajt numeru sektora. Pozwala to na zaadresowanie do 16777215 sektorów na jednej partycji.

Rozszerzone adresowanie pamięci (65C816)

DracOS (odmiana XL OS przygotowana dla procesora 65C816) zawiera rozszerzenie SIO pozwalające na transfery danych bezpośrednio do i z dodatkowej pamięci adresowalnej liniowo (tj. znajdującej się pod adresami wyższymi niż $FFFF) oraz 32-bitowe adresowanie sektorów.

Przykłady kodów źródłowych służących do komunikacji pomiędzy Atari i mikrokontrolerem z wykorzystaniem protokołu SIO

Urządzenie peryferyjne o identyfikatorze $40 obsługujące rozkaz 'W' ($57), dla którego odbiera 8 bajtów danych i realizuje jakąś operację.

Kod dla Atari

  lda #$40
  sta DDEVIC   ;$300
  lda #$01
  sta DUNIT    ;$301
  lda #'W'
  sta DCMND    ;$302
  lda #$80
  sta DSTATS   ;$303
  lda #<buffer
  sta DBUFA    ;$304
  lda #>buffer
  sta DBUFA+1
  lda #$07
  sta DTIMLO   ;$306
  lda #<8
  sta DBUFL    ;$308
  lda #>8
  sta DBUFL+1
  lda #$00
  sta DAUX1    ;$30A
  lda #$00
  sta DAUX2    ;$30B
  jsr SIOV     ;$E459
  bmi ?error

Kod dla mikrokontolera AVR (Arduino)

/*
SIO CMD structure:
Byte:
RxBuffer[0]	-	SIO device identifier and unit number
RxBuffer[1]	-	COMMAND, for future use,
RxBuffer[2]	-	DAUX1, for future use,
RxBuffer[3]	-	DAUX2, for future use,
RxBuffer[4]	-	checksum.

SIO DATA structure:
RxBuffer[0]	        - data,
RxBuffer[1]	        - data,
...
...
RxBuffer[RxDataSize-1]  - data,
RxBuffer[RxDataSize]	- checksum.
*/


/* Arduino hardware settings */
#define PIN_SIOCOMMAND      2 // ATARI SIO-COMMAND Pin
#define SIO Serial1           // ATARI SIO-Serial interface

// ----------------------------------------
/* Global define */
#define RxCmdSize   4        // size of command frame (w/o checksum byte)
#define RxDataSize  8        // size of data frame (w/o checksum byte)

#define DEVICE_ID  0x40      // SIO device identifier and unit number
#define COMMAND_ID 'W'       // SIO operation command

/* Global Variable */
uint8_t RxBuffer [32+1];

uint8_t RxSumData   = 0;
uint8_t RxSumCmd    = 0;


void setup()
{
  pinMode(PIN_SIOCOMMAND, INPUT_PULLUP);
  SIO.begin(19200);
}

void loop()
{      
  while (1)
  {
    //wait for COMMAND line is LOW
    while (digitalRead(PIN_SIOCOMMAND) > 0) ;

    //receive command frame and calculate checksum
    RxSumCmd = ReceiveData(RxBuffer, RxCmdSize+1);

    //wait for COMMAND line is LOW
    while (digitalRead(PIN_SIOCOMMAND) == 0) ;
    
    //verify device identifier
    if (RxBuffer[0] == DEVICE_ID)
    {
      //check command checksum
      if (RxSumCmd == RxBuffer[RxCmdSize])
      {
        //check command identifier
        if (RxBuffer[1] == COMMAND_ID)
        {
          //-- check or process auxiliary bytes RxBuffer[2] and RxBuffer[3] when needed
          
          //...
          //...
          
          //-- end of aux data processing  ----------------------------------------

          //send ACK and continue receive data
          delayMicroseconds(1000);
          SIO.write('A');
          SIO.flush();

          //receive data frame
          RxSumData = ReceiveData(RxBuffer, RxDataSize+1);
          if (RxSumData == RxBuffer[RxDataSize])
          {
            //send ACK
            delayMicroseconds(1000);
            SIO.write('A');
            SIO.flush();

            //-- start operation according to received command and data
            
            //...
            //...
            
            //-- end of operation ----------------------------------------

            //then send operation COMPLETE
            delayMicroseconds(250);
            SIO.write('C');
            SIO.flush();
          }
          else 
          {
            //send NAK because of wrong data frame checksum
            delayMicroseconds(1000);
            SIO.write('N');
            SIO.flush();

            //then send operation ERROR
            delayMicroseconds(250);
            SIO.write('E');
            SIO.flush(); 
          } 
        }
        else
        {
          //send NAK because of not supported command
          delayMicroseconds(1000);
          SIO.write('N');
          SIO.flush();
        }   
      }
      else
      {
        //send NAK because of wrong command frame checksum
        delayMicroseconds(1000);
        SIO.write('N');
        SIO.flush();
      }
    }
  }
}
//functions
uint8_t ReceiveData(uint8_t *buffer, uint8_t length)
{
  u8 cnt = 0;
  int sum = 0;

  cnt = SIO.readBytes(buffer,length);
  if (cnt == length)
  {
    for (cnt = 0; cnt < length-1; cnt++)
    {
      sum += buffer[cnt];
      if (sum >= 256)
      {
        sum = (sum - 256) + 1;  // add carry into sum
      }
    }
  }
  return sum;
}

Zobacz też

Bibliografia

Personal tools