Toruń, dnia 28 lutego 2005

OPIS PROGRAMU R5 v2.06


1. Czym jest R5 ?

R5 jest programem umożliwiającym ładowanie zarówno plików
wykonywalnych (binarnych) w formacie Atari DOS jak i obrazów
dyskietek (w popularnym formacie ATR) wprost z dysku komputera PC
do Atari poprzez interfejs Sio2PC.


2. Ogólna obsługa programu

Wybór pliku do załadowania następuje albo za pomocą okna
dlalogowego po przyciśnięciu przycisku "Load" albo poprzez
"wrzucenie" pliku na okno programu (Drag&Drop).

Jeżeli plik ma rozszerzenie ".ATR" wówczas program przyjmuje,
że ma do czynienia z obrazem dyskietki i pracuje w trybie
stacji dysków D1. W pozostałych 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 poprawności wewnętrznego formatu pliku. (program
odmówi pracy z uszkodzonymi plikami wykonywalnymi lub
uszkodzonymi obrazami dyskietek).

Jedynym ustawieniem, które można zmieniać z poziomu okna programu
jest wybór portu komunikacyjnego COM (1 ... 4). Ustawienie to
zostanie automatycznie zapamiętane w pliku R5.ini.
Program zapamiętuje też ścieżkę ostatniego używanego pliku.


2. Ładowanie plików binarnych

Należy wskazać plik wykonywalny, jak podano w p.1. Następnie
sprawdzana jest poprawność formatu pliku. Jeżeli format
jest poprawny wyświetlony zostanie komunikat :

"Ready for booting Atari"

Jeżeli plik jest uszkodzony lub nie jest to plik binarny
Atari DOS wówczas wyświetlony zostanie komunikat :

"Not an executable"

Jeżeli plik jest zbudowany poprawnie, wówczas program
oczekuje na stgnał z komputera ATARI - należy wykonać
standardowy zimny start. (program oczekuje na sygnał
jako stacja D1).

Po bootowaniu ATARI wyświetlony zostanie napis :

"Booting"

Po czym do ATARI przesłane zostaną 3 sektory zawierające
specjalny loader, który po uruchomieniu wyświetli u
góry ekranu ATARI napis : "R5 Loader" i rozpocznie
się ładowanie właściwego pliku wykonywalnego.
Dalsze ładowanie odbywa się z prędkością 57600 bit/s
w specjalnym blokowym formacie z kontrolą poprawności
danych za pomocą sumy CRC. W trakcie ładowania
pomarańczowy pasek w oknie R5 pokazuje postęp ładowania
pliku. Po zakończeniu ładowania R5 wyświetli napis :

"Complete!"

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

Reset ATARI w dowolnym momencie spowoduje rozpoczęcie
procedury ładowania pliku od początku.

Plik binarny Atari DOS używany jest tylko w trakcie procedury ładowania,
później dostęp do niego nie jest dłużej blokowany - można
więc go modyfikować np. kompilować ponownie bez wyłączania
programu R5.


3. Ładowanie obrazów dysków (ATR'ów)

Po wskazaniu pliku *.ATR program R% sprawdzi jego
poprawność. W przypadku niespójności wyświetlony zostanie komunikat:

"Broken ATR"

Jeżeli plik jest zbudowany poprawnie, wówczas pojawi się
krótkie info nt. formatu obrazu dyskietki, np. :

"DD image, 720 sectors"

i program od tego momentu pracuje jako stacja dysków D1
(która może tylko odczytywać z dyskietki !)

Dalsza obsługa po stronie ATARI przebiega tak jak praca z
normalną stacją dyskietek.


4. Informacje techniczne

- Ogólnie do transmisji szeregowej NIE jest używana linia COMMAND
  w ATARI, więc program powinien działać niezależnie od tego czy
  SIO2PC w naszym komuterze używa 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 skacząc pod adres RUNAD ($2e0).
  Możliwe ładowanie programu bezpośrednio do rozszerzonego RAM lub
  po OS ROM (aby program ładował także pod OS ROM należy w pliku
  R5.INI dodać w sekcji "Settings" linię "OffROM = 1")
  Loader nie modyfikuje rejestru PORTB - włączanie lub wyłączanie BASIC
  zależy od użytkownika.
  Loader zajmuje pamięć od adresu $700 do $87e
  Bufor danych zajmuje obszar od $87f do $97f
  Dodatkowo, na stronie zerowej używane są rejestry od $43 do $48 włącznie
  Szybkość transmisji pliku binarnego wynosi 57600 bit/s, w blokach
  po 256 bajtów wraz z 16 bitowym CRC.

- W trybie binarnym na PC plik zablokowany jest tylko na czas ładowania
  do ATARI, później można go modyfikować beż wyłączania programu R5.

- W trybie ATR po załadowaniu pliku jest on blokowany do uzycia przez inne programy
  do czasu załadowania innego pliku lub zamknięcia programu R5.


5. Wymagania programu

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


6. Uwagi

- R5 jest programem przeznaczonym do użytku
  i kopiowania bezpłatnego (freeware)

- Autor nie ponosi odpowiedzialności za jakiekolwiek szkody,
  które mogą powstać na skutek lub w trakcie użytkowania
  programu R5.

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

28.2.2005 v. 2.06

- dodano obsługę obrazów dysków ATR (jako stacja D1 i tylko odczyt),
- poprawki w kodzie transmisji szeregowej na PC,
- poprawki w kodzie loadera na ATARI,
- zmieniona obsługa GUI - pasek postępu już nie miga,
- blokowanie dostępu do pliku binarnego tylko na czas jego
  ładowania do ATARI,
- inne drobne zmiany i poprawki.

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

Proszę o wszelkie uwagi i sugestie

Electron/Taquart
Tomasz Piórek
tpiorek@wp.pl