diff --git a/docs/en/SUMMARY.md b/docs/en/SUMMARY.md index 7156fcd0ef5..6055eecb810 100644 --- a/docs/en/SUMMARY.md +++ b/docs/en/SUMMARY.md @@ -211,6 +211,7 @@ - [ZenFC H743](flight_controller/zenfc_h743.md) - [SIYI-UniFC-6-PICO](flight_controller/siyi-unifc-6-pico.md) - [Experimental Autopilots](flight_controller/autopilot_experimental.md) + - [AIFoundry Erbium](flight_controller/aifoundry_erbium.md) - [BeagleBone Blue](flight_controller/beaglebone_blue.md) - [Raspberry Pi 2/3 Navio2](flight_controller/raspberry_pi_navio2.md) - [Raspberry Pi 2/3/4 PilotPi](flight_controller/raspberry_pi_pilotpi.md) diff --git a/docs/en/flight_controller/aifoundry_erbium.md b/docs/en/flight_controller/aifoundry_erbium.md new file mode 100644 index 00000000000..ca64337a720 --- /dev/null +++ b/docs/en/flight_controller/aifoundry_erbium.md @@ -0,0 +1,43 @@ +# AIFoundry Erbium + + + +::: warning +PX4 does not manufacture this (or any) autopilot. +Contact [AIFoundry](https://github.com/aifoundry-org) for hardware support or compliance issues. +::: + +[Erbium](https://erbium.readthedocs.io/en/latest/) is an AIFoundry RISC-V chip whose design is [open source](https://github.com/aifoundry-org/erbium). +Its CPU subsystem has eight dual-threaded 64-bit [ET-Minion](https://erbium.readthedocs.io/en/latest/minion/) cores (RV64IMFC), derived from the Esperanto ET-SoC-1. +The PX4 target `aifoundry_erbium_default` runs NuttX on a single hart. + +## Development Status + +Erbium silicon is not yet available. +The target only runs on the `erbium_emu` system emulator from [ET-platform](https://github.com/aifoundry-org/et-platform), and has not been tested on hardware. + +The target has no sensor or actuator drivers. +It boots the [SIH](../sim_sih/index.md) quadcopter (airframe `1100`) and keeps parameters and dataman in RAM, so they are lost on reboot. +In the emulator it has been tested to pass the preflight checks, arm, and take off. + +The target is not built in PX4 CI, because the CI image does not include a RISC-V toolchain. + +## Building + +The build uses the `riscv-none-elf` toolchain ([xPack GNU RISC-V Embedded GCC](https://github.com/xpack-dev-tools/riscv-none-elf-gcc-xpack), tested with 14.3.0-1). +Add its `bin` directory to `PATH`, then build: + +```sh +make aifoundry_erbium_default +``` + +## Running in the Emulator + +Build `erbium_emu` as described in the [NuttX Erbium Minion documentation](https://nuttx.apache.org/docs/latest/platforms/risc-v/erbium/boards/minion/index.html), then start PX4 with: + +```sh +erbium_emu -elf_load build/aifoundry_erbium_default/aifoundry_erbium_default.elf \ + -reset_pc 0x40000200 -single_thread -max_cycles 100000000000 +``` + +The NuttX shell runs on the emulator console. diff --git a/docs/en/flight_controller/autopilot_experimental.md b/docs/en/flight_controller/autopilot_experimental.md index 1409dd2875a..57751d07f9c 100644 --- a/docs/en/flight_controller/autopilot_experimental.md +++ b/docs/en/flight_controller/autopilot_experimental.md @@ -12,6 +12,7 @@ For more information about PX4 project autopilot board support levels see: [px4. This category is for experimental autopilots (and autopilot "platforms") that are _not supported_ by either the PX4 project team or by a manufacturer. +- [AIFoundry Erbium](../flight_controller/aifoundry_erbium.md) - [BeagleBone Blue](../flight_controller/beaglebone_blue.md) - [Raspberry Pi 2/3 Navio2](../flight_controller/raspberry_pi_navio2.md) - [Raspberry Pi 2/3/4 PilotPi Shield](../flight_controller/raspberry_pi_pilotpi.md)