雙頻 Wi-Fi 模組 是支持 2.4GHz 和 5GHz 兩個頻段的無線通信模塊，雙頻 Wi-Fi 提供更快的速度、更少的干擾和更穩定的網絡連接，雙頻模組支持SSID混頻路由配網，用戶只需要連接一個SSID就可以完成配網，不僅簡化了配網流程，也提升了配網成功率。

BW20系列模組是安信可科技基于RTL8711 系列芯片開發的雙頻Wi-Fi +BLESoC 模組，支持雙頻（2.4 GHz 或 5.8 GHz）802.11a/b/g/n WLAN 協議和Bluetooth 5.0協議。

●2.4G+5.8G雙頻Wi-Fi模塊

●自帶BLE5.0藍牙

●支持Wi-Fi Mesh 組網

BW20集成了雙核 MCU，一個 ARM V8.1（兼容 Cortex-M4F）高性能MCU，最高主頻可達330MHz；一個 ARM V8M（兼容 Cortex-M0）低功耗MCU。

BW20模組具有豐富的外設接口，包括 UART/GPIO/ADC/PWM/IIC/SPI/SDIO/IR/SWD/USB 等。可廣泛應用于物聯網(IoT)、移動設備、可穿戴電子設備、智能家居等領域。

BW20系列模組主要有兩種封裝類型：BW20-12F以及BW20-07S，用戶可根據需要選擇。

01、前期準備

●需自行搭建準備Ubuntu 系統

推薦使用 Ubuntu 18 及以上版本，可以參考以下視頻：

●VScode 軟件

使用最新的版本，也可以參考以上視頻。

●確保 Ubuntu 系統有以下依賴

make、gcc、Python 3.7 及以上版本、git

02、SDK 克隆

SDK 是模組編程的基礎源碼包，所有的開發都需要基于 SDK 進行，所以必須克隆，打開 Vscode 并且遠程連接到 Ubuntu 虛擬機，打開終端進行克隆：

Github

git clone https://github.com/Ameba-AIoT/ameba-rtos.git

Gitee

git clone https://gitee.com/Ai-Thinker-Open/ameba-rtos.git

克隆結果如下：

正克隆到 'ameba-rtos'...
remote: Enumerating objects: 29976, done.
remote: Counting objects: 100% (3416/3416), done.
remote: Compressing objects: 100% (1736/1736), done.
remote: Total 29976 (delta 1725), reused 3220 (delta 1567), pack-reused 26560 (from 1)
接收對象中: 100% (29976/29976), 227.49 MiB | 16.32 MiB/s, 完成.
處理 delta 中: 100% (13489/13489), 完成.
正在更新文件: 100% (17742/17742), 完成.

安裝依賴（必要）

SDK 編譯之前需要安裝好依賴環境，不然會導致程序無法運行：

cd ameba-rtos
pip3 install -r tools/image_scripts/requirements.txt

03、編譯工具克隆

編譯工具就是專門給 BW20 系列模組編譯程序用的一系列軟件，如果沒有編譯工具，你的程序就無法編譯。

BW20 系列模組的編譯工具鏈下載比較方便具體步驟如下：

●修改opt權限

SDK 在編譯的時候，需要在 opt 文件夾創建目錄，所以需要事先修改 opt 的權限

cd /opt/..
sudo chmod 777 opt

●下載編譯工具

回到 ameba-rtos/amebadplus_gcc_project 文件夾

cd ameba-rtos/amebadplus_gcc_project

執行指令下載編譯工具鏈

make toolchain URL=aliyun

示例：

長度：274482247 (262M) [application/x-bzip2]
正在保存至: “/opt/rtk-toolchain/asdk-10.3.1-linux-newlib-build-4072-x86_64.tar.bz2”
asdk-10.3.1-linux-newlib-build-4072-x86_64.tar.bz2 100%[=================================================================================================================>] 261.77M 18.2MB/s 用時 15s
2024-10-11 15:50:36 (18.0 MB/s) - 已保存 “/opt/rtk-toolchain/asdk-10.3.1-linux-newlib-build-4072-x86_64.tar.bz2” [274482247/274482247])
Download asdk-10.3.1-linux-newlib-build-4072-x86_64.tar.bz2 Success
Download End And Then Extract...
INSTALL SUCCESS
make[2]: 離開目錄“/home/seahi/workspace/ameba-rtos/amebasmart_gcc_project/project_hp/asdk”
make[1]: 離開目錄“/home/seahi/workspace/ameba-rtos/amebasmart_gcc_project/project_hp”

04、編譯工程

4.1 編譯工程

在 amebadplus_gcc_project 的目錄下，使用指令:

make all

4.2 燒錄程序

BW20 燒錄程序的方法有兩種——Windows 燒錄工具燒錄和 Linux 命令行燒錄。

燒錄工具

命令行燒錄

4.3 Windows 燒錄工具

到安信可官網下載 BW20 的專屬燒錄工具：https://docs.ai-thinker.com/rtl87xx

步驟分為：

●在燒錄工具的左上角可以看到 File 按鍵，然后選擇 imagetool_for_ameba_d_plus_139704_DeviceProfiles 路徑下的:**RTL8721F_FreeRTOS_NOR.rdev **
●在 COM 口的下拉框選擇對應的端口
●選擇 km4_boot_all.bin 固件
●選擇 km0_km4_app.bin 固件
●點擊 Download
●開發板進入燒錄模式

長按開發板的 Burn 鍵，在此期間按下開發板的 EN 鍵，即可進入燒錄模式

燒錄完成后，復位開發板即可運行

4.4 Linux 命令行燒錄

命令行燒錄程序不支持串口燒錄，而且僅支持 JLink 調試器燒錄，因此，需要事先準備一個 JLink 調試器及其驅動程序。接著下面的步驟進行配置。

驅動程序需要有 JLinkGDBServer

4.4.1 JLink 連接開發板

根據表格連接開發板：

4.4.2 打開 GDB 服務

確保程序已經編譯成功，**新開一個終端，**然后進入 utils/jlink_script 目錄：

cd amebadplus_gcc_project/utils/jlink_script

運行 GDBServer

JLinkGDBServer -select USB -device Cortex-M23 -if SWD -scriptfile AP2_KM4.JLinkScript -port 2335

注意：

在燒錄成功之前，不要關閉 GDBServer 的終端。

4.4.3 燒錄程序

回到之前的終端，或者新開終端，進入到*ameba-rtos/amebadplus_gcc_project/project_km4 ,*運行：make flash

cd ameba-rtos/amebadplus_gcc_project/project_km4
make flash


審核編輯 黃宇