Użycie sterownika dyskowego - Historia wersji

Mono: /* Zmienne systemowe */ styl.

2025-03-20T11:47:55Z

Zmienne systemowe: styl.

← poprzednia wersja		Wersja z 20 mar 2025, 13:47
Linia 23:		Linia 23:
	* DSCTLN zapisywany jest wartością $0080 odpowiadającą rozmiarowi boot-sektorów (1-3),		* 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.		* natomiast DSKTIM wartością $A0 odpowiadającą z grubsza 180 sekundom.
	Dalej podczas procedury BOOT następuje ~~pobranie~~ statusu napędu dyskowego nr 1 i ~~jeśli stacja jest podłączona, to~~ DSKTIM kopiowany jest z [[SIO#Stacja dysków\|bloku DVSTAT]] ($2EA).		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 =		= Operacje =

Mono o 09:15, 13 mar 2025

2025-03-13T09:15:16Z

← poprzednia wersja		Wersja z 13 mar 2025, 11:15
Linia 3:		Linia 3:
	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).		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 ~~skoczy do~~ SIOV ($E459), zaś po powrocie zaktualizuje zmienne systemowe zależnie od rodzaju operacji.		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.		Status wykonania zachowywany jest w DSTATS i dodatkowo zwracany w rejestrze Y, a znacznik procesora N=1 oznacza wystąpienie błędu.

Mono: aktualizacja zmiennych i dcb

2025-03-13T09:14:28Z

aktualizacja zmiennych i dcb

← poprzednia wersja		Wersja z 13 mar 2025, 11:14
Linia 3:		Linia 3:
	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).		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 ~~reszta zostanie uzupełniona przez~~ sterownik.		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 skoczy do 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.
	~~Po wykonaniu procedury status operacji~~ zwracany ~~jest~~ w rejestrze Y, a znacznik procesora N=1 oznacza wystąpienie błędu.

	= Zmienne systemowe =		= Zmienne systemowe =

Mono: /* Odczyt sektora */

2025-03-13T09:05:56Z

Odczyt sektora

← poprzednia wersja		Wersja z 13 mar 2025, 11:05
Linia 84:		Linia 84:
	* w DTIMLO natomiast znajdzie się wartość $07 odpowiadająca mniej więcej siedmiu sekundom.		* 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]]:		'''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).
	* 143 ($8F) - CHECKSUM ERROR,
	* 144 ($90) ~~- DEVICE DONE ERROR~~.

	== Zapis sektora ==		== Zapis sektora ==

Mono: /* Zmienne systemowe */

2025-03-12T23:15:40Z

Zmienne systemowe

← poprzednia wersja		Wersja z 13 mar 2025, 01:15
Linia 19:		Linia 19:
	Poza tym zależnie od kodu wykonywanej operacji ustawiane są dodatkowe zmienne opisane w dalszych sekcjach.		Poza tym zależnie od kodu wykonywanej operacji ustawiane są dodatkowe zmienne opisane w dalszych sekcjach.

	~~Po wykonaniu procedury status~~ operacji dostępny jest w DSTATS ($303).		Status wykonanej operacji dostępny jest w DSTATS ($303).

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

Mono: /* Odczyt sektora */ jeszcze checksum

2025-03-12T20:41:32Z

Odczyt sektora: jeszcze checksum

← poprzednia wersja		Wersja z 12 mar 2025, 22:41
Linia 84:		Linia 84:
	* w DTIMLO natomiast znajdzie się wartość $07 odpowiadająca mniej więcej siedmiu sekundom.		* 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 ~~$90~~]] (DEVICE DONE ERROR).		'''UWAGA!''' Po wykonaniu operacji w buforze znajdzie się zawartość żądanego sektora nawet wtedy, gdy operacja zakończy się [[Kody statusowe Atari OS\|błędem]]:
			* 143 ($8F) - CHECKSUM ERROR,
			* 144 ($90) - DEVICE DONE ERROR.

	== Zapis sektora ==		== Zapis sektora ==

Mono: przeniesienie uwagi o READ SECTOR

2025-03-12T11:40:50Z

przeniesienie uwagi o READ SECTOR

← poprzednia wersja		Wersja z 12 mar 2025, 13:40
Linia 35:		Linia 35:
	* $57 'W' - WRITE SECTOR with verification		* $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.		[[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 ==		== Status dysku ==
Linia 83:		Linia 85:

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

	~~'''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).~~

	== Zapis sektora ==		== Zapis sektora ==

Mono o 10:31, 12 mar 2025

2025-03-12T10:31:23Z

