Skip to content

docs(narinfc/h7): add flight controller documentation#26721

Open
mrpollo wants to merge 3 commits intomainfrom
mrpollo/narinfc-h7-docs
Open

docs(narinfc/h7): add flight controller documentation#26721
mrpollo wants to merge 3 commits intomainfrom
mrpollo/narinfc-h7-docs

Conversation

@mrpollo
Copy link
Copy Markdown
Contributor

@mrpollo mrpollo commented Mar 12, 2026

Summary

  • Add hardware documentation for the VOLOLAND NarinFC-H7 flight controller (pinouts, serial port mapping, PWM output groups, analog inputs)
  • Fix version badge to PX4 v1.17 (board was added in v1.17, not v1.18)
  • Clarify RC_IN is wired directly to FMU via RC_INPUT driver
  • Add entry to SUMMARY.md sidebar

Context

Supersedes #26542. This PR contains only the documentation changes, with unrelated submodule modifications (Tools/simulation/gz, platforms/nuttx/NuttX/nuttx, src/modules/mavlink/mavlink) removed.

Addresses review feedback from @hamishwillee:

  • Removed unrelated submodule changes
  • Fixed PX4 version badge (v1.17)
  • Added RC_IN wiring details (FMU-direct via RC_INPUT driver)

Based on work by @vololand and @hamishwillee.

Add hardware documentation for the VOLOLAND NarinFC-H7 flight controller
including pinouts, serial port mapping, PWM output groups, and analog
inputs. Fix version badge to v1.17 and clarify RC_IN is wired directly
to FMU via RC_INPUT driver.

Based on work by @vololand and @hamishwillee from PR #26542.

Signed-off-by: Ramon Roche <mrpollo@gmail.com>
@github-actions
Copy link
Copy Markdown

github-actions bot commented Mar 12, 2026

No broken links found in changed files.

Remove broken anchor link to modules_driver.md#rc-input which does not
exist. Use inline code formatting instead.

Signed-off-by: Ramon Roche <mrpollo@gmail.com>
@mrpollo mrpollo requested a review from hamishwillee March 12, 2026 14:12
Copy link
Copy Markdown
Contributor

@hamishwillee hamishwillee left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Docs look good to me @mrpollo . I'm happy for you to merge when you are ready.


The NarinFC-H7 supports up to 14 PWM outputs.
All outputs except M13 and M14 support DShot.
Outputs 1-8 support Bi-Directional DShot.
Copy link
Copy Markdown
Contributor

@hamishwillee hamishwillee Mar 19, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to Claude, only outputs 1–4 (Timer5) support bidirectional - since _bidi_timer_index = 0 is hardcoded and limits bidirectional to the first timer. @mrpollo

EDIT. Note, after looking at Jake's new PR it further says that this is the true statemnt:

Outputs 1–12 support DShot. Outputs 1–7 and 9–12 support Bidirectional DShot (output + eRPM). Output 8
supports Bidirectional DShot output only (no eRPM capture — STM32H7 Timer4 CH4 has no per-channel apture DMA).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Note, even if this is true, it might be an accidental limitation. Until recently (#26263) you could only 4, but that limitation seems to have changed https://docs.px4.io/main/en/peripherals/dshot#hardware-support

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants