Skip to content

Add MicoAir743-Lite and MicoAir743v3 flight controller targets - #12245

Open
Minderring wants to merge 1 commit into
iNavFlight:maintenance-10.xfrom
Minderring:add-micoair743-lite-and-v3
Open

Minderring wants to merge 1 commit into
iNavFlight:maintenance-10.xfrom
Minderring:add-micoair743-lite-and-v3

Conversation

@Minderring

Copy link
Copy Markdown
Contributor

Dear INAV Developers.

This PR adds support for two STM32H743 flight controllers from MicoAir Tech to maintenance-10.x. It uses the sensor and peripheral drivers already in INAV.

Firmware target Board and configuration
MICOAIR743LITE MicoAir743-Lite with an ICM45686 IMU, SPA06 barometer and MSP DisplayPort. An external compass connects to I²C1.
MICOAIR743V3 MicoAir743v3 with a BMI088 (default) or ICM45686 IMU, SPA06 barometer and onboard IST8310 compass on I²C2. The board supports analog OSD, MSP DisplayPort and DroneCAN.
MICOAIR743V3_EXTMAG The same V3 hardware, configured to use an external compass on I²C1. Choose this target when using a GPS module with its own compass.

Both boards use UART3 for GPS, UART6 for the serial receiver, UART7 RX for ESC telemetry and UART8 for onboard Bluetooth. Blackbox logs to the microSD card by default.

Board manuals and pinouts

Build and hardware review

All three firmware targets were built locally from this branch with Arm GNU Toolchain 13.2.1 and tested in the drones.

We would be happy to provide production samples of boards to INAV core developers for evaluation. Please let us know whom to coordinate with before shipping.

Best regard!
Minderring

QQ_2026-11-21_18-54-38 QQ_2026-11-21_18-55-33

@qodo-code-review

Copy link
Copy Markdown
Contributor

ⓘ Qodo reviews are paused because the subscription is no longer active. Ask your workspace admin to reactivate the subscription to resume reviews. Manage billing

@qodo-free-for-open-source-projects

qodo-free-for-open-source-projects Bot commented Nov 21, 2026 •

Copy link
Copy Markdown

PR Summary by Qodo

Add MicoAir743-Lite and V3 flight controller targets

✨ Enhancement 📝 Documentation 🕐 40+ Minutes

Grey Divider

AI Description

• Add STM32H743 firmware targets for MicoAir743-Lite and V3, including an external-compass V3
 variant.
• Configure board-specific sensors, ports, outputs, and microSD logging using existing INAV drivers.
• Document default connections and hardware constraints to guide setup.
Merge Risk 🟡 Medium

Blast radius 🟡 Medium 💥 3 capabilities

  • 3 affected capabilities within one bounded functional scope: MicoAir743 board-family hardware integration.
  • The IMU registration and timer table feed the same end-to-end flight-control behavior: sensor acquisition is consumed by stabilization and timer outputs are consumed by motor/servo actuation.
  • They are separate implementation hops of one board integration capability, not independent deployment scopes.
  • Serial defaults, barometer/compass buses, SD logging, ADCs, and optional MSP peripherals are distinct user-visible operations within the same bounded board-support integration.
  • Their shared target definition is the propagation mechanism; they do not establish independent functional scopes.
  • The dual-IMU registrations and timer table converge on the same end-to-end flight-control behavior.
  • The EXT MAG distinction changes compass input, but does not create a separate functional scope from the V3 board integration.
  • The onboard/external compass selection and serial/peripheral defaults produce distinct peripheral outcomes but remain part of the bounded V3 board-support integration.
  • The compile-time EXT MAG path is a compatibility variant of this same behavior.
  • USER1-controlled VTX/camera supply is a distinct system outcome from serial or sensor I/O, but it is still a bounded board integration capability.
  • The path is supported by the explicit USER1 permanent-ID assignment and PINIO1 target definition.
Sources

src/main/target/MICOAIR743LITE/config.c[22-27]

void targetConfiguration(void)
{
    serialFindPortConfiguration(SERIAL_PORT_USART2)->functionMask = FUNCTION_MSP_OSD;
    serialFindPortConfiguration(SERIAL_PORT_USART3)->functionMask = FUNCTION_GPS;
    serialFindPortConfiguration(SERIAL_PORT_USART7)->functionMask = FUNCTION_ESCSERIAL;
    serialFindPortConfiguration(SERIAL_PORT_USART8)->functionMask = FUNCTION_MSP; // Bluetooth

src/main/target/MICOAIR743V3/target.c[28-31]

// BMI088 accelerometer and gyro must use the same selection tag.
BUSDEV_REGISTER_SPI_TAG(busdev_bmi088_gyro, DEVHW_BMI088_GYRO, BMI088_SPI_BUS, BMI088_GYRO_CS_PIN, BMI088_GYRO_EXTI_PIN, 0, DEVFLAGS_NONE, IMU_BMI088_ALIGN);
BUSDEV_REGISTER_SPI_TAG(busdev_bmi088_acc, DEVHW_BMI088_ACC, BMI088_SPI_BUS, BMI088_ACC_CS_PIN, BMI088_ACC_EXTI_PIN, 0, DEVFLAGS_NONE, IMU_BMI088_ALIGN);
BUSDEV_REGISTER_SPI_TAG(busdev_icm45686, DEVHW_ICM45686, ICM45686_SPI_BUS, ICM45686_CS_PIN, ICM45686_EXTI_PIN, 1, DEVFLAGS_NONE, IMU_ICM45686_ALIGN);
Behavioral complexity 🟡 Medium 🧩 Compatibility cases, Interacting branches

  • Before: a single target configuration could select one IMU and one compass arrangement.
  • After: the V3 target introduces two IMU registrations with a selection tag, two compile-time compass variants, and shared timer resources that must remain compatible with LED/output modes.
  • New correctness conditions are: both parts of a BMI088 pair must use the same selection tag; the selected IMU must match the configured board variant; EXT MAG must use I2C1 while onboard compass uses I2C2 with the correct alignment; and timer/LED allocation must not remove required outputs.
  • These are new compatibility and resource-interaction conditions, not merely reuse of existing drivers.
Sources

src/main/target/MICOAIR743V3/target.c[28-31]

// BMI088 accelerometer and gyro must use the same selection tag.
BUSDEV_REGISTER_SPI_TAG(busdev_bmi088_gyro, DEVHW_BMI088_GYRO, BMI088_SPI_BUS, BMI088_GYRO_CS_PIN, BMI088_GYRO_EXTI_PIN, 0, DEVFLAGS_NONE, IMU_BMI088_ALIGN);
BUSDEV_REGISTER_SPI_TAG(busdev_bmi088_acc, DEVHW_BMI088_ACC, BMI088_SPI_BUS, BMI088_ACC_CS_PIN, BMI088_ACC_EXTI_PIN, 0, DEVFLAGS_NONE, IMU_BMI088_ALIGN);
BUSDEV_REGISTER_SPI_TAG(busdev_icm45686, DEVHW_ICM45686, ICM45686_SPI_BUS, ICM45686_CS_PIN, ICM45686_EXTI_PIN, 1, DEVFLAGS_NONE, IMU_ICM45686_ALIGN);
Potential damage 🔴 High 🩹 Critical loss

  • A wrong IMU bus/chip-select/orientation or timer output mapping can leave stabilization unavailable or make motor/servo commands reach incorrect physical channels.
  • Reverting the firmware restores the prior code, but any persisted mixer/output assignments still require checking and the board must be reflashed.
  • Recoverable by installing a corrected target firmware and restoring or verifying output/sensor configuration; no source evidence establishes automatic repair of persisted configuration.
Assessed commit 776b6a7
Diagram

graph TD
    Build["H743 build"] --> Lite["Lite target"] --> Drivers["INAV drivers"] --> Hardware["Board peripherals"]
    Build --> V3["V3 targets"] --> Drivers
    V3 --> Compass{"Compass variant"} --> Onboard["Onboard IST8310"]
    Compass --> External["External I2C1"]
Loading
High-Level Assessment

The following are alternative approaches to this PR:

1. Extend the existing MICOAIR743V2 target
  • ➕ Could share more definitions across related boards.
  • ➖ Different pins, IMUs, storage wiring, and compass options would introduce extensive conditional configuration and increase regression risk for V2.

Recommendation: Keep separate Lite and V3 board definitions while sharing the V3 implementation between its two compass builds. This isolates hardware differences without duplicating the V3 pin and timer mappings.

Files changed (9) +546 / -0

Enhancement (6) +421 / -0
CMakeLists.txtRegister the Lite firmware target +1/-0

Register the Lite firmware target

• Adds MICOAIR743LITE as an STM32H743XI build target.

src/main/target/MICOAIR743LITE/CMakeLists.txt

target.cRegister Lite IMU and output timers +48/-0

Register Lite IMU and output timers

• Registers the ICM45686 SPI device and maps motor, servo, and LED-strip pads to timers. Marks the outputs without channel DMA as PWM-only.

src/main/target/MICOAIR743LITE/target.c

target.hDefine Lite hardware and feature configuration +126/-0

Define Lite hardware and feature configuration

• Defines sensor buses, serial pins, receiver defaults, SD-card logging, ADC scaling, and peripheral features. Leaves the LED strip disabled by default to retain TIM4 outputs.

src/main/target/MICOAIR743LITE/target.h

CMakeLists.txtRegister both V3 compass builds +2/-0

Register both V3 compass builds

• Adds STM32H743XI build targets for the standard V3 and V3_EXTMAG configurations.

src/main/target/MICOAIR743V3/CMakeLists.txt

target.cRegister selectable V3 IMUs and output timers +49/-0

Register selectable V3 IMUs and output timers

• Registers the BMI088 accelerometer and gyro under one selection tag and the ICM45686 under another. Maps the V3 outputs and LED pad while leaving the beeper as GPIO.

src/main/target/MICOAIR743V3/target.c

target.hDefine V3 hardware and compass variants +195/-0

Define V3 hardware and compass variants

• Defines both IMUs, analog OSD, DroneCAN, serial ports, sensors, SD-card logging, outputs, and VTX power control. Selects the onboard I2C2 compass or external I2C1 compass at build time.

src/main/target/MICOAIR743V3/target.h

Documentation (1) +58 / -0
MicoAir743-Lite-and-V3.mdDocument board variants and setup constraints +58/-0

Document board variants and setup constraints

• Describes the three targets, default ports, IMU selection, output timer groups, and shared connector signals. Explains LED-strip output conflicts and the V3 camera/VTX power-control behavior.

docs/boards/MicoAir743-Lite-and-V3.md

Other (2) +67 / -0
config.cSet Lite serial-port defaults +28/-0

Set Lite serial-port defaults

• Assigns MSP DisplayPort, GPS, ESC telemetry, and Bluetooth MSP to their respective UARTs.

src/main/target/MICOAIR743LITE/config.c

config.cSet V3 port, compass, and power-control defaults +39/-0

Set V3 port, compass, and power-control defaults

• Assigns serial functions by port identifier, sets onboard compass alignment for the standard build, and exposes VTX power control through USER1.

src/main/target/MICOAIR743V3/config.c

@qodo-free-for-open-source-projects

Copy link
Copy Markdown

Code Review by Qodo

🐞 Bugs (0) 📘 Rule violations (0) 📎 Requirement gaps (0)

Grey Divider

Great, no issues found!

Qodo reviewed your code and found no material issues that require review

Grey Divider

Tip of the day
💡 Did you know, you can add REVIEW.md to your repo root and Qodo follows it on every PR

More tips ↗ | Customize Qodo ↗ | Qodo docs ↗

Grey Divider

Qodo Logo

@github-actions

Copy link
Copy Markdown

RAM / Flash usage vs. base commit 21adf64 — commit 776b6a7

Target Flash Δ RAM Δ
MATEKF405 ±0 B (±0.00%) CCM: ±0 B (±0.00%)
RAM: ±0 B (±0.00%)
MATEKF722 ±0 B (±0.00%) ITCM_RAM: ±0 B (±0.00%)
RAM: ±0 B (±0.00%)
TCM: ±0 B (±0.00%)
MATEKF765 ±0 B (±0.00%) DTCM_RAM: ±0 B (±0.00%)
SRAM1: ±0 B (±0.00%)
MATEKH743 ±0 B (±0.00%) D2_RAM: ±0 B (±0.00%)
DTCM_RAM: ±0 B (±0.00%)
ITCM_RAM: ±0 B (±0.00%)
RAM: ±0 B (±0.00%)

See RAM/flash optimization guide for techniques to reduce usage.

@github-actions

Copy link
Copy Markdown

Test firmware build ready — commit 776b6a7

Download firmware for PR #12245

254 targets built. Find your board's .hex file by name on that page (e.g. MATEKF405SE.hex). Files are individually downloadable — no GitHub login required.

Development build for testing only. Use Full Chip Erase when flashing.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant