入门指南

Ameba ARDUINO: Getting Started with BW16 Type C

介绍

Realtek RTL8720DN 是一款 Wi-Fi 和蓝牙 IC，支持 2.4GHz 和 5GHz 双频 Wi-Fi 通信，以及蓝牙低功耗 (BLE) 5.0。BW16模组由B&T生产，该模组是以RTL8720DN为主要SoC（System on Chip）的高度集成的Wi-Fi和蓝牙模块，可以看作是典型SBC的Wi-Fi和蓝牙应用的SoC。BW16 Type C 是与模块集成的开发板。 BW16开发板有2块，BW16和BW6-TypeC。 BW16-TypeC 使用 USB TypeC 连接器，与 BW16 相比具有自动上传电路。

BW16-TypeC 开发板

../../../_images/image198.png

开发板的尺寸为 50.4*25.4(±0.2) mm。它使用TypeC USB供电，这在很多智能设备中都很常见。BW16 的引脚图和功能请参考下图和下表。

../../../_images/image286.png

#

GPIO Pin

GPIO INT

ADC

PWM

UART

SPI

I2C

IR

RGB LED

SWD

0

PA7

✓

LOG_TX

1

PA8

✓

LOG_RX

2

PA27

✓

SWD_DATA

3

PA30

✓

✓

4

PB1

✓

SERIAL1_TX

5

PB2

✓

SERIAL1_RX

6

PB3

✓

A2

SWD_CLK

7

PA25

✓

✓

I2C_SCL

IR_TX

8

PA26

✓

✓

I2C_SDA

IR_RX

9

PA15

✓

SPI_SS

10

PA14

✓

SPI_SCLK

LED_G

11

PA13

✓

✓

SPI_MISO

LED_B

12

PA12

✓

✓

SPI_MOSI

LED_R

除了 USB 连接器外，还有 2 个按钮。如上图所示，左侧为“RST”按钮，右侧为“Burn”按钮。有关按钮的功能，请参阅下表。

Button Functions

Button Process

Reset board

  1. Press then release “RST”

Enter upload mode

  1. Press and hold “Burn”

  2. Press then release “RST”

  3. Release “Burn”

清除flash或上传固件时，开发板需要上传模式。 BW16-TypeC 有自动上传电路。它不需要手动进入上传模式。

设置开发环境

步骤一、 环境配置

BW16 (RTL8720DN) 开发板目前支持 Windows OS 32 位元或 64 位元、Linux OS (Ubuntu) 和 macOS。为了获得最佳体验，请使用最新版本的作业系统。

步骤二、 设定 Arduino IDE

从 1.6.5 版本开始，Arduino IDE 支持第三方硬件。 Arduino IDE用于在开发板上开发应用程序，以及Arduino基本范例(refer to the basic example link)。

Arduino IDE 可以在 Arduino 网站下载：https://www.arduino.cc/en/Main/Software

安装完成后，打开Arduino IDE。请打开 “File” -> “Preferences”.

并将以下 URL 复制到 “Additional Boards Manager URLs” 栏位:https://github.com/ambiot/ambd_arduino/raw/master/Arduino_package/package_realtek.com_amebad_index.json

接下来，打开 “Tools” -> “Board” -> “Boards Manager”:

../../../_images/image360.png

“Boards Manager”大约需要几秒钟来刷新所有硬件文件(如果网络状况不好，可能需要更长的时间)。在列表中找到“Realtek Ameba Boards (32-bits ARM Cortex-M33 @200MHz)”，点击“Install”，Arduino IDE会自动开始下载AmebaD包含BW16所需的文件。

../../../_images/image447.png

如果您遇到 GitHub 下载问题，请参考以下连结 中的“下载/软体开发套件”。有3个部分。1. “AmebaD_Arduino_patch1_SDK”，请至少选择 1 个 SDK。目前有 5 个最新发布的 SDK 选项。2. “AmebaD_Arduino_patch2_Tools”，请根据您的作业系统进行选择。有 Windows、Linux 和 MacOS。3. “AmebaD_Arduino_Source_Code”，此部分为可选下载，用来参考最新原始码。

https://www.amebaiot.com.cn/en/ameba-arduino-summary/

下载选择的文件，然后解压（patch1 和patch2 是必须的）。有“Install.doc”/“Install.pdf”供您参考安装步骤。根据您的系统，请运行“Offline_SDK_installation_tool”文件夹中的安装工具。

安装运行成功后，您可以打开Arduino IDE并选择 “Tools” -> “Board” -> “Ameba ARM (32-bits) Boards” ->” BW16(RTL8720DN)” 来选择AmebaD作为当前连接的开发板。

../../../_images/image534.png

步骤三、 安装串行端口

首先，通过 TypeC USB 将开发板连接到电脑：

BW16-TypeC 开发板

../../../_images/image622.png

对应连接后，会自动安装USB驱动。如果连接板有驱动问题，请到http://www.wch- ic.com/downloads/CH341SER_ZIP.html 参考 USB 驱动程序。在 Windows 作业系统的装置管理员中检查 COM 端口号：

../../../_images/image719.png

到“Tools”->“Port”并选择正确的 COM 端口。

../../../_images/image815.png

进入“Tools”->“Serial Monitor”，将baud rate设置为“115200”，然后按RST按钮检查串口连接。

../../../_images/image911.png ../../../_images/image1010.png

步骤四、 清除 flash

根据生产批次的不同，部分开发板可能内置了预设的B&T固件，固件信息如下图所示：

../../../_images/image1116.png

固件位于 OTA 部分。所有新编译的固件将被 OTA 固件自动替换。因此，需要先清除 OTA 固件才能使用已编译的固件。

方法一：Arduino SDK V3.1.3 之后的“Erase Flash Enable”。

选择“Tools”->“Erase Flash”->“Enable”

../../../_images/image1213.png

然后进入上传模式。

  • 手动。按住“Burn”按钮，按下然后放开“RST”按钮并放开“Burn”按钮。

  • 自动。选择“Tools”->“Auto Upload Mode”->“Enable”。注意只有内置自动上传电路的板子才能使用自动上传模式，否则会回到正常上传模式并等待5秒。

接下来，选择“Sketch”->“Upload”。 “Erase flash done” 会出现。

../../../_images/image1313.png ../../../_images/image1413.png

按RST按钮来检查串行监视器和重制开发板。如果只有“#”表示清除flash成功。记得选择“Tools”->“Erase Flash”->“Disable”。

../../../_images/image1513.png

尝试操作范例

Step 1. 编译与上传

Arduino IDE提供了很多内建的范例，可以在开发板上直接编译、上传和运行。这里，我们以“Blink”为例进行第一次尝试。

打开 “File” -> “Examples” -> “01.Basics” -> “Blink”:

../../../_images/image1611.png ../../../_images/image1711.png

小技巧

板载 RGB LED，预设“LED_BUILTIN”为绿色。将“LED_BUILTIN”更改为“LED_R”、“LED_G”或“LED_B”以获得红色、绿色或蓝色。

接下来，直接编译范例代码。 “Sketch”->“Verify/Compile”。

然后如果没有编译错误，接着“Sketch”->“Upload”。

  • 检查并选择 “Tools” -> “Erase Flash” -> “Disable

  • 进入上传模式。手动或自动。选择 “Tools” -> “Auto Upload Mode” -> “Enable”/ ”Disable”

  • “Verify/Compile” 和 “Upload”. “Upload” 包括 “Verify/Compile”, “Verify/Compile” 可以跳过。

上传成功会显示“All images are sent successfully!”

../../../_images/image1811.png

参考

  1. Introduction of BW16 on Instructable: https://www.instructables.com/RTL8720DN/

  2. Load Arduino image into BW16: How to load BW16 program with Arduino – #13

  3. BW16 IMG2 SIGN Invalid Solution: RTL8720DN(BW16) IMG2 SIGN Invalid Solution

  4. FTDI Driver Download from here: https://ftdichip.com/wp-content/uploads/2021/02/CDM21228_Setup.zip