Ameba ARDUINO: Getting Started with AMB23 (RTL8722DM MINI)

介绍

Ameba是一个易于编程的微控制器平台,可用于开发各种物联网应用程序。

AMB23 有各种外围接口,包括WiFi, GPIO INT, I2C, UART, SPI, PWM, ADC。通过这些接口,AMB23 以连接LED、开关、压力计、湿度计、PM2.5粉尘传感器等电子元件。Ameba所收集的数据可以通过WiFi无线上传,并被智能设备上的应用程序使用,实现物联网的应用。

get-start-1

AMB23使用Micro USB来供电,这在许多智能设备中很常见。
AMB23的引脚图和功能请参考下图和表格。

get-start-3

 GPIO pinGPIO INTADCPWMUARTSPII2CLEDButtonSWD
0PB0    I2C_SDA (a)   
1PB1A4 SERIAL2_TX (a)     
2PB2A5 SERIAL2_RX (a)     
3PB3A6      SWD_CLK
4PB4A0 SPI_MOSI (b)    
5PB5A1 SPI_MISO (b)I2C_SCL (b)   
6PB6A2  SPI_SCLK (b)I2C_SDA (b)   
7PB7A3 SPI_SS (b)    
8PA2        
9PA12 SERIAL2_TX (b)SPI_MOSI (a)    
10PA13 SERIAL2_RX (b)SPI_MISO (a)    
11PA14   SPI_SCLK (a)    
12PA15   SPI_SS (a)    
13PA16        
14PA28       
15PA18  SERIAL1_TX (b)     
16PA19  SERIAL1_RX (b)     
17PA30       
18PA21  SERIAL1_TX (a)     
19PA22  SERIAL1_RX (a)     
20PA23   I2C1_SCL   
21PA24   I2C1_SDA   
22PA31    I2C_SCL (a)   
SWDPA27       SWD_DATA
        LED_B  
        LED_G  
         PUSH_BTN 

设置开发环境

步骤1: 环境配置

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

任何 Linux 作业系统 (Ubuntu) 相关问题,请参考 https://forum.amebaiot.com/t/ubuntu-linux-environment/2259

任何 macOS 作业系统相关问题,请参考 https://forum.amebaiot.com/t/macos-environment/2260

步骤2: 安装驱动程序

首先,通过Micro USB将AMB23 连接到电脑:

get-start-4

如果这是您第一次将AMB23连接到您的电脑,那么AMB23I的USB驱动程序将自动安装。
如果遇到开发板连接到电脑的驱动程序问题,请参考下列USB 驱动程序 https://ftdichip.com/drivers /
你可以在你电脑的装置管理员中检查COM端口号:

get-start-5

步骤2: 设置Arduino IDE

从1.6.5版本开始,Arduino IDE支持第三方硬件。因此,我们可以使用Arduino IDE在AMB23上开发应用程序。请参考 basic example link:

Arduino IDE可以在Arduino网站下载: https://www.arduino.cc/en/Main/Software
安装完成后,打开Arduino IDE。为了在Arduino IDE中正常使用AMB23,请打开“File”—>“Preferences”。

get-start-6

并将以下网址粘贴到 “Additional Boards Manager URLs” 栏位: https://github.com/ambiot/ambd_arduino/raw/master/Arduino_package/package_realtek_amebad_index.json

接下来,选择 “Tools” -> “Board” -> “Boards Manager”:

get-start-7

“Boards Manager”大约需要10~20秒来刷新所有硬件文件(如果网络状况不好,可能需要更长的时间)。每次连接新硬件时,我们都需要重新打开Boards Manager。在列表中找到“Realtek Ameba Boards (32-bits ARM Cortex-M33 @200MHz)”,点击“Install”,Arduino IDE会自动开始下载所需的文件。

get-start-8

如果您遇到 GitHub 下载问题,请参考以下中的链接 “下载/软体开发套件”。有3个部分。

1. “AMB23_Arduino_patch1_SDK”,请至少选择 1 个 SDK。目前有 5 个最新发布的 SDK 选项。
2. “AMB23_Arduino_patch2_Tools”,请根据您的作业系统进行选择。有 Windows、Linux 和 MacOS。
3. “AMB23_Arduino_Source_Code”,此部分为可选下载,用来参考最新原始码。

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

安装工具运行成功后,您可以打开Arduino IDE并选择 “tools” -> “Board“ -> “Ameba ARM (32-bits) Boards” -> “AMB23 (RTL8722DM_MINI)”。

get-start-9

尝试新范例

Step 1. 编译 & 上传

Arduino IDE提供了很多内置的范例,可以在开发板上直接编译、上传和运行。这里,我们以“Blink”为例进行第一次尝试。
打开“File”->“Examples”->“ 01.Basics”-> “Blink”:

get-start-10

Arduino IDE打开一个带有完整示例代码的新视窗。

get-start-11

开发板上有AMB23的LED,默认“LED_BUILTIN”是蓝色的LED
将“LED_BUILTIN”更改为“LED_B”或“LED_G”以使用不同的颜色。板载LED选项LED_B和LED_G。 (蓝色和绿色)。
接下来,我们直接编译示例代码,点击“Sketch”->“Verify/Compile”

get-start-12

Arduino IDE在IDE窗口的底部区域打印编译消息。编译完成后,会得到如下图所示的消息:

get-start-14

之后,我们将把编译后的代码上传到开发板。请确保开发板已连接到您的电脑,然后单击“Sketch” -> “Upload”。

Arduino IDE将先编译,然后上传。用户需要将开发板调至上传模式。要进入上传模式,首先按住 UART_DOWNLOAD 按钮,然后按下并松开 RESET 按钮,最后松开 UART_DOWNLOAD 按钮。设置了 5 秒倒计时提醒进入上传模式。

get-start-15

get-start-16

用户可选择检查开发板是否进入上传模式。打开串行监视器并查找“#Flash Download Start”。请注意,某些串口终端可能会显示如下图所示的未知字符是正常的。

get-start-17

同样,在上传过程中IDE会自动显示消息。上传过程需要相当长的时间(大约30秒到1分钟)。上传完成后,您会看到“Done uploading”消息。

运行Blink示例

在每个示例中,Arduino不仅提供了示例代码,还提供了详细的文档,包括接线图、示例代码说明、技术细节等。这些示例可以直接用于AMB23。在这里我们可以找到Blink这个示例的详细信息:
https://www.arduino.cc/en/Tutorial/BuiltInExamples/Blink

简而言之,该示例可以在板载 LED(绿色或蓝色)或外部 LED(使用任何 GPIO 引脚进行信号输出)上运行。
最后,按下 RESET 按钮,您可以看到 LED 闪烁。
如果您遇到任何问题,请参考Q&A。

特色介绍

Erase Flash

get-start-17

• Enable: 清除快闪记忆体中的image而不上传当前image。
• Disable: 编译完成后上传使用者代码。

“Erase Flash”预设选择为“Disable”来上传使用者代码。

Standard Lib Enable

get-start-17

• Arduino_STD_PRTINF: 使用 printf 时启用 Arduino avr“stdio.h”和“#include ”
• NA: 使用 printf() 基于标准 sdk _rtl_printf()

“Standard Lib Enable”预设选择为“NA”。

Upload Speed

get-start-17

选择上传 baudrate 为 1,500,000 或 921,600.

请先确认已安装QQ通讯软体