     **********************************************************************
     * Dokumentation zu SHARP-Archiv 1.1.1           - R.Tracht  13.04.94 *
     **********************************************************************

     0. Neu in Version 1.1.1
     =======================

        Eigener Menpunkt zum ffnen von ASCII-Dateien.
        Probleme mit dem Fileselector behoben.
        'Anwendung anmelden' fr *.BAS-Dateien funktioniert jetzt.
        Fehler in der Checksummenroutine korrigiert.
        Mehr Datentypen werden erkannt.
        Einige kleinere Bugfixes.
        Verbesserung des Kabels zum Schutz der Sharp-Elektronik (2 Wider-
        stnde).


     1. Allgemeines
     ============== 

        SHARP-Archiv ermglicht Datensicherung und Programmentwicklung fr 
        Sharp Pockets der Typen PC-12xx, 13xx, 14xx mit dem Atari ST.
        Bentigt nur ein Verbindungskabel.
        Kommt ohne Software fr den Sharp aus.


        Einige Plus- und Minuspunkte:

        + Ist ein GEM-Programm
        + Bentigt nur minimale Hardware (nur ein Verbindungskabel)
        + Es werden die normalen Sharp-Befehle (CSAVE, CLOAD) benutzt. Fr 
          den Sharp ist keine Software ntig.
        + Erstellen und editieren von Sharp-Programmen ist mit jedem Atari-
          Editor mglich.
        + Vorhandene ASCII-Listings von BASIC-Programmen knnen zum Sharp 
          gesendet werden.
        + Programme knnen zwischen verschiedenen SHARP-Typen ausgetauscht 
          werden.
        + SHARP-Archiv ist Shareware (10 DM Registriergebhr)

        - Beim Datentransfer wird die Druckerschnittstelle belegt
        - Whrend des eigentlichen Datentransfers wird jegliches Multitask-
          ing unterbrochen (auch Mag!X)!

        Das erste vom Sharp empfangene Byte kennzeichnet den Datentyp. In 
        der vorliegenden Programmversion werden die Typen &20, &21, &70 und 
        &71 als Basic-Programm dekodiert. Mglicherweise gibt es noch 
        weitere Basic-Datentypen (Wer hat Infos?).

        Die vom Sharp empfangenen Daten oder geffnete Dateien drfen 
        maximal 32000 Byte lang sein. Von Basic-Programmen werden maximal 
        1000 Programmzeilen angezeigt.

        SHARP-Archiv ist ein GEM-Programm. Es kann im Desktop mit 
        "Anwendung anmelden" fr *.SHA- oder *.BAS-Dateien angemeldet 
        werden.

        Erprobte Atari-Sharp-Kombinationen stehen im Abschnitt 5.4.3

        Falls jemand Bremsfaktoren fr weitere Sharp-Atari-Kombinationen 
        erprobt hat oder neue Token-Dateien erstellt hat, wre es nett wenn 
        er mir diese zur Weiterverbreitung zur Verfgung stellen wrde.


     2. Nutzungsbedingungen
     ====================== 

        SHARP-Archiv ist ein Shareware-Programm.
        Das Programmpaket besteht aus folgenden Dateien:

        \SHARP.111\SHARP.PRG        - Hauptprogramm
        \SHARP.111\SHARP.RSC        - Ressource-Datei
        \SHARP.111\SHARP.INL        - Assemblerroutine des Hauptprogramms
        \SHARP.111\SHARP.TXT        - Diese Dokumentation
        \SHARP.111\SHARP.UPL        - Kurz-Info fr den Mailbox-Upload
        \SHARP.111\SHA\TOKEN.SHA    - Sharp-Programm zur Token-Ermittlung
        \SHARP.111\BAS\TOKEN.BAS    - ASCII-Listing von TOKEN.SHA
        \SHARP.111\TOK\1245_51.TOK  - Token-Datei fr Sharp PC-1245/51
        \SHARP.111\TOK\1350.TOK     - Token-Datei fr Sharp PC-1350
        \SHARP.111\TOK\1401_02.TOK  - Token-Datei fr Sharp PC-1401/02
        \SHARP.111\TOK\1403.TOK     - Token-Datei fr Sharp PC-1403
        \SHARP.111\TOK\1450.TOK     - Token-Datei fr Sharp PC-1450
        \SHARP.111\TOK\MAKE_TOK.PRG - Zur Erstellung von Token-Dateien
        \SHARP.111\TOK\PR_TOK.PRG   - Zum Ausdruck von Token-Dateien

        SHARP-Archiv darf nur komplett weitergegeben werden.

        Alle Rechte liegen beim Programmautor.

        Falls das Programm nach einer vierwchigen Testzeit weiterhin 
        genutzt werden soll, so mu der Sharewarebeitrag von 10 DM an den 
        Autor gezahlt werden. Der gezahlte Beitrag erlaubt die Nutzung von 
        zuknftige Versionen von SHARP-Archiv. Bei Nichtbezahlung ist das 
        Programm genauso eine Raubkopie, wie illegale Kopien von kommer-
        ziell vertriebener Software.

        Fr etwaige Schden, die durch die Benutzung des Programms oder des 
        Kabels entstehen, bernehme ich keine Haftung.

        Zahlungen entweder in bar, per Scheck oder als berweisung an:

        Anschrift:      Rainer Tracht
                        Badstr. 9
                        D-33189 Schlangen

        Bankverbindung: Sparkasse Detmold
                        Bankleitzahl: 47650130
                        Kontonummer: 127001436
                        Verwendungszweck: SHARP-ARCHIV (evtl. Anschrift)

        MausNet:        RAINER TRACHT @ PB
        E-Mail:         rainer_tracht@pb.maus.de  (keine Mails > 16 KB !!!)

        ffentliche Diskussionen zu SHARP-Archiv bitte in der MausNet-
        Gruppe 'POCKETS' fhren, da ich 'ATARI.SOFT' nicht stndig lese.

        Die jeweils neueste Programmversion kann in der QUARK-Mailbox 
        Paderborn (05251/71409; Gastdownload mglich) im Brett 305 (ST-
        Software) gesaugt werden.


     3. Verbindungskabel
     =================== 
      
        Zur Nutzung von SHARP-Archiv ist ein Kabel erforderlich, welches 
        die Druckerschnittstelle des ATARI mit der 11-poligen Anschlu-
        leiste des SHARP verbindet:


                      Atari ST:                       Sharp:
                Druckerschnittstelle         11-polige Anschluleiste

        +----------------------------------------+ 
        |                         +---[10k]----+ |    M  LS
        |                         | +-[10k]--+ | | ------------- 
        |    ---------------------|-|---     | | | |OOOOOOOOOOO|
        | 13 \O O O O O O O O O O O O O/ 01  | | | ---|--||----- 
        |  25 \O O O O O O O O O O O O/ 14   | | +----+  ||
        |      --------------|--------       | +---------+|
        +--------------------+               +------------+

        Es ist jeweils die Ansicht auf die Schnittstelle dargestellt.


        Material: 1 Sub-D-Stecker 25-polig
                  1 Stiftleiste 11-polig
                  1 Kabel 3-polig
                  2 Widerstnde 10k

        Hinweise: Die beiden Widerstnde sind zum Betrieb von SHARP-Archiv 
                  nicht unbedingt erforderlich. Die SHARP-Elektronik wird 
                  dadurch wirkungsvoll geschtzt (mir ist allerdings nicht 
                  bekannt, da ohne diese Widerstnde Schden aufgetreten 
                  sind). Da der Aufwand gering ist, sollten sie sicher-
                  heitshalber eingebaut werden (am einfachsten ins Stecker-
                  gehuse).

                  Es ist sinnvoll am Sharp-Stecker einen mechanischen 
                  Schutz gegen verdrehtes Einstecken anzubringen.




     4. Installation
     =============== 

        Die Dateien SHARP.PRG, SHARP.RSC und SHARP.INL sowie die Ordner 
        BAS, SHA und TOK mssen sich in einem Ordner (oder im Hauptver-
        zeichnis des Laufwerks) befinden. Vorhandene *.BAS-, *.SHA- oder 
        *.TOK-Dateien sollten sich in den entsprechenden Ordnern befinden. 
        SHARP.PRG starten und im Men "Einstellungen" den Befehl "Pfad:" 
        anklicken. Mit dem Dateiauswahldialog die Datei "SHARP.PRG" auswh-
        len. Im Men "Einstellungen" den Befehl "Sharp:" anklicken und die 
        dem eigenen Sharp entsprechende *.TOK-Datei auswhlen. Im Men 
        "Einstellungen" den Befehl "Einstellungen sichern..." whlen und 
        Grundeinstellung als "SHARP.INF" speichern.


     5. Programmbedienung
     ==================== 

        SHARP-Archiv ist ein GEM-Programm. Die Bedienung der GEM-Elemente 
        (Mens, Alertboxen, Fenster) sollte daher keine Probleme bereiten. 
        In dieser Dokumentation sind nur die Programmfunktionen erklrt.


     5.1. Men "SHARP-Archiv"
     ------------------------ 

          Wie blich: Programm-Info und Accessories.


     5.1.1. Befehl "ber SHARP-Archiv..."

            Es erscheint die Info-Alertbox des Programms


     5.2. Men "Datei"
     ----------------- 

          Befehle zum ffnen, sichern und drucken von Sharp-Daten, sowie 
          zum beenden des Programms.


     5.2.1. Befehl "ffnen..."

            ffnet Dateien im Sharp-Format. Falls die geffnete Datei als 
            Basic-Programm dekodiert werden kann, wird es in einem GEM-
            Fenster dargestellt, andernfalls erscheint eine Alertbox die 
            Datentyp und Datenlnge anzeigt.
            Die Breite des Fensters richtet sich nach der im Einstellungen-
            Men eingestellten Druckbreite. Zu lange Zeilen werden umge-
            brochen und um zwei Zeichen eingerckt.


     5.2.2. Befehl "Sichern..."

            Eine geffnete *.SHA-Datei oder ein vom Sharp empfangenes 
            Programm wird als *.SHA-Datei gespeichert. Ein evtl. vom Sharp 
            empfangener Programmname wird als Vorauswahl im Dateiauswahl-
            dialog eingetragen.


     5.2.3. Befehl "ASCII-ffnen..."

            ffnet Dateien im ASCII-Format. ASCII-Dateien werden nach dem 
            ffnen zunchst ins Sharp-Format umgewandelt (das dauert seine 
            Zeit) und anschlieend genau wie geffnete *.SHA-Dateien behan-
            delt. Je nach eingestellter *.TOK-Datei wird der Programmtyp 
            ausgewhlt und eine evtl. notwendige Umwandlung von Kleinbuch-
            staben durchgefhrt. Zwischen der Zeilennummer und dem ersten 
            Befehl mu sich mindestens ein Leerzeichen befinden.


     5.2.4. Befehl "ASCII sichern..."

            Ein Basic-Programm kann als ASCII-Datei (*.BAS) gespeichert 
            werden. Bei langen Programmzeilen wird kein Umbruch durchge-
            fhrt. Die Datei kann als Quelltext fr andere Basic-Interpre-
            ter dienen oder mit einer Textverarbeitung in Dokumente inte-
            griert werden.


     5.2.5. Befehl "Drucken"

            Ein im Fenster angezeigtes Basic-Programm kann auf einem 
            Drucker ausgegeben werden. Die Einstellungen fr Druckbreite 
            und linkem Rand im Einstellungen-Men werden bercksichtigt. Zu 
            lange Zeilen werden umgebrochen und um zwei Zeichen eingerckt.


     5.2.6. Befehl "Ende"

            Das Programm wird sofort beendet. Bei geffnetem GEM-Fenster 
            kann auch durch anklicken des Schliefeldes ein Programmende 
            erreicht werden.


     5.3. Mentitel "Transfer"

          Die Befehle dieses Mens ermglichen den Datentransfer zwischen 
          Atari und Sharp. Dazu mu natrlich das Verbindungskabel instal-
          liert sein. Whrend der bertragung werden fast alle anderen 
          Aktivitten (Interrupts) des Ataris gesperrt (keine Maus, keine 
          Tastaturklicks, kein Multitasking!!!).


     5.3.1. Befehl "Sharp -> Atari"

            Daten werden vom Sharp empfangen. Falls die empfangenen Daten 
            als Basic-Programm dekodiert werden knnen, wird es in einem 
            GEM-Fenster dargestellt, andernfalls erscheint eine Warnmeldung 
            mit der Mglichkeit eine Dekodierung zu erzwingen. Die Breite 
            des Fensters richtet sich nach der im Einstellungen-Men eingestell-
            ten Druckbreite. Zu lange Zeilen werden umgebrochen und um zwei 
            Zeichen eingerckt. Ein vom Sharp gesendeter Programmname 
            (CSAVE "name") wird bernommen. Pawrter (CSAVE ,"pass") 
            werden angezeigt.
            Auch undekodierte Daten knnen gesichert werden!
            Die Empfangsroutine synchronisiert sich selbstndig auf die 
            Geschwindigkeit des Sharps.


     5.3.2. Befehl "Atari -> Sharp"

            Eine geffnete Datei oder vom Sharp empfangene Daten werden zum 
            Sharp gesendet.
            Die Senderoutine ist Geschwindigkeitsabhngig. Fr einen feh-
            lerlosen Datenversand mu der Bremsfaktor im Einstellungen-Men 
            entsprechend der vorhandenen Atari-Sharp-Kombination einge-
            stellt sein!
            Sharp-Dateien vom Typ 20/21 knnen auch von Sharps die Typ 
            70/71 erzeugen gelesen werden. Soll ein Programmaustausch in 
            Gegenrichtung erfolgen, so mu dies ber eine ASCII-Datei 
            erfolgen. Dabei die Unterschiede zwischen den Basic-Dialekten 
            beachten (z.B.: gre von Zeilennummern und Laufvariablen).


     5.4. Mentitel "Einstellungen"
     ------------------------------ 

          Programmeinstellungen knnen verndert und gespeichert werden.


     5.4.1. Befehl "Pfad:"

            Der Pfad in dem das Programm seine Dateien und Ordner sucht 
            kann verndert werden. Dazu mit dem Dateiauswahldialog die 
            Datei "SHARP.PRG" auswhlen.


     5.4.2. Befehl "Sharp:"

            Eine zum entsprechendem Sharp passende *.TOK-Datei kann ausge-
            whlt werden. Diese Datei wird zur Dekodierung von Basic-
            Programmen bentigt.


     5.4.3. Befehl "Bremsfaktor:"

            Die Senderoutine ist von den Rechnergeschwindigkeiten abhngig. 
            Zum Ausgleich unterschiedlicher Geschwindigkeiten dient der 
            Bremsfaktor. Ein schneller Atari (16 MHz) erfordert einen 
            groen Bremsfaktor, ein schneller Sharp (z.B. PC-1260/61 oder 
            "getuned") erfordert einen kleinen Faktor.
            Zur Grobeinstellung kann mit "Messen" zunchst die Dauer des 
            Sharp-Headertons (das ist der langanhaltende Ton zu Beginn 
            einer Datenbertragung) gestoppt werden. SHARP-Archiv errechnet 
            sich daraus den erforderlichen Bremsfaktor.
            Mit "ndern" erfolgt die Feinjustierung. Dazu die Faktoren 
            ermitteln bei denen eine erfolgreiche Datenbertragung statt-
            findet. Der Mittelwert ist der gesuchte Bremsfaktor.

            Erprobte Kombinationen:

            ATARI           |SHARP:                                |FAKTOR:
            ----------------|--------------------------------------|-------
            ST(E)           |1245/51 1401/02/03                    |~80
            ST(E)+SpeedUp16 |1245/51 1401/02/03                    |~123
            ST(E)+HBS210    |1260/61 1350 1450                     |~191
            MegaSTE 16MHz   |1260/61 1350 1450                     |~80


     5.4.4. Befehl "Zeichensatz:"

            Verndert die Textdarstellung im GEM-Fenster. Einer der drei 
            Systemzeichenstze kann eingestellt werden.


     5.4.5. Befehl "Zeilenlnge:"

            Beeinflut Bildschirm- und Druckerausgaben. Die Zeilenlnge ab 
            der ein Umbruch erfolgt kann verndert werden. Die Breite des 
            GEM-Fensters wird entsprechend verndert.


     5.4.6. Befehl "Linker Rand:"

            Die Breite des linken Randes bei Druckerausgaben kann verndert 
            werden. Hat keinen Einflu auf Bildschirmausgaben.


     5.4.7. Befehl "Einstellungen laden..."

            Die Einstellungen einer *.INF-Datei werden geladen.


     5.4.8. Befehl "Einstellungen sichern..."

            Die Einstellungen der Befehle des Einstellungen-Mens werden in 
            der einer *.INF-Datei gesichert. Wird diese Datei SHARP.INF 
            genannt, so werden ihre Einstellungen beim nchsten Programm-
            start automatisch geladen.


     6. Erstellung von Token-Dateien
     ===============================

        Wenn fr den vorhandenen Sharp noch keine gleichnamige Token-Datei 
        existiert und mit den vorhandenen *.TOK-Dateien Befehle oder 
        Zeichen von dekodierten Basic-Programmen nicht korrekt angezeigt 
        werden, so ist es notwendig sich eine eigene Token-Datei zu 
        erstellen.


     6.1. Das Sharp-Programm TOKEN.SHA
     --------------------------------- 

          Dies Programm dient zur Ermittlung der Token-Codes eines Sharp. 
          Als Startadresse sollte zunchst die Anfangsadresse des Sharp-
          RAMs eingegeben werden (falls unbekannt 0 eingeben, danach ist 
          der Sharp einige Minuten beschftigt). Nach etwas Gepiepse wird 
          die ermittelte Adresse angezeigt. Diese Adresse sollte man bei 
          erneutem Programmstart als Startadresse eingeben. Danach wird ein 
          Startcode erfragt. Ab diesem Token-Code werden jetzt Token-Code 
          und Token angezeigt. Nach ENTER wird das nchste Token angezeigt. 
          Vor und hinter dem Token mu jeweils ein Doppelpunkt stehen. 
          Falls das Programm bei bestimmten Codes mit Fehlermeldung 
          abbricht, handelt es sich um Steuerzeichen (dafr in MAKE_TOK.PRG 
          ein Leerzeichen eingeben). Falls nur ein Doppelpunkt nach dem 
          Token-Code angezeigt wird, so ist das Anfhrungszeichen das 
          gesuchte Token.
          TOKEN.SHA ist vom Programmtyp 70. Es wurde auf einem PC-1401 
          geschrieben. Fr Rechner deren Codierung vom ASCII Standard 
          abweicht (PC-1245/51) sind nderungen notwendig!


     6.2. Das Programm MAKE_TOK.PRG
     ------------------------------ 

          Damit ist es mglich, sich auf der Basis einer vorhandenen Token-
          Datei, eine zum vorhandenen Sharp passende Datei zu erstellen. 
          Man sollte als Basis die Token-Datei whlen mit der die besten 
          Ergebnisse erzielt werden. Fr unbenutzte Token bzw. Zeichen 
          mssen Null-Bytes eingegeben werden. Bei Befehlen die nicht am 
          Zeilenanfang stehen (z.B. THEN, TO, STEP, ROT) ist ein vorange-
          stelltes Leerzeichen ntzlich. Es mssen immer alle Token neu 
          eingegeben werden. Jedoch kann das alte Token mit RETURN oder 
          ENTER unverndert bernommen werden. Nach einer Tilde (~) knnen 
          ATARI-ASCII-Codes als Zahlenwerte eingegeben werden.
          Bei Multitasking-Betriebssystemen sollte MAKE_TOK im jeweiligen 
          VT52-Emulator laufen und evtl. im Single-Modus gestartet werden.


     6.3. Das Programm PR_TOK.PRG
     ---------------------------- 

          Der Inhalt einer Token-Datei kann damit auf dem Drucker ausgege-
          ben werden.



     7. Danke
     ========

        Mein Dank geht an alle die mich mit Hardware, Kritik, Informationen, 
        Token-Dateien und Shareware-Beitrgen (vielleicht bezahlt ja mal 
        jemand) versorgt haben oder es noch tun werden.


