@DATABASE "Alcuin" @AUTHOR "Stephan Schupfer" @(C) "1996 Stephan Schupfer" @$VER: Alcuin.guide 1.0 @NODE MAIN "Alcuin Usage Guide" @{b}ALCUIN@{ub} Version 1.0 Ein Saturn CPU Emulator für Amiga Computer um HP 48 S/SX/G/GX Taschenrechner zu emulieren © Copyright 1996 Stephan Schupfer @{" Überblick " LINK Overview} Was ist und kann Alcuin ? @{" Registrierung " LINK Registration} Einschränkungen der unregistrierten Version @{" Support " LINK Support} Wo findet man Alcuin ? @{" Installation " LINK Installation} Wie intalliert man Alcuin ? @{" Benutzung " LINK Using} Wie benutzt man Alcuin @{" Hinweise zur Emulation " LINK About} Dinge die man wissen sollte @{" Bugs " LINK Bugs} Bekannte Fehler @{" Rechtliches " LINK Legal} Copyright etc.. @{" Fehlerreport " LINK BugReports} Wie melde ich Fehler ? @{" Danksagungen " LINK Thanks} Der Autor bedankt sich @{" Der Autor " LINK Schupfer} Über den Programmierer @{" History " LINK History} Entwicklungsgeschichte @{" Zukunft " LINK Future} Zukunft von Alcuin @ENDNODE @NODE Overview "Überblick" @{b}Alcuin@{ub} ist ein multitasking-fähiger HP48 CPU Emulator für Amiga Computer. Der Emulator läuft als normaler Task unter dem Amiga OS, sodaß der Amiga und Alcuin gleichzeitig benutzt werden können. Wenn Sie eine Kopie des ROM eines HP 48 (S/SX/G/GX) Taschenrechners haben, können Sie diesen Taschenrechner auf Ihrem Amiga emulieren. @{b}Achtung@{ub} ------- Dieser Emulator erlaubt Ihnen eine vollständige Nachbildung des HP48 zu erzeugen. Um dies zu bewerkstelligen benötigt man jedoch eine Kopie des ROM von IHREM Taschenrechner. Um einen Gesetzesbruch zu vermeiden und die Firma HP nicht zu verärgern MÜSSEN SIE EIN STOLZER BESITZER EINES HP48 SEIN bevor Sie dieses Programm benutzen. @ENDNODE @NODE Registration "Registrierung" Alcuin ist SHAREWARE. Um Ihnen die Entscheidung, die geringe Gebühr zu bezahlen, zu erleichtern hat die unregistrierte Version einige Einschränkungen: · Kein Filetransfer wird unterstützt. · Der Emulator lädt nicht die Zustandsdatei, daher wird bei jedem Start des Programms ein Reset ausgeführt, was einige Zeit benötigt. ( Mit der Zustandsdatei ist der Emulator bei einem neuen Start sofort zum Weiterarbeiten an der Stelle bereit, an der man zuletzt aufgehört hat.) Die Sharewaregebühr beträgt ATS 200.- oder DM 30.- oder US$ 20.- innerhalb von Europa. Außerhalb von Europa beträgt die Gebühr US$ 25.-. Registrierte Benutzer erhalten ein persönliches Keyfile, welches sie in die Lage versetzt, die fehlenden Funktionen zu aktivieren. Dieses Keyfile wird auch mit zukünftigen Versionen von Alcuin funktionieren, sodaß registrierte Benutzer die jeweils neueste, frei kopierbare Version herunterladen können. Wie wird man registrierter Benutzer ? Der einfachste Weg ist, die beigefügte Datei "Bestellformular" auszufüllen, auszudrucken, zu unterschreiben (wenn möglich in dieser Reihenfolge), es in ein Kuvert zu stecken, zusammen mit der Gebühr, und an @{"mich" LINK Schupfer} zu senden. Ich werde keine Bestellungen akzeptieren, welche nicht unterschrieben sind. Das Keyfile wird Ihnen entweder in uuencodierter Form via EMail (bevorzugt) oder auf einer Diskette (wie sie es wünschen) zugesandt. @ENDNODE @NODE Support "Support" Die neuesete Version von Alcuin befindet sich im AMINET im Verzeichnis: misc/emu Ich denke auch darüber nach, eine Seite über Alcuin meiner Homepage im WWW beizufügen. http://www.ping.at/members/schupfer/ oder http://www.sbox.tu-graz.ac.at/home/schupfer/ @ENDNODE @NODE Installation "Installation" Sehen Sie zuerst nach was @{"benötigt" LINK Need} wird, um in der Lage zu sein Alcuin auf Ihrem Computer zu starten. Um Das Programm auf Ihrer Harddisk zu installieren, benutzen Sie bitte das beigefügte Installationsprogramm. Danach @{" Erzeugen Sie eine Kopie des ROM Ihres HP48" LINK CopyROM}. Die erzeugte Datei wird rom.dump heißen. Benennen Sie diese in Alcuin_ROM um und kopieren Sie sie in das Verzeichnis, welches von Ihrem Installations- programm erzeugt wurde. (Alcuin:) Nun sind Sie in der Lage den Emulator zu starten. @ENDNODE @NODE CopyROM "Wie man eine Kopie des ROM erzeugt" Wie man eine Kopie des ROM erzeugt ================================== Der Emulator arbeitet nach dem Prinzip, daß er ein Ebenbild des ROM eines HP48 ausführt. Um den Emulator benutzen zu können be- nötigen Sie deshalb eine Version des ROM auf Ihrem Computer. ********************************************************************** * Sie impliziert das HIDDEN ROM. Bitte verwenden Sie keine DUMP Pro- * * gramme, welche nicht auch das HIDDEN ROM auslesen. Ansonsten wird * * der Emulator nicht funktionieren. * ********************************************************************** Um eine Kopie des ROM zu erhalten machen Sie folgendes: - Laden Sie die Datei 'romdump/ROMDump' in Ihren HP48. - Um die Daten zu empfangen starten Sie das Programm Kermit, oder ein anderes Terminal Programm welches in der Lage ist das Kermit Protokoll zu emulieren, auf Ihrem Computer, verbinden Sie Ihren Computer mit dem Taschenrechner. Setzen Sie die Baudrate auf 9600 und schalten Sie "log session" an um die empfangenen Daten zu speichern. Danach starten die Verbindung. - To capture a complete ROM, start kermit, or any other terminal programm which is capable to emulate the kermit protocol, on your computer, set the speed to 9600 baud and type 'log session', then 'connect'. - Auf einem HP48 S/SX Taschenrechner tippen Sie '#0h #7FFF0h ROMDump' ein, auf einem HP48 G/GX Taschenrechner tippen Sie '#0h #FFFF0h ROMDump' ein. Es wird nun das ROM von Ihrem Taschenrechner zu Ihrem Computer übertragen. Dieser Vorgang wird in etwa 15 Minuten auf einem S/SX Taschenrechner, 30 Minuten auf einem G/GX Taschenrechner benötigen. - Wenn der Vorgang beendet ist speichern Sie, falls notwendig die log-datei ab und beenden das Terminalprogramm. Das ROM sollte sich nun in einer Datei, die 'session.log' oder so ähnlich heißt befinden. Diese Datei enthält Zeilen, wie diese folgende: #00000:2369B108DADF1008 ... Diese müssen nun in eine Binärdatei konvertiert werden, welche hernach das ROM für Alcuin darstellt. Starten Sie den Befehl: `dump2rom session.log` Dieser konvertiert den Dump in eine ROM-datei, welche für den Emulator lesbar ist und 'rom.dump' heißt. ÜBERPRÜFEN Sie die Datei mit dem Befehl 'checkrom' Tippen Sie 'checkrom rom.dump' ein. Daraufhin antwortet der Computer mit: ROM Version is HP48-A ROM CRC reads 0xcb76 (für Rev. A, wird für andere Versionen anders lauten) IROM OK: ROM CRC test passed. oder mit: ROM Version is HP48-R ROM CRC 1 reads 0xdfed (für Rev. R, wird für andere Versionen anders lauten) ROM CRC 2 reads 0xf0b1 ( --- " --- ) IROM OK: ROM CRC test passed. Sollte dieser Test fehlschlagen, dann ist während der Übertragung etwas schiefgelaufen. Machen Sie nicht den Fehler nun über die Größe oder das Aussehen der Nibbles in der Datei 'rom.dump' nachzudenken, sondern versuchen Sie die Übertragung einfach nochmal. Wenn Sie jedoch etwas besser bescheid wissen, können Sie natürlich nur den defekten Teil der Datei 'rom.dump' übertragen (z.B.: '#60000h #60080h ROMDump') und diese Zeilen in der Datei 'session.log' wiederherstellen. @ENDNODE @NODE Need "Was wird benötigt" Um Alcuin zu verwenden benötigen Sie: · Ihr Amiga muß zumindest mit einem 68020 Prozessor ausgestattet sein. ( Alle Programme wurden für 68020-40 CPUs compiliert. Ich denke mit einer weniger leistungsfähigen CPU als einem 68020, der Emulator wird zu langsam sein um brauchbare Ergebnisse zu liefern. Ich weiß nicht ob der Emulator mit einer 68060 CPU funktioniert. Sollte jemand damit Erfahrungen machen, würde ich gerne davon hören. - Insbesonders was die Geschwindigkeit betrifft !) · Der Amiga muß zumindest Kickstart 2.04 und Workbench 2.1 verwenden. · Ein HP 48 (S/SX/G/GX) Taschenrechner um eine legale Kopie des ROM zu erhalten. · Ein serielles Verbindungskabel, um Ihren Computer mit dem HP 48 zu verbinden. @ENDNODE @NODE Using "Benutzung von Alcuin" Benutzung von Alcuin -------------------- @{" Start von der Worbench " LINK WBStart} @{" Start vom CLI " LINK CLIStart} @{" Erzeugen einer Kopie des ROM " LINK CopyROM} @{" Die Tastatur " LINK Keyboard} @{" Das Menü " LINK Menu} @{" Übertragen von Dateien " LINK Transfer} @{" Verwenden von RAM und ROM Steckkarten " LINK RAMCards} @ENDNODE @NODE WBStart "Start von der Workbench" @{b}Workbench :@{ub} Setzen Sie die Tooltypes entsprechen Ihrer Konfiguration und machen Sie einen Doppelklick auf dem Icon. ACHTUNG: Wird die Konfiguration der RAM bzw ROM-Module verändert muss der Emulator vorher in ausgeschaltetem Zustand beendet worden sein, da ansonsten der Speicherinhalt von des emulierten HP48 verloren gehen kann. Folgende Optionen können Sie mit den Tooltypes wählen: · DOUBLE_SIZE Wenn dieser Tooltype gesetzt wird, wird alles doppelt so groß dargestellt. Diese Option ist speziell für Benutzer von Grafikkarten, die eine große Bildschirmgröße, wie 1024x768 oder mehr verwenden. · COMPACT Diese Option erzeugt ein kompakteres Aussehen des Emulators, welche für nicht so hohe Screengrößen besser ist. · RESET Der Emulator vollführt einen Reset während des Starts. · INITIALIZE Der Emulator versucht die Zustandsfiles von der Festplatte zu lesen. Diese sind Alcuin_State und Alcuin_RAM. · PORT1=RAM ( or ROM ) Der Emulator simuliert eine Einsteckkarte im Port1 und versucht die Datei Alcuin_PORT1 von der Festplatte zu lesen. Sie können zwischen RAM und ROM Karten unterscheiden. · PORT2=RAM ( or ROM ) Der Emulator simuliert eine Einsteckkarte im Port2 und versucht die Datei Alcuin_PORT1 von der Festplatte zu lesen. Sie können zwischen RAM und ROM Karten unterscheiden. · SERIAL=serial.device Wählen Sie Ihr persönlich bevorzugtes serial.device (z.B: SERIAL= serial.device) für die serielle Schnittstelle. Wenn Sie keine Auswahl treffen verwendet der Emulator serial.device. · UNIT=0 Wählen Sie die Einheit der seriellen Schnittstelle (z.B: UNIT=0). Wenn keine Auswahl getroffen wird verwendet der Computer Unit 0. Die maximale Nummer ist 3. · XPOS=100 Geben Sie die X-Koordinate für das Fenster von Alcuin an. (z.B.: 100) · YPOS=100 Geben Sie die Y-Koordinate für das Fenster von Alcuin an. (z.B.: 100) @ENDNODE @NODE CLIStart "Start vom CLI" @{b}CLI :@{ub} Alcuin [DOUBLE/S,COMPACT/S,RESET/S,INIT/S,P1=PORT1/K,P2=PORT2/K, SER=SERIAL/K,U=UNIT/N,X=XPOS/N,Y=YPOS/N,HELP/S] Die Optionen entsprechen den @{"Tooltypes" LINK WBStart} beim Start von der Workbench. · HELP Mit dieser Option erhalten Sie einen Überblick über alle möglichen Optionen. @ENDNODE @NODE Keyboard "Die Tastatur" Sie können Alcuin mit der Maus oder der Tastatur bedienen. Die Tasten A-Z entsprechen den Tasten A-Z auf Ihrer HP 48 im Alpha Modus. Sie werden keine Probleme haben die anderen Tasten zu finden. Hier sind einige spezielle Tasten: @{b}HP 48 G/GX/S/SX @{ub} HP Amiga ----------------------------- · alpha ........... Ctrl · shift left ...... Shift · shift right ..... Alt · ON .............. ESC Ich habe auch einige spezielle Funktionen auf den Funktionstasten belegt: · ON A F ...........F1 Reset · ON B .............F2 Oops (Unterbricht einen ON- command) · ON C .............F3 Warmstart · ON D .............F4 Testmode · ON E .............F5 Looping selftest · ON 4 .............F6 Cancel Alarm · ON 1 .............F7 Screen dump · ON + .............F8 Mehr Kontrast · ON - .............F9 Weniger Kontrast · ON SPC ...........F10 Coma mode @ENDNODE @NODE Menu "Das Menü" · über... ... Öffnet ein Info-Fenster über den Autor · Reset ... Vollführt einen Reset des Emulators · verbergen ... iconifiziert Alcuin · beenden ... beendet Alcuin ohne den Zustand zu speichern · beenden und speichern ... beendet Alcuin und speicher den aktuellen Zustand. Ein Schließen des Fensters mittels des CLOSE Symbols bewirkt ein Beenden von Alcuin @{b}UND@{ub} ein Speichern des aktuellen Zustandes. @ENDNODE @NODE Transfer "Übertragen von Dateien" Übertragen von Dateien ---------------------- Der HP 48 hat 2 Ports · wire (eine serielle Schnittstelle) · IR (eine eingebaute Infrarot Schnittstelle) Der Amiga hat, soweit ich weiß keine Infrarot Schnittstelle, daher werden Dateien die via IR oder wire übertragen werden, jeweils über die serielle Schnittstelle des Amiga übertragen. Sollte ein 2 serieller Port benötigt werden, werde ich über eine Implementation in einer der nächsten Version nachdenken. Um Dateien zu übertragen, verbinden Sie Iheren HP48 mit der seriellen Schnittstelle des Amiga. Nun können Sie Daten von und zu Alcuin übertragen. Solange der Emulator so langsam ist, ist es besser das Kermit Über- tragungsprotokoll zu verwenden, anstelle des Xmodem Protokolls. @ENDNODE @NODE RAMCards "Verwendung von Einsteckkarten" Verwendung von Einsteckkarten ----------------------------- Wird ein HP48S oder HP48G emuliert, so können Sie, wie auch bei dem realen Gerät keine Einsteckkarten verwenden. Wird ein HP48SX oder HP48GX emuliert, so können sie leere RAM Einsteckkarten mit dem beigefügten Programm 'mkcard' erzeugen. Wollen Sie Einsteckkarten verwenden (um z.B.: mehr Speicher zur Verfügung zu haben) benötigen Sie die richtigen Einstellungen in den Tooltypes oder Optionen beim CLI-Start, die die Karte auswählen. ACHTUNG ! Da bei einem realen HP48 die Einsteckkarten nur bei aus- geschaltetem Taschenrechner erfolgen sollen, ein Aus- schalten bei der Emulation jedoch meist nicht notwendig ist, sollten Sie unbedingt, wenn Sie die Einstellungen für Einsteckkarten verändern, Alcuin vorher in ausge- schaltenem Zustand "speichern und beenden". @{b}HP48GX@{ub} Wird ein HP48GX emuliert so haben Sie 2 Ports zur Verfügung. Port 1 hat die maximale Kapazität von 128KB und Port 2 hat eine maximale Kapazität von 4MB. Mit Hilfe der Tooltypes können sie zwischen RAM oder ROM Einsteck- karen wählen. Da ich jedoch keine ROM Einsteckkarten habe, kann ich über deren Erzeugung und Verwendung nichts sagen. Ich glaube jedoch, daß eine Erzeugung ähnlich der des HP48 ROM ist. Mit einer RAM Einsteckkarte in Port 1 können Sie RAM zu Ihrem System RAM hinzufügen. ( Für genauere Informationen halten Sie sich bitte an IHR Handbuch) @{b}HP48SX@{ub} 2 - 128kB RAM cards @ENDNODE @NODE About "Wissenwertes über die Emulation" Alcuin ist langsamer als ein realer HP48 :-(. Alcuin wurde auf folgenden Rechnern getestet: Amiga 2000, 1MB ChipRAM, 4 MB FastRAM + Derringer 40Mhz 68030, 66MHz 68882, 16 MB 32BitRAM + Picasso II with CybergraphX WB Emulation Es wurde sowohl Amiga Standard ECS als auch Cybergraphics 8-Bit Displays verwendet. Da ich selbst nur einen HP48GX habe, sind Erfahrungen über die Emulation von HP48(S/SX/G) spärlich. Ich bin daher an Erfahrungen mit diesen Systemen interessiert. @ENDNODE @NODE Bugs "Bekannte Fehler" · Aufgrund des Fehlens von Betatestern können Fehler durch andere Systeme bzw. Systemkonfigurationen auftreten. · Im Augenblick sind keine Fehler bekannt @ENDNODE @NODE Legal "Rechtliches" Das Programm "Alcuin", die "hp48.font" und diese Anleitung sind © Copyright 1996 Stephan Schupfer. Die Verteilung des Progamms ist frei solange folgende Regeln beachtet werden: - Alle Programme bzw Dokumentationen dürfen in keiner From verändert werden. - Das Paket wird immer in seiner gesamten Form verteilt. - Mit der Verteilung von Alcuin darf kein Gewinn erzielt werden. Speziell Disketten, welche Alcuin enthalten dürfen den Verkaufspreis von US$ 5,- nicht überschreiten (äquivalente Preise in anderen Währungen). - Es ist erlaubt Alcuin über Mailboxen und Netzwerke zu verteilen. - Das Programm darf in keinem kommerziellen Produkt vertrieben werden ohne die ausdrückliche, schriftliche Genehmigung des Autors. Alle Rechte einer kommerziellen Verwertung verbleiben bei dem @{"Autor" LINK Schupfer}. Die Programme "checkrom", "dump2rom", mkcard" und "ROMDump" sind © Copyright 1994 Eddie C. Dost und sind freie Software unter den Bedingungen der GNU General Public License, wie von der Free Software Foundation publiziert. Das Keyfile, welches registrierte Benutzer erhalten, darf @{b}nur@{ub} auf einem Computer installiert sein und @{b}auf keinen Fall@{ub} an andere weitergegeben werden. Ein Zuwiderhandeln wird von mir strafrechtlich verfolgt. Mit Ihrer Unterschrift auf dem Bestellformular, akzeptieren Sie diese Bedingungen. Das Programm wird dem Benutzer so zur Verfügung gestellt, wie es ist, ohne jegliche Garantie oder Haftung irgendeiner Art, sei es ausdrücklich oder implizit. Wer das Programm benutzt, erklärt sich damit einverstanden, jegliches @{b}Risiko@{ub}, das die Benutzung der Programme mit sich bringt, @{b}selbst zu tragen@{ub}. Der Autor haftet @{b}in keinem Fall@{ub} für Schäden, die direkt oder indirekt durch den Gebrauch oder Mißbrauch des Programms entstanden sind. Die zur Benutzung von Alcuin notwendige HP48-ROM-Datei ist nicht Teil von Alcuin und @{b}urheberrechtlich von HP geschützt@{ub}. Fur die rechtlichen Folgen, die die illegale Nutzung einer solchen ROM-Datei nach sich ziehen kann, übernimmt der Autor @{b}keinerlei@{ub} Verantwortung. "Amiga" and "Commodore" sind eingetragene Warenzeichen der Escom AG, Bochum. "HP" is a eingetragenes Warenzeichen der Hewlett-Packard Co. In dieser Anleitung und in Programmtexten erwähnte Hard- und Software- Bezeichnungen sind in den meisten Fällen geschützte Warenzeichen der jeweiligen Firmen und nicht als solche kenntlich gemacht. Aus dem fehlen eines solchen Hinweises darf also nicht geschlossen werden, daß es sich um einen freien Warennamen handelt. @ENDNODE @NODE BugReports "Fehlerreport" Achtung ! Bitte senden Sie mir keine Fragen bezüglich der Funktionsweise bzw. Benutzung des HP48, sondern lesen Sie hierfür Ihr Handbuch und/oder die FAQ diverser HP48 Newsgroups. Sollten Sie einen Fehler oder eine Fehlfunktion im Programm entdecken, oder sollten Sie Ideen haben um das Programm zu verbessern, dann lassen Sie mir bitte eine Nachricht zukommen, sodaß ich in der Lage bin die Funktion von Alcuin in der Zukunft zu verbessern. Meine Adresse finden Sie @{"hier" LINK Schupfer}. Wichtig für einen Fehlerreport sind folgende Angaben: · Version von Alcuin (wird angezeigt wenn man den Befehl 'version Alcuin' ausführt) · Verwendete Amiga Konfiguration ( z.B.: A4000,...,ECS, AGA, Cybergraphics,...,68030, ..,2MB Chip,..., OS 3.0,....,serial.device,.....) · Verwendete HP48 ROM Version ( z.B.: GX : P etc.) · Information über installierte Startup-Programme auf dem Amiga · Information über installierte Programme auf Alcuin · Einstellungen von Alcuin · Detailierte Beschreibung welches Programm oder welcher Befehl den Fehler erzeugt, bzw wie dieser reproduziert werden kann. Als erstes sollten Sie jedoch nachsehen ob dieser Fehler nicht schon @{"bekannt" LINK Bugs} ist. @ENDNODE @NODE Thanks "Dankeschön" Ein Dankeschön gebührt: · @{b}Eddie C. Dost@{ub} für x48 ( ein HP48 Emulator für UNIX ) und für seine Utilities ein ROM zu erzeugen und für seine Hilfe, die ich erhielt, wann immer ich Probleme hatte. · Paul Fox für em48 ( ein HP48 Emulator for UNIX ) auf welchem x48 basierte · Mika Heiskanen mheiskan@vipunen.hut.fi für seine Unterlagen über den HP48 und die Saturn CPU · Hewlett Packard für deren leistungsstarke Taschenrechner · Amiga Technologies für deren Engagement den Amiga am Leben zu erhalten. @ENDNODE @NODE Schupfer "Der Autor" Programmentwicklung ist ein Weg um den Amiga am Leben zu erhalten. Meine Adresse lautet: Stephan Schupfer Brockmanngasse 69 8010 Graz Österreich Email: schupfer@sbox.tu-graz.ac.at WWW: http://www.ping.at/members/schupfer/ http://www.sbox.tu-graz.ac.at/home/schupfer/ Anfragen, Kritiken, Vorschläge und @{"Fehlerreports" LINK BugReports} sind jederzeit willkommen. Email wird bevorzugt ! Bitte verstehen Sie, daß ich nicht jeden Brief/Email persönlich beantworten kann. @{b}Unter keinen Umständen@{ub} werde ich Ihnen ROM files, auch nicht "unter Freunden" !, zukommen lassen. Keine Chance ! @ENDNODE @NODE History "History" History ------- V1.0 25.April.96 - Erste veröffentlichte Version @ENDNODE @NODE Future "Zukünkftige Eintwicklung" Zukunft ------- Soweit ich Zeit habe werde ich die Arbeit an diesem Produkt fortsetzen. Ich bin für Fehlerreports, Ideen, Geschenke und dergleichen dankbar, da diese der Entwicklung sicherlich förderlich sind. Als nächstes will ich folgendes implementieren: · Alle bekannten Fehler bereinigen. · Mehr Geschwindigkeit ist noch immer notwendig · Laden und Speichern von Dateien direkt in den Emulator · Unterstützung von weiteren Sprachen. @ENDNODE