Skip to content

Improve Armv7-R documentation - #162654

Open
jonathanpallant wants to merge 1 commit into
rust-lang:mainfrom
ferrocene:document-armv7r-cpus
Open

Improve Armv7-R documentation#162654
jonathanpallant wants to merge 1 commit into
rust-lang:mainfrom
ferrocene:document-armv7r-cpus

Conversation

@jonathanpallant

@jonathanpallant jonathanpallant commented Sep 11, 2026

Copy link
Copy Markdown
Contributor

People have fallen over the issue where target-cpu=cortex-r5 unexpectedly turns on FPU support, even on an EABI soft-float target. So this update attempts to document the full set of Armv7-R processors, their FPU options, and how to set things up for the precise combination you have.

It is modelled after the Armv7E-M documentation.

I know the features it recommends are "unstable" but I really do not know any other way of controlling what kind of FPU rustc is generating code for. I'd love a simple -Ctarget-cpu=cortex-r5 -Ctarget-fpu=vfp3-d16-sp option but we don't have one at this time.

This actually matters more on Armv7-R than on Armv7E-M, because rustc currently assumes a double-precision FPU and some hardware only has a single-precision FPU. So you need target features to make the target work on that hardware.

  • No LLMs were used in the creation of this PR

People have fallen over the issue where `target-cpu=cortex-r5` unexpectedly turns on FPU support, even on an EABI soft-float target. So this update attempts to document the full set of Armv7-R processors, their FPU options, and how to set things up for the precise combination you have.

It is modelled after the Armv7E-M documentation.
@rustbot

rustbot commented Sep 11, 2026

Copy link
Copy Markdown
Collaborator

Some changes occurred in src/doc/rustc/src/platform-support

cc @Noratrieb

@rustbot rustbot added the S-waiting-on-review Status: Awaiting review from the assignee but also interested parties. label Sep 11, 2026
@rustbot

rustbot commented Sep 11, 2026

Copy link
Copy Markdown
Collaborator

r? @khyperia

rustbot has assigned @khyperia.
They will have a look at your PR within the next two weeks and either review your PR or reassign to another reviewer.

Use r? to explicitly pick a reviewer

Why was this reviewer chosen?

The reviewer was selected based on:

  • Owners of files modified in this PR: compiler
  • compiler expanded to 76 candidates
  • Random selection from 21 candidates

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

Labels

S-waiting-on-review Status: Awaiting review from the assignee but also interested parties.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants