Z80 Download - Z80 Quellcode Download

Z80

C#-Quellcode

v0.2-pre-2024-09-21

Herunterladen

Zilog Z80 -CPU -Emulator

Einführung

Die Z80 -Bibliothek implementiert einen schnellen, kleinen und genauen Emulator des Zilog Z80. Es emuliert alles, was bisher über diese CPU bekannt ist, einschließlich der undokumentierten Verhaltensweisen, Memptr, Q und dem besonderen Reset. Es hat auch die Ehre, das erste Open-Source-Projekt gewesen zu sein, das den Interrupt-Modus 0 vollständig nachahmt.

Der Quellcode ist in ANSI C für maximale Portabilität geschrieben und wird ausgiebig kommentiert. Ziel war es, ein gut strukturiertes, leicht verständliches Stück Software zu schreiben. Etwas Solides und Elegantes, das den Test der Zeit bestehen kann, ohne wesentliche Veränderungen erforderlich zu machen.

Genauigkeit

Dieser Z80-CPU-Emulator verfügt über ein klassisches Design mit Granularität auf Befehlsebene, das die beste Leistung liefert und gleichzeitig eine angemessene Flexibilität bietet, um Genauigkeit auf das T-St-State-Level zu erreichen.

Die Granularität auf Befehlsebene impliziert, dass die Ausführung einer bestimmten Anweisung außer in einigen gut definierten Fällen erst aufhören kann, wenn alle internen M-Zykle verarbeitet wurden (dh Anweisungen werden nicht in Mikrooperationen unterteilt). Darüber hinaus werden Register nur einmal pro Anweisung geändert und der T-State-Zähler wird normalerweise aktualisiert, nachdem eine vollständige Anweisung ausgeführt wurde.

Anweisungen, Flaggen, Speicherzugriffe, Interrupts, Taktzyklen usw. werden jedoch entsprechend den verfügbaren technischen Dokumentationen, den nach Jahrzehnten der Forschung an Z80 und elektronischen Simulationen vorgenommenen Ergebnisse genau emuliert. Und natürlich führt der Emulator die bisher umfassendsten Tests durch, einschließlich aller drei Haupttestsuiten:

Zilog Z80 CPU Test Suite von Patrik Rak

Diese Programmgruppe soll den Autoren der Emulator helfen, die gewünschte Ebene der CPU -Emulationsauthentizität zu erreichen. Jedes der eingeschlossenen Programme führt eine erschöpfende Berechnung mit jeder der getesteten Z80 -Anweisungen durch, vergleicht die Ergebnisse mit Werten, die aus einem realen Sinclair -ZX -Spektrum 48K mit Zilog Z80 -CPU erhalten wurden, und meldet alle erkannten Abweichungen.

Ergebnisse (v1.0)

z80full.tap ^{Tests alle Flaggen und Register.}	Z80DOC.TAP ^{Tests alle Register, aber nur offiziell dokumentierte Flaggen.}

Z80FLAGS.TAP ^{Tests alle Flaggen, ignoriert Register.}	Z80DOCFLAGS.TAP ^{Tests nur dokumentierte Flags, ignoriert Register.}

Z80CCF.TAP ^{Testen Sie alle Flags nach der Ausführung von ccf nach jedem getesteten Befehl.}	Z80Memptr.tap ^{Testen Sie alle Flags nach der Ausführung von bit N,(hl) nach jedem getesteten Befehl.}

Ergebnisse (v1.2a)

z80full.tap ^{Tests alle Flaggen und Register.}	Z80DOC.TAP ^{Tests alle Register, aber nur offiziell dokumentierte Flaggen.}

Z80FLAGS.TAP ^{Tests alle Flaggen, ignoriert Register.}	Z80DOCFLAGS.TAP ^{Tests nur dokumentierte Flags, ignoriert Register.}

Z80CCF.TAP ^{Testen Sie alle Flags nach der Ausführung von ccf nach jedem getesteten Befehl.}	Z80Memptr.tap ^{Testen Sie alle Flags nach der Ausführung von bit N,(hl) nach jedem getesteten Befehl.}

Z80 Testsuite von Mark Woodmass

Diese Suite führt eine Reihe von Tests durch, um die MEMPTR -Dokumente ^{(englisch, russisch)} zu überprüfen, die genau richtig sind, sowie einen kurzen Lauf durch einige der CBh/DDh/FDh -Opcode -Bereiche. Die Testergebnisse im Programm werden mit denen einer NEC D780C-1-CPU verglichen, aber Simon Conway testete freundlicherweise mehrere andere Z80-Klone und bestätigte dieselben Ergebnisse.

Ergebnisse

Z80Tests.tap

Z80 -Anweisungssatz Tainer von Frank D. Cringle

Der Z80 -Befehlssatz von Frank Cringle versucht, jeden Z80 -Opcode auszuführen, sie durch einen Testzyklus zu setzen und die Ergebnisse mit den tatsächlichen Ergebnissen zu vergleichen, indem sie den Code auf einem echten Z80 ausführen. Der Trainer wird mit Franks Yaze (noch einem Z80 -Emulator) geliefert. Es ist oft schwierig, aufzuspüren, also hat Jonathan Graham Harston es hier zusammengestellt, sowie einige Konvertierungen. Die neueste Veröffentlichung von Yaze ist auf der Website von Andreas Gerlich erhältlich.

