Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rprouse/z80emu
A simple Z80 8-Bit emulator
https://github.com/rprouse/z80emu
hacktoberfest z80 z80-emulator
Last synced: 24 days ago
JSON representation
A simple Z80 8-Bit emulator
- Host: GitHub
- URL: https://github.com/rprouse/z80emu
- Owner: rprouse
- License: mit
- Created: 2023-06-02T02:06:18.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-05-03T20:25:00.000Z (6 months ago)
- Last Synced: 2024-05-04T02:11:45.001Z (6 months ago)
- Topics: hacktoberfest, z80, z80-emulator
- Language: C#
- Homepage: https://8bitlabs.ca
- Size: 282 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Z80Emu
A Z80 emulator/monitor program written in C#. Opcodes are generated automatically
using the [JSON Opcode Table](https://github.com/deeptoaster/opcode-table/blob/master/opcode-table.json)
from [Z80 Opcode Table](https://clrhome.org/table/).
## Usage
Pass in a compiled Z80 binary file as the first argument to the program.
```bash
z80emu
```
This will load the program to the CP/M or Agon MOS program memory location 0x0100
and drop you to a prompt where you can enter commands. (TODO: Allow loading to
other memory locations)
### Commands
Most commands are kept to one charater to make it easier to enter them
quickly. The exception is the `reg` which is used less often since the
registers are displayed after every step or run.
| Command | Example | Description |
| ------- | ------- | ----------- |
| `h` | `h` | Display help |
| `s` | `s` | Step through the program one instruction at a time |
| `r` | `r` | Run the program to the next breakpoint |
| `reg` | `reg` | Dump the registers and flags |
| `m []` | `m 100` | Dump the memory starting at the given address. If the address is not specified, defaults to 0x100 or the last memory address viewed |
| `d []` | `d 100` | Disassemble the program starting at the given address. If no address is given, will start disassembly at the program counter. If entered again, it will continue after the last disassembled address. |
| `p ` | `p 0x42` | View the value in the given port. The port must be a hex number. |
| `p ` | `p 0x42 0x0a` | Set the given byte into the given port. The port and byte must be a hex number. |
| `b` | `b` | Manage breakpoints |
| `q` | `q` | Quit the emulator |
### Breakpoints
Breakpoints can be managed by entering the `b` command.
| Command | Description |
| ------- | ----------- |
| `add` | Add a breakpoint. You will be prompted for an address to set a breakpoint at |
| `delete` | Delete a breakpoint. You will be shown all breakpoints and be able to select one to delete |
| `list` | List breakpoints |
| `clear` | Clear all breakpoints |
| `quit` | Quit the breakpoint manager |
### OS System Calls
The emulator currently supports a small subset of the [CP/M 2.2](https://www.seasip.info/Cpm/bdos.html)
system calls. For a list of supported system calls, see [CPM22.cs](./Z80Emu.Core/OS/CPM22.cs). The plan
is to expand the supported system calls as needed and to add support for the
Agon Light [MOS API](https://github.com/breakintoprogram/agon-docs/wiki/MOS-API) system calls.
You will be able to select between CP/M and Agon MOS with a command line switch.
### Limitations
- This does not emulate undocumented opcodes
- It is not cyle accurate
- It does not set the undocumented flags
- Only a subset of system calls are supported