Ameba ARDUINO: Getting Started with RTL8722DM MINI
工作环境
AmebaD RTL8722DM MINI 开发板目前支持 Windows OS 32 位元和 64 位元(WIN7/8/10)、Linux OS(Ubuntu 18 LTS/20 LTS/最新)和 macOS 作业系统。请使用最新的作业系统版本以获得最佳体验。在本文档中,请使用最新版本的 Arduino IDE(至少 1.8.12 版)。
AmebaD RTL8722DM MINI 介绍
Ameba是一个易于编程的微控制器平台,可用于开发各种物联网应用程序。
AmebaD有各种外围接口,包括WiFi, GPIO INT, I2C, UART, SPI, PWM, ADC。通过这些接口,AmebaD可以连接LED、开关、压力计、湿度计、PM2.5粉尘传感器等电子元件。
Ameba所收集的数据可以通过WiFi无线上传,并被智能设备上的应用程序使用,实现物联网的应用。
RTL8722DM MINI使用Micro USB来供电,这在许多智能设备中很常见。
RTL8722DM MINI的引脚图和功能请参考下图和表格。
PIN name | GPIO INT | ADC | PWM | UART | SPI | I2C | |
D0 | GPIOB_0 | ✓ | I2C0 SDA | ||||
D1 | GPIOB_1 | ✓ | A4 | Serial2_TX | |||
D2 | GPIOB_2 | ✓ | A5 | Serial2_RX | |||
D3 | GPIOB_3 | ✓ | A6 | ||||
D4 | GPIOB_4 | ✓ | A0 | ✓ | |||
D5 | GPIOB_5 | ✓ | A1 | ✓ | I2C0 SCL | ||
D6 | GPIOB_6 | ✓ | A2 | I2C0 SDA | |||
D7 | GPIOB_7 | ✓ | A3 | ✓ | |||
D8 | GPIOA_2 | ✓ | |||||
D9 | GPIOA_12 | ✓ | ✓ | Serial2_TX | SPI1_MOSI | ||
D10 | GPIOA_13 | ✓ | ✓ | Serial2_RX | SPI1_MISO | ||
D11 | GPIOA_14 | ✓ | SPI1_CLK | ||||
D12 | GPIOA_15 | ✓ | SPI1_CS | ||||
D13 | GPIOA_16 | ✓ | |||||
D14 | GPIOA_28 | ✓ | ✓ | ||||
D15 | GPIOA_18 | ✓ | Serial1_TX | ||||
D16 | GPIOA_19 | ✓ | Serial1_RX | ||||
D17 | GPIOA_30 | ✓ | ✓ | ||||
D18 | GPIOA_21 | ✓ | Serial1_TX | ||||
D19 | GPIOA_22 | ✓ | Serial1_RX | ||||
D20 | GPIOA_23 | ✓ | ✓ | ||||
D21 | GPIOA_24 | ✓ | ✓ | ||||
D22 | GPIOA_31 | ✓ | I2C0 SCL |
设置开发环境
步骤1: 安装驱动程序
首先,通过Micro USB将RTL8722DM MINI连接到电脑:
如果这是您第一次将RTL8722DM MINI连接到您的电脑,那么RTL8722DM MINI的USB驱动程序将自动安装。
如果遇到开发板连接到电脑的驱动程序问题,请参考下列USB 驱动程序https:// ftdichip.com/drivers /。
你可以在你电脑的装置管理员中检查COM端口号:
步骤2: 设置Arduino IDE
从1.6.5版本开始,Arduino IDE支持第三方硬件。因此,我们可以使用Arduino IDE在RTL8722DM MINI上开发应用程序,Arduino的示例也可以在RTL8722DM MINI上运行。请参考 basic example link:
Arduino IDE可以在Arduino网站下载: https://www.arduino.cc/en/Main/Software
安装完成后,打开Arduino IDE。为了在Arduino IDE中正常使用RTL8722DM MINI,请打开“File”—>“Preferences”。
并将以下网址粘贴到“Additional Boards Manager URLs” 栏位: https://github.com/ambiot/ambd_arduino/raw/master/Arduino_package/package_realtek.com_amebad_index.json
接下来,选择 “Tools” -> “Board” -> “Boards Manager”:
“Boards Manager”大约需要10~20秒来刷新所有硬件文件(如果网络状况不好,可能需要更长的时间)。每次连接新硬件时,我们都需要重新打开Boards Manager。因此,我们先关闭然后再次打开它。在列表中找到“Realtek Ameba Boards (32-bits ARM Cortex-M33 @200MHz)”,点击“Install”,Arduino IDE会自动开始下载AmebaD所需的文件。
如果您遇到 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/ameba-arduino-summary/
下载选择的文件,然后解压(patch1 和patch2 是必须的)。 有“Install_中文.doc”/“Install_中文.pdf”供您参考安装步骤。 根据您的系统,请运行“Offline_SDK_installation_tool”文件夹中的安装工具。
安装工具运行成功后,您可以打开Arduino IDE并选择 “tools” -> “Board“ -> “Boards Manager…”。
尝试在列表中找到“Realtek Ameba Boards (32-bits ARM Cortex-M33 @200MHz)”,点击“Install”,Arduino IDE开始下载AmebaD所需的文件。
最后,我们在“tools”->“Board”->“Ameba ARM (32-bits) Boards”->” RTL8722DM MINI”中选择了AmebaD作为当前连接的开发板:
Try the First Example
Step 1. Compile & Upload
Arduino IDE提供了很多内置的范例,可以在开发板上直接编译、上传和运行。这里,我们以“Blink”为例进行第一次尝试。
打开“File”->“Examples”->“ 01.Basics”-> “Blink”:
Arduino IDE打开一个带有完整示例代码的新视窗。
开发板上有RTL8722DM MINI的LED,默认“LED_BUILTIN”是蓝色的LED
将“LED_BUILTIN”更改为“LED_B”或“LED_G”以使用不同的颜色。板载LED选项LED_B和LED_G。 (蓝色和绿色)。
接下来,我们直接编译示例代码,点击“Sketch”->“Verify/Compile”
Arduino IDE在IDE窗口的底部区域打印编译消息。编译完成后,会得到如下图所示的消息:
之后,我们将把编译后的代码上传到RTL8722DM MINI。请确保RTL8722DM MINI已连接到您的电脑,然后单击“Sketch” -> “Upload”。
Arduino IDE将先编译,然后上传。用户需要将开发板调至上传模式。
要进入上传模式,首先按住 UART_DOWNLOAD 按钮,然后按下并松开 RESET 按钮,最后松开 UART_DOWNLOAD 按钮。 设置了 5 秒倒计时提醒进入上传模式。
用户可选择检查开发板是否进入上传模式。打开串行监视器并查找“#Flash Download Start”。请注意,某些串口终端可能会显示如下图所示的未知字符是正常的。
同样,在上传过程中IDE会自动显示消息。上传过程需要相当长的时间(大约30秒到1分钟)。上传完成后,您会看到“Done uploading”消息。
运行Blink示例
在每个示例中,Arduino不仅提供了示例代码,还提供了详细的文档,包括接线图、示例代码说明、技术细节等。这些示例可以直接用于RTL8722DM MINI。在这里我们可以找到Blink这个示例的详细信息:
https://www.arduino.cc/en/Tutorial/BuiltInExamples/Blink
简而言之,对于RTL8722DM MINI,该示例可以在板上LED(绿色或蓝色)或外部LED(使用任何GPIO引脚进行信号输出)上运行。
最后,按RESET按钮,你就会看到LED开始闪烁。
如果您遇到任何问题,请参考故障排除。