Ergebnisse (Jonathan Graham Harstons Version)

zexdoc.tap ^{Tests dokumentierten offiziell Flag -Effekte.}	zexall.tap ^{Tests alle Flaggenänderungen.}

Ergebnisse (Version von Jan Bobrowski)

zexfix.tap ^{Tests alle Flaggenänderungen.}	zexbit.tap ^{Tests alle Flag -Änderungen der bit -Anweisungen.}

Ergebnisse (Patrik Raks Version)

zexall2.tap

Installation

Debian, Ubuntu und andere Debian-basierte Linux-Verteilungen

Fügen Sie zunächst das zxe -Repository hinzu und aktualisieren Sie den Paketindex:

sudo mkdir -pm700 /root/.gnupg
sudo mkdir -pm755 /etc/apt/keyrings
sudo gpg --no-default-keyring --keyring /etc/apt/keyrings/zxe-archive-keyring.gpg --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys FE214A38D6A0C01D9AF514EE841EA3BD3A7E1487
echo " deb [arch= $( dpkg --print-architecture ) signed-by=/etc/apt/keyrings/zxe-archive-keyring.gpg] https://zxe.io/repos/apt stable main " | sudo tee /etc/apt/sources.list.d/zxe.list
sudo apt update

Installieren Sie als nächstes das Bibliothekspaket:

sudo apt install libz80

Wenn Sie Software erstellen müssen, für die die Z80 -Bibliothek erforderlich ist, installieren Sie auch das Entwicklungspaket:

sudo apt install libz80-dev

Gentoo

Fügen Sie zuerst die zxe -Overlay hinzu und synchronisieren Sie:

eselect repository add zxe git https://github.com/redcode/zxe-gentoo-overlay.git
emaint sync --repo zxe

Dann installieren Sie die Bibliothek:

emerge emulation-libs/z80

Homebrew

brew install redcode/zxe/z80

Fenster

Vorgefertigte Binärdateien für Windows sind auf der Download-Seite verfügbar.

Installation aus Quellen

Sie benötigen CMake v3.14 oder später, um das Paket zu erstellen, und optional aktuelle Versionen von Doxygen, Sphinx und Atem, um die Dokumentation zu erstellen. Stellen Sie außerdem sicher, dass Sie Latex mit PDF -Support auf Ihrem System installiert haben, wenn Sie die Dokumentation im PDF -Format generieren möchten.

Der Emulator benötigt einige Typen und Makros, die in Zeta enthalten sind, einer Abhängigkeitsfreien, die nur mit Header-Nur-Header-Bibliothek verwendet wird, um die Kompatibilität bei den meisten C-Compilern beizubehalten. Installieren Sie Zeta oder extrahieren Sie seinen Quellcode -Tarball in das Stammverzeichnis des Z80 -Projekts oder des übergeordneten Verzeichnisses. Zeta ist die einzige Abhängigkeit; Der Emulator ist eine freistehende Implementierung und hängt als solche nicht von der C -Standardbibliothek ab.

Sobald die Voraussetzungen erfüllt sind, erstellen Sie ein Verzeichnis und führen Sie cmake von dort aus, um das Build -System vorzubereiten:

mkdir build
cd build
cmake [options] < Z80-project-directory >

Die resultierenden Build -Dateien können konfiguriert werden, indem Optionen an cmake übergeben werden. Geben Sie Folgendes ein:

cmake -LAH -N -B .

Lesen Sie im Zweifelsfall die CMAKE -Dokumentation für weitere Informationen zu Konfigurationsoptionen. Im Folgenden sind einige der relevantesten Standardoptionen von CMake aufgeführt:

-DBUILD_SHARED_LIBS=(YES|NO)
Generieren Sie gemeinsame Bibliotheken anstatt statische Bibliotheken.
Der Standard ist NO .
-DCMAKE_BUILD_TYPE=(Debug|Release|RelWithDebInfo|MinSizeRel)
Wählen Sie den zu generierenden Buildtyp (Konfiguration).
Die Standardeinstellung ist Release .
-DCMAKE_INSTALL_NAME_DIR="<path>"
Geben Sie den Verzeichnisanteil der dynamischen Bibliotheksnamen auf Apple -Plattformen (für installierte freigegebene Bibliotheken) an.
Standardmäßig nicht definiert.
-DCMAKE_INSTALL_PREFIX="<path>"
Geben Sie das Installationspräfix an.
Die Standardeinstellung ist "/usr/local" (auf UNIX- und UNIX-ähnlichen Betriebssystemen).

Paketspezifische Optionen werden mit Z80_ vorangestellt und können in zwei Gruppen unterteilt werden. Der erste steuert Aspekte, die sich nicht mit dem Quellcode der Bibliothek beziehen:

