TRS DESKTOP – user’s manual

INFORMACJE OGÓLNE

	TRS Desktop to graficzna nakładka, przeznaczona do pracy pod kontrolą Sparta DOS X i dedykowana użytkownikom posiadającym dysk twardy. Założeniem jest uproszczenie uruchamiania programów i skupienie skrótów w jednym miejscu – na wzór “okienkowych” systemów operacyjnych znanych z innych platform. Instalator przeprowadza wraz z użytkownikiem początkową fazę instalacji programu, do pierwszego uruchomienia. Do pracy, oprócz modułu Sparta DOS X, wymagana jest mysz typu Atari ST / Atari TRAK-BALL  lub Amiga.
Idea napisania GUI powstała w marcu 2005. Głównie jest to zasługą nie spełnienia oczekiwań przez inne tego rodzaju produkty, które najczęściej nie spełniają podstawowych swoich funkcji; tj. szybkości działania oraz możliwości uruchamiania dowolnych programów, które funkcjonują bez przeszkód pod “normalnym” DOS-em.

INSTALACJA

Przed przystąpieniem do instalacji należy przygotować pustą, sformatowaną partycję docelową. Zalecana jest partycja o rozmiarze 16MB, ale faktyczne zapotrzebowanie zależy od wyboru pakietów instalacyjnych. 
UWAGA: Instalator zapisuje na wskazanej przez użytkownika partycji pliki konfiguracyjne dla Sparta DOS X oraz Desktopu i nie sprawdza, czy nie nadpisuje istniejących plików. Przed instalacją należy upewnić się, że partycja nie zawiera żadnych ważnych danych – autor nie ponosi odpowiedzialności za ewentualną utratę danych.
•	Instalację należy rozpocząć od uruchomienia komputera z dysku instalacyjnego, umieszczonego w stacji D1:. Zapewni to najlepsze warunki dla instalatora. Jeśli istnieje potrzeba ręcznego uruchomienia programu instalacyjnego (SETUP.COM) z innego napędu, nie należy ładować dodatkowych sterowników dla SDX – może to bowiem uniemożliwić instalację (brak pamięci).
•	Pierwszy etap to wybór składników instalacji (installation packets). Obowiązkowa jest instalacja programu głównego (Desktop core), opcjonalnie możemy także zainstalować pakiety z dodatkami. Każdy dodatkowy pakiet zostanie skonfigurowany w programie jako oddzielny pulpit (maksymalna ich ilość to 19 sztuk). Pakiety oznaczone przez użytkownika za pomocą “+” zostaną zainstalowane, zaś te z “–” będą pominięte. 
•	W kolejnym kroku badane są dostępne dyski w poszukiwaniu odpowiedniej ilości wolnego miejsca. Po zakończeniu tej czynności zostanie wyświetlona lista dysków, z której należy wybrać przygotowaną wcześniej partycję docelową (dysk), na której zostanie zainstalowany Desktop.
•	Następnie program sprawdza konfigurację sprzętową systemu (typ procesora, ilość pamięci RAM, wersję SDX, zegar czasu rzeczywistego, typ myszy itd.). Zależnie od konfiguracji sprzętu zostanie utworzona konfiguracja dla SDX oraz dla Desktopu.
•	Dalej następuje rozpakowanie wybranych pakietów. Operacja może zająć dłuższy czas, w zależności od szybkości dysków źródłowego i docelowego.
•	Ostatnia faza to zapis konfiguracji dla SDX i Desktopu. Instalator proponuje przy tym użytkownikom SIO2IDE, KMK/JŻ IDE lub IDEa automatyczne zamontowanie docelowej partycji jako D1:, co umożliwi automatyczne uruchamianie Desktopu wraz z systemem w optymalnej konfiguracji. Pozostali użytkownicy również mogą skonfigurować Desktop dla dysku D1, pod warunkiem ręcznego zamontowania na nim partycji docelowej przed kolejnym uruchomieniem systemu. Pomyślna instalacja kończy się pierwszym uruchomieniem Desktopu. 

PIERWSZE URUCHOMIENIE

Jeżeli podczas instalacji wybrano zamontowanie partycji z Desktopem jako D1:, Desktop jest automatycznie uruchamiany wraz ze startem systemu. Niżej podano inne sposoby uruchamiania Desktopu:
•	z linii poleceń, poprzez przejście do katalogu głównego partycji z Desktopem i wpisanie ”-D” (katalog ten można również na stałe dodać do zmiennej PATH);
•	z linii poleceń za pomocą “–7:>D”, przy czym 7 należy zastąpić numerem partycji z Desktopem;
•	w systemie DracOS (dla 65c816) i SDX 4.3 naciskając klawisz >START< przy bootowaniu i wybierając partycję z Desktopem.
Przy pierwszym uruchomieniu mogą wystąpić niekiedy pewne problemy, spowodowane początkowym, błędnym ustawieniem typu myszy.  W takim przypadku, przed samym startem Desktopu należy przytrzymać klawisz >OPTION<, co daje możliwość automatycznego uruchomienia programu do konfiguracji myszy (MOUSECFG.TDX). Program ten jest obsługiwany z klawiatury oraz uruchamia się wyłącznie pod TRS Desktop.
Inne problemy mogą wiązać się z tym, że system uruchamiano z inną konfiguracją startową (CONFIG.SYS) niż utworzona przez instalator. Ponieważ zależą one od użytej konfiguracji startowej, trudno podać uniwersalne rozwiązanie. Należy jednak pamiętać, że instalator utworzył w partycji docelowej optymalne pliki konfiguracyjne (CONFIG.SYS, AUTOEXEC.BAT), które mogą służyć za wzór przy tworzeniu własnych plików.

PROGRAM GŁÓWNY:

MYSZ:

	Obsługiwane są dwa standardy  – mysz w standardzie Atari ST oraz Amiga. Dokładnych różnic nie ma sensu tu opisywać, najważniejsza jest pewna właściwość tego rodzaju urządzeń. Otóż niektóre myszy działają wyłącznie w trybie jedno-przyciskowym, inne widziane są jako dwu-przyciskowe, a w przypadku tych ostatnich występują jeszcze 2 rodzaje. Jeśli więc funkcja obsługi prawego klawisza nie daje się uruchomić, należy w menu konfiguracji myszy włączyć opcję emulacji prawego klawisza. W trybie emulacji zmienia się znaczenie lewego przycisku – teraz pojedyncze ”kliknięcie” spowoduje normalną reakcję na wskazanym obiekcie, długie ”kliknięcie” spowoduje emulowanie prawego przycisku myszy. Opóźnienie ustawia się w programie do konfigurowania myszy.
Można także dokonać sprzętowej modyfikacji myszy, po której desktop obsłuży urządzenie jako dwu-przyciskowe. Dla oryginalnie dedykowanego sprzętu (real ST/AMIGA), modyfikacja taka nie będzie miała żadnego funkcjonalnego znaczenia. 

FUNKCJE:

Na ekranie Desktopu można wyróżnić następujące elementy:
•	MENU – zawiera listę programów możliwych do uruchomienia niezależnie od aktualnie używanego pulpitu – na chwile obecną edycja MENU odbywa się poprzez dowolny edytor tekstu, modyfikując plik MENU.PIN. Pojedynczy wpis zawiera nazwę programu do wyświetlania, skrót do odpowiedniej lokalizacji na HDD, oraz nazwę pliku do uruchomienia. Separatory w MENU określone są znakiem ”-”
•	DESK – zawiera listę dostępnych pulpitów, oraz opcję NEW, oraz SAVE.
-	NEW umożliwia utworzenie nowego pulpitu
-	SAVE umożliwia trwały zapis zmian w obrębie danego pulpitu. Jeśli po modyfikacji pulpitu nie zapiszesz zmian i przełączysz się na inny – tracisz ostatnie zmiany.
•	IKONY – pojedynczy ”klik” spowoduje uruchomienie programu, do którego odnosi się skrót, prawy klawisz myszy (lub długi ”klik”) spowoduje otwarcie okna właściwości ikony. Dostępne są następujące opcje:
–	EDIT – edycja właściwości, czyli obraz ikony, nazwa do wyświetlania, ścieżka prowadząca do pliku oraz nazwa pliku. Jeśli skrót odnosi się do katalogu na tej samej partycji, na której zainstalowany jest Desktop, numer dysku można pominąć, np. D:>PROGRAMS>. Dodatkowo, jeśli odwołujemy się do podkatalogu podrzędnego względem DESK (czyli katalogu z podstawowymi plikami Desktopu), np. D:>DESK>TOOLS>, możemy użyć skrótu D:TOOLS>.
–	MOVE – służy do przenoszenia ikon. Ikony wyrównywane są z dokładnością do ośmiu pixeli.
–	DELETE – usunięcie skrótu. Trwałe usunięcie uzyskujemy dopiero poprzez zapis Desktopu opcją SAVE.
•	PULPIT – prawy lub długi ”klik” spowoduje otwarcie menu pomocniczego, a w nim opcji tworzenia nowego skrótu oraz właściwości pulpitu. Obecnie funkcja zmiany właściwości pulpitu nie jest dostępna. Odpowiednia łata zostanie opublikowana w przyszłości jako dodatek aktualizacyjny dla TRS Desktop.
•	ZEGAR – obsługiwany przez dwa rozszerzenia modułu zegara czasu rzeczywistego: R-Time 8, oraz Atari Realtime Clock (Pasiu/SSG). Opcja zmiany ustawień – obecnie nieaktywna – zostanie opublikowana w przyszłości jako dodatek aktualizacyjny dla TRS Desktop.  Możliwa jest oczywiście zmiana daty i czasu z poziomu wiersza poleceń SpartaDOS X. Program w chwili obecnej nie pracuje poprawnie z JIFFY.SYS z modułu Sparta DOS X
•	MENU TRS DESK – informacja o autorach, oraz wersji programu

ŁADOWANIE PROGRAMÓW:

	Program umożliwia uruchamianie standardowych plików wykonywalne, które można wywoływać z poziomu wiersza poleceń Sparta DOS X oraz dodatkowo część programów, których uruchomienie pod tym systemem nie jest normalnie możliwe. Jeśli uruchomiony program posiada opcję wyjścia do DOSu (lecz nie poprzez procedurę Reset), nastąpi powrót do GUI (dzieje się tak, gdyż Desktop działa w zapętlonym pliku wsadowym). Każdorazowo przed uruchomieniem jakiegokolwiek programu wykonywane są dwie, ważne operacje związane ze zwiększeniem zgodności ze starszym lub niedbale napisanym  oprogramowaniem:
•	Przed uruchomieniem katalog z programem jest przestawiany jako domyślne ”D:”. Starsze programy nie obsługujące podkatalogów działają więc na swoich wydzielonych ”roboczych” podkatalogach.
•	Przed uruchomieniem programu następuje wyzerowanie pamięci RAM od $1600 do granicy memtop. Jeśli uruchamiany program spodziewa się wyzerowanej pamięci przy uruchomieniu, powinien działać prawidłowo. Należy jednak uważać, aby memlo nie  wzrosło powyżej $1400 (bezpieczna granica), np. w wyniku ładowania przy starcie dużej ilości sterowników.
Przy uruchamianiu programów można opcjonalnie skorzystać z programu CTRL + ALT + DEL, autorstwa Lizarda.

SZCZEGÓŁY TECHNICZNE:

•	Najważniejsze pliki Desktopu:
-	R.BAT: plik wsadowy z pętlą ładującą Desktop
-	DESKTOP.PIN: ostatnio używany pulpit lub pulpit ustawiony przy pierwszym uruchomieniu
-	*.DSK – pliki z takim rozszerzeniem zawierają konfigurację dla poszczególnych pulpitów
-	EXIT.EXE – przy pomocy tego czegoś desktop przerywa działanie pliku wsadowego ładującego desktop w pętli, umożliwiając wyjście do wiersza poleceń SDX.
-	START.EXE – biblioteka uruchamiająca program MAIN.TD0 (zob. dalej)
-	*.GR8 – bitmapy trybu GR.8 – opcjonalne znaczenie; w postaci tapety dla GUI
-	DESK00.GR8 – plik użyty jako tapeta w chwili, w której próba odczytu bitmapy wskazanej w DESK.CFG nie powiodła się
-	DESK3.OBJ – procedura obsługi okien, sprite’ów, fontów itd.
-	LOAD03.OBJ – główna procedura ładowania plików wykonywalnych
-	ICONS_A.PIN – plik zawierający bitmapy wszystkich ikon – matryca 32x32 pixeli, 32 sztuki
-	ICONS_D.PIN – systemowe nazwy ikon używanych przez desktop
-	MENU.PIN – lista nazw do wyświetlania, ścieżek oraz nazw plików do uruchomienia dla opcji MENU
-	MAIN.TD0 – program główny Desktopu
-	CLOCK.TDX – program przeznaczony dla GUI; w chwili obecnej nie dokończony.
-	INFO.TDX - program przeznaczony dla GUI; informacja o autorach, oraz wersji programu
-	MOUSECFG.TDX - program przeznaczony dla GUI; konfigurator myszy.
-	SCRCFG.TDX - program przeznaczony dla GUI; w chwili obecnej nie dokończony.

•	Pliki programu instalacyjnego:
-	SETUP.COM – program ładujący i uruchamiający instalację;
-	SETUPSDX.BIN – plik zawierający procedury instalacyjne;
-	XUNZIP.EXE – program rozpakowujący archiwa ZIP, autor: Epi;
-	*.ZIP – archiwa z pakietami instalacyjnymi;
-	*.DAT – pliki z danymi o pakietach instalacyjnych;
-	AUTOEXEC.BAT, CONFIG.SYS – pliki z konfiguracją startową;
-	README.TXT – uwagi dotyczące instalacji, są one wyświetlane po jej uruchomieniu.

MINIMALNE WYMAGANIA SPRZĘTOWE:

•	CPU 6502
•	SIO2PC lub inne źródło odczytu instalatora programu
•	128kB RAM
•	Sparta DOS 4.20
•	Mysz – standard Atari ST / TRAK-BALL lub Amiga podpięte do portu 2
•	1 MB wolnej przestrzeni dyskowej

ZALECANE WYMAGANIA SPRZĘTOWE:

•	CPU 65c816 (dowolna modyfikacja oparta o 16-bit procesor) 
•	KMK/IDE'a hard disk interface, CF adapter/CF (szybszy czas dostępu)
•	1024kB RAM
•	Sparta DOS X 4.3
•	Mysz – standard Atari ST / TRAK-BALL lub Amiga
•	ARC clock/Pasiu SSG
•	SIO2PC – (przy instalacji)
•	3 MB wolnej przestrzeni dyskowej :)

Szczególnie rekomendowane są 65c816, KMK/JŻ IDE lub IDEa z kartą Compact Flash. Zapewnia to m.in. bardziej komfortową pracę, ze względu na przyśpieszony zapis pliku tymczasowego na ramdysku przez 16 bitowy procesor. W przyszłości przewiduje się również wsparcie dla karty przyśpieszającej, zawierającej procesor 65c816, szybszy zegar oraz większą ilość pamięci liniowej oraz dla innych interesujących rozwiązań sprzętowych (VideoBoard XE ?? ) – czas zweryfikuje te zamierzenia. 

Autorzy:

