Lots of changes. Maybe for the better, maybe not.

reference/disk.txt

@@ -0,0 +1,191 @@
+Diskettstasjonkontrolleren i TIKI-100 Rev C
+-------------------------------------------
+
+TIKI-100 inneholder en FD1767PL-02 eller en FD1797-PL diskettstasjonkontroller
+fra Western Digital. I TIKI-100 er ikke FD17xx kretsens INTRQ tilkoblet, så
+den vil ikke kunne generere interrupts.
+
+FD17xx kretsen kontrolleres gjennom 4 I/O porter:
+
+I/O-port 10H: Statusord / styreord
+
+Ved skriving er dette kommandoregisteret. Ved lesing er det statusregisteret.
+
+I/O-port 11H: Spornummer
+
+Her kan spor-registeret skrives og leses.
+
+I/O-port 12H: Sektornummer
+
+Her kan sektor-registeret skrives og leses.
+
+I/O-port 13H: Dataregister
+
+Gjennom denne porten leses og skrives data til diskett.
+
+Oversikt over kommandoer
+
+Type Navn             Bits i kommandoregister
+---------------------------------------------
+  I  Restore          0  0  0  0  h  V  r1 r0
+  I  Seek             0  0  0  1  h  V  r1 r0
+  I  Step             0  0  1  T  h  V  r1 r0
+  I  Step-In          0  1  0  T  h  V  r1 r0
+  I  Step-Out         0  1  1  T  h  V  r1 r0
+ II  Read Sector      1  0  0  m  1  1  U  0
+ II  Write Sector     1  0  1  m  1  1  U  a0
+III  Read Address     1  1  0  0  0  1  U  0
+III  Read Track       1  1  1  0  0  1  U  0
+III  Write Track      1  1  1  1  0  1  U  0
+ IV  Force Interrupt  1  1  0  1  0  0  0  0
+
+r1,r0: Stepping Motor Rate
+   0 0 =  6 ms
+   0 1 = 12 ms
+   1 0 = 20 ms
+   1 1 = 30 ms
+V: Track Number Verify Flag
+   0 = ikke verifiser
+   1 = sjekk at sporregisteret tilsvarer spornummeret i første ID-felt på
+       målsporet
+h: Head Load
+   0 = ikke senk lese/skrive hodet
+   1 = senk lese/skrive hodet
+T: Track Update Flag
+   0 = ikke oppdater sporregister
+   1 = oppdater sporregister etter endt operasjon
+U: Side select
+   0 = velg side 0
+   1 = velg side 1
+m: Multiple Record Flag
+   0 = les/skriv kun 1 sektor
+   1 = les/skriv sektorer helt til hele sporet er dekket
+a0: Data Address Mark
+   0 = dataadressemerket er 0fbH
+   1 = dataadressemerket er 0f8H (slettet dataadressemerke)
+
+Statusregister
+
+Type I kommandoer:
+
+Bit  Navn                     Forklaring
+----------------------------------------------------------------------------
+7    Not ready                Stasjonen er ikke klar
+6    Protected                Skrivebeskyttet diskett
+5    Alltid 1 i TIKI-100
+4    Seek error               Ønsket spor ikke verifisert
+3    CRC error                Gal CRC i ID-felt
+2    Track 0                  Hodet står over spor 0
+1    Index                    Angir begynnelsen av første sektor
+0    Busy                     Kommando under utførelse
+
+Type II og III kommandoer:
+
+Bit  Navn                     Forklaring
+----------------------------------------------------------------------------
+7    Not ready                Samme som for type I
+6    Protected                Lesekommandoer: ikke brukt
+                              Skrivekommandoer: diskett er skrivebeskyttet
+5    Record type/Write fault  Les sektor: 1 = slettet dataadressemerke
+                                          0 = vanlig dataadressemerke
+                              Skrivekommandoer: Skrivefeil
+4    Record not found         Ønsket spor, sektor eller side ikke funnet
+3    CRC error                Sammen med bit 4: Feil sjekksum i kontrollfelt
+                              Uten bit 4: Feil sjekksum i datafelt
+2    Lost data                Prosessor har ikke håndtert DRQ raskt nok
+1    Data request             Kopi av DRQ, klar for overføring av neste byte
+0    Busy                     Kommando under utførelse
+
+Busy flagget settes når en kommando er under utførelse. Ingen kommando, utenom
+"Force Interrupt" må legges inn i kommandoregisteret mens Busy er satt.
+
+Type I kommandoer
+
+Restore
+
+Før hodet til spor 0 og oppdater sporregisteret.
+Hvis ikke sporet finnes innen 255 flytt, settes "Seek error" i
+statusregisteret.
+
+Seek
+
+Denne kommandoen antar at sporregisteret inneholder gjeldende spornummer og
+dataregisteret inneholder ønsket målspor.
+Fører hodet til sporet angitt i dataregisteret og oppdaterer sporregisteret.
+
+Step
+
+Flytt hodet ett spor i samme retning som det ble flyttet sist.
+
+Step-In
+
+Flytt hodet ett spor innover (mot økende spornummer).
+
+Step-Out
+
+Flytt hodet ett spor utover (mot spor 0).
+
+Type II kommandoer
+
+Legg ønsket sektor i sektorregisteret.
+
+Read Sector
+
+Overfører ønsket sektor byte for byte gjennom dataregisteret. Hver gang en byte
+er klar for overføring settes "Data request" flagget i statusregisteret. Etter
+endt operasjon settes "Recort type" flagget i statusregisteret.
+
+Write Sector
+
+Skriver ønsket sektor til diskett. Hver gang en byte kan skrives, settes "Data
+request" flagget i statusregisteret. Diskettkontrolleren lager selv ID feltet
+med riktig dataadressemerke og CRC.
+
+Type III kommandoer
+
+Read Address
+
+Overfører gjennom dataregisteret det neste ID feltet som passeres. Hver gang en
+byte er klar for overføring settes "Data request" flagget i statusregisteret.
+ID feltet består av seks bytes:
+  1    spor
+  2    side
+  3    sektor
+  4    sektorlengde
+        0 = 128 bytes
+        1 = 256 bytes
+        2 = 512 bytes
+        3 = 1024 bytes
+  5,6  CRC
+
+Read Track
+
+Overfører hele sporet gjennom dataregisteret, inkludert ID felt og mellomrom.
+Hver gang en byte er klar for overføring settes "Data request" flagget i
+statusregisteret.
+
+Write Track
+
+Skriver et spor til diskett, inkludert mellomrom og ID felter. Brukes til
+formatering av diskett. Bytes overføres gjennom dataregisteret. "Data request"
+settes i statusregisteret når det er klart for neste byte.
+Bytes f5H-feH tolkes som dataadressemerke. Spesielt tolkes f5H-f7H slik:
+   f5H  Skriv a1H, nullstill CRC generator.
+   f6H  Skriv c2H
+   f7H  Skriv 2 bytes CRC.
+
+Type IV kommandoer
+
+Force Interrupt
+
+Brukes til å stanse en pågående operasjon før den avsluttes på normalt vis,
+eller sikre type I statusregister.
+Hvis denne kommandoen settes mens en annen kommando utføres (busy = 1), vil
+busy settes lik 0 og resten av statusregisteret er uforandret.
+Hvis busy = 0 når denne kommandoen utføres vil statusregisteret slettes /
+oppdateres og reflektere type I statusregister.
+
+---
+21 januar 2001
+Asbjørn Djupdal, djupdal@stud.ntnu.no
+

reference/ioporter.txt

@@ -0,0 +1,47 @@
+I/O-porter i TIKI-100 Rev C
+---------------------------
+
+Adresse  Retning     Funksjon
+--------------------------------------------------------
+00-03    les/skriv   Tastatur
+04       les/skriv   Seriekanal A, dataord
+05       les/skriv   Seriekanal B, dataord
+06       les/skriv   Seriekanal A, statusord/styreord
+07       les/skriv   Seriekanal B, statusord/styreord
+08       les/skriv   Parallellport A, dataord
+09       les/skriv   Parallellport B, dataord
+0A       les/skriv   Parallellport A, statusord/styreord
+0B       les/skriv   Parallellport B, statusord/styreord
+0C-0F    skriv       Grafikk modus
+10       les/skriv   Diskettstasjon statusord/styreord
+11       les/skriv   Diskettstasjon spornummer-register
+12       les/skriv   Diskettstasjon sektor-register
+13       les/skriv   Diskettstasjon dataregister
+14-15    skriv       Grafikk fargeregister (pallett)
+16       skriv       Lyd og scroll peker
+17       les/skriv   Lyd og scroll data
+18       les/skriv   Tellerkrets (CTC) kanal 0
+19       les/skriv   Tellerkrets (CTC) kanal 1
+1A       les/skriv   Tellerkrets (CTC) kanal 2
+1B       les/skriv   Tellerkrets (CTC) kanal 3
+1C-1F    skriv       Systemregister
+
+Ledige I/O-porter:
+
+20-7F                Reservert TIKI-DATA
+20-27                Winchester controller
+60-6F                Analog I/O (SINTEF)
+60-67                RVO-kort (DIGI I/O)
+70-77                Analog/Digital I/O
+78-7B                Lyspenn interface
+7E-7F                8088/87 16 bit prosessor med 128k RAM
+80-FF                Ledig for bruk av andre enn TIKI-DATA
+
+Alle adresser er i hex.
+Der flere portadresser er angitt for ett og samme register, bør du benytte deg
+av den første.
+
+---
+18 juni 2000
+Asbjørn Djupdal, djupdal@stud.ntnu.no
+

reference/lyd.txt

