Skip to content

doc#157 — Add a tech note on using a USB WiFi adapter on the DevKit - #158

Open
dotimothy wants to merge 3 commits into
developfrom
doc/devkit-wifi-tech-note
Open

dotimothy wants to merge 3 commits into
developfrom
doc/devkit-wifi-tech-note

Conversation

@dotimothy

@dotimothy dotimothy commented Nov 5, 2026 •

Copy link
Copy Markdown
Collaborator

Closes #157

Summary

Adds the tech note Use a USB WiFi Adapter on the Modalix SoM DevKit for platform 3.0, in all five locales, and lists it in the Tech Notes index and sidebar.

Section Content
Before You Start Platform 3.0, an MT7921AU adapter (0e8d:7961), for example the BrosTrend AXE3000, Ethernet for packages, a Linux host with Docker and git; check the adapter with lsusb.
1. Build the Driver on the Host Clone SiMa-ai/simaai-linux, read the DevKit's /proc/config.gz, and build mt7921u plus the six mt76 modules it needs in a debian:trixie container (GCC 14.2, the compiler of the 3.0.0 kernel), with LOCALVERSION=-modalix.
2. Install the Driver and Firmware Copy the modules to /lib/modules/$(uname -r)/updates/mt76, depmod, install firmware-mediatek and wireless-regdb, modprobe mt7921u.
3. Connect to a WiFi Network nmcli device wifi rescan / list / connect, checks, and nmtui as the menu option. Ethernet stays the default route.
Limitations Firmware updates remove the driver; other chips need their own driver; 6 GHz is not tested.

Tested on a 3.0.0 DevKit

  • Adapter: MediaTek MT7921AU (USB ID 0e8d:7961) on the USB 3 hub.
  • The 3.0.0 kernel has cfg80211/mac80211 (as modules) but no mt7921u, no module signing, and no MODVERSIONS. The modules were built from SiMa-ai/simaai-linux master (the 2.1.3 release commit, kernel 6.18.3) with the board's config; all 460 symbols they import exist on the board.
  • modprobe mt7921u loads the chain, and the firmware starts (WM Firmware Version: ____010000, Build Time: 20241106151045); the interface appears as wlx<mac>.
  • Scanning finds networks on 2.4 GHz and 5 GHz. The DevKit connected to a WPA2/WPA3 network on 5 GHz, got a DHCP address, and pinged 8.8.8.8 over WiFi (3/3), with Ethernet still the default route (metric 100 vs 600).
  • The modules and the saved connection are on the persistent overlay in /data.

Not yet run: the note's exact one-command build (the same steps were run through a script), installing firmware-mediatek on its own (it was installed as a dependency of firmware-misc-nonfree), and a reboot.

Follow-up for the BSP (in #157): enabling CONFIG_MT7921U=m in the platform kernel would remove the build step.

Change Type

  • Bug fix
  • Refactor
  • Feature
  • Docs
  • Test-only
  • Build/CI
  • Breaking change

Risk

  • Low
  • Medium
  • High

Test Evidence

npm run check:i18n-complete                 46/46 in ja, ko, zh-Hant, uk; structure preserved
SYSDOC_STRICT_LINKS=1 npx docusaurus build  exit 0, all 5 locales

npm run check:language fails on develop for an unrelated reason; #153 fixes it.

Docs Impact

  • No docs update needed
  • Docs updated in this PR
  • Docs follow-up required (linked issue)

Migration Impact

  • No migration impact

Breaking API Change

  • Not applicable

API / Deprecation Checklist

  • Public API unchanged

Update (7a0589a): links the BrosTrend AXE3000 as an example MT7921AU adapter, and says 6 GHz is not tested instead of not supported (the adapter supports it; the test used 2.4 GHz and 5 GHz).

🤖 Generated with Claude Code

Build the MT7921AU (mt7921u) driver for platform 3.0, install its
firmware, and connect with nmcli. Tested on a 3.0.0 DevKit. Translate
into ja, ko, zh-Hant, uk.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 5, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-05T21:14:49.499763Z f31ffdc PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: f31ffdccee

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/reference/tech-notes/wifi.mdx Resolved
…he bands

The adapter reports 2.4, 5 and 6 GHz; say 6 GHz is not tested rather
than unsupported.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch has not been deployed

No deployments
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.

3 participants