Arm backend: Update examples/arm/README.md

[martinlsm]

Make the README concise for setup, run.sh usage, example notebooks, applications, and helper scripts. Move broader backend documentation links to the backend README.

cc @digantdesai @freddan80 @per @zingo @oscarandersson8218 @mansnils @Sebastian-Larsson @robell @rascani

[pytorch-bot]

🔗 Helpful Links

🧪 See artifacts and rendered test results at hud.pytorch.org/pr/pytorch/executorch/19756

• 📄 Preview Python docs built from this PR

Note: Links to docs will display an error until the docs builds have been completed.

❗ 1 Active SEVs

There are 1 currently active SEVs. If your PR is affected, please view them below:

• /easycla is not responding

❌ 2 New Failures, 4 Unrelated Failures

As of commit 581e9c6 with merge base 4741f3a ():

NEW FAILURES - The following jobs have failed:

• pull / android / build-android (gh)
• trunk / test-models-macos-cpu (llama2, xnnpack-quantization-delegation) / macos-job (gh)
  RuntimeError: Command bash /Users/ec2-user/runner/_work/_temp/exec_script failed with exit code 1

FLAKY - The following job failed but was likely due to flakiness present on trunk:

• trunk / unittest-release / macos / macos-job (gh) (similar failure)
  ##[error]The operation was canceled.

BROKEN TRUNK - The following jobs failed but was present on the merge base:

👉 Rebase onto the `viable/strict` branch to avoid these failures

• pull / test-static-llama-qnn-linux (stories_110m) / linux-job (gh) (trunk failure)
  test_llama_stories_110m
• pull / unittest / macos / macos-job (gh) (trunk failure)
  ##[error]The operation was canceled.
• pull / unittest-editable / macos / macos-job (gh) (trunk failure)
  ##[error]The operation was canceled.

This comment was automatically generated by Dr. CI and updates every 15 minutes.

[linux-foundation-easycla]

The committers listed above are authorized under a signed CLA.

• ✅ login: martinlsm / name: Martin Lindström (47c1e4c, 4e1899d, 2238146, 3a6d1f1, ba894af)

[martinlsm]

@pytorchbot label ciflow/trunk

[martinlsm]

@pytorchbot label "partner: arm"

[martinlsm]

@pytorchbot label "release notes: arm"

[Copilot]

Pull request overview

This PR streamlines the Arm examples documentation by making examples/arm/README.md more concise (setup/run usage, example notebooks/apps/utilities) and relocating broader “getting started” documentation links into the Arm backend README.

Changes:

• Rewrote examples/arm/README.md to focus on setup.sh / run.sh usage and to index notebooks, applications, and helper scripts.
• Updated backends/arm/README.md to point to the hosted Arm backend tutorials/overview pages and to link the Ethos-U porting guide.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File	Description
examples/arm/README.md	Condenses setup/run guidance and adds a curated index of example notebooks/apps/utilities.
backends/arm/README.md	Replaces local doc paths with hosted documentation links and adds a porting guide link.

Comments suppressed due to low confidence (5)

examples/arm/README.md:20

• setup.sh generates setup-path scripts at arm-scratch/setup_path.{sh|fish} (see setup.sh log message). The README currently says it generates setup_path.sh scripts, which is slightly inaccurate and may hide the fish variant. Consider referencing setup_path.{sh|fish} or setup_path.sh/setup_path.fish explicitly.

`setup.sh` downloads the Arm cross-compilation toolchain and Corstone FVP
simulators, installs the Python dependencies for TOSA, Ethos-U Vela, and
Cortex-M/CMSIS-NN, and generates `setup_path.sh` scripts for adding those tools
to your environment. Optional flags also install VGF/MLSDK and Vulkan
dependencies.

examples/arm/README.md:80

• Markdown list formatting looks off here: the nested "-" plus the following continuation lines are inconsistently indented, which can render as a separate list item/paragraph. Consider using the same "- link - description" pattern as the other entries and wrap the description with proper indentation.

- [image_classification_example_ethos_u](image_classification_example_ethos_u/)
  - End-to-end DEiT-Tiny image classification flow for Ethos-U, including
  model fine-tuning, export, bare-metal runtime build, and Corstone-320 FVP
  execution.
- [image_classification_example_vgf](image_classification_example_vgf/) -

examples/arm/README.md:34

• Docs wording may be misleading here: run.sh invokes the Arm AOT compiler via python3 -m backends.arm.scripts.aot_arm_compiler (see run.sh), while examples/arm/aot_arm_compiler.py exists only as a deprecated compatibility wrapper. Consider calling out the canonical module/path to avoid steering users to the deprecated wrapper.

`run.sh` is an end-to-end helper for building and executing an Arm backend
example. It sources the `setup_path.sh` script generated by `setup.sh`, runs
`aot_arm_compiler.py` to convert the selected model to a `.pte` or `.bpte`,
builds the matching runner with CMake, and starts the simulator or runtime for

examples/arm/README.md:83

• Link style inconsistency: this list uses trailing slashes for other directories (e.g., image_classification_example_vgf/) but super_resolution_example_vgf is linked without /. Using a consistent directory link style avoids confusion and works more reliably across different Markdown renderers.

- [image_classification_example_vgf](image_classification_example_vgf/) -
  DEiT-Tiny image classification flow for VGF host execution.
- [super_resolution_example_vgf](super_resolution_example_vgf) - Swin2SR image
  super-resolution.

examples/arm/README.md:94

• Broken link: composable_quantizer_example.py is referenced here, but there is no such file under examples/arm/ (and a repo-wide search only finds this mention). Either add the script or update/remove the link to point at the correct location.

- [export_standalone_tosa_graph.py](export_standalone_tosa_graph.py) -
  Example of exporting a standalone TOSA graph with multiple outputs.
- [composable_quantizer_example.py](composable_quantizer_example.py) - Minimal
  script showing experimental composable quantizer use.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

[Copilot]

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

[Copilot]

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.

[Copilot]

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.