← poprzednia wersja		Wersja z 12 mar 2025, 12:31
Linia 52:		Linia 52:
	* DBUF na adres [[SIO#Blok statusu\|bloku statusu]] DVSTAT $02EA,		* DBUF na adres [[SIO#Blok statusu\|bloku statusu]] DVSTAT $02EA,
	* w DTIMLO zaś znajdzie się wartość $07 odpowiadająca mniej więcej siedmiu sekundom.		* w DTIMLO zaś znajdzie się wartość $07 odpowiadająca mniej więcej siedmiu sekundom.
	4-bajtowy blok statusu zostanie odczytany do 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.		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 ==		== Odczyt sektora ==

Mono: /* Zmienne systemowe */ reset i boot

2025-03-12T10:28:26Z

Zmienne systemowe: reset i boot

← poprzednia wersja		Wersja z 12 mar 2025, 12:28
Linia 21:		Linia 21:
	Po wykonaniu procedury status operacji dostępny jest w DSTATS ($303).		Po wykonaniu procedury status operacji dostępny jest w DSTATS ($303).

	Obydwie zmienne DSCTLN i DSKTIM ustawiane są w trakcie procedury ~~BOOT~~:		Obydwie zmienne DSCTLN i DSKTIM ustawiane są w trakcie procedury RESET podczas inicjalizacji sterownika dyskowego:
	* DSCTLN ~~inicjalizowany~~ jest wartością $80 odpowiadającą rozmiarowi boot-sektorów (1-3),		* DSCTLN zapisywany jest wartością $0080 odpowiadającą rozmiarowi boot-sektorów (1-3),
	* natomiast DSKTIM kopiowany jest z bloku DVSTAT ($2EA) ~~po pobraniu statusu stacji dysków.~~		* natomiast DSKTIM wartością $A0 odpowiadającą z grubsza 180 sekundom.
	~~Operacje te wykonywane są na napędzie 1~~.		Dalej podczas procedury BOOT następuje pobranie statusu napędu dyskowego nr 1 i jeśli stacja jest podłączona, to DSKTIM kopiowany jest z [[SIO#Stacja dysków\|bloku DVSTAT]] ($2EA).

	= Operacje =		= Operacje =

Mono: kosmetyka

2025-03-12T07:15:32Z

kosmetyka

← poprzednia wersja		Wersja z 12 mar 2025, 09:15
Linia 5:		Linia 5:
	Przed jej wywołaniem wystarczy ustawić w zmiennych systemowych tylko niezbędne informacje, a reszta zostanie uzupełniona przez sterownik.		Przed jej wywołaniem wystarczy ustawić w zmiennych systemowych tylko niezbędne informacje, a reszta zostanie uzupełniona przez sterownik.

	Po wykonaniu procedury status operacji zwracany w rejestrze Y, a znacznik procesora N=1 oznacza wystąpienie błędu.		Po wykonaniu procedury status operacji zwracany jest w rejestrze Y, a znacznik procesora N=1 oznacza wystąpienie błędu.

	= Zmienne systemowe =		= Zmienne systemowe =
Linia 47:		Linia 47:
	bmi error		bmi error
	</pre>		</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.		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 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.		4-bajtowy blok statusu zostanie odczytany do 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.

Linia 74:		Linia 77:
	bmi error		bmi error
	</pre>		</pre>
	DSTATS ~~zostanie ustawiony~~ na odczyt ($40), a DBYT na DSCTLN, w DTIMLO natomiast znajdzie się wartość $07 odpowiadająca mniej więcej siedmiu sekundom.		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 $90]] (DEVICE DONE ERROR).		'''UWAGA!''' Po wykonaniu operacji w buforze znajdzie się zawartość żądanego sektora nawet wtedy, gdy operacja zakończy się [[Kody statusowe Atari OS\|błędem $90]] (DEVICE DONE ERROR).
Linia 103:		Linia 109:
	bmi error		bmi error
	</pre>		</pre>
	DSTATS ~~zostanie ustawiony~~ na zapis ($80), a DBYT na DSCTLN, w DTIMLO natomiast znajdzie się wartość $07 odpowiadająca mniej więcej siedmiu sekundom.		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.		Weryfikacja zapisu sektora leży po stronie stacji dysków i powoduje, że operacja po prostu będzie trwała nieco dłużej.

Linia 124:		Linia 132:
	bmi error		bmi error
	</pre>		</pre>
	DSTATS ~~jest ustawiany~~ na odczyt ($40), a DBYT na DSCTLN, w DTIMLO natomiast znajdzie się zawartość DSKTIM.		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.		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).		W DBYT zwracana jest długość listy (bez markera).