@@ -0,0 +1,46 @@
+Lyd og scrolling i TIKI-100 Rev C
+---------------------------------
+
+TIKI-100 inneholder en AY-3-8912 chip. Dette er en standard lydkrets som finnes
+i mange andre datamaskiner, bl.a Amstrad CPC og ZX-Spectrum. Siden det finnes
+mange gode tekster som omhandler programmering av denne kretsen, tar jeg bare
+med det som gjelder spesielt for TIKI her.
+
+AY-3-8912 har 15 registre som kontrollerer kretsens virkemåte. Den har 2
+funksjoner; Hovedfunksjonen er lydgenerering, men den inneholder også en 8 bits
+dataport. Denne dataporten er i TIKI-100 brukt til vertikal scrolling av
+skjermen.
+
+Tilgang til AY-3-8912 skjer gjennom 2 I/O-porter:
+
+I/O-port 16H: Lyd og scroll peker
+
+For å få tilgang til et av registrene i AY-3-8912, må det aktuelle
+registernummeret skrives til denne porten.
+
+I/O-port 17H: Lyd og scroll data
+
+Etter at registernummeret er skrevet til I/O-port 16H, kan data til det aktuelle
+registeret skrives/leses i denne porten.
+
+Hardware scrolling
+
+Som nevnt tidligere, benyttes AY-3-8912's dataport (register 14) til vertikal
+scrolling. Hver gang prosessor eller videokrets prøver å få tilgang til grafikk-
+hukommelsen, adderes innholdet i denne dataporten multiplisert med 128 til
+verdien på adressebussen. Hvis f.eks prosessoren skal ha tak i innholdet i
+adresse 0 i grafikkram, og innholdet i AY-3-8912's dataport er 10, vil
+prosessoren i stedet få innholdet i adresse 0 + (10*128) MOD 32768 = 1280. Selv
+om data i grafikkram ikke fysisk skifter plass, vil det i praksis føles som om
+grafikkram-innholdet hopper oppover like mange linjer som dataportens innhold
+øker med i verdi.
+
+Med andre ord: For å scrolle skjermen oppover x antall linjer, legg x til
+verdien som allerede ligger i AY-3-8912's dataport.
+For å scrolle skjermen nedover x antall linjer, trekk x fra verdien som
+allerede ligger i AY-3-8912's dataport.
+
+---
+26 juni 2001
+Asbjørn Djupdal, djupdal@stud.ntnu.no
+

reference/parallell.txt

@@ -0,0 +1,116 @@
+Parallellporter i TIKI-100 Rev C
+--------------------------------
+
+TIKI-100 inneholder en Z80 PIO krets med 2 stk. 8-bits I/O porter
+(hver med kvitteringssignalene RDY og STB). 
+Begge disse er koblet opp til parallellport P3. Se portbeskrivelsen
+for mer informasjon om pinnetilordning. 
+
+Z80 PIO kontrolleres gjennom 4 I/O porter:
+
+I/O-port 08H: Parallellport A, dataord
+
+Her leses og skrives data for parallellport A. 
+
+I/O-port 09H: Parallellport B, dataord
+
+Her leses og skrives data for parallellport B. 
+
+I/O-port 0AH: Parallellport A, styreord
+
+Her skrives kontrollregisteret til parallellport A.
+
+I/O-port 0BH: Parallellport B, styreord
+
+Her skrives kontrollregisteret til parallellport B. 
+
+Operasjonsmodi
+
+Parallellportene kan settes til en av 4 modi:
+
+Modus 0: Data ut. Data skrevet til dataregisteret blir satt rett ut på
+         porten. De kan også leses tilbake. Når gyldige data settes ut
+         på porten, går RDY høy. STB kan settes høy av eksternt utstyr
+         for å indikere at data er lest. 
+Modus 1: Data inn. Porten klokker inn data utenfra når det eksterne
+         utstyret setter STB høy. Data kan hentes inn til CPU ved å
+         lese dataregisteret. Da blir samtidig RDY høy, og indikerer
+         til det eksterne utstyret at porten er klar for en ny byte.
+         Når STB settes høy, går RDY lav, og kretsen kan gi interrupt. 
+Modus 2: Bidireksjonal (både inn og ut). Bare port A kan fungere i
+         modus 2. Når port A settes til modus 2, må samtidig port B
+         settes til modus 2 og port B må settes til å ikke generere
+         interrupts. 
+         Data ut er lik modus 0, bortsett fra at data bare settes ut
+         når ASTB er lav. 
+         Data inn er lik modus 1, bortsett fra at kvitteringssignalene
+         og interruptmulighetene til port B benyttes. 
+Modus 3: Bit kontroll. Individuelle bits i parallellporten kan settes
+         enten til inn eller ut. RDY og STB er ikke brukt. I stedet
+         genereres en interrupt hvis interruptbetingelsene til
+         input-pinnene bestemt under programmering av porten er
+         oppfyllt.
+
+Programmering
+
+Programmering av porten foregår ved skriving til portens
+kontrollregister. 
+
+Følgende styreord kan skrives til kontrollregisteret:
+
+Mode Control Word: 
+
+Bit 6-7:   Velger modus:
+           Bit 7    Bit 6
+           0        0        Modus 0
+           0        1        Modus 1
+           1        0        Modus 2
+           1        1        Modus 3
+           Når modus 3 velges, MÅ etterfølgende ord skrevet til
+           kontrollregisteret være et retningsord, der en ener i en
+           bitposisjon medfører at tilsvarende I/O-pinne vil bli en
+           inngang, mens en nuller vil medføre at I/O-pinnen blir en
+           utgang. 
+Bit 4-5:   Ubrukt
+Bit 0-3:   Må settes til 1111 (identifiserer at dette er Mode Control
+           Word). 
+
+Interrupt Control Word:
+
+Bit 7 = 1: Skrur på interruptfunksjonen
+Bit 7 = 0: Skrur av interruptfunksjonen
+Bit 6 = 1: OG funksjon, alle bit med i interruptbetingelsen må gå til
+           den definerte tilstanden for at interrupt skal genereres. 
+Bit 6 = 0: ELLER funksjon, interrupt genereres når minst ett bit går
+           til den definerte tilstanden. 
+Bit 5 = 1: Definert tilstand er høy
+Bit 5 = 0: Definert tilstand er lav
+Bit 4 = 1: Kun utvalgte bit er med i interruptbetingelsen. Neste byte
+           skrevet til kontrollregisteret må være et maskeord. Dersom
+           et utvalgt bit i maskeordet er satt vil den tilsvarende
+           pinnen i parallellporten IKKE monitoreres for interrupt.
+           Dersom bit 4 er satt, MÅ det altså skrives et slikt
+           maskeord til kontrollregisteret umiddelbart etterpå.
+           Uansett modus, ved å sette bit 4 til 1 vil alle ventende
+           interrupts bli slettet.
+Bit 0-3:   Må settes til 0111 (identifiserer at dette er Interrupt
+           Control Word). 
+
+Interrupt Disable Word:
+
+Bit 7 = 1: Skrur på interrupts
+Bit 7 = 0: Skrur av interrupts
+Bit 4-6:   Ubrukt
+Bit 0-3:   Må settes til 0011 (identifiserer at dette er Interrupt
+           Disable Word). 
+
+Interrupt Vector Word:
+
+Bit 1-7:   Setter interrupt vektoren som skal benyttes ved interrupts
+           (med implisitt 0 i minst signifikante bit). 
+Bit 0:     Må settes til 0 (identifiserer at dette er Interrupt Vector
+           word). 
+
+---
+18 august 2002
+Asbjørn Djupdal, djupdal@stud.ntnu.no

reference/serie.txt

