Platform Cambridge z88 - z88dk/z88dk GitHub Wiki
Z88 Platform
Classic library support (+z88)
- Native console output
- Native console input
- ANSI vt100 engine
- Generic console
- Redefinable font
- UDG support
- Paper colour
- Ink colour
- Inverse attribute
- Bold attribute
- Underline attribute
- Lores graphics
- Hires graphics
- PSG sound
- ETracker (SAA tracker)
- PSG Lib (SN76489)
- Arkos2 Player (AY)
- WYZ Player (AY)
- Vortex tracker (AY)
- One bit sound (on the keyboard speaker)
- [x]] Inkey driver
- Hardware joystick
- File I/O (MSXDOS + MSXDOS2)
- Far heap
- Interrupts
- RS232
Introduction
The z88 operating system, OZ, provides a lot of functionality for programmers which permit multiple applications to co-exist and conserve resources (i.e. memory) as necessary. z88dk aims to hide away a lot of the details and provide a relatively simple solution to developing of applications.
For details of the functionality OZ exposes, it's advisable to read the Z88 Developer Notes. The notes describe a lot of detail that is skipped over here.
Maths Library
The z88's floating point routines are supported, to use them, add -lmz to the command line when compiling with sccz80.
BBC Basic Target
By default, z88dk generates binaries that can be LOADed into the BBC Basic application and run. Using this target is the easiest way to get an application up and running on the z88.
Command Line
zcc +z88 .....
Z88 Application Target
Z88dk can be used to create a z88 Applications that can be run from the Main Menu. Both good, bad and ugly applications can be constructed. When creating applications, the farheap is available.
Command Line
zcc +z88 -subtype=app -create-app ...
The output of this command will be a .epr file (suitable for insertion into Emulators) and .63 (.62, .61, .60) files representing the individual banks.
To generate files suitable for Installation with OZ4.5+ and OZ5 use -subtype=installer. Both 4 and 5 installer files will be created, (.app, .apX for OZ4.x and .a5p for OZ5).
Z88 Packages
Only useful for OZ3.x and OZ4.0
Z88dk can create Packages (shared libraries) that allow code to be shared between applications. ZSock was built using this technique to provide TCP/IP services for the z88.
Command Line
As for applications, i.e.:
zcc +z88 -create-app -subtype=app app.c
Z88 Shell Target
The z88 shell is a unix-like shell providing command line file manipulation on the z88. Naturally, z88dk supports generating applications that can be run from the command line.
Command Line
zcc +z88 -subtype=z88shell -create-app cmd.c
The above command line will create commands that run under the Forth shell written by Garry Lancaster for OZ3. For the shell built into OZ5 use the following commands:
zcc +z88 -subtype=z88shell5 -create-app cmd.c
ZSock Devices
ZSock devices can be compiled with z88dk, these are raw binary blobs that sit at address 8192 and cannot use a stdio resources.
Command Line
zcc +z88 -subtype=zsockdev
z88net library
Command Line
zcc +z88 -clib=net