Simantic runs this firmware on simulated hardware, no board needed. Try it at simantic.com.
Run this firmware with no hardware. Simantic simulates the whole board, peripherals, sensors and buses included. Try it free at simantic.com, or run it locally:
curl -fsSL https://simantic.com/install | sh
This fork adds a demo to the F´ Zephyr reference: the deployment, built for the upstream-tested NUCLEO-H723ZG, runs unmodified on a simulated board inside an orbit and power environment, with the stock F´ ground station attached. No board, no satellite.
Media demo (34 s), the short cut for sharing:
Technical demo (67 s), from reset to orbit: what is in the firmware file, how it loads, the clock registers it writes at boot, and its 10 Hz and 1 Hz loops as the simulator timed them. The preview below plays here; click it for the full-resolution video.
./demo # nominal: orbit, eclipse, commands, detumble
./demo faults # the power system damages three replies; the firmware retries each one
# F´ GDS web UI while it runs: http://127.0.0.1:5800Needs sim (Simantic's simulator, proprietary; curl -fsSL https://simantic.com/install | sh)
and Python 3.10-3.13 for fprime-gds. The ELF and dictionary are prebuilt in sim/, so
no Zephyr SDK is needed; sim/build.sh rebuilds them.
flowchart LR
gds["fprime-gds<br/>stock F´ ground station"] <-- "USART3 (ST-LINK VCP)<br/>bridged to TCP 5761" --> fw
subgraph board["NUCLEO-H723ZG, simulated"]
fw["F´ deployment<br/>(this repo, unmodified ELF)"]
end
fw <-- "FDCAN1, CSP over CAN" --> eps["Power system + battery<br/>(peer, sim/EPS-PROTOCOL.md)"]
fw <-- "SPI1" --> fram["FRAM<br/>boot count"]
fw <-- "I2C1" --> imu["2x LIS2DW12, 2x IST8310"]
fw <-- "ADC1, 6 channels" --> sun["Sun sensors, 6 panels"]
fw -- "TIM1 PWM + DIR" --> mtq["Magnetorquers"]
orbit(["orbit model: tumble, Earth's field, eclipse at 90 s"]) -.-> eps & imu & sun
What ./demo shows (its walkthrough prints each step):
| Step | What happens |
|---|---|
| Orbit | The sun sweeps across the panels; the firmware reads it through its own ADC. The battery charges at about +330 mA. |
| Eclipse | At 90 s every sun sensor reads 0 and the battery goes to -195 mA. Nothing tells the firmware; it sees it through its sensors and the power system's replies. |
| Commands | EPS_PING over CSP/CAN, MTQ_SET Y 40 (PWM duty), FRAM_WRITE then FRAM_READ 0xCAFEF00D over SPI, each through the F´ dispatcher. |
| Detumble | The B-dot loop drives the coils from the magnetometer. The orbit model spins the satellite kinematically, so the rate does not drop (no attitude dynamics). |
Faults (./demo faults) |
Housekeeping requests 30, 40 and 50 lose a CAN frame, arrive corrupted, and arrive late; the firmware reports HkRetry and recovers on attempt 2 each time. |
Pins, files and what is modelled: sim/README.md. The power-system
protocol is made up for this demo: sim/EPS-PROTOCOL.md. The
video is generated from two recorded runs (video/; every number on screen comes from
video/runs/).
Branch simantic-sim-demo, merged up to fprime-community/fprime-zephyr-reference devel at 4af31f4.
This project is an implementation of F` on Zephyr RTOS.
- F Prime System Requirements listed here
- Zephyr dependencies listed here
- Minimum required CMake version: 3.27.0
- Follow the Hello World Tutorial
- Follow the Zephyr Getting Started Guide. Ensure that the Zephyr's dependencies and SDK have been installed
- If you are using WSL, make sure to refer to the WSL Notes docs