@@ -0,0 +1,180 @@
+Serieporter i TIKI-100 Rev C
+----------------------------
+
+TIKI-100 benytter seg av en Z80 DART som inneholder to asynkrone RS-232
+serieporter.
+
+DART kontrolleres gjennom 4 I/O porter:
+
+I/O port 04H: Seriekanal A, dataord
+
+Gjennom denne porten leses og skrives data til serieport A. 
+
+I/O port 05H: Seriekanal B, dataord
+
+Gjennom denne porten leses og skrives data til serieport B. 
+
+I/O port 06H: Seriekanal A, statusord/styreord
+
+Ved skriving er dette kommandoregisteret til port A, ved lesing er det
+statusregisteret.
+
+I/O port 07H: Seriekanal B, statusord/styreord
+
+Ved skriving er dette kommandoregisteret til port B, ved lesing er det
+statusregisteret.
+
+DART's interne registre
+
+Hver seriekanal har 3 leseregistre og 6 skriveregistre. Disse kan nås gjennom to
+etterfølgende lese/skrive-operasjoner til kanalens kommandoregister. Først
+skrives en peker til kommandoregisteret som angir hvilket register som ønskes,
+deretter skrives/leses det aktuelle registeret gjennom den samme I/O
+porten. Dersom en lese/skrive operasjon ikke kommer etter en gyldig peker, vil
+register 0 benyttes. 
+
+Leseregister 0
+
+Bit 7 = 1: BRK. Seriekanalen ligger på +V i mer enn 2 tegnlengder. 
+Bit 6:          Ikke i bruk. 
+Bit 5 = 1: CTS. Modemsignalet CTS er satt. 
+Bit 3-4:        Ikke i bruk.
+Bit 2 = 1: TBE. Transmit Buffer Empty. Sender har sendt tegn og er klar for et
+                nytt. Rett etter initialisering av seriekanal kan et tegn
+                skrives til dataporten uten å sjekke denne biten først. Dette
+                fordi denne biten settes først etter at et tegn har blitt sendt,
+                og vil derfor ikke være satt før første tegn er sendt. 
+Bit 1 = 1: INT. Interrupt er satt
+Bit 0 = 1: RXA. Receive Character Available, dvs. nytt tegn mottatt og kan leses
+                ut av dataporten. Denne biten blir nullstilt etter at dataporten
+                har blitt lest. 
+
+Leseregister 1
+
+Bit 7:          Ikke i bruk.
+Bit 6 = 1: FF.  Format feil, f.eks feil antall stopbits. 
+Bit 5 = 1: RXO. Receiver Overflow, dvs innkommende tegn har kommet fortere enn
+                de har blitt lest ut av dataporten. 
+Bit 4 = 1: PF.  Paritetsfeil. 
+Bit 1-3:        Ikke i bruk. 
+Bit 0 = 1: AS.  Alt sendt. 
+
+Leseregister 2
+
+Interruptvektor kan leses ut av dette registeret. Bit 0-3 kan variere, avhengig
+av status dersom "Status affects vector" er satt. 
+
+Skriveregister 0
+
+I skriveregister 0 settes peker for det neste registeret man vil nå gjennom
+denne porten. 
+
+Bit 6-7:        Ikke i bruk
+Bit 3-5:        Peker til neste register som skal nås
+                Bit 5   Bit 4   Bit 3   Register
+                0       0       0       0
+                0       0       1       1
+                0       1       0       2
+                0       1       1       3
+                1       0       0       4
+                1       0       1       5
+Bit 0-2:        Nullstillingskommando
+                Bit 2   Bit 1   Bit 0   Funksjon
+                0       1       0       Nullstill status interrupt
+                0       1       1       Nullstill hele kanalen
+                1       0       0       Sett interrupt når neste serietegn
+                                        mottas
+                1       0       1       Nullstill senderinterrupt
+                1       1       0       Nullstill feilmelding
+                1       1       1       Retur fra interrupt (bare kanal A)
+
+Skriveregister 1
+
+Bit 5-7:        Ikke i bruk.
+Bit 3-4:   RXI. 
+                Bit 4   Bit 3   Type mottakerinterrupt
+                0       0       Ingen mottaker interrupt
+                0       1       Sett mottaker interrupt ved første mottatte tegn 
+                1       0       Interrupt på alle mottatte tegn, paritet endrer
+                                vektor (aner ikke hva det vil si)
+                1       1       Interrupt på alle mottatte tegn, paritet endrer
+                                ikke vektor
+Bit 2 = 1: SAV. Status Affects Vector, dvs interruptvektoren endres avhengig av
+                årsaken til interruptet.
+Bit 1 = 1: TXI. Sett interrupt når senderen er klar for neste tegn. 
+Bit 0 = 1: EXI. Sett interrupt ved endring av eksterne signaler. 
+
+Skriveregister 2
+
+Interruptvektor, skriv inn ønsket interruptvektor her. Interruptvektoren er delt
+mellom begge seriekanalene. 
+
+Skriveregister 3
+
+Bit 6-7:        Antall bits pr. tegn i mottakeren
+                Bit 6   Bit 5   Antall bits
+                0       0       5
+                0       1       6
+                1       0       7
+                1       1       8
+Bit 5 = 1: AE.  Auto Enable, dvs senderen slås automatisk av og på med signalet
+                CTS. 
+Bit 1-4:        Ikke i bruk. 
+Bit 0 = 1: RXE. Receiver Enable, dvs starter mottakerfunksjon. 
+
+Skriveregister 4
+
+Bit 6-7:        Neddeling av klokkefrekvensen, dvs hvilket tall innkommende
+                klokkefrekvens skal deles med for å få antall baud. 
+                Bit 7   Bit 6   Neddeling
+                0       0       1
+                0       1       16
+                1       0       32
+                1       1       64
+Bit 4-5:        Ikke i bruk. 
+Bit 2-3:        Antall stopbits
+                Bit 3   Bit 2   Antall
+                0       0       Ugyldig
+                0       1       1
+                1       0       1,5
+                1       1       2
+Bit 1 = 1: PN.  Like paritet. 
+Bit 0 = 1: P.   Paritet skal benyttes. 
+
+Skriveregister 5
+
+Bit 7:          Ikke i bruk.
+Bit 5-6: TN     Antall bits pr. tegn i senderen
+                Bit 6   Bit 5   Antall
+                0       0       5
+                0       1       7
+                1       0       6
+                1       1       8
+Bit 4 = 1: SB.  Send Break, dvs legg serieutgangen på -V.
+Bit 3 = 1: TXE. Start senderfunksjonen. 
+Bit 2:          Ikke i bruk. 
+Bit 1 = 1: RTS. Slå på Request To Send. 
+Bit 0:          Ikke i bruk. 
+
+Interrupts
+
+Jeg er usikker på en del av DART's interruptgenerering. Dette er hva jeg tror: 
+
+Interruptvektor deles mellom kanalene.
+Dersom "Status Affects Vector" er satt, vil interruptvektoren som benyttes
+forandres avhengig av status. Vektoren forandres slik:
+
+Sender B, normal:   Bit 3 = 0, bit 2 = 0, bit 1 = 0
+Sender B, feil:     Bit 3 = 0, bit 2 = 0, bit 1 = 1
+Mottaker B, normal: Bit 3 = 0, bit 2 = 1, bit 1 = 0
+Mottaker B, feil:   Bit 3 = 0, bit 2 = 1, bit 1 = 1
+
+Sender A, normal:   Bit 3 = 1, bit 2 = 0, bit 1 = 0
+Sender A, feil:     Bit 3 = 1, bit 2 = 0, bit 1 = 1
+Mottaker A, normal: Bit 3 = 1, bit 2 = 1, bit 1 = 0
+Mottaker A, feil:   Bit 3 = 1, bit 2 = 1, bit 1 = 1
+
+---
+28 juni 2001
+Asbjørn Djupdal, djupdal@stud.ntnu.no
+

reference/sysreg.txt

@@ -0,0 +1,38 @@
+Systemregisteret i TIKI-100 Rev C
+---------------------------------
+
+I/O-port 1CH - Systemregister
+
+Dette registeret benyttes til valg av minnekonfigurasjon, styring av lamper på
+tastaturet, og styring av div diskett-funksjoner.
+
+Bit nr   Navn     Aktiv    Funksjon
+----------------------------------------------------------
+7        LMP1     LAV      Lys i LOCK-tast lampe
+6        MOTON    HØY      Slår på diskett-motor
+5        LMP0     LAV      Lys i GRAFIKK-tast lampe
+4        SDEN     HØY      Enkel skrivetetthet på diskett
+3        VIRE     HØY      Grafikk RAM i området 0000-7FFF
+2        ROME     LAV      EPROM i området 0000-3FFF
+1        DRIS1    HØY      Velger diskettstasjon 1
+0        DRIS0    HØY      Velger diskettstasjon 0
+
+Minnekonfigurasjon:
+
+Bit 3          Bit 2       | Adresseområde
+VIRE           ROME        | 0000-3FFF    4000-7FFF    8000-FFFF
+---------------------------+------------------------------------
+0              0           | EPROM        RAM          RAM
+0              1           | RAM          RAM          RAM
+1              0           | Reservert (ikke i bruk)
+1              1           | GFX-RAM      GFX-RAM      RAM
+
+Som du sikkert ser, har EPROM'en et adresseområde på 16k. Disse er fordelt på 2
+sokler (U10 og U9) med hver sin 8k EPROM. Kun den første (U10) er i bruk, men
+man kan sette inn en standard 2k, 4k eller 8k 28 pins EPROM i den andre sokkelen
+(U9) hvis ønskelig. Den vil i såfall få området 2000-3FFF.
+
+---
+21 juni 2000
+Asbjørn Djupdal, djupdal@stud.ntnu.no
+

reference/tastatur.txt

@@ -0,0 +1,39 @@
+Tastaturet i TIKI-100 Rev. C
+----------------------------
+
+Tastaturet består av en tastaturmatrise på 8 rader og 12 kolonner.
+
+I/O-port 00H: Tastatur
+
+Denne porten benyttes ved avlesning av tastaturet. All skriving til denne porten
+nullstiller / resetter avlesningen og må gjøres før avlesning begynner. Deretter
+kan hver enkelt tastatur kolonne avleses ved gjentatt lesing av denne porten.
+Etter 12 leseoperasjoner har man hentet inn alle tastaturkolonnene.
+Satt bit betyr tast IKKE nedtrykket. 
+F.eks: Hvis du etter å ha resatt tastaturet med en skriveoperasjon til port 0, 
+leser verdien 01111111B, betyr det at CTRL er nedtrykket. 
+
+Tastaturmatrise:
+
+    |    0    |    1    |    2    |    3    |    4    |    5    |    6    |    7    |
+----+---------+---------+---------+---------+---------+---------+---------+---------+
+  1 | CTRL    | SHIFT   | BRYT    | RETUR   | MLMROM  | / (num) | SLETT   |         |
+  2 | GRAFIKK | 1       | ANGRE   | a       | <       | z       | q       | LOCK    |
+  3 | 2       | w       | s       | x       | 3       | e       | d       | c       |
+  4 | 4       | r       | f       | v       | 5       | t       | g       | b       |
+  5 | 6       | y       | h       | n       | 7       | u       | j       | m       |
+  6 | 8       | i       | k       | ,       | 9       | o       | l       | .       |
+  7 | 0       | p       | ø       | -       | +       | å       | æ       | HJELP   |
+  8 | @       | ^       | '       | VENSTRE | UTVID   | F1      | F4      | SIDEOPP |
+  9 | F2      | F3      | F5      | F6      | OPP     | SIDENED | VTAB    | NED     |
+ 10 | + (num) | - (num) | * (num) | 7 (num) | 8 (num) | 9 (num) | % (num) | = (num) |
+ 11 | 4 (num) | 5 (num) | 6 (num) | HTAB    | 1 (num) | 0 (num) | . (num) |         |
+ 12 | HJEM    | HØYRE   | 2 (num) | 3 (num) | ENTER   |         |         |         |
+----+---------+---------+---------+---------+---------+---------+---------+---------+
+
+(num) betyr at tasten er på det numeriske tastaturet. 
+
+---
+27 august 2000
+Asbjørn Djupdal, djupdal@stud.ntnu.no
+

