v0.1.0-rc1

First release of the rewritten Bellatrix, and the first one produced by the
release machinery itself. Treat both as under test.

What this release is for

Two things, in this order.

Exercising the pipeline. Until now nothing here had ever been packaged,
verified or published. This release is where that machinery gets used for the
first time: the three assets, the checks that run before anything is uploaded,
the digests that say what a card is, and the two-scenario split between building
on a workstation and building on a runner. If something about the download is
wrong, that is the interesting failure, not a footnote.

Getting a Raspberry Pi 3 to come up. The code behind it is deliberately
quick and dirty — enough to bring the board up on real hardware and no further.
Where a choice was between the correct design and the one that would boot this
week, the one that boots won. Several parts are known to be provisional and are
written to be replaced rather than extended.

It is not a foundation to build on yet, and nothing in it is a stable interface.

Relative to the old Bellatrix

This is not a continuation of the 0.0.x line. That codebase was a bare-metal
Amiga machine emulator with its own chipset integration, multicore runtime and
launcher; it is preserved on the legacy branch and at the legacy-2026-08-03
tag, and none of it is in this tree.

What replaced it is smaller and aims elsewhere: AROS/m68k running on a Pi 3
under Emu68, with no Amiga chipset at all. M68K is treated as another
instruction set the board runs, not as a machine to simulate. Classic chipset
support is wanted later and would sit beside this path rather than under it.

What works

On a Raspberry Pi 3 Model B and under QEMU alike: the machine boots to the
Workbench desktop, the SD card is the system volume AROS runs from, the display
comes up on HDMI, and a wired USB mouse drives the desktop.

What does not

• USB input. Some devices stop the boot before the desktop appears. Start
  the machine with nothing plugged in, then add a plain wired mouse.
• Storage. The card is read correctly, but the driver stumbles once during
  start-up on real hardware and recovers by resetting the controller.
• The display path. nocomposition is required, and it is in the
  cmdline.txt on the card for that reason. With the compositor enabled the
  boot finishes and the screen never changes.

Open work is filed under AI_context/issues/.

Installing

Format a microSD card with one FAT32 partition and unpack the archive at its root:

tar -xJf bellatrix-v0.1.0-rc1-pi3.tar.xz -C /media/you/BOOT

Updating a card you already have

Install the archive; this is the first release with digests recorded.

Both files go at the root of the card, under the names they have here —
config.txt names them, so renaming one is the same as not copying it.

Running it without a Pi

bellatrix-'v0.1.0-rc1'-qemu.tar.xz is the same system, packaged to run under
QEMU. Unpack it anywhere and:

./run.sh

or run.bat on Windows. It needs qemu-system-aarch64 — Debian and Ubuntu
call the package qemu-system-arm, Windows users want the installer from
qemu.weilnetz.de. Ctrl-A X quits, and ./run.sh -display none runs it on the
serial line alone.

What this is

bellatrix   v0.1.0-rc1
built       2026-08-15T17:03:10Z
commit      138f497
emu68       9b4379a
aros        85705361ca
d-emu68     21cbfe2f9945
d-elf       2d46d41e39ff
d-system    27af9ce4f9b1