Epi, Pin – kod programu głównego, programy pomocnicze
Trub – kod instalatora
Draco (KMK) – loader plików wykonywalnych
Xan – troche ikonek
Pin, Epi – idea programu
Pin, Trub – wypociny, które być może nieopatrznie przeczytałeś
Podziękowania za pomoc przy testowaniu programu: Dely, Piguła, Pasiu.

TRS DESKTOP został napisany i skompilowany pod Turbo Basic XL.

Program nie jest jeszcze upubliczniony - obecnie w fazie betatestów.

    * Pulpitów do max 20 sztuk - każdy zapisany w pliku zaopatrzonym w rozszerzenie *.dsk.
    * Każdy z desktopów - full konfigurowalny; dowolne położenie ikon, każdy ze skrótów prowadzi do programu zapisanego na twardzielu w zakresie napedów D1:-D9:
    * Dla każdego programu uruchamianego tą metodą ustalany jest oddzielnie katalog roboczy (D: - więc KAŻDY uruchomiony program pracuje niejako oddzielnie.
    * Menu podręczne, czy jakże popularne dziś windowe menu - zawiera konfigi, oraz kilka co bardziej potrzebnych rzeczy.
    * Wsparcie dla ARCCLOCK - w prawym dolnym rogu zawsze aktualny czas. Jak na razie program nie działa poprawnie z R-Time8.
    * Wsparcie dla: amigamouse, atariSTmouse (w trybie jednoprzyciskowym), oraz Atari Trak-BALL - 2 klawiszowe. Opcja emulacji myszy (trakballa) dwuprzyciskowej. Obsługa Joya z przyczyn oczywistych niestety nie zostanie nigdy zaimplementowana (pozostaje opcja - "napisz se").
    * Program uruchamia normalne pliki wykonywalne, uruchamia też programy specjalnie napisane pod desktop.
    * Całość pracuje w trybie "gr8" - text wyświetlany w trybie 80 col.
    * Program napisany w TURBO-BASICU, oczywiście w raz z małym wsparciem ze strony kodu "maszynowego" - jednakże sposobem działania nie powoduje problemów z głównym układem nerwowym - tak jak ma to miejsce w przypadku innych "wiodących" tego typu produktów. Wszystkie strategicznie ważne procki (rysowanie ikon, obsługa 80-kolumnowego txt, mysz) napisane są w postaci wstawek kodu maszynowego.
    * Przy standartowym filesystemie SDX rekomendowana jest obecność ramdysku - najlepiej przeznaczonego dla procesorów 65c816. Ster do ramdysku rozpoznaje typ procesora.
    * Zaimplementowano jakże popularne i lubiane bluescreeny.
    * Program jest Grzybsono-odporny - tzn. docelowo będzie działać w postaci skompilowanej. 

Diabeł tkwi w szczegółach - więc przed upublicznieniem pierwszej wersji planowany jest instalator, który dopasuje konfiguracje programu odpowiednio do posiadanego sprzętu (detekcja wersji Sparta DOS, rodzaju interface'u HDD, zainstalowanie odpowiednich plików konfiguracyjnych SDX, detekcja zegara). Instalator będzie korzystał z depakera ZIP.

wymagania zalecane:

    * CPU 65c816
    * KMK/IDE'a hard disk interface, CF adapter/CF (szybszy czas dostępu)
    * 1024kB RAM
    * Sparta DOS X 4.31
    * ARC clock/Pasiu SSG
    * 16MB wolnej przestrzeni dyskowej :) 

wymagania minimalne:

    * CPU 6502
    * SIO2PC
    * 128kB RAM
    * Sparta DOS X 4.20
    * 1MB wolnej przestrzeni dyskowej :) 
    * mysz Atari ST/Amiga lub Atari Track-ball wpięte do portu 2.

... lecz taki konfig nie gwarantuje komfortowych warunków pracy :D

Autorzy: program główny: Epi/Trs, Pin/Trs, nieoceniona pomoc: Draco/ind. - sdx loader, Xan/Trs - troche ikonek.