Tekst źródłowy strony Użycie sterownika dyskowego

W haśle [[SIO]] opisano [[SIO#Struktura DCB|blok kontroli urządzeń]] i uniwersalny sposób niskopoziomowej komunikacji z dowolnym urządzeniem podłączonym do Atari za pośrednictwem [[Gniazdo SIO|szyny szeregowej]] oraz [[PBI|szyny równoległej]].

Firma Atari umieściła w systemie operacyjnym również procedurę pozwalającą na komunikację specjalnie ze stacją dysków oraz zdefiniowała w [[Tablica skoków|tablicy skoków]] pod adresem $E453 oficjalny skok DSKINV (JDSKINT).

Przed jej wywołaniem wystarczy ustawić w zmiennych systemowych tylko niezbędne informacje, a na ich podstawie sterownik uzupełni brakujące pola DCB i sam wywoła SIOV ($E459), zaś po powrocie zaktualizuje zmienne systemowe zależnie od rodzaju operacji.
Status wykonania zachowywany jest w DSTATS i dodatkowo zwracany w rejestrze Y, a znacznik procesora N=1 oznacza wystąpienie błędu.

== Zmienne systemowe ==

Sterownik wykorzystuje następujące zmienne systemowe:

* DSKTIM ($246) - timeout dla operacji formatowania,
* DSCTLN ($2D5,$2D6) - wielkość sektora,

a poza tym DCOMND ($302) z bloku kontroli urządzeń, do ustawienia zmiennych DCB:

* rodzaju urządzenia DDEVIC ($300) na kod stacji dysków $31,
* rodzaju operacji DSTATS ($303),
* czasu oczekiwania na wykonanie operacji DTIMLO ($306),
* rozmiaru bufora DBYT ($308,$309).

Poza tym zależnie od kodu wykonywanej operacji ustawiane są dodatkowe zmienne opisane w dalszych sekcjach.

Status wykonanej operacji dostępny jest w DSTATS ($303).

Obydwie zmienne DSCTLN i DSKTIM ustawiane są w trakcie procedury RESET podczas inicjalizacji sterownika dyskowego:

* DSCTLN zapisywany jest wartością $0080 odpowiadającą rozmiarowi boot-sektorów (1-3),
* natomiast DSKTIM wartością $A0 odpowiadającą z grubsza 180 sekundom.

Dalej podczas procedury BOOT następuje próba pobrania statusu napędu dyskowego nr 1 i w przypadku zakończenia operacji powodzeniem DSKTIM kopiowany jest z [[SIO#Stacja dysków|bloku DVSTAT]] ($2EA).

== Operacje ==

Sterownik dyskowy obsługuje tylko podstawowe operacje

* $21 '!' - FORMAT DISK
* $50 'P' - PUT SECTOR without verification
* $52 'R' - READ SECTOR
* $53 'S' - READ STATUS
* $57 'W' - WRITE SECTOR with verification

[[Lista komend SIO według funkcji|Każda inna operacja]] powinna być wykonywana po samodzielnym ustawieniu parametrów DCB i użyciu procedury SIOV $E459.

'''UWAGA!''' Sterownik dyskowy tak naprawdę potraktuje każdy rozkaz prócz '!' ($21), 'P' ($50), 'S' ($53) i 'W' ($57) jako odczyt sektora i ustawi DCB tak, jakby to był rozkaz 'R' ($52).

== Status dysku ==

Odczyt statusu napędu dyskietek wymaga jedynie podania jego numeru w DUNIT:

<pre>
  lda #1
  sta DUNIT
  lda #'S'
  sta DCOMND
  jsr DSKINV
  bmi error
</pre>

Sterownik ustawi:

* DSTATS na odczyt ($40),
* DBYT na $0004,
* DBUF na adres [[SIO#Blok statusu|bloku statusu]] DVSTAT $02EA,
* w DTIMLO zaś znajdzie się wartość $07 odpowiadająca mniej więcej siedmiu sekundom.

4-bajtowy blok statusu zostanie odczytany do [[SIO#Stacja dysków|bufora DVSTAT]] z którego 3-ci bajt oznaczający czas wykonania najdłuższej komendy (domyślnie jest to formatowanie dysku) przepisywany jest do DSKTIM.

== Odczyt sektora ==

Przed wykonaniem procedury należy podać:

* adres bufora w DBUF,
* numer napędu dyskietek w DUNIT,
* numer sektora w DAUX,
* wielkość sektora w DSCTLN.

<pre>
  lda #1
  sta DUNIT
  lda #'R'
  sta DCOMND
  ldx #&lt;buffer
  ldy #&gt;buffer
  stx DBUF
  sty DBUF+1
  ldx #&lt;sector
  ldy #&gt;sector
  stx DAUX1
  sty DAUX2
  jsr DSKINV
  bmi error
</pre>

Sterownik ustawi:

* DSTATS na odczyt ($40),
* DBYT na DSCTLN,
* w DTIMLO natomiast znajdzie się wartość $07 odpowiadająca mniej więcej siedmiu sekundom.

'''UWAGA!''' Po wykonaniu operacji w buforze znajdzie się zawartość żądanego sektora nawet wtedy, gdy operacja zakończy się [[Kody statusowe Atari OS|błędem]] 144 DEVICE DONE ERROR ($90).

== Zapis sektora ==

Przed wykonaniem procedury należy podać:

* adres bufora w DBUF,
* numer napędu dyskietek w DUNIT,
* numer sektora w DAUX,
* wielkość sektora w DSCTLN.

<pre>
  lda #1
  sta DUNIT
  lda #'P'     ;lub 'W'
  sta DCOMND
  ldx #&lt;buffer
  ldy #&gt;buffer
  stx DBUF
  sty DBUF+1
  ldx #&lt;sector
  ldy #&gt;sector
  stx DAUX1
  sty DAUX2
  jsr DSKINV
  bmi error
</pre>

Sterownik ustawi:

* DSTATS na zapis ($80),
* DBYT na DSCTLN,
* w DTIMLO natomiast znajdzie się wartość $07 odpowiadająca mniej więcej siedmiu sekundom.

Weryfikacja zapisu sektora leży po stronie stacji dysków i powoduje, że operacja po prostu będzie trwała nieco dłużej.

== Formatowanie dysku ==

Przed wywołaniem sterownika należy:

* w DBUF ustawić adres bufora w którym po wykonaniu operacji znajdą się numery wadliwych sektorów,
* w DUNIT podać numer napędu dyskietek.

<pre>
  lda #1
  sta DUNIT
  lda #'!'
  sta DCOMND
  ldx #&lt;buffer
  ldy #&gt;buffer
  stx DBUF
  sty DBUF+1
  jsr DSKINV
  bmi error
</pre>

Sterownik ustawi:

* DSTATS na odczyt ($40),
* DBYT na DSCTLN,
* w DTIMLO natomiast znajdzie się zawartość DSKTIM.

Po wykonaniu komendy w buforze znajdą się przesłane przez stację numery wadliwych sektorów zakończone markerem $FFFF.
W DBYT zwracana jest długość listy (bez markera).

== Zobacz ==

* [[SIO]]
* [[Nowe urządzenia]]
* [[Tablica skoków]]

[[Kategoria:Niezbędnik kodera]]
[[Kategoria:Programowanie Atari 8-bit]]