Toru, dnia 28 lutego 2005

OPIS PROGRAMU R5 v2.06


1. Czym jest R5 ?

R5 jest programem umoliwiajcym adowanie zarwno plikw
wykonywalnych (binarnych) w formacie Atari DOS jak i obrazw
dyskietek (w popularnym formacie ATR) wprost z dysku komputera PC
do Atari poprzez interfejs Sio2PC.


2. Oglna obsuga programu

Wybr pliku do zaadowania nastpuje albo za pomoc okna
dlalogowego po przyciniciu przycisku "Load" albo poprzez
"wrzucenie" pliku na okno programu (Drag&Drop).

Jeeli plik ma rozszerzenie ".ATR" wwczas program przyjmuje,
e ma do czynienia z obrazem dyskietki i pracuje w trybie
stacji dyskw D1. W pozostaych przypadkach program przyjmuje,
e plik jest plikiem binarnym Atari DOS i pracuje dalej w trybie
loadera pliku wykonywalnego.

Po rozpoznaniu typu pliku przeprowadzana jest automatyczna
weryfikacja poprawnoci wewntrznego formatu pliku. (program
odmwi pracy z uszkodzonymi plikami wykonywalnymi lub
uszkodzonymi obrazami dyskietek).

Jedynym ustawieniem, ktre mona zmienia z poziomu okna programu
jest wybr portu komunikacyjnego COM (1 ... 4). Ustawienie to
zostanie automatycznie zapamitane w pliku R5.ini.
Program zapamituje te ciek ostatniego uywanego pliku.


2. adowanie plikw binarnych

Naley wskaza plik wykonywalny, jak podano w p.1. Nastpnie
sprawdzana jest poprawno formatu pliku. Jeeli format
jest poprawny wywietlony zostanie komunikat :

"Ready for booting Atari"

Jeeli plik jest uszkodzony lub nie jest to plik binarny
Atari DOS wwczas wywietlony zostanie komunikat :

"Not an executable"

Jeeli plik jest zbudowany poprawnie, wwczas program
oczekuje na stgna z komputera ATARI - naley wykona
standardowy zimny start. (program oczekuje na sygna
jako stacja D1).

Po bootowaniu ATARI wywietlony zostanie napis :

"Booting"

Po czym do ATARI przesane zostan 3 sektory zawierajce
specjalny loader, ktry po uruchomieniu wywietli u
gry ekranu ATARI napis : "R5 Loader" i rozpocznie
si adowanie waciwego pliku wykonywalnego.
Dalsze adowanie odbywa si z prdkoci 57600 bit/s
w specjalnym blokowym formacie z kontrol poprawnoci
danych za pomoc sumy CRC. W trakcie adowania
pomaraczowy pasek w oknie R5 pokazuje postp adowania
pliku. Po zakoczeniu adowania R5 wywietli napis :

"Complete!"

I nastpi uruchomienie pliku binarnego na ATARI poprzez skok pod
adres wskazywany przez wektor RUNAD ($2e0).

Reset ATARI w dowolnym momencie spowoduje rozpoczcie
procedury adowania pliku od pocztku.

Plik binarny Atari DOS uywany jest tylko w trakcie procedury adowania,
pniej dostp do niego nie jest duej blokowany - mona
wic go modyfikowa np. kompilowa ponownie bez wyczania
programu R5.


3. adowanie obrazw dyskw (ATR'w)

Po wskazaniu pliku *.ATR program R% sprawdzi jego
poprawno. W przypadku niespjnoci wywietlony zostanie komunikat:

"Broken ATR"

Jeeli plik jest zbudowany poprawnie, wwczas pojawi si
krtkie info nt. formatu obrazu dyskietki, np. :

"DD image, 720 sectors"

i program od tego momentu pracuje jako stacja dyskw D1
(ktra moe tylko odczytywa z dyskietki !)

Dalsza obsuga po stronie ATARI przebiega tak jak praca z
normaln stacj dyskietek.


4. Informacje techniczne

- Oglnie do transmisji szeregowej NIE jest uywana linia COMMAND
  w ATARI, wic program powinien dziaa niezalenie od tego czy
  SIO2PC w naszym komuterze uywa linii RI czy te np. DSR jako COMMAND.

- loader binarny : zajmuje 3 sektory, aduje standardowe pliki
  wykonywalne (nie SDX), wykonuje bloki inicjalizacyjne INITAD ($2e2)
  oraz uruchamia program skaczc pod adres RUNAD ($2e0).
  Moliwe adowanie programu bezporednio do rozszerzonego RAM lub
  po OS ROM (aby program adowa take pod OS ROM naley w pliku
  R5.INI doda w sekcji "Settings" lini "OffROM = 1")
  Loader nie modyfikuje rejestru PORTB - wczanie lub wyczanie BASIC
  zaley od uytkownika.
  Loader zajmuje pami od adresu $700 do $87e
  Bufor danych zajmuje obszar od $87f do $97f
  Dodatkowo, na stronie zerowej uywane s rejestry od $43 do $48 wcznie
  Szybko transmisji pliku binarnego wynosi 57600 bit/s, w blokach
  po 256 bajtw wraz z 16 bitowym CRC.

- W trybie binarnym na PC plik zablokowany jest tylko na czas adowania
  do ATARI, pniej mona go modyfikowa be wyczania programu R5.

- W trybie ATR po zaadowaniu pliku jest on blokowany do uzycia przez inne programy
  do czasu zaadowania innego pliku lub zamknicia programu R5.


5. Wymagania programu

- komputer PC z Windows 9x/2000/XP
- interfejs Sio2PC w dowolnej wersji


6. Uwagi

- R5 jest programem przeznaczonym do uytku
  i kopiowania bezpatnego (freeware)

- Autor nie ponosi odpowiedzialnoci za jakiekolwiek szkody,
  ktre mog powsta na skutek lub w trakcie uytkowania
  programu R5.

----------------------------------------------------------------
HISTORIA PROGRAMU

28.2.2005 v. 2.06

- dodano obsug obrazw dyskw ATR (jako stacja D1 i tylko odczyt),
- poprawki w kodzie transmisji szeregowej na PC,
- poprawki w kodzie loadera na ATARI,
- zmieniona obsuga GUI - pasek postpu ju nie miga,
- blokowanie dostpu do pliku binarnego tylko na czas jego
  adowania do ATARI,
- inne drobne zmiany i poprawki.

----------------------------------------------------------------

Prosz o wszelkie uwagi i sugestie

Electron/Taquart
Tomasz Pirek
tpiorek@wp.pl
