BW20系列模组是安信可科技基于RTL8711 系列芯片开发的双频Wi-Fi +BLESoC 模组，支持双频（2.4 GHz 或 5.8 GHz）802.11a/b/g/n WLAN 协议和Bluetooth 5.0协议。
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.gitgit 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-rtospip3 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 命令行烧录。
烧录工具
| 优点 | 支持 UART 烧录 操作简单 |
| 缺点 | 需要从 Linux 复制固件 不方便调试 |
命令行烧录
| 优点 | 方便调试 可在 Linux 终端烧录，不需要切换平台 |
| 缺点 | 配置麻烦 不支持 UART 烧录 |
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 连接开发板
根据表格连接开发板：
JLink |
BW20 开发版 |
DIO(DATA) |
PA31 |
CLK |
PA30 |
GND |
GND |
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_km4make flash
微信改版，容易错过最新资讯和福利？
快将“安信可科技”设为星标⭐
可以第一时间接收小安的推送！
▼
开源硬件新鲜玩：小安派-Eyes-S1/S2多功能开发板
10公里！超远距离传输的LoRa模块上架
安信可更多产品信息可进入以下链接查阅：
●开发资料：https://docs.ai-thinker.com/
●官方教程：https://blog.csdn.net/Boantong_
●安信可官网：www.ai-thinker.com
●安信可社区：https://bbs.ai-thinker.com
●业务咨询请联系：18022036575
