文章目录
- 前言
- 一、认识RTL8720DN
- 二、认识 BW16
- 三、环境搭建
- Step 1: 安装 Arduino IDE
- Step 2: 下载编译依赖环境
- Step 3: 复制编译依赖环境工具到Arduino环境
- Step 4: 添加附件开发选项
- Step 5: 开始安装
- 四、尝试编译第一个范例
- 五、下载
- 其他参考
- 另外，不要把我的博客作为学习标准，我的只是笔记，难有疏忽之处，如果有，请指出来，也欢迎留言哈！
前言
2.4G WiFi 模组已经在国内已经是烂大街了，今天给大家带来的是 5G WiFi 模组的二次开发教程；
熟悉我文章的人都知道我不写Arduino编程的，至于我为什么选择 Arduino开发，虽然实际的复杂产品开发确实很少用到 Arduino环境，这里我也以此芯片进去 Arduino的开发环境，以达到根据项目的需求做出灵活的方案选择。
不管何种开发方式达到客户需求，只追求快速、稳定运行即可，而 Arduino在国外也是非常火爆的开发方式，相信我此系列的开发笔记，可以帮助更多有需要的开发者。
后续，我也会更新一些关于 RTL8720DN 的 C 编程的 SDK 笔记，那部分的门槛会比较高，敬请期待。
一、认识RTL8720DN
相信查看电脑主板网卡的人都知道 RTL 这个缩写，毕竟现在的电脑网卡大多数都是采用这个的，这个芯片是中国台湾的瑞昱(yù)半导体生产的。
Realtek RTL8720DN 是一款 WiFi 和蓝牙芯片，具有用于 WiFi 通信的双频段。值得一提的是，这个小模块还可以支持WiFi 5G和蓝牙低功耗5.0。该WiFi和蓝牙模块是一款高度集成的WiFi和蓝牙模块，可以看作是具有典型SBC的WiFi和蓝牙应用的SoC。
二、认识 BW16
BW16 是博安通（安信可的母公司）基于 RTL8720DN 开发的双频 Wi-Fi+蓝牙 SoC 模组。其开发板 BW16-Kit （见下图），更多资料见：
https://docs.ai-thinker.com/rtl87xx
本系列博文也是采用此款开发板的，如需要的，自行某宝购买。
| PIN name | GPIO INT | ADC | PWM | UART | SPI | I2C | |
|---|---|---|---|---|---|---|---|
| D0 (PA7) | GPIOA_7 | ✓ | UART_LOG_TX | ||||
| D1 (PA8) | GPIOA_8 | ✓ | UART_LOG_RX | ||||
| D2 (PA27) | GPIOA_27 | ✓ | |||||
| D3 (PA30) | GPIOA_30 | ✓ | |||||
| D4 (PB1) | GPIOB_1 | ✓ | A0 | Serial_TX | |||
| D5 (PB2) | GPIOB_2 | ✓ | A1 | Serial_RX | |||
| D6 (PB3) | GPIOB_3 | ✓ | A2 | ||||
| D7 (PA25) | GPIOA_25 | ✓ | ✓ | I2C0_CLK | |||
| D8 (PA26) | GPIOA_26 | ✓ | ✓ | I2C0_SDA | |||
| D9 (PA15) | GPIOA_15 | ✓ | SPI_CS | ||||
| D10 (PA14) | GPIOA_14 | ✓ | SPI_CLK | ||||
| D11 (PA13) | GPIOA_13 | ✓ | ✓ | SPI_MISO | |||
| D12 (PA12) | GPIOA_12 | ✓ | ✓ | SPI_MOSI |
三、环境搭建
Step 1: 安装 Arduino IDE
因为 Arduino 支持离线安装了，请保证版本是 1.8.13 或以上，如果未安装到 Arduino 中文社区下载：
https://www.arduino.cn/thread-5838-1-1.html
Step 2: 下载编译依赖环境
打开下面链接，下载所需的工具，包括一个 ambd_arduino_xxx和操作系统压缩包，都解压出来。
https://www.amebaiot.com.cn/cn/amebad-arduino-download/
Step 3: 复制编译依赖环境工具到Arduino环境
在文件 ambd_arduino_xxx解压后有个离线安装的脚本，在 Offline_SDK_installation_tool
文件夹里面，根据您的操作系统所决定，我们大多数选择的是 window ，所以使用 window powershell,直接运行脚本，把所需要的工具依赖包复制到 Arduino 里面去：
.\Offline_Tool_Windows.cmd
效果截图：
Step 4: 添加附件开发选项
打开 文件 — 首选项 — 附件开发板管理器网址，复制下面一个链接到里面：
https://github.com/ambiot/ambd_arduino/raw/master/Arduino_package/package_realtek.com_amebad_index.json
效果图：
Step 5: 开始安装
在 Arduino IDE Boards Manager 中选择 Ameba1 “Cortex-M3” 或选择 AmebaD “Cortex-M33” 来进行安装。
四、尝试编译第一个范例
步骤一、编译和上传
Arduino IDE提供了很多内置的范例，可以在开发板上直接编译、上传和运行。这里，我们以“Blink”为例进行第一次尝试。
打开 “File” -> “Examples” -> “01.Basics” -> “Blink”:
Arduino IDE打开一个带有完整范例代码的新视窗。
RTL8720DN （BW16）的开发板上带有板载 LED， 默认的”LED_BUILTIN”代表绿色板载 LED。将”LED_BUILTIN”更改为”LED_B”或”LED_R”则可以将颜色转换为蓝色或者红色。这里，我们使用LED_B为例。
接下来，我们直接编译范例代码，点击“Sketch”->“Verify/Compile”
五、下载
之后，我们将把编译后的代码上传到RTL8720DN(BW16)。
请确保RTL8720DN(BW16)已连接到您的电脑，然后单击“Sketch” -> “Upload”。
Arduino IDE将先编译，然后上传。在上传过程中，用户需要将开发板调至上传模式。要进入下载模式，首先按照下面接线，然后按住RTL8720DN(BW16) “Burn” 键，按下“RST”键 ，最后松开“Burn”键。
同样，在上传过程中IDE会自动显示消息。上传过程需要相当长的时间(大约30秒到1分钟)。上传完成后，您会看到“Done uploading”消息。
其他参考
- 官方技术社区：https://forum.amebaiot.com
- BW16 Ardunio gitub：https://github.com/ambiot/ambd_arduino
- 原厂 RTL872xD 芯片手册：UM0401_RTL872xD_Datasheet_v3.4_watermark.pdf
- arduino api 接口文档：api_documents
另外，不要把我的博客作为学习标准，我的只是笔记，难有疏忽之处，如果有，请指出来，也欢迎留言哈！
- 玩转
esp8266带你飞、加群QQ群，不喜的朋友勿喷勿加：434878850 - 个人邮箱：xuhongv@yeah.net 24小时在线，有发必回复！
- esp8266源代码学习汇总（持续更新，欢迎star）：https://github.com/xuhongv/StudyInEsp8266
- esp32源代码学习汇总（持续更新，欢迎star）：https://github.com/xuhongv/StudyInEsp32
- 关注下面微信公众号二维码，干货多多，第一时间推送！
