pato-z80-home-computer/pat80-computer/software/z80-assembly/os/README.md

# Pat80 Operating System and Memory Monitor

## Intro

This folder contains the Pat80 Operating System.
It is a System Monitor that makes available also some system API to access hardware (monitor, sound, keyboard, parallel terminal...).

## Build

### Requirements

z80asm
minipro (if you want to write to an EEPROM)

### Make

The os can be **built** issuing command `make build`.
Two files will be generated:
- `rom.bin` is the rom file to be flashed on the eeprom
- `abi-generated.asm` is the file to be included in any Pat80 application to access system APIs (see README.md in ../applications/)

The os can be **written to an EEPROM** with a minipro-compatible programmer issuing command `make write`. This runs the build and then tries to write the rom to a MiniPRO.

The os can otherwise be **runned in the emulator** issuing command `make run`. This requires to have the emulator executable already built (follow the instructions on `pat80-emulator/README.md` to build it).
First os version with ABI number and working system calls 2020-12-30 19:58:32 +01:00			`# Pat80 Operating System and Memory Monitor`

			`## Intro`
Memory monitor: Removed unused ADB command 2025-02-14 09:50:44 +01:00
First os version with ABI number and working system calls 2020-12-30 19:58:32 +01:00			`This folder contains the Pat80 Operating System.`
			`It is a System Monitor that makes available also some system API to access hardware (monitor, sound, keyboard, parallel terminal...).`

			`## Build`
Memory monitor: Removed unused ADB command 2025-02-14 09:50:44 +01:00
First os version with ABI number and working system calls 2020-12-30 19:58:32 +01:00			`### Requirements`
Memory monitor: Removed unused ADB command 2025-02-14 09:50:44 +01:00
			`z80asm`
			`minipro (if you want to write to an EEPROM)`

First os version with ABI number and working system calls 2020-12-30 19:58:32 +01:00			`### Make`
Memory monitor: Removed unused ADB command 2025-02-14 09:50:44 +01:00
			The os can be built issuing command `make build`.
First os version with ABI number and working system calls 2020-12-30 19:58:32 +01:00			`Two files will be generated:`
			- `rom.bin` is the rom file to be flashed on the eeprom
			- `abi-generated.asm` is the file to be included in any Pat80 application to access system APIs (see README.md in ../applications/)
Memory monitor: Removed unused ADB command 2025-02-14 09:50:44 +01:00
			The os can be written to an EEPROM with a minipro-compatible programmer issuing command `make write`. This runs the build and then tries to write the rom to a MiniPRO.

			The os can otherwise be runned in the emulator issuing command `make run`. This requires to have the emulator executable already built (follow the instructions on `pat80-emulator/README.md` to build it).