Projects/tigris
Projects
/
tigris
Archived
5
0
Fork 0
This repository has been archived on 2024-07-04. You can view files and clone it, but cannot push or open issues or pull requests.
tigris/TIKI-100_emul-src/TIKI-100_emul.txt

340 lines
11 KiB
Plaintext
Raw Normal View History

2008-09-01 12:30:26 +02:00
TIKI-100_emul V1.1.1, 25 august 2001
En freeware TIKI-100 Rev. C emulator
Z80 emulering copyright (C) Marat Fayzullin.
Resten copyright (C) Asbj<62>rn Djupdal.
Jeg gir tillatelse til <20> bruke og spre denne emulatoren fritt bortsett
fra til kommersielle form<72>l. Det skal aldri tjenes penger p<> denne
emulatoren.
Introduksjon
------------
TIKI-100 er en norskbygd maskin lansert i 1984. Den kj<6B>rer et norsk
operativsystem, TIKO, som er kompatibelt med CP/M-2.2. Maskina har en
Z80A p<> 4MHz, fargegrafikk og 3 kanalers lyd. Den ble mye brukt i norske
skoler.
Programmet du n<> leser om er en TIKI-100 emulator, dvs et program som
lar deg kj<6B>re all programvare som finnes til TIKI-100 p<> en mer
moderne datamaskin.
Emulatoren er skrevet i C. Kildefilene er tilgjengelig p<> emulatorens
hjemmeside: http://www.stud.ntnu.no/~djupdal/tiki/emulator/
Hva som emuleres
----------------
- Z80 CPU
- CTC klokkekrets
- DART rs-232 serieporter (begrenset)
- PIO parallellporter (sv<73>rt begrenset)
- Videokrets
- FD17xx diskettkontroller
- Div andre sm<73>ting som minneh<65>ndtering, tastatur, etc.
Hva som mangler
---------------
- AY-3-8912 lydgenerator
- Modemsignaler (DART). Emulering av serieporter skjer uten noen
kontroll p<> modemsignaler.
- Skikkelig emulering av parallellporter (PIO). N<> emuleres bare
det aller mest n<>dvendige for <20> kunne bruke skriver.
- Emulering av diverse tilleggsutstyr (harddisk, 8088-kort, etc.)
Bruk av emulatoren
------------------
Denne emulatoren er en s<>kalt maskinvareemulator, dvs den etterligner
maskinvaren i en TIKI-100. Det gj<67>r at alle operativsystemer som
finnes til TIKI-100 vil kj<6B>re p<> denne emulatoren, s<>fremt de ikke
forutsetter tilleggsutstyr som ikke st<73>ttes.
N<EFBFBD>r emulatoren starter opp pr<70>ver den <20> laste inn fila
"tiki.rom". Denne inneholder en kopi av ROM'en i en ekte
TIKI-100. <20>nsker du <20> bruke en annen ROM kan du bare bytte ut denne
fila. Emulatoren st<73>tter alle ROM-filer opp til 16kB, akkurat som en
ekte TIKI-100. OBS: En slik fil M<> v<>re tilstede!
Emulatoren bruker diskettfiler. En diskettfil er en TIKI-100 diskett
som i sin helhet har blitt kopiert inn p<> en enkelt fil. Det som er
viktig <20> vite om diskettfilene i denne emulatoren er at forandringer
som gj<67>res p<> en diskett i emulatoren ikke blir lagret f<>r du
eksplisitt ber emulatoren om det.
Etter at emulatoren har startet opp vil du f<> det velkjente TIKI-100
oppstartsbildet p<> skjermen: "Sett inn en TIKI diskett og trykk B"
Bruk av emulatoren utenom dette avhenger av hvilken versjon du bruker.
Amiga-versjonen
---------------
Merk at serieporter og parallellport forel<65>pig ikke st<73>ttes av
Amigaversjonen.
Nederst i emulatorvinduet ser du 4 "lysdioder". Disse tilsvarer
lysdiodene p<> lock-tasten, grafikk-tasten, diskettstasjon a og
diskettstasjon b.
Amigaversjonen har disse menyene som burde v<>re selvforklarende:
- Emulator
- Reset
- Om...
- Avslutt
- Diskettstasjon
- Hent plate A...
- Hent plate B...
- Lagre plate A...
- Lagre plate B...
- Fjern plate A...
- Fjern plate B...
- Innstillinger
- Begrens hastighet (forel<65>pig ikke i bruk)
- Bevar forhold
- 40-modus st<73>rrelse
- Standard
- Fordoblet
- Firedoblet
- 80-modus st<73>rrelse
- Standard
- Fordoblet
Plassering av TIKI taster p<> tastaturet:
GRAFIKK: ` (til venstre for tasten 1)
BRYT: Tab
ANGRE: Esc
LOCK: Venstre Alt
UTVID: \ (til venstre for slettetasten)
HJEM: Del
Side opp: F7
Side ned: F8
Venstre tab: F9
H<>yre tab: F10
%: [ (p<> numerisk tastatur)
=: ] (p<> numerisk tastatur)
Resten av tastene er plassert p<> de tilsvarende Amiga-tastene.
Win32-versjonen
---------------
Nederst i emulatorvinduet ser du 4 "lysdioder". Disse tilsvarer
lysdiodene p<> lock-tasten, grafikk-tasten, diskettstasjon a og
diskettstasjon b.
Win32-versjonen har disse menyene som burde v<>re selvforklarende:
- Emulator
- Reset
- Innstillinger...
- Om...
- Avslutt
- diskettstasjon
- Hent plate A...
- Hent plate B...
- Lagre plate A...
- Lagre plate B...
- Fjern plate A
- Fjern plate B
Menyvalget "Innstillinger" bringer fram en dialogboks der du kan
stille inn diverse:
- Merk "Senk hastighet" dersom du vil at emulatoren skal kj<6B>re p<>
samme hastighet som en ekte TIKI-100. Denne har bare virkning
dersom din datamaskin er for rask.
- Alt innenfor boksen "Skjermforst<73>rring" styrer forst<73>rring av
TIKI-skjermbilde. "Bevar forhold" gir samme forhold p<>
emulatorvinduet som p<> en ekte TIKI-skjerm.
- Det innenfor boksen "Porter" bestemmer hvordan de emulerte
TIKI-portene skal brukes. Skriv inn navnet p<> PC-portene du vil
skal benyttes til de forskjellige TIKI-portene. Skriver du inn et
filnavn i stedet vil alt som skulle blitt sendt til en port i
stedet bli lagret til den fila.
Merker du av "Sett ST 28 b" vil du f<> samme effekt som om du satte
den tilsvarende b<>ylen ("jumper'en") i en ekte TIKI-100. Du vil
neppe f<> bruk for denne.
Plassering av TIKI taster p<> tastaturet:
GRAFIKK: | (til venstre for tasten 1)
BRYT: Tab
ANGRE: Esc
UTVID: Insert
Venstre tab: Delete
H<>yre tab: End
HJELP: F8
ENTER (num): F9
%: F11
=: F12
Resten av tastene er plassert p<> de tilsvarende PC-tastene.
Unix-versjonen
--------------
Nederst i emulatorvinduet ser du 4 "lysdioder". Disse tilsvarer
lysdiodene p<> lock-tasten, grafikk-tasten, diskettstasjon a og
diskettstasjon b.
Trykk Escape-tasten i emulatorvinduet for <20> g<> inn i kommandomodus. Da
vil en prompt komme fram i xtermen du startet emulatoren fra. F<>lgende
kommandoer kan da skrives inn:
hjelp : Vis hjelpetekst
h : Forkortelse for 'hjelp'
disk <stasjon> <filnavn> : Hent inn diskettfil
d <stasjon> <filnavn> : Forkortelse for 'disk ...'
lagre <stasjon> <filnavn> : Lagre diskettfil
l <stasjon> <filnavn> : Forkortelse for 'lagre...'
fjern <stasjon> : Fjern diskettfil
f <stasjon> : Forkortelse for 'fjern...'
pk [kommandonavn] : Send utskrift til print-kommando
pf [filnavn] : Send utskrift til fil
reset : Reset emulator
fortsett : Fortsett emulering
c : Forkortelse for 'fortsett'
om : Om emulator (bl.a versjonsnummer)
avslutt : Avslutt emulator
q : Forkortelse for 'avslutt'
Alle diskettkommandoene tar et stasjonsargument. Det er enten a eller
b, avhengig av hvilken diskettstasjon du <20>nsker <20> benytte kommandoen
p<EFBFBD>. Stasjon a er oppstartsdiskettstasjonen i en TIKI-100.
Eksempel: For <20> hente inn diskettfil 'plater/tiko_kjerne_v4.01.dsk'
til stasjon a skriver du: 'disk a plater/tiko_kjerne_v4.01.dsk'.
Kommandoene pk og pf spesifiserer hhv en printkommando eller en fil
som utskrift fra TIKI-programmer skal sendes til. Dersom du <20>nsker <20>
skru av utskriftsmulighetene igjen s<> gi kommandoen uten argument. Du
kan skrive til b<>de kommando og fil samtidig. V<>r oppmerksom p<> at
utskrift til en printkommando som oftest ikke sendes til skriver f<>r
forbindelsen til den avsluttes. S<> selv om TIKI-programmet er ferdig
med utskriften m<> du avslutte printkommando med "pk" for <20> sende
utskrift til skriver.
Eksempel: For <20> sende utskrift til kommandoen 'lpr' skriver du:
'pk lpr'. For <20> sende utskrift til fila 'utskrift' skriver du:
'pf utskrift'.
Plassering av TIKI taster p<> tastaturet:
BRYT: Break, F10
SLETT: BackSpace, Delete
GRAFIKK: F8
ANGRE: Redo, F9
LOCK: Caps_Lock, Shift_Lock, F7
HJELP: Help, F11
UTVID: Insert, F12
Venstre TAB: Prior
H<EFBFBD>yre TAB: Tab, Next
Navnet p<> TIKI-tasten er til venstre og navnet p<> den (eller de)
tilsvarende X11-keysym tasten(e) er til h<>yre. For mer informasjon om
keysyms, les man-siden til 'xmodmap'.
Resten av tastene er mappet til tilsvarende keysyms. Merk at TIKI-100
bare har 6 F-taster, s<> dersom et program ber deg trykke p<> F7, er det
antakelig ute etter shift-F1 i stedet.
F<EFBFBD>lgende kommandolinjeargumenter kan benyttes ved oppstart:
-display <display> Angi display
-d <display> Samme som over
-geometry <geometry> Angi vindusplassering (st<73>rrelse ignoreres)
-g <geometry> Samme som over
-diska <diskettfil> Angi diskettfil til stasjon A
-diskb <diskettfil> Angi diskettfil til stasjon B
-bevarforhold Emulatorvindu har samme forhold som en ekte
TIKI-skjerm
-ikkebevarforhold Negasjonen av den over
-40x <forst<73>rrelse> Angi forst<73>rring av 40-modus skjerm (1-4)
-80x <forst<73>rrelse> Angi forst<73>rring av 80-modus skjerm (1-2)
-begrens Dersom datamaskin er for rask, sett ned
hastigheten til "normal" TIKI-100
hastighet
-ikkebegrens Negasjonen av den over
-port1 <device> Angi hvilken device du vil skal benyttes til
TIKI-serieport P1 (f.eks /dev/tty00)
-port2 <device> Samme som -port1 men for TIKI-serieport P2.
-pk <utskriftskommando> Angi hvilken kommando utskrift skal sendes til.
-pf <utskriftsfil> Angi hvilken fil utskrift skal sendes til.
-st28b Tilsvarende <20> sette b<>yle ('jumper') ST 28 b i en
ekte TIKI-100. Du vil neppe f<> bruk for denne.
-ikkest28b Negasjonen av den over
Disse kan ogs<67> settes i .Xresources filen:
Tikiemul.geometry (geometry)
Tikiemul.diska (filnavn)
Tikiemul.diskb (filnavn)
Tikiemul.bevarforhold (on eller off)
Tikiemul.40x (1-4)
Tikiemul.80x (1-2)
Tikiemul.begrens (on eller off)
Tikiemul.port1 (device)
Tikiemul.port2 (device)
Tikiemul.pk (utskriftskommando)
Tikiemul.pf (utskriftsfil)
Tikiemul.st28b (on eller off)
Dersom du ikke gir noen kommandolinjeargumenter, og ingen verdier er
satt i .Xresources, vil f<>lgende standardverdier benyttes:
'-begrens -ikkest28b -ikkebevarforhold -40x 1 -80x 1', ingen
diskettfiler i stasjonen, og ingen printkommando/fil.
Annet
-----
P<EFBFBD> min TIKI-100 hjemmeside finner du mer informasjon om TIKI-100. Der
finner du ogs<67> mange kjente TIKI-100 programmer som kan benyttes i
denne emulatoren. Her finner du ogs<67> emulatorens hjemmeside.
http://www.stud.ntnu.no/~djupdal/tiki/
Send sp<73>rsm<73>l, forslag til forbedringer og andre kommentarer til:
djupdal@stud.ntnu.no
Historie
--------
* 25 aug 2001 Versjon 1.1.1
- Fikset feil i diskettkontrolleremulering
* 24 aug 2001 Versjon 1.1.0 for Amiga, win32, unix.
- Generell opprenskning i alle kildefiler.
- Fikset feil i diskkontrolleremulering
- Fikset feil i videoemulering
- Laget (begrenset) serie og parallellport emulering
- Laget unix-versjon
- Laget helt ny Amiga-versjon
- Forbedret win32-versjon
- Kildefiler tilgjengelig
* 21 sep 2000 Versjon 1.0.1 for win32
* 26 aug 2000 Versjon 1.0.0 for Amiga