
         Ŀ
                 Ŀ 
                                                            
              Popis emultoru mikropotae SHARP MZ-800     
                           Verze 1.5                        
                
         Ĵ
                   Copyright (c) 1992,3 Perex soft           
                       Vechna prva vyhrazena               
         





                          Obsah



   1.      Hardwarov poadavky
   1.1           Distribun disketa
   2.      Emulace jednotlivch komponent
   2.1           Obrazovka
   2.2           Klvesnice
   2.3           Tiskrna
   2.4           Disketov jednotka
   2.5           RAM disk
   2.6           Programovateln zvukov genertor
   2.7           Hudebn soubory z Amigy
   3.      Debugger
   3.1           Breakpointy
   3.2           Pkazy
   3.3           Speciln klvesy
   3.4           Kazeta emultoru ZX Spectra
   4.      Typy pro uivatele
   5.      Typy pro programtora
   6.      Konfiguran soubor
   7.      Nov instrukce
   8.      Kazetov magnetofon
   9.      Budouc verze

.pa


1.   Hardwarov poadavky


  Minimln konfigurace potae PC, na kterm bude emultor pracovat je
  nsledujc:

           CPU            :  80386  (potae typu AT 386)
           Zkladn pam :  512kB
           Grafick karta :  VGA

                 a alespo jedna disketov mechanika (na kapacit nezle)

  Doporuen konfigurace je nsledujc:

           CPU            :  80386 nebo vy s taktem 25 Mhz
           Zkladn pam :  640kB
           Grafick karta :  VGA
           Pevn disk     :  alespo 1 MB volnho msta

                 a libovoln disketov mechanika



1.1        Distribun disketa



  Na distribun disket najdete tyto soubory:

           SHARP.EXE               - EMULTOR SHARPa
           ROM.SHA                 - upraven ROMka SHARPa
           CONFIG.SHA              - konfiguran soubor pro emultor
           CTIMNE.EXE              - program na prohlen souboru CTIMNE.TXT
           CTIMNE.TXT              - tento text
           POPIS.602               - tento text ve formtu T602
           FORM.EXE                - formtovac program pro CP/M


  Pokud se po zkoprovn na pevn disk povol v souboru CONFIG.SHA
  RAM disk, pak se vytv jet soubor pro RAM disk o velikost 512Kb.
  M nzev RD.SHA. Soubor RD.SHA se vytv vdy v podadresi, ve
  kterm je emultor. (Nedoporuuji jej povolit, pokud mte emultor
  na disket, ale je to mon).
  Soubory ROM.SHA a CONFIG.SHA mus bt t ve stejnm podadresi,
  ve kterm je emultor.
.pa


2.   Emulace jednotlivch komponent


2.1        Obrazovka

   Odchylky byly zatm zjitny pouze u nkterch typ VGA karet pi
   testech rozen video-RAM u program BASIC (originln) a INTERKARATE+.
   V mdu MZ-700 je zatm nevyeen tento problm: U karty EGA nebo VGA
   se zobrazuj znaky po 9-ti bodech, jenom nkter grafick znaky se zo-
   brazuj po 8-mi. Proto je u obrzk, kter jsou pevedeny do reimu
   MZ-700, nkde vidt svisl ry. Problm bude fixovn a seenu podn
   popis VGA karty. (Jestli jej nkdo m, a mi ho, prosm, nabdne !!!)


2.2        Klvesnice

   U n nebyly zjitny dn odchylky, ale nkter klvesy byly z dvod
   rozdlnosti klvesnic pesunuty na jin msto. Jsou to nsledujc
   klvesy:

   SHARP        PC
   
     ?          F10
   ALPHA        ALT
   GRAPH        `     (obrcen apostrof)
   Esc          Print Screen



   Nkter klvesy, kter SHARP nem, maj vznam pro emultor.

   Klvesa      Vznam
   
   F6           Barvy zapnout/vypnout
   F7           Zvuk zapnout/vypnout
   F8           Emulaci programovatelnho zvukovho gen. zap./vyp.
   Page Up      Zeslen zvuku z Amigy (viz. kap. 2.7)
   Page Down    Zeslaben zvuku z Amigy
   Scroll Lock  Reset
   Esc          Debugger


2.3        Tiskrna


   Emulace tiskrny probh pes paraleln port, kter je specifikovan
   v konfiguranm souboru (viz. kap. 6). Nebyly zjitny dn odchylky.
   Nen mon emulovat tiskrnu pes sriov port !!! Pokud nechcete
   tiskrnu emulovat, vlote msto sla tiskrny do konfiguranho sou-
   boru nulu. Je to teba nap. u her typu Bruce Lee, kde je chybn pe-
   dlan zvuk ze Spectra.
.pa


2.4        Disketov jednotka


   Originln adi pro SHARPa me ovldat a tyi mechaniky. Vtina
   pota PC m nejve mechaniky dv. Emulace druhch dvou mechanik
   je provdna na prvnch dvou mechanikch, take je mon (pokud mte
   vysokokapacitn mechaniky 5 1/4") pouvat najednou diskety naformto-
   van na 720kB a 320kB.

   Pklad:  konfigurace systmu CP/M     A: 720kB; B: 720kB
                                          C: 360kB; D: 360kB

             z hlediska potae PC to vypad nsledovn:

                 A: 720kB nebo 320kB (podle toho, jestli je aktivn
                                      v CP/M disk A: nebo C:)
                 B: 720kB nebo 320kB (podle toho, jestli je aktivn
                                      v CP/M disk A: nebo C:)

   Dleit upozornn:

     Nikdy nepouvejte disky A: a C: v CP/M najednou (teba pi
     koprovn) !!! Mohlo by to vst ke ztrt dat !!!
     To sam plat pro disky B: a D:

   Pokud mte v PC dv rozdln mechaniky (teba A: 1.2Mb a B: 1.44Mb)
   mete si je pomoc konfiguranho souboru prohodit (viz. kap. 6).


2.5        RAM disk


   RAM disk je emulovn na pevnm disku potae PC. Pokud je emulace
   povolena, vytvo se pi prvnm sputn emultoru soubor o velikosti
   512kB. Pokud nen msto na pevnm disku emulace nebude provdna !!!
   RAM disk se tv jako zlohovan. Testovno s operanm systmem
   LEC CP/M, programem RDTEST a Spectrum Debugger V1.1R.


2.6        Programovateln zvukov genertor


   Emulace nen zatm provdna v plnm rozsahu (vbec nen podporovn
   umov genertor). Emulaci je mon zapnout nebo vypnout klvesou F8
   na potai o taktu alespo 20 Mhz. U vtiny pota PC nen mon
   emulovat zvuk pi ten z disku, proto ho nedoporuuji spoutt u pro-
   gram, kter maj vce soubor na disket CP/M (BATMAN, LAST NINJA 2
   atd.)
.pa

2.7        Hudebn soubory z Amigy


   Na pozad bhu emultoru je mon spustit hran hudebnho souboru
   z Amigy (soubory s pponou .MOD  4 kanlov). Emultor je proto
   vybaven dvma novmi instrukcemi PLAY a STOP. Bli vysvtlen
   je v kapitole 7. Tuto hudbu nelze v dnm ppad kombinovat s
   emulac programovatelnho zvukovho genertoru !!!


3.   Debugger


   Integrovan debugger umouje programtorm stopnout kdykoli a
   kdekoli jakkoli program. Mimo to nabz nkolik slueb, kter
   usnaduj pevod program ze ZX Spectra na SHARPa.

   Jednoduch pohyb po pamti je mon pes nsledujc klvesy:
   PageUp, PageDown, kurzor nahoru, kurzor dol.

   Pokud se potebujete dostat na libovolnou adresu, sta ji pouze
   napsat a odeslat klvesou <Enter>. Pokud je adresa v dekadickm
   tvaru, mus ped n bt znak 'D' !!!  V hexadecimlnm tvaru nesm
   bt prvn psmeno - take pokud adresa zan psmeny A, B, C, D, E,
   F, mus ped nimi bt slice 0.

   V mdu zobrazovn instrukc je mon pout jednoduch assembler.
   Sta napsat pouze instrukci.

   Nap.:        Ready : LD A,B



3.1        Breakpointy


   Breakpoint je mon dt kdekoli - i do ROM. ROMka se d samozejm
   i modifikovat. Kd breakpointu je 6DH - instrukce LD L,L. Breakpoint
   se nastavuje nebo ru klvesou F2.

   Pokud chcete, aby se program zastavil na pozici kurzoru, tak pouijte
   klvesu F4.

   Program je mon i krokovat pomoc klvesy F7.

   Specialn krokovn je mon pomoc klvesy F8. Nejsou krokovny
   podprogramy.
.pa

3.2        Pkazy


   Pkaz mus pedchzet znak lomeno '/'.

 Ŀ
 Pkaz Parametry               Vznam                                  
 Ĵ
  C      ----                   pepn disassembler do zobrazovn     
                                instrukc                               
 Ĵ
  D      ----                   pepn disassembler do zobrazovn     
                                byt                                    
 Ĵ
  W      ----                   pepn disassembler do zobrazovn     
                                slov                                    
 Ĵ
  L      ---- nebo <KAM>        nahraje vybran soubor typu .MZF        
                                do pamti, pokud nen udna adresa      
                                <KAM>, nahraje se na msto specifikov  
                                v hlavice                              
                                Nap. /L3000                            
                                      - nahraje vybran soubor od       
                                        adresy 3000H                    
 Ĵ
  S      ----                   nahraje st pamti jako soubor .MZF    
                                (dal daje se zadvaj pozdji)       
 Ĵ
  F      <ODKUD>, <CO>, <CO> .. hled specifikovan byty v pamti od    
                                adresy <ODKUD>                          
                                Nap. /F1000,0cd,10,3d,_,10             
                                      - znak '_' znamen libovoln byte 
                                      - hled od adresy 1000H sekvenci  
                                        0CDH, 10H, 3DH, ??, 10H         
 Ĵ
  /      ----                   hled dal vskyt sekvence specifiko-  
                                van pkazem /F                        
 
.pa

 Ŀ
 Pkaz Parametry               Vznam                                  
 Ĵ
  K      ----                   pepn ASCII a SHARP ASCII             
 Ĵ
  M      <ODKUD>,<KAM>,<KOLIK>  penese sek pamti od adresy <ODKUD>   
                                na adresu <KAM> o dlce <KOLIK>         
 Ĵ
  H      <ODKUD>, <KOLIK>, <CO> nastav sek pamti od adresy <ODKUD>   
                                o dlce <KOLIK> na byte <CO>            
 Ĵ
  O      <KAM>, <DOS SOUBOR>    nahraje do pamti na adresu <KAM>       
                                DOSov soubor, kter m nzev           
                                <DOS SOUBOR>                            
 Ĵ
  Q      <KAM>,<CIS>,<KAZETA>   nahraje do pamti na adresu <KAM>       
                                blok, kter m slo <CIS> z kazety,    
                                kter m nzev <KAZETA>. Vysvtlen     
                                v kap. 3.4                              
 Ĵ
  V      <ADRESA>               pepot adresu z VRAM ZX Spectra      
                                do VRAM SHARPa.                         
 Ĵ
  =      <VRAZ>                kalkulaka, spot zadan vraz        
 Ĵ
  RX     <strnka>              vybere 64Kb strnku na ram-disku, se    
                                kterou budou pracovat pkazy RR a RW   
 Ĵ
  RR     <kam>,<dokud>          nahraje z vybran strnky z ram-disku   
                                oblast kam - dokud                      
 Ĵ
  RW     <kam>,<dokud>          ulo na vybranou strnku na ram-disk   
                                oblast kam - dokud                      
 

  Pkazy, kter neuvd '/':
   B=<CO>, <CO> ....               zape do pamti od pozice kurzoru
                                   byty specifikovan <CO>
   A=<etzec>                     zape do pamti ASCII etzec, kter
                                   ukon nulou
   S=<etzec>                     zape do pamti SHARP ASCII etzec,
                                   kter ukon nulou

   V parametrech, kde je oekvna adresa, nebo byte je mono pout
   opertor +, -, * a /. Dle je mon pout nzv registr
   (AF, BC, DE, HL, IX, IY, SP, PC, A1, B1, D1, H1). Pokud chcete
   pout oznaen registru ve specifikaci adresy, kam se m disassembler
   nastavit, pouijte ped nm sekvenci 0+.
   Ve vrazech nen mon pout zvorky. Vpoet probh vdy zprava do
   leva !!!

   P.:    10+PC                   ; nastav aktun adresu na PC + 10H
           /V4000+d18              ; pepot adresu 4012H na adresu
                                     8016H
.pa


3.3        Speciln klvesy


   Klvesa      Akce
 
   F1           sten status emultoru
   F2           Nastaven/zruen breakpointu
   F4           Zastav program na pozici kurzoru v debuggeru
   F5           Pohled na obrazovku SHARPA
   F6           Pohled na obrazovku ZX Spectra
   F7           Provede jednu instrukci
   F8           Provede jednu instrukci. Pokud je to instrukce
                CALL, tak se emultor zastav a po proveden
                podprogramu.
   F9           Spout emulaci
   F10          Nastavuje registr PC na adresu, na kter je kurzor




3.4        Kazeta emultoru ZX Spectra



   Tato kazeta je vlastn DOSov soubor s pponou .SPC. Jsou v nm
   uloeny jednotliv bloky (hlavika, program atd.). Tuto kazetu
   pouv emultor ZX Spectra, kter je od polskch autor.
   Pokud budete chtt s tmito kazetami pracovat zalu Vm, na po-
   dn, jejich popis.



4.    Typy pro uivatele



   - diskety nelze formtovat pod emultorem. K tomu slou program
     FORM.EXE.
   - DOSov diskety nelze pout pod CP/M, protoe maj jin formt
     (u SHARPa) !!! Lze z nich ovem st a zapisovat pomoc programu
     XDOS pod CP/M.
.pa


5.   Typy pro programtory


   - vtina program vytvoench v emultoru bude mt pravdpodobn
     problmy s asovnm. Proto provete jemn doladn pmo na SHARPu.
   - dky jednoduch dekdovac metod u assembleru se musej nkter
     instrukce zapsat v kdech pomoc pkazu B=
     Jsou to nap. instrukce : RLD, RRD apod.


6.   Konfiguran soubor


   V konfiguranm souboru (CONFIG.SHA) lze nastavit nsledujc para-
   metry:

DRIVE=<X>              <X> - pokud je 0 jsou disky A: a B: standartn
                           - pokud je 1 jsou disky A: a B: prohozen
AMUSIC=<X>             <X> - pokud je 0 je hudba z Amigy a emulace PSG
                             zakzna (vhodn pro pomalej potae)
                           - pokud je 1 je hudba a PSG povolena
AFREQ=<X>              <X> - udv frekvenci, pod kterou pob hudba
                             z Amigy a emulace PSC (od 16000 do 23000);
                             nejlep vsledky jsou kolem 22000;
                             zde zle na rychlosti potae -
                             22000 Hz se zvld od 25Mhz !!!
HRDWR=<X>              <X> - specifikace pes jak hardware se bude hrt
                             hudba z Amigy nebo emulovat PSG
                                   0 - vestavn reproduktor
                                   1 - D/A pevodnk na LPT 1
                                   2 - D/A pevodnk na LPT 2
RAMDRIVE=<X>           <X> - pokud je 0 nebude RAM disk emulovn
                           - pokud je 1 bude RAM disk emulovn
LPT=<X>                <X> - uruje na kter port bude emulovan tiskrna
                             (1-4), pokud je 0 je emulace tiskrny vypnut
VGACOL=<X>             <X> - standartn je 0, pokud budete mt problmy
                             s barvami zkuste 1
S256=<X>               <X> - pro normln disktety CP/M - 0, pokud
                             jsou diskety nap. s BETA DISC CONTROL SYSTEM 3
                             tak zde mus bt 1

   Standartn konfiguran soubor (CONFIG.SHA):

DRIVE=0
AMUSIC=0
AFREQ=16000
@CP 5
HRDWR=0
RAMDRIVE=0
LPT=1
VGACOL=0
S256=0

.pa

   Poad nemus bt dodreno, ale hodnoty musej bt v urenm rozsahu !!!
   Konfiguran soubor lze editovat v libovolnm ASCII editoru.



7.   Nov instrukce


Ŀ
Kd      Nzev      Popis                                               
Ĵ
ED,FA    PLAY       Registr DE mus ukazovat na nzev hudebnho modulu  
                    z Amigy. Nzev mus bt v ASCII a ukonen nulou.   
                    Hudba se hraje na pozad. CY = 1 - chyba            
Ĵ
ED,FB    STOP       Zruen hudby z Amigy.                              
Ĵ
ED,FC    LOAD PRG   HL - kam, BC - velikost. Nahraje soubor nebo st   
                    souboru do pamti. Tuto instrukci mus pedchzet   
                    instrukce LOAD HEAD nebo instrukce LOADS HEAD.      
                    CY = 1 - chyba (lze pout pouze pro soubory, kter 
                    maj formt MZF)                                    
Ĵ
ED,FD    WAIT       ek na stisk klvesy                               
Ĵ
ED,FE    LOAD HEAD  HL - kam, DE - ukazatel na soubor. Soubor mus bt  
                    v ASCII a ukonen nulou. Nahraje hlaviku MZF sou- 
                    boru do pamti na adresu HL.                        
Ĵ
ED,FF    LOADS HEAD HL - kam. Nahraje do pamti hlaviku vybranho MZF  
                    souboru.                                            




8.   Kazetov magnetofon


   Emulace kazetovho magnetofonu nen provdna. Pokud provedete v hlavnm
   menu po nahrn emultoru volbu <C> (Cassete tape), pak emultor vype
   vechny soubory s pponou .MZF, kter se nachzej v souasnm adresi.
   Pohyb po souborech je umonn kurzorovmi klvesami. Klvesou <Enter>
   se zadan program nahraje do emultoru. Klvesou <Esc> se zru poadavek
   na nahrn programu.
   Formt .MZF je toton s formtem .MZF, jak pouvaj programy v CP/M.
   Pomoc programu XDOS nebo podobnho sta soubory pekonvertovat do for-
   mtu DOSu nebo je spoutet z disket operanho systmu CP/M. Vceblokov
   hry se musej samozejm upravit.

.pa

9.   Budouc verze


     Vvoj emultoru jsem v souasn dob pln zastavil a nepedpokldm,
     e ho obnovm. Nemm na to chu ani penze. Pokud m nkdo schopn
     zjem o zdrojov kdy k tomuto emultoru, tak za stku 1000,- K jsem
     mu je ochoten dt. Tu stku berte jako symbolickou. Pochybuju, e
     byste nkde zskali 450kB zdrojk v ASSEMBLERu a Borland C++ 3.0 za
     takovou cenu.


Na zvr ...

     bych chtl podkovat "firmm" RDOS SOFTWARE a MICROCODE za obtavou
     spoluprci a zapjen potebnch materil.

     V souasn dob m emultor okolo 450kB zdrojovch text vtinou
     pro assembler (cel emulace SHARPa) a zbytek jsou Ckovsk zdrojov
     texty (debugger apod.). Pokud bych ml odhadnout dobu vvoje tohoto
     programu, tak je to cca 5 msc. A to ji nepotm as, kter jsem
     strvil studovnm materil popisujcch nejrznj hardware PC,
     kter emultor pouv. Stejn jsem nkter triky musel zskat pmo
     z VGA BIOSu, jeliko nebyly popsny v dn literatue, kterou jsem
     zskal.


.pa


!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

V DNM PPAD SE NA M NEOBRACEJTE S DOSTMI O OPRAVU CHYB NEBO JAK CO
NAKONFIGUROVAT. BERTE TENTO PROGRAM JAKO - FREEWARE - BEZ PODPORY.

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!


                                   Jaroslav Kysela alias Perex

                                   InterNet: kysela@virgo.jcu.cz
                                   FidoNet : RST Communications BBS (SysOp)
                                             2:423/84.30 (doasn)


                 !!! ZMNY VYHRAZENY !!!
                     !!! ZMNY VYHRAZENY !!!
                        !!! ZMNY VYHRAZENY !!!
                           !!! ZMNY VYHRAZENY !!!
                              !!! ZMNY VYHRAZENY !!!