From f31ffdccee7c0c08b0caa4aca74aada896df1c89 Mon Sep 17 00:00:00 2001 From: Timothy Do Date: Thu, 5 Nov 2026 13:10:24 -0800 Subject: [PATCH 1/2] =?UTF-8?q?doc#157=20=E2=80=94=20Add=20a=20tech=20note?= =?UTF-8?q?=20on=20using=20a=20USB=20WiFi=20adapter=20on=20the=20DevKit?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- docs/reference/tech-notes/index.md | 1 + docs/reference/tech-notes/wifi.mdx | 144 ++++++++++++++++++ .../current/reference/tech-notes/index.md | 1 + .../current/reference/tech-notes/wifi.mdx | 144 ++++++++++++++++++ .../current/reference/tech-notes/index.md | 1 + .../current/reference/tech-notes/wifi.mdx | 144 ++++++++++++++++++ i18n/translation-sources.json | 20 ++- .../current/reference/tech-notes/index.md | 1 + .../current/reference/tech-notes/wifi.mdx | 144 ++++++++++++++++++ .../current/reference/tech-notes/index.md | 1 + .../current/reference/tech-notes/wifi.mdx | 144 ++++++++++++++++++ sidebars.js | 1 + 12 files changed, 738 insertions(+), 8 deletions(-) create mode 100644 docs/reference/tech-notes/wifi.mdx create mode 100644 i18n/ja/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx create mode 100644 i18n/ko/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx create mode 100644 i18n/uk/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx create mode 100644 i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx diff --git a/docs/reference/tech-notes/index.md b/docs/reference/tech-notes/index.md index 1470d5a..4262452 100644 --- a/docs/reference/tech-notes/index.md +++ b/docs/reference/tech-notes/index.md @@ -13,3 +13,4 @@ Use these pages for platform-specific instructions, advanced setup, and known li - [Convert from 2.1.3 to 3.0.0](./convert-2-1-3-to-3-0-0.md) - [Set Up Bluetooth on the Modalix SoM DevKit](./bluetooth.mdx) - [Install ROS 2 on the Modalix SoM DevKit](./ros2.mdx) +- [Use a USB WiFi Adapter on the Modalix SoM DevKit](./wifi.mdx) diff --git a/docs/reference/tech-notes/wifi.mdx b/docs/reference/tech-notes/wifi.mdx new file mode 100644 index 0000000..ef7fa7c --- /dev/null +++ b/docs/reference/tech-notes/wifi.mdx @@ -0,0 +1,144 @@ +--- +title: Use a USB WiFi Adapter on the Modalix SoM DevKit +description: Build the MediaTek MT7921AU driver for platform 3.0, install its firmware, and connect the Modalix SoM DevKit to WiFi with nmcli. +sidebar_position: 7 +--- + +# Use a USB WiFi Adapter on the Modalix SoM DevKit + +The Modalix SoM DevKit has no built-in WiFi. You can add it with a USB WiFi adapter. This note uses an adapter with the MediaTek MT7921AU chip, which supports WiFi 6 on 2.4 GHz and 5 GHz. The platform 3.0 kernel includes the Linux wireless stack, but not the driver for this chip, so you build the driver, install it with the chip's firmware, and then connect with NetworkManager. + +## Before You Start + +You need: + +- A Modalix SoM DevKit with platform version **3.0**. To check, run `cat /etc/buildinfo` on the DevKit. +- A USB WiFi adapter with the MediaTek MT7921AU chip (USB ID `0e8d:7961`). +- Internet access on the DevKit, through Ethernet, to install packages. +- A Linux host with Docker and `git`, to build the driver, and SSH access from the host to the DevKit. + +Plug the adapter into a USB port on the DevKit, then check that the DevKit detects it: + +```console +sima@modalix:~$ lsusb | grep 0e8d:7961 +Bus 002 Device 003: ID 0e8d:7961 MediaTek Inc. Wireless_Device +``` + +## 1. Build the Driver on the Host {#build} + +Build the `mt7921u` driver and the `mt76` modules it depends on from the SiMa.ai kernel source, with the DevKit's own kernel configuration. The build runs in a Debian container that has the same compiler as the DevKit's kernel. + +Run these commands **on the host**. Replace `` with the DevKit's IP address. + +1. Get the kernel source, and the DevKit's kernel configuration: + + ```bash + git clone --depth 1 https://github.com/SiMa-ai/simaai-linux.git + ssh sima@ 'zcat /proc/config.gz' > board.config + ``` + +2. Build the modules: + + ```bash + docker run --rm -v "$PWD":/w -w /w/simaai-linux debian:trixie bash -c ' + apt-get update && apt-get install -y gcc-aarch64-linux-gnu make bc flex bison libssl-dev libelf-dev python3 kmod && + export ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- LOCALVERSION=-modalix && + cp ../board.config .config && + scripts/config --module MT7921U && + make olddefconfig && + make -j"$(nproc)" modules_prepare && + make -j"$(nproc)" M=drivers/net/wireless/mediatek/mt76 KBUILD_MODPOST_WARN=1 modules' + ``` + + The build prints warnings about unresolved symbols. They are expected: the symbols are in the `cfg80211` and `mac80211` modules that are already on the DevKit. + +3. Check that the build made seven modules: + + ```bash + find simaai-linux/drivers/net/wireless/mediatek/mt76 -name '*.ko' + ``` + + You get `mt76.ko`, `mt76-usb.ko`, `mt76-connac-lib.ko`, `mt792x-lib.ko`, `mt792x-usb.ko`, `mt7921-common.ko` and `mt7921u.ko`. + +4. Copy them to the DevKit: + + ```bash + scp $(find simaai-linux/drivers/net/wireless/mediatek/mt76 -name '*.ko') sima@:/tmp/ + ``` + +## 2. Install the Driver and Firmware on the DevKit {#install} + +Run the commands below **on the DevKit**. + +1. Install the modules, and update the module index: + + ```console + sima@modalix:~$ sudo mkdir -p /lib/modules/$(uname -r)/updates/mt76 + sima@modalix:~$ sudo mv /tmp/mt7*.ko /lib/modules/$(uname -r)/updates/mt76/ + sima@modalix:~$ sudo depmod -a + ``` + +2. Install the adapter's firmware and the wireless regulatory database: + + ```console + sima@modalix:~$ sudo apt-get update + sima@modalix:~$ sudo apt-get install -y firmware-mediatek wireless-regdb + ``` + +3. Load the driver: + + ```console + sima@modalix:~$ sudo modprobe mt7921u + ``` + + From now on, the driver loads by itself whenever the adapter is plugged in, including at boot. + +4. Check that the adapter has a wireless interface: + + ```console + sima@modalix:~$ nmcli device status + DEVICE TYPE STATE CONNECTION + end0 ethernet connected end0-dhcp + wlxe84e06afdb5e wifi disconnected -- + ``` + + The interface name starts with `wlx`, followed by the adapter's MAC address. If it does not appear, check the driver messages with `sudo dmesg | grep mt7921u`. They show the firmware version when the firmware loads. + +## 3. Connect to a WiFi Network {#connect} + +Use `nmcli`, the NetworkManager command-line tool, on the DevKit. + +1. Scan for networks: + + ```console + sima@modalix:~$ sudo nmcli device wifi rescan + sima@modalix:~$ nmcli device wifi list + ``` + +2. Connect. Replace `` and `` with the network's name and password: + + ```console + sima@modalix:~$ sudo nmcli device wifi connect "" password "" + ``` + + NetworkManager saves the connection, and reconnects to it at every boot. + +3. Check the connection: + + ```console + sima@modalix:~$ nmcli device status + sima@modalix:~$ ip -4 -br addr show + sima@modalix:~$ ping -c 3 -I wlxe84e06afdb5e 8.8.8.8 + ``` + + Replace `wlxe84e06afdb5e` with your interface name. + +To choose a network from a menu instead, run `sudo nmtui` and select **Activate a connection**. + +If the DevKit is also connected through Ethernet, the Ethernet connection stays the default route. NetworkManager gives WiFi a lower priority. + +## Limitations {#limitations} + +- **Firmware updates remove the driver.** The modules are built for the running kernel. After you update the DevKit firmware, build and install them again. +- **Other adapters need their own driver.** This note covers the MediaTek MT7921AU. Other chips need a different kernel driver and firmware. +- **No 6 GHz.** The MT7921AU uses 2.4 GHz and 5 GHz only. diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/reference/tech-notes/index.md b/i18n/ja/docusaurus-plugin-content-docs/current/reference/tech-notes/index.md index 0248090..4a2ac2d 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/reference/tech-notes/index.md +++ b/i18n/ja/docusaurus-plugin-content-docs/current/reference/tech-notes/index.md @@ -13,3 +13,4 @@ sidebar_position: 1 - [2.1.3 から 3.0.0 にバージョンアップします。](./convert-2-1-3-to-3-0-0.md) - [BluetoothをModalix SoM DevKitに設定します。](./bluetooth.mdx) - [ROS 2 を Modalix SoM DevKit にインストールします。](./ros2.mdx) +- [Modalix SoM DevKit で USB WiFi アダプターを使用する](./wifi.mdx) diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx b/i18n/ja/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx new file mode 100644 index 0000000..4ae0aaf --- /dev/null +++ b/i18n/ja/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx @@ -0,0 +1,144 @@ +--- +title: "Modalix SoM DevKit で USB WiFi アダプターを使用する" +description: "プラットフォーム 3.0 向けに MediaTek MT7921AU ドライバーをビルドし、ファームウェアをインストールして、nmcli で Modalix SoM DevKit を WiFi に接続します。" +sidebar_position: 7 +--- + +# Modalix SoM DevKit で USB WiFi アダプターを使用する + +Modalix SoM DevKit には WiFi が内蔵されていません。USB WiFi アダプターを使用すると WiFi を追加できます。このノートでは、2.4 GHz と 5 GHz で WiFi 6 に対応する MediaTek MT7921AU チップを搭載したアダプターを使用します。プラットフォーム 3.0 のカーネルには Linux ワイヤレススタックが含まれていますが、このチップ用のドライバーは含まれていません。そのため、ドライバーをビルドし、チップのファームウェアと一緒にインストールしてから、NetworkManager で接続します。 + +## 始める前に + +必要なもの: + +- プラットフォームバージョン **3.0** の Modalix SoM DevKit。確認するには、DevKit で `cat /etc/buildinfo` を実行します。 +- MediaTek MT7921AU チップを搭載した USB WiFi アダプター(USB ID `0e8d:7961`)。 +- パッケージをインストールするための、Ethernet 経由での DevKit のインターネット接続。 +- ドライバーをビルドするための Docker と `git` を備えた Linux ホスト、およびホストから DevKit への SSH アクセス。 + +アダプターを DevKit の USB ポートに接続し、DevKit がアダプターを検出していることを確認します。 + +```console +sima@modalix:~$ lsusb | grep 0e8d:7961 +Bus 002 Device 003: ID 0e8d:7961 MediaTek Inc. Wireless_Device +``` + +## 1. ホストでドライバーをビルドする {#build} + +SiMa.ai のカーネルソースから、DevKit 自身のカーネル設定を使用して、`mt7921u` ドライバーと、それが依存する `mt76` モジュールをビルドします。ビルドは、DevKit のカーネルと同じコンパイラーを持つ Debian コンテナー内で実行されます。 + +以下のコマンドを**ホスト上で**実行します。`` は DevKit の IP アドレスに置き換えてください。 + +1. カーネルソースと DevKit のカーネル設定を取得します。 + + ```bash + git clone --depth 1 https://github.com/SiMa-ai/simaai-linux.git + ssh sima@ 'zcat /proc/config.gz' > board.config + ``` + +2. モジュールをビルドします。 + + ```bash + docker run --rm -v "$PWD":/w -w /w/simaai-linux debian:trixie bash -c ' + apt-get update && apt-get install -y gcc-aarch64-linux-gnu make bc flex bison libssl-dev libelf-dev python3 kmod && + export ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- LOCALVERSION=-modalix && + cp ../board.config .config && + scripts/config --module MT7921U && + make olddefconfig && + make -j"$(nproc)" modules_prepare && + make -j"$(nproc)" M=drivers/net/wireless/mediatek/mt76 KBUILD_MODPOST_WARN=1 modules' + ``` + + ビルド中に未解決シンボルに関する警告が表示されます。これは想定どおりです。これらのシンボルは、DevKit にすでに存在する `cfg80211` および `mac80211` モジュールに含まれています。 + +3. ビルドで 7 つのモジュールが作成されたことを確認します。 + + ```bash + find simaai-linux/drivers/net/wireless/mediatek/mt76 -name '*.ko' + ``` + + `mt76.ko`、`mt76-usb.ko`、`mt76-connac-lib.ko`、`mt792x-lib.ko`、`mt792x-usb.ko`、`mt7921-common.ko`、`mt7921u.ko` が得られます。 + +4. これらを DevKit にコピーします。 + + ```bash + scp $(find simaai-linux/drivers/net/wireless/mediatek/mt76 -name '*.ko') sima@:/tmp/ + ``` + +## 2. DevKit にドライバーとファームウェアをインストールする {#install} + +以下のコマンドを**DevKit 上で**実行します。 + +1. モジュールをインストールし、モジュールインデックスを更新します。 + + ```console + sima@modalix:~$ sudo mkdir -p /lib/modules/$(uname -r)/updates/mt76 + sima@modalix:~$ sudo mv /tmp/mt7*.ko /lib/modules/$(uname -r)/updates/mt76/ + sima@modalix:~$ sudo depmod -a + ``` + +2. アダプターのファームウェアとワイヤレス規制データベースをインストールします。 + + ```console + sima@modalix:~$ sudo apt-get update + sima@modalix:~$ sudo apt-get install -y firmware-mediatek wireless-regdb + ``` + +3. ドライバーを読み込みます。 + + ```console + sima@modalix:~$ sudo modprobe mt7921u + ``` + + 以降は、起動時を含め、アダプターを接続するたびにドライバーが自動的に読み込まれます。 + +4. アダプターにワイヤレスインターフェースがあることを確認します。 + + ```console + sima@modalix:~$ nmcli device status + DEVICE TYPE STATE CONNECTION + end0 ethernet connected end0-dhcp + wlxe84e06afdb5e wifi disconnected -- + ``` + + インターフェース名は `wlx` で始まり、その後にアダプターの MAC アドレスが続きます。表示されない場合は、`sudo dmesg | grep mt7921u` でドライバーのメッセージを確認してください。ファームウェアが読み込まれると、メッセージにファームウェアのバージョンが表示されます。 + +## 3. WiFi ネットワークに接続する {#connect} + +DevKit で、NetworkManager のコマンドラインツールである `nmcli` を使用します。 + +1. ネットワークをスキャンします。 + + ```console + sima@modalix:~$ sudo nmcli device wifi rescan + sima@modalix:~$ nmcli device wifi list + ``` + +2. 接続します。`` と `` は、ネットワークの名前とパスワードに置き換えてください。 + + ```console + sima@modalix:~$ sudo nmcli device wifi connect "" password "" + ``` + + NetworkManager は接続を保存し、起動するたびにその接続に再接続します。 + +3. 接続を確認します。 + + ```console + sima@modalix:~$ nmcli device status + sima@modalix:~$ ip -4 -br addr show + sima@modalix:~$ ping -c 3 -I wlxe84e06afdb5e 8.8.8.8 + ``` + + `wlxe84e06afdb5e` は、お使いのインターフェース名に置き換えてください。 + +代わりにメニューからネットワークを選択するには、`sudo nmtui` を実行して **Activate a connection** を選択します。 + +DevKit が Ethernet でも接続されている場合、Ethernet 接続がデフォルトルートのままになります。NetworkManager は WiFi に低い優先度を割り当てます。 + +## 制限事項 {#limitations} + +- **ファームウェアを更新するとドライバーが削除されます。** モジュールは実行中のカーネル向けにビルドされています。DevKit のファームウェアを更新した後は、モジュールを再度ビルドしてインストールしてください。 +- **他のアダプターには専用のドライバーが必要です。** このノートは MediaTek MT7921AU を対象としています。他のチップには、別のカーネルドライバーとファームウェアが必要です。 +- **6 GHz には対応していません。** MT7921AU は 2.4 GHz と 5 GHz のみを使用します。 diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/reference/tech-notes/index.md b/i18n/ko/docusaurus-plugin-content-docs/current/reference/tech-notes/index.md index f8cefc0..04ab396 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/reference/tech-notes/index.md +++ b/i18n/ko/docusaurus-plugin-content-docs/current/reference/tech-notes/index.md @@ -13,3 +13,4 @@ sidebar_position: 1 - [2.1.3에서 3.0.0으로 변환합니다.](./convert-2-1-3-to-3-0-0.md) - [Modalix SoM DevKit에 Bluetooth를 설정합니다.](./bluetooth.mdx) - [ROS 2를 Modalix SoM DevKit에 설치합니다.](./ros2.mdx) +- [Modalix SoM DevKit에서 USB WiFi 어댑터를 사용합니다.](./wifi.mdx) diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx b/i18n/ko/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx new file mode 100644 index 0000000..064d7cd --- /dev/null +++ b/i18n/ko/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx @@ -0,0 +1,144 @@ +--- +title: "Modalix SoM DevKit에서 USB WiFi 어댑터를 사용합니다." +description: "플랫폼 3.0용 MediaTek MT7921AU 드라이버를 빌드하고 펌웨어를 설치한 다음, nmcli로 Modalix SoM DevKit를 WiFi에 연결합니다." +sidebar_position: 7 +--- + +# Modalix SoM DevKit에서 USB WiFi 어댑터를 사용합니다. + +Modalix SoM DevKit에는 WiFi가 내장되어 있지 않습니다. USB WiFi 어댑터를 사용하여 WiFi를 추가할 수 있습니다. 이 문서에서는 2.4 GHz 및 5 GHz에서 WiFi 6를 지원하는 MediaTek MT7921AU 칩이 탑재된 어댑터를 사용합니다. 플랫폼 3.0 커널에는 Linux 무선 스택이 포함되어 있지만 이 칩용 드라이버는 포함되어 있지 않습니다. 따라서 드라이버를 빌드하고, 칩의 펌웨어와 함께 설치한 다음, NetworkManager로 연결합니다. + +## 시작하기 전에 + +다음이 필요합니다: + +- 플랫폼 버전 **3.0**을 사용하는 Modalix SoM DevKit. 확인하려면 DevKit에서 `cat /etc/buildinfo`를 실행하십시오. +- MediaTek MT7921AU 칩이 탑재된 USB WiFi 어댑터(USB ID `0e8d:7961`). +- 패키지를 설치하기 위한 DevKit의 인터넷 연결(Ethernet 사용). +- 드라이버를 빌드하기 위한 Docker와 `git`이 설치된 Linux 호스트, 그리고 호스트에서 DevKit로의 SSH 접속. + +어댑터를 DevKit의 USB 포트에 연결한 다음, DevKit가 어댑터를 인식하는지 확인하십시오: + +```console +sima@modalix:~$ lsusb | grep 0e8d:7961 +Bus 002 Device 003: ID 0e8d:7961 MediaTek Inc. Wireless_Device +``` + +## 1. 호스트에서 드라이버 빌드 {#build} + +SiMa.ai 커널 소스에서 DevKit 자체의 커널 구성을 사용하여 `mt7921u` 드라이버와 이 드라이버가 의존하는 `mt76` 모듈을 빌드합니다. 빌드는 DevKit 커널과 동일한 컴파일러를 갖춘 Debian 컨테이너에서 실행됩니다. + +다음 명령을 **호스트에서** 실행하십시오. ``를 DevKit의 IP 주소로 바꾸십시오. + +1. 커널 소스와 DevKit의 커널 구성을 가져옵니다: + + ```bash + git clone --depth 1 https://github.com/SiMa-ai/simaai-linux.git + ssh sima@ 'zcat /proc/config.gz' > board.config + ``` + +2. 모듈을 빌드합니다: + + ```bash + docker run --rm -v "$PWD":/w -w /w/simaai-linux debian:trixie bash -c ' + apt-get update && apt-get install -y gcc-aarch64-linux-gnu make bc flex bison libssl-dev libelf-dev python3 kmod && + export ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- LOCALVERSION=-modalix && + cp ../board.config .config && + scripts/config --module MT7921U && + make olddefconfig && + make -j"$(nproc)" modules_prepare && + make -j"$(nproc)" M=drivers/net/wireless/mediatek/mt76 KBUILD_MODPOST_WARN=1 modules' + ``` + + 빌드 중에 확인되지 않은 심볼에 대한 경고가 출력됩니다. 이는 예상된 동작입니다. 해당 심볼은 DevKit에 이미 있는 `cfg80211` 및 `mac80211` 모듈에 포함되어 있습니다. + +3. 빌드에서 모듈 7개가 생성되었는지 확인합니다: + + ```bash + find simaai-linux/drivers/net/wireless/mediatek/mt76 -name '*.ko' + ``` + + `mt76.ko`, `mt76-usb.ko`, `mt76-connac-lib.ko`, `mt792x-lib.ko`, `mt792x-usb.ko`, `mt7921-common.ko` 및 `mt7921u.ko`가 생성됩니다. + +4. 모듈을 DevKit로 복사합니다: + + ```bash + scp $(find simaai-linux/drivers/net/wireless/mediatek/mt76 -name '*.ko') sima@:/tmp/ + ``` + +## 2. DevKit에 드라이버 및 펌웨어 설치 {#install} + +아래 명령을 **DevKit에서** 실행하십시오. + +1. 모듈을 설치하고 모듈 인덱스를 업데이트합니다: + + ```console + sima@modalix:~$ sudo mkdir -p /lib/modules/$(uname -r)/updates/mt76 + sima@modalix:~$ sudo mv /tmp/mt7*.ko /lib/modules/$(uname -r)/updates/mt76/ + sima@modalix:~$ sudo depmod -a + ``` + +2. 어댑터의 펌웨어와 무선 규제 데이터베이스를 설치합니다: + + ```console + sima@modalix:~$ sudo apt-get update + sima@modalix:~$ sudo apt-get install -y firmware-mediatek wireless-regdb + ``` + +3. 드라이버를 로드합니다: + + ```console + sima@modalix:~$ sudo modprobe mt7921u + ``` + + 이제부터는 부팅 시를 포함하여 어댑터를 연결할 때마다 드라이버가 자동으로 로드됩니다. + +4. 어댑터에 무선 인터페이스가 있는지 확인합니다: + + ```console + sima@modalix:~$ nmcli device status + DEVICE TYPE STATE CONNECTION + end0 ethernet connected end0-dhcp + wlxe84e06afdb5e wifi disconnected -- + ``` + + 인터페이스 이름은 `wlx`로 시작하고 그 뒤에 어댑터의 MAC 주소가 붙습니다. 인터페이스가 나타나지 않으면 `sudo dmesg | grep mt7921u`로 드라이버 메시지를 확인하십시오. 펌웨어가 로드되면 메시지에 펌웨어 버전이 표시됩니다. + +## 3. WiFi 네트워크에 연결 {#connect} + +DevKit에서 NetworkManager 명령줄 도구인 `nmcli`를 사용합니다. + +1. 네트워크를 검색합니다: + + ```console + sima@modalix:~$ sudo nmcli device wifi rescan + sima@modalix:~$ nmcli device wifi list + ``` + +2. 연결합니다. ``와 ``를 네트워크 이름과 비밀번호로 바꾸십시오: + + ```console + sima@modalix:~$ sudo nmcli device wifi connect "" password "" + ``` + + NetworkManager는 연결을 저장하고 부팅할 때마다 다시 연결합니다. + +3. 연결을 확인합니다: + + ```console + sima@modalix:~$ nmcli device status + sima@modalix:~$ ip -4 -br addr show + sima@modalix:~$ ping -c 3 -I wlxe84e06afdb5e 8.8.8.8 + ``` + + `wlxe84e06afdb5e`를 사용 중인 인터페이스 이름으로 바꾸십시오. + +메뉴에서 네트워크를 선택하려면 `sudo nmtui`를 실행하고 **Activate a connection**을 선택하십시오. + +DevKit가 Ethernet으로도 연결되어 있으면 Ethernet 연결이 기본 경로로 유지됩니다. NetworkManager는 WiFi에 더 낮은 우선순위를 부여합니다. + +## 제한 사항 {#limitations} + +- **펌웨어를 업데이트하면 드라이버가 제거됩니다.** 모듈은 실행 중인 커널용으로 빌드됩니다. DevKit 펌웨어를 업데이트한 후에는 모듈을 다시 빌드하고 설치하십시오. +- **다른 어댑터에는 해당 어댑터용 드라이버가 필요합니다.** 이 문서는 MediaTek MT7921AU를 다룹니다. 다른 칩에는 다른 커널 드라이버와 펌웨어가 필요합니다. +- **6 GHz는 지원되지 않습니다.** MT7921AU는 2.4 GHz와 5 GHz만 사용합니다. diff --git a/i18n/translation-sources.json b/i18n/translation-sources.json index 79fb57e..8cc6db8 100644 --- a/i18n/translation-sources.json +++ b/i18n/translation-sources.json @@ -35,7 +35,7 @@ "docs/reference/tech-notes/bluetooth.mdx": "80ff2403f1039e2b7fed2fbd054d163b117ed77aec83f2f25ec42b23d52fd0e5", "docs/reference/tech-notes/convert-2-1-3-to-3-0-0.md": "d2dde32a78466fe4624817edec089a4fbd4b980e36bb598f7ff0d2c78b488ebd", "docs/reference/tech-notes/elxr-conversion.mdx": "8ba9bbf53a10180d8751018e3ba1eb2355c4dd22a857301b5c7a307c7ea244c0", - "docs/reference/tech-notes/index.md": "dc17ec31f8f8361832b4923c2afb43129a54c7a4c075e7fbd02666e89cabe16f", + "docs/reference/tech-notes/index.md": "b01ca8ffa126192a9f880d2d277597d68bb02abd198e047b86b87e90d20ce109", "docs/reference/tech-notes/nfs.mdx": "511438098915297862f154772cfbb5a66047add1aaead45836914599b3f6e0b9", "docs/reference/tech-notes/ros2.mdx": "38411f9cc21dc8896b48ef5a0b8c3394d95820b4b1aff38d03960dc0baa9a5dc", "docs/software/build-from-source.mdx": "9c317af51ca8ee7f3a6f1241809a546dab4a99344255b22bc3ec287ae8a17a2c", @@ -44,7 +44,8 @@ "docs/software/index.md": "0685a95448457d3b5580a031a79db8de6314bbc6ee2e6cfe0e899c815d2167b4", "docs/software/release-compatibility.mdx": "e1e385742351e6ff02041e396c44a0eee3bc5fab53b948ecae5fbf0cf362d9cf", "docs/software/yocto-image.mdx": "9a70b5f9564b8ab27f217b8d803f60157c79ebf9c090895e2584a99e25ecf0bf", - "docs/tools/web-serial-console.mdx": "05830a59ca6e0b9310e39f38e02fabbba35b889315173523f2a8584b34e6cbe9" + "docs/tools/web-serial-console.mdx": "05830a59ca6e0b9310e39f38e02fabbba35b889315173523f2a8584b34e6cbe9", + "docs/reference/tech-notes/wifi.mdx": "cb4ed0b45dd304df7a72d08732946b14fe24311d5142e0f83e049a0fbefdac55" }, "ko": { "docs/deployment/factory-build-and-test.mdx": "bf776078da7368062a1a08110783928e44637f5b73baf7427ecb5751f55a9b19", @@ -82,7 +83,7 @@ "docs/reference/tech-notes/bluetooth.mdx": "80ff2403f1039e2b7fed2fbd054d163b117ed77aec83f2f25ec42b23d52fd0e5", "docs/reference/tech-notes/convert-2-1-3-to-3-0-0.md": "d2dde32a78466fe4624817edec089a4fbd4b980e36bb598f7ff0d2c78b488ebd", "docs/reference/tech-notes/elxr-conversion.mdx": "8ba9bbf53a10180d8751018e3ba1eb2355c4dd22a857301b5c7a307c7ea244c0", - "docs/reference/tech-notes/index.md": "dc17ec31f8f8361832b4923c2afb43129a54c7a4c075e7fbd02666e89cabe16f", + "docs/reference/tech-notes/index.md": "b01ca8ffa126192a9f880d2d277597d68bb02abd198e047b86b87e90d20ce109", "docs/reference/tech-notes/nfs.mdx": "511438098915297862f154772cfbb5a66047add1aaead45836914599b3f6e0b9", "docs/reference/tech-notes/ros2.mdx": "38411f9cc21dc8896b48ef5a0b8c3394d95820b4b1aff38d03960dc0baa9a5dc", "docs/software/build-from-source.mdx": "9c317af51ca8ee7f3a6f1241809a546dab4a99344255b22bc3ec287ae8a17a2c", @@ -91,7 +92,8 @@ "docs/software/index.md": "0685a95448457d3b5580a031a79db8de6314bbc6ee2e6cfe0e899c815d2167b4", "docs/software/release-compatibility.mdx": "e1e385742351e6ff02041e396c44a0eee3bc5fab53b948ecae5fbf0cf362d9cf", "docs/software/yocto-image.mdx": "9a70b5f9564b8ab27f217b8d803f60157c79ebf9c090895e2584a99e25ecf0bf", - "docs/tools/web-serial-console.mdx": "05830a59ca6e0b9310e39f38e02fabbba35b889315173523f2a8584b34e6cbe9" + "docs/tools/web-serial-console.mdx": "05830a59ca6e0b9310e39f38e02fabbba35b889315173523f2a8584b34e6cbe9", + "docs/reference/tech-notes/wifi.mdx": "cb4ed0b45dd304df7a72d08732946b14fe24311d5142e0f83e049a0fbefdac55" }, "uk": { "docs/deployment/factory-build-and-test.mdx": "bf776078da7368062a1a08110783928e44637f5b73baf7427ecb5751f55a9b19", @@ -129,7 +131,7 @@ "docs/reference/tech-notes/bluetooth.mdx": "80ff2403f1039e2b7fed2fbd054d163b117ed77aec83f2f25ec42b23d52fd0e5", "docs/reference/tech-notes/convert-2-1-3-to-3-0-0.md": "d2dde32a78466fe4624817edec089a4fbd4b980e36bb598f7ff0d2c78b488ebd", "docs/reference/tech-notes/elxr-conversion.mdx": "8ba9bbf53a10180d8751018e3ba1eb2355c4dd22a857301b5c7a307c7ea244c0", - "docs/reference/tech-notes/index.md": "dc17ec31f8f8361832b4923c2afb43129a54c7a4c075e7fbd02666e89cabe16f", + "docs/reference/tech-notes/index.md": "b01ca8ffa126192a9f880d2d277597d68bb02abd198e047b86b87e90d20ce109", "docs/reference/tech-notes/nfs.mdx": "511438098915297862f154772cfbb5a66047add1aaead45836914599b3f6e0b9", "docs/reference/tech-notes/ros2.mdx": "38411f9cc21dc8896b48ef5a0b8c3394d95820b4b1aff38d03960dc0baa9a5dc", "docs/software/build-from-source.mdx": "9c317af51ca8ee7f3a6f1241809a546dab4a99344255b22bc3ec287ae8a17a2c", @@ -138,7 +140,8 @@ "docs/software/index.md": "0685a95448457d3b5580a031a79db8de6314bbc6ee2e6cfe0e899c815d2167b4", "docs/software/release-compatibility.mdx": "e1e385742351e6ff02041e396c44a0eee3bc5fab53b948ecae5fbf0cf362d9cf", "docs/software/yocto-image.mdx": "9a70b5f9564b8ab27f217b8d803f60157c79ebf9c090895e2584a99e25ecf0bf", - "docs/tools/web-serial-console.mdx": "05830a59ca6e0b9310e39f38e02fabbba35b889315173523f2a8584b34e6cbe9" + "docs/tools/web-serial-console.mdx": "05830a59ca6e0b9310e39f38e02fabbba35b889315173523f2a8584b34e6cbe9", + "docs/reference/tech-notes/wifi.mdx": "cb4ed0b45dd304df7a72d08732946b14fe24311d5142e0f83e049a0fbefdac55" }, "zh-Hant": { "docs/deployment/factory-build-and-test.mdx": "bf776078da7368062a1a08110783928e44637f5b73baf7427ecb5751f55a9b19", @@ -176,7 +179,7 @@ "docs/reference/tech-notes/bluetooth.mdx": "80ff2403f1039e2b7fed2fbd054d163b117ed77aec83f2f25ec42b23d52fd0e5", "docs/reference/tech-notes/convert-2-1-3-to-3-0-0.md": "d2dde32a78466fe4624817edec089a4fbd4b980e36bb598f7ff0d2c78b488ebd", "docs/reference/tech-notes/elxr-conversion.mdx": "8ba9bbf53a10180d8751018e3ba1eb2355c4dd22a857301b5c7a307c7ea244c0", - "docs/reference/tech-notes/index.md": "dc17ec31f8f8361832b4923c2afb43129a54c7a4c075e7fbd02666e89cabe16f", + "docs/reference/tech-notes/index.md": "b01ca8ffa126192a9f880d2d277597d68bb02abd198e047b86b87e90d20ce109", "docs/reference/tech-notes/nfs.mdx": "511438098915297862f154772cfbb5a66047add1aaead45836914599b3f6e0b9", "docs/reference/tech-notes/ros2.mdx": "38411f9cc21dc8896b48ef5a0b8c3394d95820b4b1aff38d03960dc0baa9a5dc", "docs/software/build-from-source.mdx": "9c317af51ca8ee7f3a6f1241809a546dab4a99344255b22bc3ec287ae8a17a2c", @@ -185,6 +188,7 @@ "docs/software/index.md": "0685a95448457d3b5580a031a79db8de6314bbc6ee2e6cfe0e899c815d2167b4", "docs/software/release-compatibility.mdx": "e1e385742351e6ff02041e396c44a0eee3bc5fab53b948ecae5fbf0cf362d9cf", "docs/software/yocto-image.mdx": "9a70b5f9564b8ab27f217b8d803f60157c79ebf9c090895e2584a99e25ecf0bf", - "docs/tools/web-serial-console.mdx": "05830a59ca6e0b9310e39f38e02fabbba35b889315173523f2a8584b34e6cbe9" + "docs/tools/web-serial-console.mdx": "05830a59ca6e0b9310e39f38e02fabbba35b889315173523f2a8584b34e6cbe9", + "docs/reference/tech-notes/wifi.mdx": "cb4ed0b45dd304df7a72d08732946b14fe24311d5142e0f83e049a0fbefdac55" } } diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/reference/tech-notes/index.md b/i18n/uk/docusaurus-plugin-content-docs/current/reference/tech-notes/index.md index 796d92f..6008363 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/reference/tech-notes/index.md +++ b/i18n/uk/docusaurus-plugin-content-docs/current/reference/tech-notes/index.md @@ -13,3 +13,4 @@ sidebar_position: 1 - [Оновіть з версії 2.1.3 до 3.0.0.](./convert-2-1-3-to-3-0-0.md) - [Налаштуйте Bluetooth на Modalix SoM DevKit.](./bluetooth.mdx) - [Встановіть ROS 2 на Modalix SoM DevKit.](./ros2.mdx) +- [Використовуйте USB-адаптер WiFi на Modalix SoM DevKit](./wifi.mdx) diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx b/i18n/uk/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx new file mode 100644 index 0000000..86f505a --- /dev/null +++ b/i18n/uk/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx @@ -0,0 +1,144 @@ +--- +title: "Використовуйте USB-адаптер WiFi на Modalix SoM DevKit" +description: "Зберіть драйвер MediaTek MT7921AU для платформи 3.0, встановіть його мікропрограму та підключіть Modalix SoM DevKit до WiFi за допомогою nmcli." +sidebar_position: 7 +--- + +# Використовуйте USB-адаптер WiFi на Modalix SoM DevKit + +Modalix SoM DevKit не має вбудованого WiFi. Його можна додати за допомогою USB-адаптера WiFi. У цій примітці використано адаптер із чипом MediaTek MT7921AU, який підтримує WiFi 6 у діапазонах 2,4 ГГц і 5 ГГц. Ядро платформи 3.0 містить бездротовий стек Linux, але не містить драйвера для цього чипа, тому ви збираєте драйвер, встановлюєте його разом із мікропрограмою чипа, а потім підключаєтеся за допомогою NetworkManager. + +## Перш ніж почати + +Вам знадобиться: + +- Modalix SoM DevKit з версією платформи **3.0**. Щоб перевірити її, виконайте на DevKit команду `cat /etc/buildinfo`. +- USB-адаптер WiFi із чипом MediaTek MT7921AU (USB ID `0e8d:7961`). +- Доступ до Інтернету на DevKit через Ethernet для встановлення пакетів. +- Хост Linux із Docker і `git` для збирання драйвера, а також доступ SSH із хоста до DevKit. + +Під’єднайте адаптер до USB-порту DevKit, а потім переконайтеся, що DevKit його виявив: + +```console +sima@modalix:~$ lsusb | grep 0e8d:7961 +Bus 002 Device 003: ID 0e8d:7961 MediaTek Inc. Wireless_Device +``` + +## 1. Зберіть драйвер на хості {#build} + +Зберіть драйвер `mt7921u` і модулі `mt76`, від яких він залежить, із вихідного коду ядра SiMa.ai з власною конфігурацією ядра DevKit. Збирання виконується в контейнері Debian, що має той самий компілятор, що й ядро DevKit. + +Виконайте ці команди **на хості**. Замініть `` на IP-адресу DevKit. + +1. Отримайте вихідний код ядра та конфігурацію ядра DevKit: + + ```bash + git clone --depth 1 https://github.com/SiMa-ai/simaai-linux.git + ssh sima@ 'zcat /proc/config.gz' > board.config + ``` + +2. Зберіть модулі: + + ```bash + docker run --rm -v "$PWD":/w -w /w/simaai-linux debian:trixie bash -c ' + apt-get update && apt-get install -y gcc-aarch64-linux-gnu make bc flex bison libssl-dev libelf-dev python3 kmod && + export ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- LOCALVERSION=-modalix && + cp ../board.config .config && + scripts/config --module MT7921U && + make olddefconfig && + make -j"$(nproc)" modules_prepare && + make -j"$(nproc)" M=drivers/net/wireless/mediatek/mt76 KBUILD_MODPOST_WARN=1 modules' + ``` + + Під час збирання виводяться попередження про нерозв’язані символи. Це очікувано: ці символи містяться в модулях `cfg80211` і `mac80211`, які вже є на DevKit. + +3. Переконайтеся, що збирання створило сім модулів: + + ```bash + find simaai-linux/drivers/net/wireless/mediatek/mt76 -name '*.ko' + ``` + + Ви отримаєте `mt76.ko`, `mt76-usb.ko`, `mt76-connac-lib.ko`, `mt792x-lib.ko`, `mt792x-usb.ko`, `mt7921-common.ko` і `mt7921u.ko`. + +4. Скопіюйте їх на DevKit: + + ```bash + scp $(find simaai-linux/drivers/net/wireless/mediatek/mt76 -name '*.ko') sima@:/tmp/ + ``` + +## 2. Встановіть драйвер і мікропрограму на DevKit {#install} + +Виконайте наведені нижче команди **на DevKit**. + +1. Встановіть модулі та оновіть індекс модулів: + + ```console + sima@modalix:~$ sudo mkdir -p /lib/modules/$(uname -r)/updates/mt76 + sima@modalix:~$ sudo mv /tmp/mt7*.ko /lib/modules/$(uname -r)/updates/mt76/ + sima@modalix:~$ sudo depmod -a + ``` + +2. Встановіть мікропрограму адаптера та базу даних регуляторних правил бездротового зв’язку: + + ```console + sima@modalix:~$ sudo apt-get update + sima@modalix:~$ sudo apt-get install -y firmware-mediatek wireless-regdb + ``` + +3. Завантажте драйвер: + + ```console + sima@modalix:~$ sudo modprobe mt7921u + ``` + + Відтепер драйвер завантажується автоматично щоразу, коли адаптер під’єднано, зокрема під час завантаження системи. + +4. Переконайтеся, що адаптер має бездротовий інтерфейс: + + ```console + sima@modalix:~$ nmcli device status + DEVICE TYPE STATE CONNECTION + end0 ethernet connected end0-dhcp + wlxe84e06afdb5e wifi disconnected -- + ``` + + Назва інтерфейсу починається з `wlx`, після чого йде MAC-адреса адаптера. Якщо інтерфейс не з’являється, перегляньте повідомлення драйвера за допомогою `sudo dmesg | grep mt7921u`. Коли мікропрограма завантажується, вони показують її версію. + +## 3. Підключіться до мережі WiFi {#connect} + +Використовуйте на DevKit `nmcli` — інструмент командного рядка NetworkManager. + +1. Виконайте пошук мереж: + + ```console + sima@modalix:~$ sudo nmcli device wifi rescan + sima@modalix:~$ nmcli device wifi list + ``` + +2. Підключіться. Замініть `` і `` на назву та пароль мережі: + + ```console + sima@modalix:~$ sudo nmcli device wifi connect "" password "" + ``` + + NetworkManager зберігає з’єднання та повторно підключається до нього під час кожного завантаження. + +3. Перевірте з’єднання: + + ```console + sima@modalix:~$ nmcli device status + sima@modalix:~$ ip -4 -br addr show + sima@modalix:~$ ping -c 3 -I wlxe84e06afdb5e 8.8.8.8 + ``` + + Замініть `wlxe84e06afdb5e` на назву вашого інтерфейсу. + +Щоб натомість вибрати мережу з меню, виконайте `sudo nmtui` і виберіть **Activate a connection**. + +Якщо DevKit також підключено через Ethernet, з’єднання Ethernet залишається маршрутом за замовчуванням. NetworkManager надає WiFi нижчий пріоритет. + +## Обмеження {#limitations} + +- **Оновлення мікропрограми видаляють драйвер.** Модулі зібрано для поточного ядра. Після оновлення мікропрограми DevKit зберіть і встановіть їх знову. +- **Іншим адаптерам потрібен власний драйвер.** Ця примітка стосується MediaTek MT7921AU. Іншим чипам потрібні інший драйвер ядра та інша мікропрограма. +- **Без 6 ГГц.** MT7921AU використовує лише діапазони 2,4 ГГц і 5 ГГц. diff --git a/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/tech-notes/index.md b/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/tech-notes/index.md index aa63f39..1793f5a 100644 --- a/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/tech-notes/index.md +++ b/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/tech-notes/index.md @@ -13,3 +13,4 @@ sidebar_position: 1 - [從 2.1.3 升級到 3.0.0](./convert-2-1-3-to-3-0-0.md) - [在 Modalix SoM DevKit 上設定 Bluetooth。](./bluetooth.mdx) - [在 Modalix SoM DevKit 上安裝 ROS 2。](./ros2.mdx) +- [在 Modalix SoM DevKit 上使用 USB WiFi 轉接器。](./wifi.mdx) diff --git a/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx b/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx new file mode 100644 index 0000000..d72b6b3 --- /dev/null +++ b/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx @@ -0,0 +1,144 @@ +--- +title: "在 Modalix SoM DevKit 上使用 USB WiFi 轉接器" +description: "為平台 3.0 建置 MediaTek MT7921AU 驅動程式、安裝其韌體,並使用 nmcli 將 Modalix SoM DevKit 連線到 WiFi。" +sidebar_position: 7 +--- + +# 在 Modalix SoM DevKit 上使用 USB WiFi 轉接器 + +Modalix SoM DevKit 沒有內建 WiFi,您可以使用 USB WiFi 轉接器來新增此功能。本備註使用搭載 MediaTek MT7921AU 晶片的轉接器,此晶片支援 2.4 GHz 和 5 GHz 的 WiFi 6。平台 3.0 的核心包含 Linux 無線堆疊,但不包含此晶片的驅動程式,因此您需要建置驅動程式、將它與晶片的韌體一起安裝,然後透過 NetworkManager 連線。 + +## 在您開始之前 + +您需要: + +- 一個平台版本為 **3.0** 的 Modalix SoM DevKit。若要確認版本,請在 DevKit 上執行 `cat /etc/buildinfo`。 +- 一個搭載 MediaTek MT7921AU 晶片的 USB WiFi 轉接器(USB ID `0e8d:7961`)。 +- DevKit 需透過乙太網路連上網際網路,以便安裝套件。 +- 一台安裝了 Docker 和 `git` 的 Linux 主機,用來建置驅動程式,且主機能透過 SSH 存取 DevKit。 + +將轉接器插入 DevKit 的 USB 連接埠,然後確認 DevKit 已偵測到它: + +```console +sima@modalix:~$ lsusb | grep 0e8d:7961 +Bus 002 Device 003: ID 0e8d:7961 MediaTek Inc. Wireless_Device +``` + +## 1. 在主機上建置驅動程式 {#build} + +使用 DevKit 本身的核心設定,從 SiMa.ai 核心原始碼建置 `mt7921u` 驅動程式及其相依的 `mt76` 模組。建置會在 Debian 容器中執行,該容器使用與 DevKit 核心相同的編譯器。 + +請**在主機上**執行這些指令。將 `` 替換為 DevKit 的 IP 位址。 + +1. 取得核心原始碼,以及 DevKit 的核心設定: + + ```bash + git clone --depth 1 https://github.com/SiMa-ai/simaai-linux.git + ssh sima@ 'zcat /proc/config.gz' > board.config + ``` + +2. 建置模組: + + ```bash + docker run --rm -v "$PWD":/w -w /w/simaai-linux debian:trixie bash -c ' + apt-get update && apt-get install -y gcc-aarch64-linux-gnu make bc flex bison libssl-dev libelf-dev python3 kmod && + export ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- LOCALVERSION=-modalix && + cp ../board.config .config && + scripts/config --module MT7921U && + make olddefconfig && + make -j"$(nproc)" modules_prepare && + make -j"$(nproc)" M=drivers/net/wireless/mediatek/mt76 KBUILD_MODPOST_WARN=1 modules' + ``` + + 建置過程會顯示未解析符號的警告。這是預期中的情況:這些符號位於 DevKit 上已有的 `cfg80211` 和 `mac80211` 模組中。 + +3. 確認建置產生了七個模組: + + ```bash + find simaai-linux/drivers/net/wireless/mediatek/mt76 -name '*.ko' + ``` + + 您會得到 `mt76.ko`、`mt76-usb.ko`、`mt76-connac-lib.ko`、`mt792x-lib.ko`、`mt792x-usb.ko`、`mt7921-common.ko` 和 `mt7921u.ko`。 + +4. 將它們複製到 DevKit: + + ```bash + scp $(find simaai-linux/drivers/net/wireless/mediatek/mt76 -name '*.ko') sima@:/tmp/ + ``` + +## 2. 在 DevKit 上安裝驅動程式和韌體 {#install} + +請**在 DevKit 上**執行以下指令。 + +1. 安裝模組,並更新模組索引: + + ```console + sima@modalix:~$ sudo mkdir -p /lib/modules/$(uname -r)/updates/mt76 + sima@modalix:~$ sudo mv /tmp/mt7*.ko /lib/modules/$(uname -r)/updates/mt76/ + sima@modalix:~$ sudo depmod -a + ``` + +2. 安裝轉接器的韌體和無線法規資料庫: + + ```console + sima@modalix:~$ sudo apt-get update + sima@modalix:~$ sudo apt-get install -y firmware-mediatek wireless-regdb + ``` + +3. 載入驅動程式: + + ```console + sima@modalix:~$ sudo modprobe mt7921u + ``` + + 從現在起,只要插入轉接器(包括開機時),驅動程式就會自動載入。 + +4. 確認轉接器已有無線介面: + + ```console + sima@modalix:~$ nmcli device status + DEVICE TYPE STATE CONNECTION + end0 ethernet connected end0-dhcp + wlxe84e06afdb5e wifi disconnected -- + ``` + + 介面名稱以 `wlx` 開頭,後面接著轉接器的 MAC 位址。如果介面沒有出現,請使用 `sudo dmesg | grep mt7921u` 查看驅動程式訊息。韌體載入時,這些訊息會顯示韌體版本。 + +## 3. 連線到 WiFi 網路 {#connect} + +在 DevKit 上使用 NetworkManager 的命令列工具 `nmcli`。 + +1. 掃描網路: + + ```console + sima@modalix:~$ sudo nmcli device wifi rescan + sima@modalix:~$ nmcli device wifi list + ``` + +2. 連線。將 `` 和 `` 替換為網路的名稱和密碼: + + ```console + sima@modalix:~$ sudo nmcli device wifi connect "" password "" + ``` + + NetworkManager 會儲存此連線,並在每次開機時重新連線。 + +3. 檢查連線: + + ```console + sima@modalix:~$ nmcli device status + sima@modalix:~$ ip -4 -br addr show + sima@modalix:~$ ping -c 3 -I wlxe84e06afdb5e 8.8.8.8 + ``` + + 將 `wlxe84e06afdb5e` 替換為您的介面名稱。 + +若要改從選單中選擇網路,請執行 `sudo nmtui` 並選擇 **Activate a connection**。 + +如果 DevKit 同時透過乙太網路連線,乙太網路連線仍會是預設路由。NetworkManager 會給予 WiFi 較低的優先順序。 + +## 限制 {#limitations} + +- **韌體更新會移除驅動程式。** 這些模組是針對目前執行的核心所建置。更新 DevKit 韌體後,請重新建置並安裝它們。 +- **其他轉接器需要各自的驅動程式。** 本備註涵蓋 MediaTek MT7921AU。其他晶片需要不同的核心驅動程式和韌體。 +- **不支援 6 GHz。** MT7921AU 僅使用 2.4 GHz 和 5 GHz。 diff --git a/sidebars.js b/sidebars.js index b990c21..d5b409a 100644 --- a/sidebars.js +++ b/sidebars.js @@ -88,6 +88,7 @@ const sidebars = { 'reference/tech-notes/convert-2-1-3-to-3-0-0', 'reference/tech-notes/nfs', 'reference/tech-notes/ros2', + 'reference/tech-notes/wifi', ]), ]), ], From 7a0589a04ea18f5a1c4032211ad7880f5eba8119 Mon Sep 17 00:00:00 2001 From: Timothy Do Date: Thu, 5 Nov 2026 13:20:10 -0800 Subject: [PATCH 2/2] =?UTF-8?q?doc#157=20=E2=80=94=20Link=20the=20BrosTren?= =?UTF-8?q?d=20AXE3000=20as=20an=20example=20adapter,=20and=20fix=20the=20?= =?UTF-8?q?bands?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- docs/reference/tech-notes/wifi.mdx | 6 +++--- .../current/reference/tech-notes/wifi.mdx | 6 +++--- .../current/reference/tech-notes/wifi.mdx | 6 +++--- i18n/translation-sources.json | 8 ++++---- .../current/reference/tech-notes/wifi.mdx | 6 +++--- .../current/reference/tech-notes/wifi.mdx | 6 +++--- 6 files changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/reference/tech-notes/wifi.mdx b/docs/reference/tech-notes/wifi.mdx index ef7fa7c..14ad601 100644 --- a/docs/reference/tech-notes/wifi.mdx +++ b/docs/reference/tech-notes/wifi.mdx @@ -6,14 +6,14 @@ sidebar_position: 7 # Use a USB WiFi Adapter on the Modalix SoM DevKit -The Modalix SoM DevKit has no built-in WiFi. You can add it with a USB WiFi adapter. This note uses an adapter with the MediaTek MT7921AU chip, which supports WiFi 6 on 2.4 GHz and 5 GHz. The platform 3.0 kernel includes the Linux wireless stack, but not the driver for this chip, so you build the driver, install it with the chip's firmware, and then connect with NetworkManager. +The Modalix SoM DevKit has no built-in WiFi. You can add it with a USB WiFi adapter. This note uses an adapter with the MediaTek MT7921AU chip, which supports WiFi 6E on 2.4 GHz, 5 GHz, and 6 GHz. The platform 3.0 kernel includes the Linux wireless stack, but not the driver for this chip, so you build the driver, install it with the chip's firmware, and then connect with NetworkManager. ## Before You Start You need: - A Modalix SoM DevKit with platform version **3.0**. To check, run `cat /etc/buildinfo` on the DevKit. -- A USB WiFi adapter with the MediaTek MT7921AU chip (USB ID `0e8d:7961`). +- A USB WiFi adapter with the MediaTek MT7921AU chip (USB ID `0e8d:7961`), for example the [BrosTrend AXE3000](https://www.amazon.com/dp/B0F6MY7H62). Other MT7921AU adapters work the same way. - Internet access on the DevKit, through Ethernet, to install packages. - A Linux host with Docker and `git`, to build the driver, and SSH access from the host to the DevKit. @@ -141,4 +141,4 @@ If the DevKit is also connected through Ethernet, the Ethernet connection stays - **Firmware updates remove the driver.** The modules are built for the running kernel. After you update the DevKit firmware, build and install them again. - **Other adapters need their own driver.** This note covers the MediaTek MT7921AU. Other chips need a different kernel driver and firmware. -- **No 6 GHz.** The MT7921AU uses 2.4 GHz and 5 GHz only. +- **6 GHz is not tested.** The adapter supports 6 GHz, but this note was tested on 2.4 GHz and 5 GHz only. Whether you can use 6 GHz also depends on your country's rules. diff --git a/i18n/ja/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx b/i18n/ja/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx index 4ae0aaf..786f209 100644 --- a/i18n/ja/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx +++ b/i18n/ja/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx @@ -6,14 +6,14 @@ sidebar_position: 7 # Modalix SoM DevKit で USB WiFi アダプターを使用する -Modalix SoM DevKit には WiFi が内蔵されていません。USB WiFi アダプターを使用すると WiFi を追加できます。このノートでは、2.4 GHz と 5 GHz で WiFi 6 に対応する MediaTek MT7921AU チップを搭載したアダプターを使用します。プラットフォーム 3.0 のカーネルには Linux ワイヤレススタックが含まれていますが、このチップ用のドライバーは含まれていません。そのため、ドライバーをビルドし、チップのファームウェアと一緒にインストールしてから、NetworkManager で接続します。 +Modalix SoM DevKit には WiFi が内蔵されていません。USB WiFi アダプターを使用すると WiFi を追加できます。このノートでは、2.4 GHz、5 GHz、6 GHz で WiFi 6E に対応する MediaTek MT7921AU チップを搭載したアダプターを使用します。プラットフォーム 3.0 のカーネルには Linux ワイヤレススタックが含まれていますが、このチップ用のドライバーは含まれていません。そのため、ドライバーをビルドし、チップのファームウェアと一緒にインストールしてから、NetworkManager で接続します。 ## 始める前に 必要なもの: - プラットフォームバージョン **3.0** の Modalix SoM DevKit。確認するには、DevKit で `cat /etc/buildinfo` を実行します。 -- MediaTek MT7921AU チップを搭載した USB WiFi アダプター(USB ID `0e8d:7961`)。 +- MediaTek MT7921AU チップを搭載した USB WiFi アダプター(USB ID `0e8d:7961`)。たとえば [BrosTrend AXE3000](https://www.amazon.com/dp/B0F6MY7H62) です。ほかの MT7921AU アダプターも同じ手順で使用できます。 - パッケージをインストールするための、Ethernet 経由での DevKit のインターネット接続。 - ドライバーをビルドするための Docker と `git` を備えた Linux ホスト、およびホストから DevKit への SSH アクセス。 @@ -141,4 +141,4 @@ DevKit が Ethernet でも接続されている場合、Ethernet 接続がデフ - **ファームウェアを更新するとドライバーが削除されます。** モジュールは実行中のカーネル向けにビルドされています。DevKit のファームウェアを更新した後は、モジュールを再度ビルドしてインストールしてください。 - **他のアダプターには専用のドライバーが必要です。** このノートは MediaTek MT7921AU を対象としています。他のチップには、別のカーネルドライバーとファームウェアが必要です。 -- **6 GHz には対応していません。** MT7921AU は 2.4 GHz と 5 GHz のみを使用します。 +- **6 GHz はテストしていません。** アダプターは 6 GHz に対応していますが、このノートは 2.4 GHz と 5 GHz でのみテストしています。6 GHz を使用できるかどうかは、お住まいの国の規制にもよります。 diff --git a/i18n/ko/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx b/i18n/ko/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx index 064d7cd..165a332 100644 --- a/i18n/ko/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx +++ b/i18n/ko/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx @@ -6,14 +6,14 @@ sidebar_position: 7 # Modalix SoM DevKit에서 USB WiFi 어댑터를 사용합니다. -Modalix SoM DevKit에는 WiFi가 내장되어 있지 않습니다. USB WiFi 어댑터를 사용하여 WiFi를 추가할 수 있습니다. 이 문서에서는 2.4 GHz 및 5 GHz에서 WiFi 6를 지원하는 MediaTek MT7921AU 칩이 탑재된 어댑터를 사용합니다. 플랫폼 3.0 커널에는 Linux 무선 스택이 포함되어 있지만 이 칩용 드라이버는 포함되어 있지 않습니다. 따라서 드라이버를 빌드하고, 칩의 펌웨어와 함께 설치한 다음, NetworkManager로 연결합니다. +Modalix SoM DevKit에는 WiFi가 내장되어 있지 않습니다. USB WiFi 어댑터를 사용하여 WiFi를 추가할 수 있습니다. 이 문서에서는 2.4 GHz, 5 GHz 및 6 GHz에서 WiFi 6E를 지원하는 MediaTek MT7921AU 칩이 탑재된 어댑터를 사용합니다. 플랫폼 3.0 커널에는 Linux 무선 스택이 포함되어 있지만 이 칩용 드라이버는 포함되어 있지 않습니다. 따라서 드라이버를 빌드하고, 칩의 펌웨어와 함께 설치한 다음, NetworkManager로 연결합니다. ## 시작하기 전에 다음이 필요합니다: - 플랫폼 버전 **3.0**을 사용하는 Modalix SoM DevKit. 확인하려면 DevKit에서 `cat /etc/buildinfo`를 실행하십시오. -- MediaTek MT7921AU 칩이 탑재된 USB WiFi 어댑터(USB ID `0e8d:7961`). +- MediaTek MT7921AU 칩이 탑재된 USB WiFi 어댑터(USB ID `0e8d:7961`). 예: [BrosTrend AXE3000](https://www.amazon.com/dp/B0F6MY7H62). 다른 MT7921AU 어댑터도 같은 방법으로 사용할 수 있습니다. - 패키지를 설치하기 위한 DevKit의 인터넷 연결(Ethernet 사용). - 드라이버를 빌드하기 위한 Docker와 `git`이 설치된 Linux 호스트, 그리고 호스트에서 DevKit로의 SSH 접속. @@ -141,4 +141,4 @@ DevKit가 Ethernet으로도 연결되어 있으면 Ethernet 연결이 기본 경 - **펌웨어를 업데이트하면 드라이버가 제거됩니다.** 모듈은 실행 중인 커널용으로 빌드됩니다. DevKit 펌웨어를 업데이트한 후에는 모듈을 다시 빌드하고 설치하십시오. - **다른 어댑터에는 해당 어댑터용 드라이버가 필요합니다.** 이 문서는 MediaTek MT7921AU를 다룹니다. 다른 칩에는 다른 커널 드라이버와 펌웨어가 필요합니다. -- **6 GHz는 지원되지 않습니다.** MT7921AU는 2.4 GHz와 5 GHz만 사용합니다. +- **6 GHz는 테스트하지 않았습니다.** 어댑터는 6 GHz를 지원하지만, 이 문서는 2.4 GHz와 5 GHz에서만 테스트했습니다. 6 GHz 사용 가능 여부는 국가별 규정에 따라서도 달라집니다. diff --git a/i18n/translation-sources.json b/i18n/translation-sources.json index 8cc6db8..d1a285c 100644 --- a/i18n/translation-sources.json +++ b/i18n/translation-sources.json @@ -45,7 +45,7 @@ "docs/software/release-compatibility.mdx": "e1e385742351e6ff02041e396c44a0eee3bc5fab53b948ecae5fbf0cf362d9cf", "docs/software/yocto-image.mdx": "9a70b5f9564b8ab27f217b8d803f60157c79ebf9c090895e2584a99e25ecf0bf", "docs/tools/web-serial-console.mdx": "05830a59ca6e0b9310e39f38e02fabbba35b889315173523f2a8584b34e6cbe9", - "docs/reference/tech-notes/wifi.mdx": "cb4ed0b45dd304df7a72d08732946b14fe24311d5142e0f83e049a0fbefdac55" + "docs/reference/tech-notes/wifi.mdx": "05ba0ee361552a43ed399b8a68a136fc9a8ddd63396bf8e735f8206768b93f39" }, "ko": { "docs/deployment/factory-build-and-test.mdx": "bf776078da7368062a1a08110783928e44637f5b73baf7427ecb5751f55a9b19", @@ -93,7 +93,7 @@ "docs/software/release-compatibility.mdx": "e1e385742351e6ff02041e396c44a0eee3bc5fab53b948ecae5fbf0cf362d9cf", "docs/software/yocto-image.mdx": "9a70b5f9564b8ab27f217b8d803f60157c79ebf9c090895e2584a99e25ecf0bf", "docs/tools/web-serial-console.mdx": "05830a59ca6e0b9310e39f38e02fabbba35b889315173523f2a8584b34e6cbe9", - "docs/reference/tech-notes/wifi.mdx": "cb4ed0b45dd304df7a72d08732946b14fe24311d5142e0f83e049a0fbefdac55" + "docs/reference/tech-notes/wifi.mdx": "05ba0ee361552a43ed399b8a68a136fc9a8ddd63396bf8e735f8206768b93f39" }, "uk": { "docs/deployment/factory-build-and-test.mdx": "bf776078da7368062a1a08110783928e44637f5b73baf7427ecb5751f55a9b19", @@ -141,7 +141,7 @@ "docs/software/release-compatibility.mdx": "e1e385742351e6ff02041e396c44a0eee3bc5fab53b948ecae5fbf0cf362d9cf", "docs/software/yocto-image.mdx": "9a70b5f9564b8ab27f217b8d803f60157c79ebf9c090895e2584a99e25ecf0bf", "docs/tools/web-serial-console.mdx": "05830a59ca6e0b9310e39f38e02fabbba35b889315173523f2a8584b34e6cbe9", - "docs/reference/tech-notes/wifi.mdx": "cb4ed0b45dd304df7a72d08732946b14fe24311d5142e0f83e049a0fbefdac55" + "docs/reference/tech-notes/wifi.mdx": "05ba0ee361552a43ed399b8a68a136fc9a8ddd63396bf8e735f8206768b93f39" }, "zh-Hant": { "docs/deployment/factory-build-and-test.mdx": "bf776078da7368062a1a08110783928e44637f5b73baf7427ecb5751f55a9b19", @@ -189,6 +189,6 @@ "docs/software/release-compatibility.mdx": "e1e385742351e6ff02041e396c44a0eee3bc5fab53b948ecae5fbf0cf362d9cf", "docs/software/yocto-image.mdx": "9a70b5f9564b8ab27f217b8d803f60157c79ebf9c090895e2584a99e25ecf0bf", "docs/tools/web-serial-console.mdx": "05830a59ca6e0b9310e39f38e02fabbba35b889315173523f2a8584b34e6cbe9", - "docs/reference/tech-notes/wifi.mdx": "cb4ed0b45dd304df7a72d08732946b14fe24311d5142e0f83e049a0fbefdac55" + "docs/reference/tech-notes/wifi.mdx": "05ba0ee361552a43ed399b8a68a136fc9a8ddd63396bf8e735f8206768b93f39" } } diff --git a/i18n/uk/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx b/i18n/uk/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx index 86f505a..505779b 100644 --- a/i18n/uk/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx +++ b/i18n/uk/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx @@ -6,14 +6,14 @@ sidebar_position: 7 # Використовуйте USB-адаптер WiFi на Modalix SoM DevKit -Modalix SoM DevKit не має вбудованого WiFi. Його можна додати за допомогою USB-адаптера WiFi. У цій примітці використано адаптер із чипом MediaTek MT7921AU, який підтримує WiFi 6 у діапазонах 2,4 ГГц і 5 ГГц. Ядро платформи 3.0 містить бездротовий стек Linux, але не містить драйвера для цього чипа, тому ви збираєте драйвер, встановлюєте його разом із мікропрограмою чипа, а потім підключаєтеся за допомогою NetworkManager. +Modalix SoM DevKit не має вбудованого WiFi. Його можна додати за допомогою USB-адаптера WiFi. У цій примітці використано адаптер із чипом MediaTek MT7921AU, який підтримує WiFi 6E у діапазонах 2,4 ГГц, 5 ГГц і 6 ГГц. Ядро платформи 3.0 містить бездротовий стек Linux, але не містить драйвера для цього чипа, тому ви збираєте драйвер, встановлюєте його разом із мікропрограмою чипа, а потім підключаєтеся за допомогою NetworkManager. ## Перш ніж почати Вам знадобиться: - Modalix SoM DevKit з версією платформи **3.0**. Щоб перевірити її, виконайте на DevKit команду `cat /etc/buildinfo`. -- USB-адаптер WiFi із чипом MediaTek MT7921AU (USB ID `0e8d:7961`). +- USB-адаптер WiFi із чипом MediaTek MT7921AU (USB ID `0e8d:7961`), наприклад [BrosTrend AXE3000](https://www.amazon.com/dp/B0F6MY7H62). Інші адаптери MT7921AU працюють так само. - Доступ до Інтернету на DevKit через Ethernet для встановлення пакетів. - Хост Linux із Docker і `git` для збирання драйвера, а також доступ SSH із хоста до DevKit. @@ -141,4 +141,4 @@ Bus 002 Device 003: ID 0e8d:7961 MediaTek Inc. Wireless_Device - **Оновлення мікропрограми видаляють драйвер.** Модулі зібрано для поточного ядра. Після оновлення мікропрограми DevKit зберіть і встановіть їх знову. - **Іншим адаптерам потрібен власний драйвер.** Ця примітка стосується MediaTek MT7921AU. Іншим чипам потрібні інший драйвер ядра та інша мікропрограма. -- **Без 6 ГГц.** MT7921AU використовує лише діапазони 2,4 ГГц і 5 ГГц. +- **6 ГГц не перевірено.** Адаптер підтримує 6 ГГц, але цю примітку перевірено лише в діапазонах 2,4 ГГц і 5 ГГц. Чи можна використовувати 6 ГГц, залежить також від правил вашої країни. diff --git a/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx b/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx index d72b6b3..4b7c8e3 100644 --- a/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx +++ b/i18n/zh-Hant/docusaurus-plugin-content-docs/current/reference/tech-notes/wifi.mdx @@ -6,14 +6,14 @@ sidebar_position: 7 # 在 Modalix SoM DevKit 上使用 USB WiFi 轉接器 -Modalix SoM DevKit 沒有內建 WiFi,您可以使用 USB WiFi 轉接器來新增此功能。本備註使用搭載 MediaTek MT7921AU 晶片的轉接器,此晶片支援 2.4 GHz 和 5 GHz 的 WiFi 6。平台 3.0 的核心包含 Linux 無線堆疊,但不包含此晶片的驅動程式,因此您需要建置驅動程式、將它與晶片的韌體一起安裝,然後透過 NetworkManager 連線。 +Modalix SoM DevKit 沒有內建 WiFi,您可以使用 USB WiFi 轉接器來新增此功能。本備註使用搭載 MediaTek MT7921AU 晶片的轉接器,此晶片支援 2.4 GHz、5 GHz 和 6 GHz 的 WiFi 6E。平台 3.0 的核心包含 Linux 無線堆疊,但不包含此晶片的驅動程式,因此您需要建置驅動程式、將它與晶片的韌體一起安裝,然後透過 NetworkManager 連線。 ## 在您開始之前 您需要: - 一個平台版本為 **3.0** 的 Modalix SoM DevKit。若要確認版本,請在 DevKit 上執行 `cat /etc/buildinfo`。 -- 一個搭載 MediaTek MT7921AU 晶片的 USB WiFi 轉接器(USB ID `0e8d:7961`)。 +- 一個搭載 MediaTek MT7921AU 晶片的 USB WiFi 轉接器(USB ID `0e8d:7961`),例如 [BrosTrend AXE3000](https://www.amazon.com/dp/B0F6MY7H62)。其他 MT7921AU 轉接器的使用方式相同。 - DevKit 需透過乙太網路連上網際網路,以便安裝套件。 - 一台安裝了 Docker 和 `git` 的 Linux 主機,用來建置驅動程式,且主機能透過 SSH 存取 DevKit。 @@ -141,4 +141,4 @@ Bus 002 Device 003: ID 0e8d:7961 MediaTek Inc. Wireless_Device - **韌體更新會移除驅動程式。** 這些模組是針對目前執行的核心所建置。更新 DevKit 韌體後,請重新建置並安裝它們。 - **其他轉接器需要各自的驅動程式。** 本備註涵蓋 MediaTek MT7921AU。其他晶片需要不同的核心驅動程式和韌體。 -- **不支援 6 GHz。** MT7921AU 僅使用 2.4 GHz 和 5 GHz。 +- **未測試 6 GHz。** 轉接器支援 6 GHz,但本備註僅在 2.4 GHz 和 5 GHz 上測試過。能否使用 6 GHz 也取決於您所在國家/地區的法規。