Z80 Simulator IDE External Modules Manual

Table Of Contents: General info z80simulatoride.ser er! "un#tions and $ro#edures %etmem! setmem! %etio! setio! z80nmi! z80int! z80reset! %et&alt! %et#r'stal! %et#lo#(#'#les! %etinst! %eta! %etf! %etb! %et#! %etd! %ete! %et&! %etl! %etix! %eti'! %ets$! %et$#! %eti! %etr! %eta)! %etf)! %etb)! %et#)! %etd)! %ete)! %et&)! %etl)! External #lient*ser ers ob+e#tinit! ob+e#trefres&! ,riteio! readio! ob+e#tterm! External modules interfa#e!

- General info Z80 Simulator IDE is an automation ./#ti e01 ser er*#lient a$$li#ation. T&is feature enables #ommuni#ation ,it& external simulation modules t&at #an be de elo$ed b' &ome de elo$ers and t&ird $arties usin% arious De elo$ment S'stems for 2indo,s. z80simulatoride.ser er External #lient a$$li#ation #an a##ess Z80 Simulator IDE ser er ser i#es b' #reatin% an /#ti e0 ob+e#t usin% z80simulatoride.ser er #lass. - "un#tions and $ro#edures 3ere is t&e list of fun#tions and $ro#edures a ailable for external #lient a$$li#ations: 4 %etmem %etmem.address1 fun#tion ,ill return t&e alue in t&e memor' lo#ation s$e#ified b' 5address5 ar%ument 60478898:. 4 setmem setmem.address! alue1 $ro#edure ,ill $ut t&e 5 alue5 ar%ument 604;88: in t&e memor' lo#ation s$e#ified b' 5address5 ar%ument 60478898:. 4 %etio %etio.address1 fun#tion ,ill return t&e alue on t&e I*O $ort s$e#ified b' 5address5 ar%ument 604;88:. 4 setio setio.address! alue1 $ro#edure ,ill $ut t&e 5 alue5 ar%ument 604;88: on t&e I*O $ort s$e#ified b' 5address5 ar%ument 604;88:. 4 z80nmi z80nmi.1 $ro#edure ,it& no ar%uments ,ill %enerate <MI interru$t si%nal. 4 z80int z80int.1 $ro#edure ,it& no ar%uments ,ill %enerate I<T interru$t si%nal. 4 z80reset z80reset.1 $ro#edure ,it& no ar%uments ,ill %enerate =ESET si%nal. 4 %et&alt %et&alt.1 fun#tion ,it& no ar%uments ,ill return t&e 3/>T state 604):. 4 %et#r'stal %et#r'stal.1 fun#tion ,it& no ar%uments ,ill return t&e #lo#( fre?uen#' $arameter. 4 %et#lo#(#'#les %et#lo#(#'#les.1 fun#tion ,it& no ar%uments ,ill return t&e number of #lo#( #'#les $assed after t&e start of t&e simulation. T&e last t,o fun#tions ,ill enable t&e external #lient a$$li#ation to de elo$ a real time be&a ior if needed. 4 %etinst %etinst.1 fun#tion ,it& no ar%uments ,ill return t&e mnemoni#s of last exe#uted instru#tion 6strin%:. 4 %eta %eta.1 fun#tion ,ill return t&e alue in / re%ister.

4 %etf %etf.1 fun#tion ,ill return t&e alue in " .fla%1 re%ister. 4 %etb %etb.1 fun#tion ,ill return t&e alue in @ re%ister. 4 %et# %et#.1 fun#tion ,ill return t&e alue in C re%ister. 4 %etd %etd.1 fun#tion ,ill return t&e alue in D re%ister. 4 %ete %ete.1 fun#tion ,ill return t&e alue in E re%ister. 4 %et& %et&.1 fun#tion ,ill return t&e alue in 3 re%ister. 4 %etl %etl.1 fun#tion ,ill return t&e alue in > re%ister. 4 %etix %etix.1 fun#tion ,ill return t&e alue in I0 re%ister. 4 %eti' %eti'.1 fun#tion ,ill return t&e alue in IA re%ister. 4 %ets$ %ets$.1 fun#tion ,ill return t&e alue in SB re%ister. 4 %et$# %et$#.1 fun#tion ,ill return t&e alue in BC re%ister. 4 %eti %eti.1 fun#tion ,ill return t&e alue in I re%ister. 4 %etr %etr.1 fun#tion ,ill return t&e alue in = re%ister. 4 %eta) %eta).1 fun#tion ,ill return t&e alue in alternate /5 re%ister. 4 %etf) %etf).1 fun#tion ,ill return t&e alue in alternate "5 re%ister. 4 %etb) %etb).1 fun#tion ,ill return t&e alue in alternate @5 re%ister. 4 %et#) %et#).1 fun#tion ,ill return t&e alue in alternate C5 re%ister. 4 %etd) %etd).1 fun#tion ,ill return t&e alue in alternate D5 re%ister. 4 %ete) %ete).1 fun#tion ,ill return t&e alue in alternate E5 re%ister. 4 %et&) %et&).1 fun#tion ,ill return t&e alue in alternate 35 re%ister. 4 %etl) %etl).1 fun#tion ,ill return t&e alue in alternate >5 re%ister. - External #lient*ser ers "ull su$$ort and full s'n#&ronization is a ailable for external a$$li#ations ,it& #lient*ser er #a$abilities. External ser er module s&ould $ro ide t&e follo,in% $ro#edures: 4 ob+e#tinit ob+e#tinit.1 $ro#edure ,ill be #alled at t&e be%innin% of t&e simulation in Z80 Simulator IDE. 2it& t&is $ro#edure external module s&ould be initialized to a (no,n initial state. 4 ob+e#trefres& ob+e#trefres&.1 $ro#edure ,ill be #alled after e er' simulated instru#tion. 4 ,riteio ,riteio.$ort!data1 $ro#edure ,ill be #alled after e er' simulated OCT instru#tion and its ar%uments ,ill be a ailable for t&e external module. 4 readio readio.$ort!data1 $ro#edure ,ill be #alled durin% t&e simulation of e er' I< instru#tion and t&e external module s&ould assi%n t&e non4ne%ati e alue 604;88: to t&e se#ond ar%ument .t&at s&ould be addressed b' referen#e and not b' alue1 onl' if it is assi%ned to t&e s$e#ified $ort ar%ument. 4 ob+e#tterm ob+e#tterm.1 $ro#edure needs to #ontain t&e #ode to terminate external module a$$li#ation .t'$i#all'

End statement1. External modules interfa#e T&e #lass name s&ould be set usin% External Modules interfa#e a ailable from Tools menu of Z80 Simulator IDE. External #lient*ser er a$$li#ations ,ill be started and terminated automati#all' ,it& Z80 Simulator IDE.