Repository navigation
Stela v0.3.1
Install
Download the archive for your system, unpack it and plug in the USB stick. Then run one of these in the unpacked folder.
Make a new stick (this erases it):
sudo ./stela setup
Update an existing Stela stick to v0.3.1:
sudo ./stela setup update stela
On Windows, open Terminal with Run as administrator and write .\stela.exe in place of sudo ./stela.
Then boot the PC from the stick.
Changes
Most fixes in this release come from boot logs that users sent. They were tested in models and in a virtual machine, not on the reporters' PCs. If one of them does not work for you, please send a new boot log.
Boot
- A PC whose firmware memory map has more than 512 entries (seen on a Ryzen 5800XT board) no longer stops after about 11 seconds.
- Intel boards whose host bridge has fixed PCI command bits no longer fail when Stela takes over the PCI devices. That failure left onboard devices, such as the network adapter, without their setup.
- The boot screen no longer freezes for part of the macOS start, and a line shown from one processor is no longer lost while another updates the screen.
- A device whose start never ends is now named: each device's start line is written to the USB log before its driver runs. On the next boot Stela skips that device and says so.
stela setup repairmakes Stela try it again. A device the boot cannot go on without is never skipped. - The 30-second start limit now covers every wait a driver makes, for every kind of device.
- A boot log that cannot be saved no longer stops the boot. The screen says once that the log could not be saved.
- Failures on screen give a plain reason on their own line, with no internal debug text. Every hint to save the boot log uses
--output log.txt.
Ethernet
- v0.3.0 did not start most Realtek adapters (RTL8111G and H, RTL8411B, RTL8125, RTL8126), because it required firmware files that setup never put on the USB stick. The files are now on the stick, and an adapter starts without its file, as it does on Linux. The v0.3.0 notes said the RTL8111H worked; that was wrong for sticks made by setup.
- Intel onboard adapters (82579, I217, I218, I219) on every chipset generation: the PHY is woken before it is read, an adapter shared with the Intel management engine starts, an adapter with a failed NVM checksum starts with a warning, and an adapter with no cable starts and reports "no link".
- Intel I210, I211, I225 and I226: an adapter whose management firmware blocks the PHY reset starts.
- An adapter with no valid stored address gets a random one instead of being refused.
- Broadcom BCM57xx: an adapter left in a low power state is woken before use.
- USB Realtek RTL8153 and RTL8156 start without their firmware patch.
- Aquantia AQC100, AQC109, AQC115C and AQC116C are supported.
- A damaged received frame is dropped and counted on every driver. Before, on Broadcom and USB adapters, one bad frame could end the network setup.
- Setup waits up to 10 seconds for the link and shows the wait.
- When no adapter starts, the screen lists each network adapter found, with its IDs and the reason.
Wi-Fi does not work in this release. Work on it continues.
Disks and USB
- SATA disks that use link power management no longer fail with a disk error during the install. Stela treated a link power event as a removed disk; it now ignores those events, as Linux does.
- USB 3 devices that were already plugged in at power-on are found (the port gets a warm reset). An empty port is no longer shown as a failure.
- Each USB device found is listed in the boot log.
Setup
- On a Mac, setup no longer fails with "Operation not supported" when it writes the USB stick.
- On a Mac, the read-back check now reads the stick and not the system's cache.
repairreplaces only damaged or missing pieces, and finds a damaged piece that a boot reported.- When
update stelaneeds new boot files, it downloads only the files it reads, not the whole 2.2 GB recovery set. update osto the version a stick already has says there is nothing to update instead of failing.uninstallalso removes the firmware files it left behind before.
Building from source
- The build works with LLVM 21, 22 and 23 on Linux, and with Xcode's Apple clang 21 or newer or Homebrew LLVM on macOS. It checks its tools at the start and lists everything that is missing.
- The Linux kernel sources build with newer Clang versions (the
-Wattribute-aliaserror is fixed).
Performance
- Floating-point code leaves translated code far less often.
- Pointer authentication instructions are answered from a small cache in translated code.
- The translation cache is written while macOS runs, in small pieces, and survives a crash.
- A page of code that was read before is hashed again only when its bytes changed.
- GPU pipelines and shader libraries are built outside the frame that first uses them.
Boot log
If Stela does not work, save the boot log and include log.txt in your report:
sudo ./stela setup boot-log --output log.txt