Skip to content
Boscon-SpacePublic

About

No description, website, or topics provided.

Resources

Stars

11 stars

Watchers

0 watching

Forks

Repository files navigation

Kapex: Kotlin from the pins to the edge of space

Kapex (Kotlin + apex) is the software of the HAB-1 payload computer: one static Kotlin/Native binary for the Raspberry Pi 5 that owns the pins, the radio, the sensors and the language model, plus the Compose console on the Mac. Kotlin packages are space.boscon.kapex.*; the Gradle root project is kapex. The folder was payload/ until 2026-10-12. See ../docs/35-pi5-kotlin-payload-computer.md §8 for the plan and §9 for the bench bring-up log.

Path What
hal/ Kernel-interface HAL: GPIO chardev v2, i2c-dev, spidev, termios. Links libc only.
camera/ MJPEG frames to AVI segments: Huffman-table insertion, AVI 1.0 writer, file sink. JVM-tested on a real C270 frame.
camrec/ One camera to 60 s AVI segments on the card; its own systemd service or a one-shot clip.
probes/ Bench probes, one executable each, pass conditions that can fail.
tools/image_card.sh Write the OS image to a microSD on the Mac.
tools/boot_config.sh Put the cloud-init first-boot files on an imaged card.
tools/pi_firstboot_setup.sh Run once on the Pi: partitions, packages, journald, interfaces.
tools/pi.sh ssh/scp wrapper (default hab1.local; PI_HOST=10.12.194.1 on the USB gadget link).
tools/run_probe.sh Build a probe, copy it to the Pi, run it.
tools/pi_service.sh Install/control the continuous telemetry beacon service on the Pi.
systemd/ Unit files deployed to the Pi.
station/ HAB-1 Station: Compose for Desktop console for the Mac, run with gradle :station:run.
tools/flash_bridge.sh Build the Heltec bridge sketch on the Mac and have the Pi flash it over USB, with rollback to the last good image.
image/ Downloaded image + per-machine user-data/network-config (git-ignored).

Build host: the Mac (Kotlin/Native cannot build on an aarch64 Linux host). Kotlin is pinned to 2.4.10 for the test campaign (gradle.properties).

gradle :probes:linkGpio_probeReleaseExecutableLinuxArm64   # one probe
tools/run_probe.sh gpio_probe                      # build + run on the Pi

License

Licensed under the Apache License, Version 2.0. See LICENSE. The license covers the code and documents in this repository. It does not cover the language model weights, the Raspberry Pi OS image or llama.cpp, which are downloaded or built separately under their own terms.

About

No description, website, or topics provided.

Resources

Stars

11 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages