The I/O bus is accessed using the in and out instructions.
Every access is 32 bits wide; there is no byte-addressing on the I/O bus and
addresses don't have to be aligned to multiples of four.
When a peripheral has multiple instances (e.g. 32 display overlays, 4 disks), the lowest bits of the address usually indicate the instance number, while higher bits indicate the function to be performed.
| start | end | description |
|---|---|---|
| 0x00000000 | 0x00000000 | serial port |
| 0x80000000 | 0x8000031f | display |
| 0x80000400 | 0x80000401 | mouse |
| 0x80000500 | 0x80000500 | keyboard |
| 0x80000600 | 0x80000600 | audio |
| 0x80000700 | 0x80000706 | RTC and uptime |
| 0x80001000 | 0x80005003 | disk |
| 0x80010000 | 0x80010000 | power controller |
Writing to this register outputs the lowest 8 bits as a byte on the debug serial port (stdout in case of the fox32 emulator). If necessary, the CPU is stalled long enough to ensure that the byte is output rather than discarded.
Reading from this register gets a byte of input from the serial port, if available, or zero otherwise.
The display controller manages a background framebuffer and 32 overlays, and composes them into the picture seen on screen.
The background framebuffer is located at the fixed RAM address 0x2000000, or 32 MiB. The screen resolution is 640x480 (307200 pixels, 1228800 bytes).
The pixel format is RGBA. The alpha channel determines transparency in overlays insofar that a non-zero alpha value causes a pixel to be fully opaque and a zero alpha value causes it to be fully transparent.
When multiple overlays are active at a specific pixel position, the highest numbered overlay that provides an opaque pixel "wins": Its pixel RGB value is output on screen.
| bits | description |
|---|---|
| 31:16 | Y (vertical) position |
| 15:0 | X (horizontal) position |
| bits | description |
|---|---|
| 31:16 | height (vertical size) |
| 15:0 | width (horizontal size) |
RAM address of the framebuffer for this overlay.
- Write non-zero to enable this overlay, zero to disable
- Read 1 if enabled, 0 of disabled
The mouse position and button states can be read and written, but hardware may change them on incoming mouse events.
| bits | description |
|---|---|
| 2 | mouse button is currently held |
| 1 | mouse button has been released |
| 0 | mouse button has been pressed |
| bits | description |
|---|---|
| 31:16 | Y (vertical) position |
| 15:0 | X (horizontal) position |
Read this register to get a key event from the key event queue, or 0 if none is currently available.
| bits | description |
|---|---|
| 8 | 0=pressed, 1=released |
| 7:0 | PC-compatible keyboard scancode |
TODO
| offset | description |
|---|---|
| 0x00 | year (e.g. 2023) |
| 0x01 | month (1-12) |
| 0x02 | day (1-31) |
| 0x03 | hour (0-23) |
| 0x04 | minute (0-59) |
| 0x05 | second (0-59) |
| 0x06 | milliseconds since startup |
| 0x07 | daylight savings time active (zero or non-zero) |
The disk controller supports four disk ports. Each of them may be connected to a disk (or not) at any time.
Disks are organized in sectors of 512 bytes each.
Read this register to get the disk size in bytes.
Address of RAM buffer to be used for read/write transfers.
Write a sector number to this register to initate a disk read from the specified sector. The CPU is stalled until the read completes.
Write a sector number to this register to initate a disk write to the specfied sector. The CPU is stalled until the write completes.
Write any value to this register to remove or eject the specified disk.
Write 0 to this register to power the computer off (or terminate the emulator).
Poweroff does not take effect immediately, so software should do something safe (such as spinning in a loop) after triggering the poweroff.