Programowanie stacji LDW Super 2000 i CA-2001

From Atariki

Do stacji LDW Super 2000 i CA-2001 można przesyłać własne podprogramy i zlecać ich wykonanie, pamiętając oczywiście, że w tych stacjach dysków znajduje się procesor z rodziny Z80, więc wszelkie programy muszą być zapisane w kodzie maszynowym jego właśnie.

Od strony Atari

Do programowania stacji służy komenda SIO o kodzie $58 ("X"). Ma ona dwie postaci, pierwsza służy do przesłania programu, druga do uruchomienia go wraz z ewentualnym odebraniem wyników.

Przesyłanie programu

W pierwszym przypadku parametry DCB ustawia się tak, jak do każdego nadawania danych przez SIO:

• DDEVIC - wartość $31
• DUNIT - numer stacji
• DCMND - kod $58 ("X")
• DSTATS - wartość $80 (zapis)
• DBUFA - adres, gdzie znajduje się kod do wysłania
• DTIMLO - timeout jak do zapisu sektora (8)
• DBYT - liczba bajtów do wysłania
• DAUX1 - wartość $00
• DAUX2 - wartość $01 (download)

Wywołanie JSIOINT ($E459) z takimi parametrami spowoduje wysłanie programu do stacji. W tej chwili na konsolce powinna zapalić się lampka BUSY.

Wykonywanie programu

Uruchomienie przesłanego kodu uzyskujemy tą samą komendą "X", tylko z nieco innymi parametrami.

• DSTATS powinien zawierać wartość $40, gdy uruchomiony kod prześle z powrotem do komputera jakieś wyniki, albo $00 gdy niczego nie przesyła.
• DBUFA to adres bufora na dane wynikowe,
• do DBYT trzeba wpisać ich spodziewaną ilość (w bajtach);
• wartość timeout (DTIMLO) też jest zależna od tego, co robi przesłany program i ile czasu mu to zajmuje - na ogół jednak timeout "8" (10,24 sek.) powinien wystarczyć dla większości zadań.
• DAUX1 - wartość $00
• DAUX2 - wartość $00 (execute)

Wywołanie JSIOINT spowoduje uruchomienie przez stację przesłanego kodu. Po zakończeniu procedury lampka BUSY na konsolce stacji powinna zgasnąć.

Ważny szczegół jest taki, że pomiędzy przesłaniem programu a jego wykonaniem nie można wysyłać do stacji żadnych innych rozkazów - gdy się to zrobi, stacja "zapomni" o kodzie załadowanym przez użytkownika i nie będzie można dokonać uruchomienia.

Od strony stacji

Jak powiedziano wyżej, program musi być napisany w asemblerze procesora Z80. Komenda "X" ładuje go do pamięci stacji pod adres $7700. Ponieważ stacja ma tylko 2k pamięci RAM zlokalizowanej w obszarze $7700-$77FF, widać z tego, że przesyłany jednorazowo blok w zasadzie nie powinien mieć więcej niż 256 bajtów.

Ważne: przesłana procedura bierze na siebie obsługę części protokołu SIO, tę mianowicie, która przesyła do komputera (ewentualne) dane wynikowe oraz końcowe potwierdzenie wykonania komendy "X". Robi to funkcja nr 8 z tabeli poniżej.

Tabela funkcji ROM-u

Programy mogą skorzystać z wbudowanych w ROM funkcji. Nie ma oczywiście gwarancji niezmienności tej tabeli funkcji, ale jest duże tego prawdopodobieństwo.

Aby użyć danej funkcji należy jej numer załadować do rejestru C procesora, a następnie wywołać (rozkazem CALL) procedurę spod adresu $0004. Rejestry, z których korzysta się przy wywołaniu/powrocie z funkcji znajdują się w nawiasach, z wyjątkiem funkcji 0C, która używa flagi przeniesienia (carry) procesora (CF).

• $00 - zwraca numer wersji ROM-u (DE)
• $01 - powrót głowicy
• $02 - ustawienie głowicy nad konkretną ścieżką (D); numer ścieżki musi być pomnożony przez dwa
• $03 - odczyt sektora (E) ze scieżki (D)
• $04 - zapis sektora (E) na scieżce (D)
• $05 - odbiór bajtu (transmisja szeregowa) (C)
• $06 - wysłanie bajtu (A)
• $07 - odbiór rekordu o długości (B) pod adres (DE)
• $08 - wysłanie rekordu o długości (B) spod adresu (DE) z zadanym potwierdzeniem (A)
• $09 - konwersja cyfry do formatu odpowiedniego dla wyswietlacza (A) do (A)
• $0A - konwersja dwucyfrowa decymalna (A) do (DE)
• $0B - konwersja dwucyfrowa heksadecymalna (A) do (DE)
• $0C - włączenie (CF=1) lub wyłączenie (CF=0) silnika
• $0D - aktualizacja statusu przełączników i zmiany dysku
• $0E - zwraca adres bieżącego bufora (BC)
• $0F - zwraca adres flagi typu kontrolera (IX)
• $10 - wytworzenie dźwięku na linii audio
• $11 - aktualizacja wyświetlacza
• $12 - zwraca adresy rejestrów (odczyt/zapis) kontrolera (BC i DE)
• $13 - ustawienie gęstości zapisu w zależności od trybu
• $14 - zwraca adresy statusu i bieżącej ścieżki (DE i IX); numer ścieżki musi być pomnożony przez dwa

Mapka pamięci stacji

Przykłady

Brzęknięcie dzwonkiem stacji

Program wywołuje "sygnał ostrzegawczy" na linii audio, ten sam, którym stacja się posługuje dla zasygnalizowania np. błędów odczytu.

   LD   C,$10     ;e0 10         numer funkcji: "bell"
   CALL $0004     ;cd 04 00      wykonać
   LD   B,$00     ;06 00         ilość danych wynikowych (zero)
   LD   C,$08     ;0e 08         numer funkcji: "send record"
   LD   A,$43     ;3e 43         kod potwierdzenia: "C" (Complete)
   CALL $0004     ;cd 04 00      wykonać
   OR   A         ;b7            ustawienie znaczników procesora
   RET            ;c9            powrot

Odczytanie numeru wersji ROM

Program przesyła do komputera dwa bajty stanowiące numer wersji ROM-u stacji.

   LD   C,$00      ;e0 00        numer funkcji: "version"
   CALL $0004      ;cd 04 00     wykonać
   LD   ($7717),DE ;ed 53 17 77  zapisz DE pod adres $7717 w pamięci stacji
   LD   DE,$7717   ;17 17 77     adres danych do przesłania umieść w DE
   LD   B,$02      ;06 02        ilość danych wynikowych (dwa bajty)
   LD   C,$08      ;0e 08        numer funkcji: "send record"
   LD   A,$43      ;3e 43        kod potwierdzenia: "C" (Complete)
   CALL $0004      ;cd 04 00     wykonać
   OR   A          ;b7           ustawienie znaczników procesora
   RET             ;c9           powrot