Commodore AmigaOS & AROS¶
cais provides first-class support for Commodore's legendary AmigaOS operating system family (running on Motorola 68000..68060 processors) and the open-source AROS Research Operating System.
đī¸ AmigaOS Version & Subsystem Support¶
đĻ Universal Baseline Subsystems (All AmigaOS Releases)¶
The following core subsystems are universally available across all AmigaOS and AROS environments:
cais.platform: Motorola 68k architecture identification, 32-bit pointer detection, and Big-Endian byte order predicates.cais.filesystem: Native AmigaDOS file locking and navigation (Lock(),UnLock(),Examine(),ExNext()).cais.parallel: Native Amigaparallel.devicedriver for Centronics printing and data exchange.cais.serial: Native Amigaserial.devicedriver for high-speed serial communications.cais.sandbox: Safely reportsCAIS_SANDBOX_UNSUPPORTED(-4) with zero runtime overhead (sandboxing primitives are absent in AmigaOS).
đšī¸ Subsystem Support by AmigaOS Generation¶
đš Modern AmigaOS & AROS (AmigaOS 3.2 / 3.9 & AROS)¶
- Architectures: Motorola 68020..68060 (AmigaOS) / x86, x86_64, ARM, m68k (AROS)
- Compilers:
m68k-amigaos-gcc,vbcc, native AROS GCC - Filesystem (
cais.filesystem): â Full AmigaDOS directory traversal and buffered file streaming. - Network Sockets (
cais.socket): â Nativebsdsocket.library(Roadshow, MiamiDX, AmiTCP).
đš Classic AmigaOS (AmigaOS 2.04 .. 3.1)¶
- Kernel / ROM: Kickstart 2.04, 3.0, 3.1 | Architectures: Motorola 68000..68040
- Filesystem (
cais.filesystem): â Native AmigaDOS 2.0+ standard packet operations. - Network Sockets (
cais.socket): â Supported viabsdsocket.librarywhen an external TCP/IP stack (AmiTCP 3/4 or Miami) is loaded.
đš Vintage AmigaOS (AmigaOS 1.2 / 1.3)¶
- Kernel / ROM: Kickstart 1.2 / 1.3 (OASIS / Amiga 500 / 2000)
- Filesystem (
cais.filesystem): â Base AmigaDOS 1.3 filesystem routines. - Parallel & Serial (
cais.parallel,cais.serial): â Nativeparallel.deviceandserial.devicestandard Exec I/O requests. - Network Sockets (
cais.socket): â ī¸ Sockets unavailable (CAIS_SOCKET_UNSUPPORTED).
đī¸ Driver & Subsystem Implementation Details¶
1. Serial Port Communication (cais.serial)¶
On AmigaOS, cais interfaces directly with the standard Exec device subsystem:
- Exec Device Open: Opens
serial.deviceunit 0 usingCreateMsgPort()andCreateIORequest(). - Configuration via
IOExtSer: Configures baud rate, parity, stop bits, and data bits via standard AmigaSDCMD_SETPARAMScontrol packets. - Hardware Handshaking: Directly queries and asserts CTS, RTS, and DTR control lines through the Amiga custom chipset (Paula UART and CIA-A / CIA-B interface chips).
2. Centronics Parallel Port (cais.parallel)¶
- Exec Device Interface: Allocates standard
struct IOStdReqand opensparallel.device. - Centronics Handshaking: Emits raw byte buffers via
CMD_WRITEwith automatic hardware busy/ack handshaking handled by the Amiga CIA (Complex Interface Adapter) 8520 chips.
3. Network Sockets via bsdsocket.library (cais.socket)¶
- Dynamic Library Binding: Opens
bsdsocket.libraryat runtime via Exec'sOpenLibrary("bsdsocket.library", 4). - Zero Host Fragmentation: Translates
cais.socketAPI calls directly intobsdsocket.libraryvector calls (socket(),connect(),send(),recv(),WaitSelect()), maintaining binary compatibility across Roadshow, Miami, Genesis, and AmiTCP.
âąī¸ Version Milestones¶
| Feature | Minimum Environment | Description & Runtime Behavior |
|---|---|---|
| Core Library & Platform | AmigaOS 1.2 (1986) | Base 68k execution, Kickstart library initialization, and byte-order verification |
Device Drivers (parallel, serial) |
AmigaOS 1.2 (1986) | Standard Exec asynchronous I/O over serial.device and parallel.device |
| AmigaDOS Filesystem | AmigaOS 1.2 / 1.3 | Lock-based file manipulation (Lock, Examine, ExNext) |
| Network Sockets | AmigaOS 2.04+ | Full TCP/UDP IPv4 communication via bsdsocket.library (Roadshow / AmiTCP) |
| Kernel Sandboxing | N/A | Unsupported (CAIS_SANDBOX_UNSUPPORTED / -4) |