reference/teller.txt

@@ -0,0 +1,54 @@
+Tellere i TIKI-100 Rev C
+------------------------
+
+TIKI-100 inneholder en Z80 CTC krets med 4 stk. 8-bits tellere.
+
+Hver teller har en inngang og en utgang.
+
+Slik er tellerkanalene koblet i TIKI-100:
+
+Kanal 0 inn: 2MHz
+Kanal 1 inn: 2MHz
+Kanal 2 inn: Kanal 0 ut
+Kanal 3 inn: Kanal 2 ut
+
+Kanal 0 ut: BAR 0, til seriekanal A
+Kanal 1 ut: BAR 1, til seriekanal B
+Kanal 2 ut: BAR 2, til seriekanal A dersom jumper ST 28 B er kortsluttet
+
+Normalt benyttes kanal 0 og 1 til å generere klokkefrekvenser til seriekanalene,
+mens kanal 3 genererer avbruddssignaler.
+Alternativt kan kanal 2 brukes til å generere klokkefrekvenser til seriekanal A
+dersom ekstra lave hastigheter er nødvendig. Da kreves det at en bøyle (jumper)
+på kretskortet kortsluttes (jumper ST 28 B)
+
+Tellerne teller alltid ned fra en startverdi (tidskonstanten).
+Når telleren kommer til 0, settes en puls ut på utgangen, og genererer evt. et
+avbrudd.
+
+I/O-porter 18H, 19H, 1AH, 1BH: Tellerkrets kanal 0, 1, 2, 3
+
+Alle disse portene brukes likt, og styrer hhv teller 0, 1, 2 og 3.
+
+Skriving til port:
+
+Bit 7 = 1: Interrupt når teller kommer til 0
+Bit 6 = 1: Tellermodus, pulser på separat inngang telles
+Bit 6 = 0: Timermodus, nedtelling av 4MHz klokke
+Bit 5 = 1: Nedskalering 256 når bit 6=0
+Bit 5 = 0: Nedskalering 16 når bit 6=0
+Bit 4 = 1: Teller på positiv flanke (negativ flanke hvis bit 4 = 0)
+Bit 3:     Skal alltid være 0 i TIKI-100
+Bit 2 = 1: Neste ord som skrives hit er tidskonstanten
+Bit 1 = 1: Reset. Teller stoppes, men ingen registre endres. Hvis både bit 1 og
+           2 er 1, fortsetter telleren etter at tidskonstanten er skrevet.
+Bit 0:     ? (bør settes til 1?)
+
+Lesing av port:
+
+Avlest verdi gir antall pulser igjen til 0.
+
+---
+18 juni 2000
+Asbjørn Djupdal, djupdal@stud.ntnu.no
+

reference/tiki100.pal

