Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/skx/z80-examples
Z80 assembly-language programs.
https://github.com/skx/z80-examples
assembly assembly-language-programming assembly-z80 z80
Last synced: 12 days ago
JSON representation
Z80 assembly-language programs.
- Host: GitHub
- URL: https://github.com/skx/z80-examples
- Owner: skx
- Created: 2019-07-18T16:29:04.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2022-07-22T05:22:08.000Z (over 2 years ago)
- Last Synced: 2024-10-26T22:23:01.458Z (25 days ago)
- Topics: assembly, assembly-language-programming, assembly-z80, z80
- Language: Makefile
- Homepage:
- Size: 13.7 KB
- Stars: 20
- Watchers: 2
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# Z80 Examples
This repository contains example code for the Z80 processor, written in assembly language. This is where I'll post things as I experiment.
The code should be standalone, but I assume that there is the ability to output a single byte to the serial-console, or STDOUT via:
ld a, '3'
out (1), a
Similarly I assume reading a single character from a serial-console, or STDIN, is possible via:
in a, (1)
This is true of the [Z80 emulator](https://github.com/skx/z80emulater/) I'm using, as well as the [physical machine I intend to build](https://blog.steve.fi/tags/z80/).
## 00. See Also
If you'd rather see something _complete_ then you should check out this repository:
* [The lighthouse of doom](https://github.com/skx/lighthouse-of-doom)
That contains a complete (simple!) text-based adventure-game written in Z80 assembly, which will work on any ZX Spectrum emulator, and can also run on CP/M systems (again under emulation if you don't have any retro-hardware).
## 01. RAM Increment
The simplest example is the first, which increments a single byte of RAM endlessly. If you have an emulator that lets you dump RAM after every instruction, or physical hardware upon which you can do the same this should prove your code is working:
* [ram-increment.z80](ram-increment.z80)
## 02. String Output
Outputing a string, held inline. Simple test of loops:
* [string-output.z80](string-output.z80)
## 03. Number Output
This example is similar to the previous one, but instead outputs the contents of the HL register-pair, as a four-digit hexadecimal number.
i.e. If you assume this `ld hl, 0x123F`, then you should see the output "0x123F" generated, which proves a number a has been converted to an ASCII-string, and output correctly.
* [number-output.z80](number-output.z80)
## 04. Simple Monitor
This is the most complex/complete program in the repository, and it is a "monitor program" which allows you to interactively use your Z80 processor. There are a couple of builtin commands for dumping ram, inputing data, and calling functions.
Each command is invoked via a letter. For example to (D)ump the 16 bytes of RAM at 0x1000 run:
```
> D1000
0x1000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
> D
0x1010 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
```
To (I)nput a simple routine:
```
> I1000 3E 68 D3 01 3E 65 D3 01 3E 6C D3 01 3E 6C D3 01
> I 3E 6F D3 01 3E 21 D3 01 3E 0A D3 01 C9
```
(Here you see that the input-address is optional in the second line, bytes are just appended to the value previously set.)
Finally you may (c)all the routine you've just loaded:
```
> C1000
hello!
```
Steve
--