136 lines
4.7 KiB
Plaintext
136 lines
4.7 KiB
Plaintext
|
Forth im <20>berblick:
|
|||
|
===================
|
|||
|
|
|||
|
Einige n<>tzliche Kommandos befinden sich in dem Modul tools.mod. In den meisten F<>llen ist es sinnvoll dieses Modul mit der Befehlssequenz "sys tools.mod saveforth" fest im Forth einzubinden.
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Wichtige Tastencodes:
|
|||
|
---------------------
|
|||
|
|
|||
|
[ESC]-1 Screen 1, COG 1
|
|||
|
[ESC]-2 Screen 2, COG 2
|
|||
|
[ESC]-3 Screen 3, COG 3
|
|||
|
[ESC]-b Break, Reset der aktuellen COG
|
|||
|
[ESC]-r Reset, Neustart Regnatix
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Wichtige Kommandos:
|
|||
|
-------------------
|
|||
|
|
|||
|
load <name> - Datei laden und comilieren, Ausgabe Screen 3
|
|||
|
dload <name> - wie load, aber Ausgabe aktueller Screen
|
|||
|
sys <name> - Datei aus sys-Verzeichnis laden und compilieren
|
|||
|
ls - Dateiliste
|
|||
|
lsl - Dateiliste- Long-Format
|
|||
|
cd <name> - in Verzeichniss wechseln
|
|||
|
mount - SD-Card einbinden
|
|||
|
unmount - SD-Card freigeben
|
|||
|
words - Anzeige W<>terbuch
|
|||
|
mod? - (tools.mod) Anzeige compilierter Erweiterungen
|
|||
|
lib? - (tools.mod) Anzeige compilierter Bibliotheken
|
|||
|
cog? - (tools.mod) Anzeige COG-Liste
|
|||
|
cat <name> - (tools.mod) Ausgabe einer Textdatei
|
|||
|
less <name> - (tools.mod) Zeilenweise Textausgabe
|
|||
|
dm? - (tools.mod) Anzeige der Systemverzeichnisse
|
|||
|
regime - CLI starten
|
|||
|
aload <name> - Adminsitra-Code laden
|
|||
|
bload <name> - Bellatrix-Code laden
|
|||
|
spin <name> - Spin-Programm starten
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Wichtige Dateien:
|
|||
|
-----------------
|
|||
|
|
|||
|
Die Dateien *.mod und *.lib enthalten ganz normale Forth-Quelltexte. Damit hat man schnell eine <20>bersicht <20>ber die grobe Funktion dieser Quellen: Lib's sind halt reine Sammlungen von Worten zu einer bestimmten Funktionsgruppe und MOD's sind mehr oder weniger fertige und abgeschlossene Programme. Ein Beispiel:
|
|||
|
|
|||
|
Die Datei hss.lib enth<74>lt Worte um die HSS-Funktionen von Administra anzusprechen. Mit diesen Funktionen kann man nun ein Modul (Programm) wie einen HSS-Soundplayer schreiben.
|
|||
|
|
|||
|
Im Gegensatz dazu die Datei splay.mod: Mit diesem Modul wird ein HSS-Soundplayer ins System eingef<65>gt, welcher Funktionen aus der hss.lib verwendet.
|
|||
|
|
|||
|
Die Datei ben<65>tigt man aber mehr oder weniger nur zur Entwicklung, ein fertiges Modul wie splay.mod enth<74>lt dann schon die die entsprechenden HSS-Worte die ben<65>tigt werden.
|
|||
|
|
|||
|
Die ifnot: ... Anweisung sorgt dabei daf<61>r, dass keine Funktionen doppelt in das W<>rterbuch compiliert werden. Das ist quasi ein verteiltes und fein granuliertes Konzept analog zu einer DLL. Die Forth-Version funktioniert dabei aber im Gegensatz zu DLL's nicht auf Bibliotheks-, sondern auf Funktionsebene.
|
|||
|
|
|||
|
*.mod Module, Forth-Erweiterungen f<>r das System
|
|||
|
*.lib Bibliotheken, grundlegende Wortsammlungen
|
|||
|
*.adm Administra-Code (z.Bsp. admsid.adm f<>r SIDCog-Code)
|
|||
|
*.bel Bellatrix-Code
|
|||
|
*.bin Spin-Code, im Normalfall zur Ausf<73>hrung in Regnatix
|
|||
|
|
|||
|
basics.f - (mod:basics) Hive-Core f<>r PropForth
|
|||
|
ari.lib - (lib:ari) Zus<75>tzliche arithmetische Funktionen
|
|||
|
cog.lib - (lib:cog) Zus<75>tzliche COG-Funktionen
|
|||
|
adm.lib - (lib:adm) Administra-Chipmanagment-Funktionen
|
|||
|
hss.lib - (lib:hss) Bibliothek f<>r Hydra-Sound-System
|
|||
|
sfx.lib - (lib:sfx) Soundeffekt-Bibliothek
|
|||
|
wav.lib - (lib:wav) Wave-Soundbibliothek
|
|||
|
|
|||
|
bel.lib - (lib:bel) Bellatrix-Chipmanagment-Funktionen
|
|||
|
key.lib - (lib:key) Tastatur-Bibliothek
|
|||
|
scr.lib - (lib:scr) Screen-Bibliothek
|
|||
|
sd0.lib - (lib:sd0) SD-Card-Bibliothek
|
|||
|
|
|||
|
debug.f - N<>tzliche Worte zur Fehlersuche und Entwicklung
|
|||
|
rom.f - EEPROM-Dateisystem
|
|||
|
tools.f - N<>tzliche Tools (cat, less, dm?...)
|
|||
|
hplay.f - HSS-Player
|
|||
|
wplay.f - WAV-Player
|
|||
|
splay.f - SID-Player
|
|||
|
|
|||
|
Administra-Codedateien im SYS-Verzeichnis:
|
|||
|
|
|||
|
admled.adm Testprogramm - HBeat-LED blinken lassen
|
|||
|
admsid.adm SidCog-Version (wird von splay ben<65>tigt)
|
|||
|
admsys.adm Standardcode f<>r ADM mit SD/HSS/WAV
|
|||
|
admym.adm Yamaha-Soundchip-Version
|
|||
|
aterm96.adm Mini-OS f<>r Administra (Testzwecke)
|
|||
|
|
|||
|
|
|||
|
|
|||
|
Reset-Fehlercodes:
|
|||
|
------------------
|
|||
|
|
|||
|
0011FFFF - stack overflow
|
|||
|
0012FFFF - return stack overflow
|
|||
|
0021FFFF - stack underflow
|
|||
|
0022FFFF - return stack underflow
|
|||
|
8100FFFF - no free cogs
|
|||
|
8200FFFF - no free main memory
|
|||
|
8400FFFF - fl no free main memory
|
|||
|
8500FFFF - no free cog memory
|
|||
|
8800FFFF - eeprom write error
|
|||
|
9000FFFF - eeprom read error
|
|||
|
|
|||
|
|
|||
|
|
|||
|
.err-Fehlercodes:
|
|||
|
-----------------
|
|||
|
|
|||
|
0 no error
|
|||
|
1 fsys unmounted
|
|||
|
2 fsys corrupted
|
|||
|
3 fsys unsupported
|
|||
|
4 not found
|
|||
|
5 file not found
|
|||
|
6 dir not found
|
|||
|
7 file read only
|
|||
|
8 end of file
|
|||
|
9 end of directory
|
|||
|
10 end of root
|
|||
|
11 dir is full
|
|||
|
12 dir is not empty
|
|||
|
13 checksum error
|
|||
|
14 reboot error
|
|||
|
15 bpb corrupt
|
|||
|
16 fsi corrupt
|
|||
|
17 dir already exist
|
|||
|
18 file already exist
|
|||
|
19 out of disk free space
|
|||
|
20 disk io error
|
|||
|
21 command not found
|
|||
|
22 timeout
|
|||
|
23 parameter error
|