@@ -0,0 +1,256 @@
+000000
+000055
+0000aa
+0000ff
+002400
+002455
+0024aa
+0024ff
+004900
+004955
+0049aa
+0049ff
+006d00
+006d55
+006daa
+006dff
+009200
+009255
+0092aa
+0092ff
+00b600
+00b655
+00b6aa
+00b6ff
+00db00
+00db55
+00dbaa
+00dbff
+00ff00
+00ff55
+00ffaa
+00ffff
+240000
+240055
+2400aa
+2400ff
+242400
+242455
+2424aa
+2424ff
+244900
+244955
+2449aa
+2449ff
+246d00
+246d55
+246daa
+246dff
+249200
+249255
+2492aa
+2492ff
+24b600
+24b655
+24b6aa
+24b6ff
+24db00
+24db55
+24dbaa
+24dbff
+24ff00
+24ff55
+24ffaa
+24ffff
+490000
+490055
+4900aa
+4900ff
+492400
+492455
+4924aa
+4924ff
+494900
+494955
+4949aa
+4949ff
+496d00
+496d55
+496daa
+496dff
+499200
+499255
+4992aa
+4992ff
+49b600
+49b655
+49b6aa
+49b6ff
+49db00
+49db55
+49dbaa
+49dbff
+49ff00
+49ff55
+49ffaa
+49ffff
+6d0000
+6d0055
+6d00aa
+6d00ff
+6d2400
+6d2455
+6d24aa
+6d24ff
+6d4900
+6d4955
+6d49aa
+6d49ff
+6d6d00
+6d6d55
+6d6daa
+6d6dff
+6d9200
+6d9255
+6d92aa
+6d92ff
+6db600
+6db655
+6db6aa
+6db6ff
+6ddb00
+6ddb55
+6ddbaa
+6ddbff
+6dff00
+6dff55
+6dffaa
+6dffff
+920000
+920055
+9200aa
+9200ff
+922400
+922455
+9224aa
+9224ff
+924900
+924955
+9249aa
+9249ff
+926d00
+926d55
+926daa
+926dff
+929200
+929255
+9292aa
+9292ff
+92b600
+92b655
+92b6aa
+92b6ff
+92db00
+92db55
+92dbaa
+92dbff
+92ff00
+92ff55
+92ffaa
+92ffff
+b60000
+b60055
+b600aa
+b600ff
+b62400
+b62455
+b624aa
+b624ff
+b64900
+b64955
+b649aa
+b649ff
+b66d00
+b66d55
+b66daa
+b66dff
+b69200
+b69255
+b692aa
+b692ff
+b6b600
+b6b655
+b6b6aa
+b6b6ff
+b6db00
+b6db55
+b6dbaa
+b6dbff
+b6ff00
+b6ff55
+b6ffaa
+b6ffff
+db0000
+db0055
+db00aa
+db00ff
+db2400
+db2455
+db24aa
+db24ff
+db4900
+db4955
+db49aa
+db49ff
+db6d00
+db6d55
+db6daa
+db6dff
+db9200
+db9255
+db92aa
+db92ff
+dbb600
+dbb655
+dbb6aa
+dbb6ff
+dbdb00
+dbdb55
+dbdbaa
+dbdbff
+dbff00
+dbff55
+dbffaa
+dbffff
+ff0000
+ff0055
+ff00aa
+ff00ff
+ff2400
+ff2455
+ff24aa
+ff24ff
+ff4900
+ff4955
+ff49aa
+ff49ff
+ff6d00
+ff6d55
+ff6daa
+ff6dff
+ff9200
+ff9255
+ff92aa
+ff92ff
+ffb600
+ffb655
+ffb6aa
+ffb6ff
+ffdb00
+ffdb55
+ffdbaa
+ffdbff
+ffff00
+ffff55
+ffffaa
+ffffff

reference/video.txt

@@ -0,0 +1,66 @@
+Videokretsen i TIKI-100 Rev C
+-----------------------------
+
+TIKI-100 inneholder kun bitmap-grafikk, dvs ingen tekstbaserte moduser.
+Prosessoren kan skrive direkte til skjermhukommelsen hvis bit 2 og 3 i
+systemregisteret (1CH) er satt.
+Grafikkhukommelsen representeres på skjermen på den intuitivt riktige måten.
+128 bytes per linje, alle disse bytene er etter hverandre i RAM. Totalt 256
+linjer:
+
+   +---------------------------------------+
+   |byte 0 ...                    byte 127 |
+   |byte 128 ...                  byte 255 |
+   |  .                                    |
+   |  .                                    |
+   |  .                                    |
+   |                                       |
+   |                                       |
+   |                                       |
+   |                                       |
+   |                                       |
+   |byte 32640 ...              byte 32767 |
+   +---------------------------------------+
+
+I/O-port 0CH - Modusregister
+
+Bit 7 = 1:  Skriv farge. Ved hver HBLANK legges fargen i fargeregister 14H inn i
+            pallettplass angitt av bit 0-3
+Bit 6:      Ikke brukt
+Bit 4-5:    Velger oppløsning
+            Bit 5    Bit 4
+            0        0
+            0        1        2 farger, 1024 kolonner
+            1        0        4 farger, 512 kolonner
+            1        1        16 farger, 256 kolonner
+            Alle 16 fargene i palletten benyttes av videokretsen i alle moduser.
+            Dersom ikke paletten settes slik det er tenkt kommer det fargerikt
+            rot på skjermen i 2 og 4 fargers modus. For 2-fargers modus: Sett
+            farge 2,4,6,8,10,12,14 lik farge 0, og farge 1,3,5,7,9,11,13,15 lik
+            farge 1. For 4-fargers modus: Sett farge 4,8,12 lik farge 0, farge
+            5,9,13 lik farge 1, farge 6,10,14 lik farge 2, og farge 7,11,15 lik
+            farge 3.
+Bit 0-3:    Hvilken plass i palletten fargen i fargeregisteret skal legges inn i
+            (hvis bit 7 = 1)
+
+I/O-port 14H - Fargeregister
+
+Dette brukes til mellomlagring av en farge før den lagres i palletten (se
+modusregister). Farger blandes slik:
+
+Bit 5-7: Rød intensitet
+Bit 2-4: Grønn intensitet
+Bit 0-1: Blå intensitet
+
+Registeret er invertert, dvs at 0 gir sterkest intensitet og 7 (3 for blåfarge)
+gir svakest intensitet. 
+
+Hardware-scrolling
+
+Hardware scrolling styres gjennom dataporten på lydkretsen AY-3-8912. Les mer om
+dette i egen tekst.
+
+---
+27 juni 2001
+Asbjørn Djupdal, djupdal@stud.ntnu.no
+