Skip to content

docs(rock3/rock3b): use Tabs to switch Maskrom entry steps for ROCK 3B / 3B+#1856

Merged
Milir-Radxa merged 1 commit into
radxa-docs:mainfrom
tangzz-radxa:docs/rock3b-maskrom-erase-tabs
Jun 18, 2026
Merged

docs(rock3/rock3b): use Tabs to switch Maskrom entry steps for ROCK 3B / 3B+#1856
Milir-Radxa merged 1 commit into
radxa-docs:mainfrom
tangzz-radxa:docs/rock3b-maskrom-erase-tabs

Conversation

@tangzz-radxa

Copy link
Copy Markdown
Contributor

Summary

Refactor the Maskrom entry steps on the ROCK 3B / 3B+ low-level-dev erase page to use a board-aware <Tabs> block so users can switch between ROCK 3B and ROCK 3B+ directly.

Previously the page only had a single Maskrom entry procedure for ROCK 3B, which made it confusing for ROCK 3B+ users (different pin locations, different on-board eMMC behavior). The shared wrapper still handles Linux/MacOS vs Windows tabs in _erase-spi-emmc.mdx; this change adds a new outer Tabs layer that switches the "进入 Maskrom 模式" steps per board.

Changes

  • docs/rock3/rock3b/low-level-dev/maskrom/erase.md
    • Wrap board-specific Maskrom entry steps in <Tabs queryString="board"> with <TabItem value="ROCK 3B"> and <TabItem value="ROCK 3B+">.
    • Each tab references its own pin callout image.
    • Keep the wrapper props (loader, rkdevtool images) unchanged.
  • i18n/en/docusaurus-plugin-content-docs/current/rock3/rock3b/low-level-dev/maskrom/erase.md
    • Mirror the same Tabs structure in English.
  • static/img/rock3/3b/rock3b-maskrom-pins.webp (new)
  • static/img/rock3/3b/rock3b-plus-maskrom-pins.webp (new)

Notes

  • Tabs share the same hardware flow (short DIS SPI/DIS eMMC, dip switch to Device, power, USB-A OTG cable). ROCK 3B has an extra note for boards without an eMMC module; that note is preserved only in the ROCK 3B tab.
  • Source: triggered by 售后技术支持群 request to make Maskrom entry steps switchable per board model.
  • pre-commit (use-webp-image, prettier, check-chinese, agent-doc-*) all pass on the touched files.

…B / 3B+

Replace the single Maskrom entry steps with a board-aware Tabs block
so users can switch between ROCK 3B and ROCK 3B+ directly on the
low-level-dev erase page. The two boards share the same hardware flow
but ROCK 3B has an extra note for boards without an eMMC module, and
the two boards have different pin callouts so each Tab now references
its own pin diagram image.

- Add rock3b-maskrom-pins.webp and rock3b-plus-maskrom-pins.webp
- Mirror the same Tabs structure in the English translation
- Keep the wrapper props (loader, rkdevtool images) unchanged

Source: triggered by 售后技术支持群 request to make Maskrom entry steps
switchable per board model.
@tangzz-radxa tangzz-radxa force-pushed the docs/rock3b-maskrom-erase-tabs branch from 8b3fbb8 to 39c3afa Compare June 18, 2026 10:11
@Milir-Radxa Milir-Radxa merged commit 4b70a40 into radxa-docs:main Jun 18, 2026
5 of 6 checks passed
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.

2 participants