-DZ80_DEPOT_LOCATION="<location>"
Geben Sie das Verzeichnis oder die URL des Depots an, das die Testdateien enthält (dh die vom Test -Tool erforderliche Firmware und Software).
Der Standardwert ist "http://zxe.io/depot" .
-DZ80_FETCH_TEST_FILES=(YES|NO)
Kopieren oder laden Sie die Testdateien aus dem Depot in das Build -Verzeichnis.
Der Standard ist NO .
-DZ80_INSTALL_CMAKEDIR="<path>"
Geben Sie das Verzeichnis an, in dem das CMAKE-Konfigurations-File-Paket installiert werden soll.
Der Standardwert ist "${CMAKE_INSTALL_LIBDIR}/cmake/Z80" .
-DZ80_INSTALL_PKGCONFIGDIR="<path>"
Geben Sie das Verzeichnis an, in dem die PKG-Config-Datei installiert werden soll.
Der Standardwert ist "${CMAKE_INSTALL_LIBDIR}/pkgconfig" .
-DZ80_NOSTDLIB_FLAGS=(Auto|"[<flag>[;<flag>...]]")
Geben Sie die Linker -Flags an, die verwendet werden, um die Verknüpfung mit Systembibliotheken zu vermeiden.
Die Standardeinstellung ist Auto (Autoconfigure -Flags). Wenn Sie Linker -Fehler erhalten, setzen Sie diese Option auf "" .
-DZ80_OBJECT_LIBS=(YES|NO)
Erstellen Sie den Emulator als Objektbibliothek.
Diese Option hat Vorrang vor BUILD_SHARED_LIBS und Z80_SHARED_LIBS . Wenn aktiviert, ignoriert das Build -System Z80_WITH_CMAKE_SUPPORT und Z80_WITH_PKGCONFIG_SUPPORT , da keine Bibliotheken oder Support -Dateien installiert werden.
Der Standard ist NO .
-DZ80_SHARED_LIBS=(YES|NO)
Erstellen Sie den Emulator eher als gemeinsame Bibliothek als als statisch.
Diese Option hat Vorrang vor BUILD_SHARED_LIBS .
Standardmäßig nicht definiert.
-DZ80_SPHINX_HTML_THEME="[<name>]"
Geben Sie das Sphinx -Thema für die Dokumentation im HTML -Format an.
Die Standardeinstellung ist "" (verwenden Sie das Standardthema).
-DZ80_WITH_CMAKE_SUPPORT=(YES|NO)
Generieren und installieren Sie das CMAKE-Konfigurationsfilmpaket.
Der Standard ist NO .
-DZ80_WITH_HTML_DOCUMENTATION=(YES|NO)
Erstellen und installieren Sie die Dokumentation im HTML -Format.
Es erfordert Doxygen, Sphinx und Atem.
Der Standard ist NO .
-DZ80_WITH_PDF_DOCUMENTATION=(YES|NO)
Erstellen und installieren Sie die Dokumentation im PDF -Format.
Es erfordert Doxygen, Sphinx, Atem und Latex mit PDF -Unterstützung.
Der Standard ist NO .
-DZ80_WITH_PKGCONFIG_SUPPORT=(YES|NO)
Generieren und installieren Sie die PKG-Config-Datei.
Der Standard ist NO .
-DZ80_WITH_STANDARD_DOCUMENTS=(YES|NO)
Installieren README die mit dem Paket verteilten HISTORY : AUTHORS , COPYING , COPYING.LESSER THANKS
Der Standard ist NO .
-DZ80_WITH_TESTS=(YES|NO)
Erstellen Sie das Testwerkzeug.
Der Standard ist NO .

Die zweite Gruppe von paketspezifischen Optionen konfiguriert den Quellcode der Bibliothek, indem sie Makros vordefinieren, die optionale Funktionen ermöglichen:

-DZ80_WITH_EXECUTE=(YES|NO)
Erstellen Sie die Implementierung der Funktion z80_execute .
Der Standard ist NO .
-DZ80_WITH_FULL_IM0=(YES|NO)
Erstellen Sie die vollständige Implementierung des Interrupt -Modus 0 anstelle des reduzierten.
Der Standard ist NO .
-DZ80_WITH_IM0_RETX_NOTIFICATIONS=(YES|NO)
Aktivieren Sie optionale Benachrichtigungen für eine reti oder retn -Anweisung, die während der Reaktion des Interrupt -Modus 0 ausgeführt wird.
Der Standard ist NO .
-DZ80_WITH_Q=(YES|NO)
Erstellen Sie die Implementierung von Q.
Der Standard ist NO .
-DZ80_WITH_SPECIAL_RESET=(YES|NO)
Erstellen Sie die Implementierung des Sonderrücksatzes.
Der Standard ist NO .
-DZ80_WITH_UNOFFICIAL_RETI=(YES|NO)
Konfigurieren Sie die undokumentierten Anweisungen ED5Dh , ED6Dh und ED7Dh als reti anstelle von retn .
Der Standard ist NO .
-DZ80_WITH_ZILOG_NMOS_LD_A_IR_BUG=(YES|NO)
Erstellen Sie die Implementierung des Fehlers, der den Zilog Z80 -NMOs beeinflusst, wodurch das P/V -Flag zurückgesetzt wird, wenn während der Ausführung der ld a,{i|r} Anweisungen ein maskierbarer Interrupt angenommen wird.
Der Standard ist NO .

Paketwartenden werden aufgefordert, mindestens die folgenden Optionen für die freigegebene Bibliothek zu verwenden:

 -DZ80_WITH_EXECUTE=YES
-DZ80_WITH_FULL_IM0=YES
-DZ80_WITH_IM0_RETX_NOTIFICATIONS=YES
-DZ80_WITH_Q=YES
-DZ80_WITH_ZILOG_NMOS_LD_A_IR_BUG=YES

Sobald das Build -System entsprechend Ihren Anforderungen konfiguriert ist, erstellen und installieren Sie das Paket:

cmake --build . [--config (Debug | Release | RelWithDebInfo | MinSizeRel)]
cmake --install . [--config < configuration > ] [--strip]

Die Option --config ist nur für die CMake -Generatoren erforderlich, die CMAKE_BUILD_TYPE (z. B. Xcode und Visual Studio) ignorieren. Verwenden Sie --strip , um Debugging-Informationen und nicht öffentliche Symbole bei der Installation von Nicht-Debug-Builds der gemeinsam genutzten Bibliothek zu entfernen.

Tl; dr

Verwenden Sie Folgendes, um den Emulator als gemeinsame Bibliothek zu erstellen und zusammen mit den Entwicklungsdateien in $HOME/.local : zu installieren:

mkdir work && cd work
git clone https://github.com/redcode/Zeta.git
git clone https://github.com/redcode/Z80.git
cd Zeta
mkdir build && cd build
cmake 
	-DCMAKE_BUILD_TYPE=Release 
	-DCMAKE_INSTALL_PREFIX= " $HOME /.local " 
	-DZeta_WITH_CMAKE_SUPPORT=YES 
	-DZeta_WITH_PKGCONFIG_SUPPORT=YES 
	..
cmake --install . --config Release
cd ../../Z80
mkdir build && cd build
cmake 
	-DBUILD_SHARED_LIBS=YES 
	-DCMAKE_BUILD_TYPE=Release 
	-DCMAKE_INSTALL_NAME_DIR= " $HOME /.local/lib " 
	-DCMAKE_INSTALL_PREFIX= " $HOME /.local " 
	-DZ80_WITH_CMAKE_SUPPORT=YES 
	-DZ80_WITH_PKGCONFIG_SUPPORT=YES 
	-DZ80_WITH_EXECUTE=YES 
	-DZ80_WITH_FULL_IM0=YES 
	-DZ80_WITH_IM0_RETX_NOTIFICATIONS=YES 
	-DZ80_WITH_Q=YES 
	-DZ80_WITH_ZILOG_NMOS_LD_A_IR_BUG=YES 
	..
cmake --build . --config Release
cmake --install . --config Release --strip

^{Build-and-Install-Z80.sh}

Die Tests ausführen

Das Paket enthält ein Tool namens test-Z80 , mit dem die relevantesten CP/M- und ZX-Spektrumversionen der Haupttestsuiten ausgeführt werden können. Konfigurieren Sie das Build -System mit -DZ80_WITH_TESTS=YES , um seine Kompilierung und -DZ80_FETCH_TEST_FILES=YES zu aktivieren, um die erforderliche Firmware und Software herunterzuladen. Beachten Sie auch, dass die Z80 -Bibliothek mit -DZ80_WITH_Q=YES erstellt werden muss, um die Tests von Patrik Rak bestehen zu können.

Sobald Sie das Paket erstellt haben, geben Sie Folgendes ein, um alle Tests auszuführen:

./test-Z80 -p depot/firmware -p depot/software/POSIX -p " depot/software/ZX Spectrum " -a

Das Tool unterstützt Optionen und kann die Tests einzeln ausführen (Typ ./test-Z80 -h für Hilfe). Wenn Sie es vorziehen, alle Tests über Ctest auszuführen, verwenden Sie diesen Befehl:

ctest --verbose --build-config (Debug | Release | RelWithDebInfo | MinSizeRel)

Die vollständigen Protokolle, die durch test-Z80 erzeugt werden, die verschiedene CPU-Varianten emulieren, finden Sie hier:

Zilog nmos
Zilog CMOS
NEC NMOS
St. CMOS

Notiz

Die CRC -Fehler in den Protokollen der NEC -NMOS -Variante sind normal und stimmen mit den auf realen Hardware erhaltenen Werten überein. Die ST CMOS -Variante wird derzeit untersucht.

Tl; dr

Verwenden Sie Folgendes, um den Emulator zu erstellen und zu testen:

mkdir work && cd work
git clone https://github.com/redcode/Zeta.git
git clone https://github.com/redcode/Z80.git
cd Z80
mkdir build && cd build
cmake 
	-DCMAKE_BUILD_TYPE=Release 
	-DZ80_FETCH_TEST_FILES=YES 
	-DZ80_WITH_TESTS=YES 
	-DZ80_WITH_EXECUTE=YES 
	-DZ80_WITH_FULL_IM0=YES 
	-DZ80_WITH_IM0_RETX_NOTIFICATIONS=YES 
	-DZ80_WITH_Q=YES 
	-DZ80_WITH_ZILOG_NMOS_LD_A_IR_BUG=YES 
	..
cmake --build . --config Release
ctest --verbose --build-config Release

^{bau- und test-z80.sh Build-and-Test-Z80.bat}

Integration

Als externe Abhängigkeit in CMake-basierten Projekten

Die Z80-Bibliothek enthält ein Konfigurations-File-Paket zur Integration in CMake-basierte Projekte, die für die Entwicklung installiert werden müssen. Verwenden Sie find_package , um das Z80 -Paket zu finden. Dadurch werden das Z80 importierte Bibliotheksziel erstellt, das die erforderlichen transitiven Verbindungsabhängigkeiten enthält. Optional kann die Verknüpfungsmethode ausgewählt werden, indem entweder die Shared oder Static Komponente angegeben wird.

Beispiel:

 find_package (Z80 REQUIRED Shared)
target_link_libraries (your- target Z80)

Wenn nicht als Komponente angegeben ist, wird die Verknüpfungsmethode gemäß Z80_SHARED_LIBS ausgewählt. Wenn diese Option nicht definiert ist, verwendet das Config-File den auf dem System installierten Bibliothekstyp. Wenn er sowohl die gemeinsam genutzten als auch die statischen Versionen findet, bestimmt BUILD_SHARED_LIBS , gegen die man verknüpfen soll.

Als CMake -Unterprojekt

Um die Z80 -Bibliothek als CMake -Unterprojekt einzubetten, extrahieren Sie die Quellcode -Tarballs von Zeta und Z80 (oder klonen ihre jeweiligen Repositorys) in ein Unterverzeichnis eines anderen Projekts. Verwenden Sie dann add_subdirectory im übergeordneten Projekt, um den Z80 -Quellcode -Baum zum Build -Prozess hinzuzufügen (NB, das Z80 -Unterprojekt findet automatisch Zeta und importiert es als Schnittstellenbibliothek).

Es ist ratsam, die Z80 -Bibliothek im CMakeLists.txt des übergeordneten Projekts zu konfigurieren. Dies verhindert, dass der Benutzer Konfigurationsoptionen für das Z80 -Unterprojekt über die Befehlszeile beim Erstellen des Hauptprojekts angeben muss.

Beispiel:

 set (Z80_SHARED_LIBS                 NO  CACHE BOOL "" )
set (Z80_WITH_Q                      YES CACHE BOOL "" )
set (Z80_WITH_ZILOG_NMOS_LD_A_IR_BUG YES CACHE BOOL "" )

add_subdirectory (dependencies/Z80)
target_link_libraries (your- target Z80)

Es ist wichtig, die Option Z80_SHARED_LIBS festzulegen. Andernfalls erstellt CMake den von BUILD_SHARED_LIBS angegebenen Bibliothekstyp, der möglicherweise nicht der gewünschte ist.

Nicht-Cmake-basierte Projekte

Der Quellcode des Emulators kann zur Kompilierung der Kompilierung durch Vordefinition einer Reihe von Makros konfiguriert werden. Sowohl Z80.h als auch Z80.c folgen den ersten beiden unten erklärten. Der Rest der Makros ist nur relevant, wenn Z80.c zusammengestellt wird:

#define Z80_EXTERNAL_HEADER "header-name.h"
Gibt den einzigen externen Header für #include an und ersetzt alle anderen.
Bestimmen Sie dieses Makro vor, um eine Header -Datei bereitzustellen, die die vom Emulator verwendeten externen Typen und Makros definiert, wodurch Ihr Projekt abhängig von Zeta abhängt. Sie können dies verwenden, wenn Sie Z80.c als Teil Ihres Projekts kompilieren oder (wenn Ihre Typen die binäre Kompatibilität nicht brechen), wenn Sie <Z80.h> mit einer vorgefertigten Z80-Bibliothek verknüpfen.
#define Z80_STATIC
Schränkt die Sichtbarkeit öffentlicher Symbole ein.
Dieses Makro ist erforderlich, wenn Sie Z80.c als statische Bibliothek erstellen, diese direkt als Teil Ihres Projekts zusammenstellen oder Ihr Programm mit der statischen Version der Z80 -Bibliothek verknüpfen. Stellen Sie in beiden Fällen sicher, dass dieses Makro definiert ist, bevor "Z80.h" oder <Z80.h> enthält.
#define Z80_WITH_LOCAL_HEADER
Sagt Z80.c zu #include "Z80.h" anstelle von <Z80.h> .

Die optionalen Merkmale des in "Installation aus Quellen" genannten Emulators sind standardmäßig deaktiviert. Wenn Sie Z80.c als Teil Ihres Projekts kompilieren, aktivieren Sie die Funktionen, die Sie benötigen, indem Sie ihre jeweiligen Aktivierungsmakros vordefinieren. Sie haben den gleichen Namen wie ihre CMake -Äquivalente:

#define Z80_WITH_EXECUTE
#define Z80_WITH_FULL_IM0
#define Z80_WITH_IM0_RETX_NOTIFICATIONS
#define Z80_WITH_Q
#define Z80_WITH_SPECIAL_RESET
#define Z80_WITH_UNOFFICIAL_RETI
#define Z80_WITH_ZILOG_NMOS_LD_A_IR_BUG

Mit Ausnahme von Z80_EXTERNAL_HEADER können die obigen Makros leer sein. Der Quellcode prüft nur, ob sie definiert sind.

Notiz

Die Aktivierung einiger der optionalen Merkmale beeinflusst die Geschwindigkeit des Emulators aufgrund verschiedener Faktoren (finden Sie in der Dokumentation für weitere Details).

Showcase

Dieser Emulator wurde von folgenden Projekten verwendet (in alphabetischer Reihenfolge aufgeführt):

Augmentinel _{von Simon Owen⟩} Github
CEDA-CEMU _{von Retranzicina GLG-Programmen⟩} Github
CPM-Emulator _{von Marc Sibert⟩} GitHub
F80 _{von Richard J. Prinz⟩} Github
Google erfasst das Flag (2021) _{von Google⟩} GitHub
King of the Grid _{von ZX Spectrum Tools Collection⟩} GitHub
MZ-1500-Emulator für Raspberry Pi Pico _{von Shippoiincho⟩} GitHub
MZ-2000/80B Emulator für Raspberry Pi Pico _{von Shippoiincho⟩} Github
PC-6001MKII-Emulator für Raspberry Pi Pico _{von Shippoiincho⟩} GitHub
Pico-Sorcerer-2 _{durch Fruchtfett⟩} Github
pico-zxspectrum _{durch Fruchtshell⟩} GitHub
Radz80 _{durch Radad⟩} GitHub
Tihle _{von Peter Marheine⟩} Github · Gitlab
Tilemap _{von Simon Owen⟩} Github
Tranzputer ^Fusionx _{von Philip Smart⟩} GitHub
Zemu _{von Jay Valentine⟩} Github · Rubygemems

Danke

Vielen Dank an die folgenden Personen (in alphabetischer Reihenfolge):

Akimov, Vadim (LVD)
- Zum Testen der Bibliothek auf vielen verschiedenen Plattformen und CPU -Architekturen.
Azesmbog ^?
1. Zur Überprüfung von Tests auf echter Hardware. ^1.1
2. Zum Entdecken des instabilen Verhaltens der ccf/scf -Anweisungen.
3. Zum Testen der ccf/scf -Anweisungen auf echter Hardware. ^{2, 3}
4. Für seine unschätzbare Hilfe.
Banken, David (Hoglet) ^?
1. Zur Entschlüsselung der zusätzlichen Flag -Änderungen der Blockanweisungen. ^{4.1, 4.2, 5}
2. Für seine Forschung zu den ccf/scf -Anweisungen. ^{5, 6}
Beliansky, Anatoly (Tolik_Trek)
- Zur Überprüfung von Tests auf echter Hardware. ^1.2
Bobrowski, Jan
- Für die Behebung des "Z80 Full Befehlssatzes für Spektrum" . ⁷
Boo_boo ^?
- Zum Entschlüsseln des Verhaltens von memptr. ^{8, 9, 10, 11}
Brady, Stuart
- Für seine Forschung zu den ccf/scf -Anweisungen. ¹²
Brauer, Tony ^?
1. Für seine Forschung zum besonderen Zurücksetzen. ^{4.3, 13}
2. Um zu helfen, die zusätzlichen Flaggenänderungen der Blockanweisungen zu entschlüsseln. ⁴
3. Zur Durchführung von Tests auf niedrigem Niveau auf echte Hardware. ⁴
4. Damit mir das Testen verschiedener Verhaltensweisen ohne Papiere des Zilog Z80 testen.
Bystrov, Dmitry (allein Codierer)
- Zur Überprüfung von Tests auf echter Hardware. ^1.2
Chandler, Richard
1. Für seine Korrekturen in die Dokumentation.
2. Zur Überprüfung von Tests auf echter Hardware. ¹⁴
Chunin, Roman (CHRV)
- Zum Testen des Verhaltens von MEMPTR auf echten Hardware. ^{8, 9, 10, 11}
Conway, Simon (Badbeard)
- Zur Validierung der "Z80 -Testsuite" an mehreren Z80 -Klonen. ¹⁵
Cooke, Simon ^?
- Um herauszufinden, wie sich die out (c),0 Anweisungen auf dem Zilog Z80 CMOS. ¹⁶
Cringle, Frank D.
- Zum Schreiben des "Z80 -Anweisungssatzes" . ¹⁷
Devic, Goran
- Für seine Forschung zu undokumentierten Verhaltensweisen der Z80 -CPU. ¹⁸
Dunn, Paul (Zxdunny)
- Für seine Korrekturen in die Dokumentation.
Tagundnachtgleiche
- Für seine Korrekturen in die Dokumentation.
Flammenkamp, Achim
- Für seinen Artikel zu Z80 unterbricht. ¹⁹
GIMENO FORTEA, PEDRO ^?
1. Für seine Forschungsarbeit. ²⁰
2. Zum Schreiben des ersten ZX-Spektrumsemulators. ^{21, 22}
Goodboy
- Zum Testen des Verhaltens von MEMPTR auf echten Hardware. ^{8, 9, 10, 11}
Greenway, Ian
- Zum Testen der ccf/scf -Anweisungen auf echter Hardware. ^{12, 23}
Harston, Jonathan Graham
1. Für seine Forschungsarbeit.
2. Für seine technischen Dokumente über den Zilog Z80. ^{24, 25, 26}
3. Zum Portieren des "Z80 -Befehlssatzes" im ZX -Spektrum. ²⁷
Helcmanovsky, Peter (Ped7g) ^{? ️}
1. Für die Hilfsmittel, den "In-Memptr" -Test zu schreiben.
2. Zum Schreiben des "Z80 Block Flags -Tests" . ^{1, 28}
3. Zum Schreiben des Tests "Z80 CCF SCF -Ergebnis" . ²⁸
4. Zum Schreiben des "Z80 Int Skip" -Tests. ²⁸
5. Für seine Forschung über das instabile Verhalten der ccf/scf -Anweisungen.
6. Für seine unschätzbare Hilfe.
Iborra Debón, Víctor (Eremus)
- Zur Überprüfung von Tests auf echter Hardware.
Eisbeer
- Zum Testen des Verhaltens von MEMPTR auf echten Hardware. ^{8, 9, 10, 11}
Eisknight
- Zur Überprüfung von Tests auf echter Hardware.
Kladov, Vladimir ^?
- Zum Entschlüsseln des Verhaltens von memptr. ^{8, 9, 10, 11}
Krook, Magnus
- Zur Überprüfung von Tests auf echter Hardware. ^1.3
London, Matthew (Mattinx)
- Zur Überprüfung von Tests auf echter Hardware.
Martínez Cantero, Ricardo (KYP)
- Zur Überprüfung von Tests auf echter Hardware.
Molodtsov, Aleksandr
- Zum Testen des Verhaltens von MEMPTR auf echten Hardware. ^{8, 9, 10, 11}
Nair, Arjun
- Zur Überprüfung von Tests auf echter Hardware. ¹
Nicolás-González, César
- Für die Untersuchung des instabilen Verhaltens der ccf/scf -Anweisungen.
Ortega Sosa, Sofía
1. Zum Optimieren des Emulators.
2. Für ihre Unterstützung.
Owen, Simon
- Für die Idee der in diesem Emulator verwendeten Hooking -Methode.
Ownby, Matthew P.
- Für seine Forschung über den Zustand der Register nach dem Power-on. ²⁹
Rak, Patrik ^?
1. Zur Verbesserung des "Z80 -Befehlssatzes für Spektrum" . ³⁰
2. Zur Entschlüsselung des Verhaltens der ccf/scf -Anweisungen. ^{15, 30}
3. Zum Schreiben der "Zilog Z80 CPU Test Suite" . ^{30, 31}
4. Für seine Forschung über das instabile Verhalten der ccf/scf -Anweisungen.
Rodríguez Jódar, Miguel Ángel (McLeod_ideafix)
- Für seine Forschung über den Zustand der Register nach dem Power-on/Reset. ³²
Rodríguez Palomino, Mario (R-Lyeh)
- Für das beibringen, wie Emulatoren funktionieren.
Sainz de Baranda y Romero, Manuel
- Für das Programmieren von Programmieren und mir meinen ersten Computer gebe.
Sánchez Ordiñana, José Ismael (Vaporatorius)
- Zur Überprüfung von Tests auf echter Hardware. ^{31.1, 33}
Sevillano Mancilla, Marta (Themartian)
- Zur Überprüfung von Tests auf echter Hardware. ^14.1
Stevenson, Dave
1. Zum Testen des speziellen Resets auf echte Hardware. ¹³
2. Zur Durchführung von Tests auf niedrigem Niveau auf echte Hardware. ^4.4
Titov, Andrey (Titus)
- Für seine Forschung zu den ccf/scf -Anweisungen. ^{2, 3}
Vučenović, Zoran
- Zum Schreiben der Pascal -Bindung.
Weissflog, Andre (Floh) ^?
1. Um festzustellen, dass die reti/retn -Anweisungen die Annahme des maskierbaren Interrupts aufschieben. ³⁴
2. Zum Schreiben des Simulators "Visual Z80 Remix" . ³⁵
Wilkinson, Oli (Evolution)
- Zur Überprüfung von Tests auf echter Hardware. ¹
WLODEK
- Zum Testen des Verhaltens von MEMPTR auf echten Hardware. ^{8, 9, 10, 11}
Holzmasse, Mark (Woody) ^{? Euen}
1. Für seine unschätzbaren Beiträge zur Emuscen.
2. Zum Schreiben der "Z80 Test Suite" . ¹⁵
3. Für seine Forschung zu den ccf/scf -Anweisungen. ³⁶
4. Zum Schreiben des "Halt2int" -Tests.
5. Zum Schreiben des "Eihalt" -Tests.
Junge, Sean ^?
1. Für seine Forschungsarbeit.
2. Für seine technischen Dokumente über den Zilog Z80. ^{20, 29, 37}
ZxGuesser
- Zur Überprüfung von Tests auf echter Hardware.

Referenzen

https://spectrumComputing.co.uk/forums/viewtopic.php?t=6102
1. https://spectrumComputing.co.uk/forums/viewtopic.php?p=83384#p83384
2. https://spectrumComputing.co.uk/forums/viewtopic.php?p=83041#p83041
3. https://spectrumComputing.co.uk/forums/viewtopic.php?p=83157#p83157
https://zx-pk.ru/threads/34173-revers-inzhining-z80.html
https://zx-pk.ru/threads/35936-zagadka-plavayushchikh-flagov-scf-cf-raskryta!.html
https://stardot.org.uk/forums/viewtopic.php?t=15464
1. https://stardot.org.uk/forums/viewtopic.php?p=211042#p211042
2. https://stardot.org.uk/forums/viewtopic.php?p=212021#p212021
3. https://stardot.org.uk/forums/viewtopic.php?p=357136#p357136
4. https://stardot.org.uk/forums/viewtopic.php?p=212360#p212360
Banks, David (2018-08-21). "Unokumentierte Z80 -Flags" Rev. 1.0.
- https://stardot.org.uk/forums/download/file.php?id=39831
- https://github.com/hoglet67/z80decoder/wiki/undocumented-flags
https://github.com/hoglet67/z80decoder/wiki/Unstable-ccf-scf-behaviour
http://wizard.ae.krakow.pl/~jb/qaop/tests.html
https://zxpress.ru/zxnet/zxnet.pc/5909
https://zx-pk.ru/threads/2506-Komanda-bit-n-(HL).html
https://zx-pk.ru/threads/2586-prosba-realshchikam-ot-emulyatorshchikov.html
boo_boo; Kladov, Vladimir (2006-03-29). "MEMPTR, Esoterisches Register der Zilog Z80 -CPU" .
- https://zx-pk.ru/showpost.php?p=43688
- https://zx-pk.ru/attachment.php?attachment is2984
- https://zx-pk.ru/showpost.php?p=43800
- https://zx-pk.ru/attachment.php?attachmentID=2989
https://sourceforge.net/p/fuse-emulator/mailman/message/6929573
Brewer, Tony (2014-12). "Z80 Special Reset" .
- http://primroseebank.net/computers/z80/z80_special_reset.htm
https://spectrumcomputing.co.uk/forums/viewtopic.php?t=10555
1. https://spectrumComputing.co.uk/forums/viewtopic.php?p=132144#p132144
https://worldofspectrum.org/forums/discussion/20345
https://groups.google.com/g/comp.os.cpm/c/hfstfpaikuu/m/kotvmwu3bzoj
Cringle, Frank D. (1998-01-28). "Yaze - Ein weiterer Z80 -Emulator" V1.10.
- ftp://ftp.ping.de/pub/misc/emulators/yaze-1.10.tar.gz
https://baltazarstudios.com/zilog-z80-undocumented-behavior
Flammenkamp, Achim. "Interrupt Verhalten der Z80 -CPU" .
- http://z80.info/interrup.htm
Young, Sean (1998-10). "Z80 undokumentierte Funktionen (im Softwareverhalten)" v0.3.
- http://www.msxnet.org/tech/z80/z80undoc.txt
https://elmundodelspectrum.com/desenterrando-el-primer-emulador-despectrum
https://elmundodelspectrum.com/con-vosotros-el-emulador-de-pedro-gimeno-1989
https://sourceforge.net/p/fuse-emulator/mailman/message/4502844
Harston, Jonathan Graham (2008). "Full Z80 Opcode -Liste einschließlich undokumentierter Opcodes" v0.11 (überarbeitet).
- https://mdfs.net/docs/comp/z80/oplist
Harston, Jonathan Graham (2012). "Z80 Mikroprozessor undokumentierte Anweisungen" V0.15.
- https://mdfs.net/docs/comp/z80/undocops
Harston, Jonathan Graham (2014). "Z80 Opcode Map" v0.10 (überarbeitet).
- https://mdfs.net/docs/comp/z80/opcodemap
https://mdfs.net/software/z80/exerciser/spectrum
https://github.com/mrkwatkins/zxspectrumntextests
Young, Sean (2005-09-18). "Undokumentiertes Z80 dokumentiert, die" v0.91.
- http://www.myquest.nl/z80undocumented
- http://www.myquest.nl/z80undocumented/z80-documented-v0.91.pdf
https://worldofspectrum.org/forums/discussion/41704
- http://zxds.raxoft.cz/taps/misc/zexall2.zip
https://worldofspectrum.org/forums/discussion/41834
- http://zxds.raxoft.cz/taps/misc/z80Test-1.0.zip
- https://github.com/raxoft/z80Test
1. https://worldofspectrum.org/forums/discussion/comment/668760/#comment_668760
https://worldofspectrum.org/forums/discussion/34574
https://jiseanchez.com/test-a-dos-placas-de-zx spectrum
Weissflog, Andre (2021-12-17). "Neuer Zyklus-Zyklus-Z80-Emulator, a" .
- https://floooh.github.io/2021/12/17/cycle-stepped-z80.html
https://github.com/floooh/v6502r
https://groups.google.com/g/comp.sys.sinclair/c/wpspr6j6w5k/m/o_u1znqf3vyj
Young, Sean (1997-09-21). "Zilog Z80 -CPU -Spezifikationen" .
http://www.msxnet.org/tech/z80/z80.zip

Lizenz

Diese Bibliothek ist kostenlose Software: Sie können sie neu verteilt und/oder unter den Bedingungen der GNU Lesser allgemeinen öffentlichen Lizenz wie von der Free Software Foundation, entweder Version 3 der Lizenz, veröffentlicht oder (nach Ihrer Option) jede spätere Version veröffentlicht.

Diese Bibliothek ist in der Hoffnung verteilt, dass sie nützlich sein wird, jedoch ohne Garantie; Ohne die implizite Garantie für Handelsfähigkeit oder Eignung für einen bestimmten Zweck . Weitere Informationen finden Sie in der GNU Lesser General Public Lizenz.

Sie sollten zusammen mit dieser Bibliothek eine Kopie der GNU Lesser -allgemeinen öffentlichen Lizenz erhalten haben. Wenn nicht, siehe https://www.gnu.org/licenses/.

Speziallizenzierung

Projekte, bei denen die Bedingungen der gnu weniger allgemeinen öffentlichen Lizenz die Verwendung dieser Bibliothek verhindern oder eine unerwünschte Veröffentlichung des Quellcode für kommerzielle Produkte erfordern, können eine spezielle Lizenz beantragen.

Expandieren

Zusätzliche Informationen