COMPUTING SOVEREIGNTY ON $50 HARDWARE
Before Pisces Moon OS, every piece of software ever written for the ESP32-S3 hardware class did one thing. A wardriving tool. A mesh radio platform. A game. When you turned on the device, it did its one function and nothing else.
Pisces Moon OS is the first general-purpose operating system for this hardware — a platform where you launch different applications, switch between them, and the device's identity is not defined by what is currently running. Building the first OS complex enough to use all of this hardware simultaneously exposed six engineering problems that had no documented solutions for this platform. Not because the solutions were obscure. Because no previous project was complex enough to trigger them.
"The forge didn't need VC funding to build the Saturn V. It just needed focus and the right raw materials."
A TWO-TIER SOVEREIGN COMPUTING PLATFORM
SIX NOVEL PROBLEMS — NONE IN THE LITERATURE BEFORE THIS PROJECT
These problems did not exist in prior documentation because no previous ESP32-S3 project was complex enough to trigger them. The solutions are now the public reference standard for this hardware class.
MicroSD and LoRa radio share the SPI bus. Simultaneous operation under sustained load causes non-deterministic Guru Meditation crashes. Solution: The SPI Bus Treaty — a formal four-rule behavioral protocol, the first documented instance of this solution class on ESP32-S3 architecture.
Running wardriving, AI client, BLE scanner, GPS, LoRa, and 60fps UI simultaneously exhausts 320KB internal SRAM. Crashes in different subsystems appeared as different bugs. Solution: PSRAM heap redirection via single compiler flag — first application in a general-purpose OS context.
Core 0 (Ghost Engine) and Core 1 (UI) concurrent SD card access corrupts SdFat linked list data structures. Only manifests at high WiFi network density — invisible in lab, near-certain in downtown Los Angeles. Solution: FreeRTOS mutex + radio state flag. Zero crashes after implementation.
150+ simultaneous BLE advertising devices cause callback stack overflow. GPS timeouts, display corruption, and random reboots were all the same root cause. Cannot be discovered in a lab. Solution: stack sizing, hard scan buffer limit, GPS drain loops — all three required simultaneously.
AES encryption — the standard solution — holds the SPI bus long enough to crash the device. The security requirement and hardware constraint were irreconcilable within the original framing. Solution: reframe the requirement. Metadata deletion renders all Ghost Partition data permanently unreachable in milliseconds, within Treaty budget.
LilyGO manufactured two production batches with different GPS modules at different baud rates. Undocumented. Silent failure — no error output. Solution: baud rate auto-detection. First documented solution to this hardware variation problem.
OPEN SOURCE — AGPL-3.0
All technical claims are verifiable against the public codebase. Both repositories are licensed under AGPL-3.0. Commercial licensing available for enterprise deployments that cannot comply with copyleft requirements.
The full technical and philosophical documentation. Five industry assumptions being obliterated. Six novel engineering problems documented. Two markets, one platform. All claims verifiable.