入門手冊

Ameba ARDUINO: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無線上傳,並被智能設備上的應用程序使用,實現物聯網的應用。

board-front

AmebaD 和 Arduino UNO 的尺寸類似,如上圖所示。

board-bottom

RTL8722DM MINI 使用 Micro USB來供電,這在許多智能設備中很常見。
RTL8722DM MINI 的引腳圖和功能請參考下圖和表格。

pin-diagram-front

pin-diagram-bottom

#

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

設置開發環境

步驟一、安裝驅動程序

首先,通過 Micro USB 將 RTL8722DM MINI 連接到電腦:

board-bottom

如果這是您第一次將RTL8722DM MINI連接到您的電腦,那麼RTL8722DM MINI的USB驅動程序將自動安裝。
如果遇到開發板連接到電腦的驅動程序問題,請參考下列 USB 驅動程序
你可以在你電腦的裝置管理員中檢查 COM 端口號:

install-driver

步驟二、設置 Arduino IDE

從1.6.5版本開始,Arduino IDE支持第三方硬件。因此,我們可以使用Arduino IDE在 RTL8722DM MINI上開發應用程序,Arduino 的示例也可以在 RTL8722DM MINI上運行。請參考 基本範例
Arduino IDE 可以在 Arduino 網站下載:
安裝完成後,打開 Arduino IDE。為了在 Arduino IDE 中正常使用 RTL8722DM MINI,請打開 “File” -> “Preferences”

get-start-6

並將以下網址粘貼到 “Additional Boards Manager URLs” 欄位:

https://github.com/ambiot/ambd_arduino/raw/master/Arduino_package/package_realtek.com_amebad_index.json

接下來,選擇 “Tools” -> “Board” -> “Boards Manager”:

get-start-7

“Boards Manager”大約需要10~20秒來刷新所有硬件文件(如果網絡狀況不好,可能需要更長的時間)。每次連接新硬件時,我們都需要重新打開Boards Manager。因此,我們先關閉然後再次打開它。在列表中找到“Realtek AmebaD Boards (32-bits ARM Cortex-M33 @200MHz)”,點擊“Install”,Arduino IDE會自動開始下載AmebaD所需的文件。

get-start-8

如果您遇到 GitHub 下載問題,請參考以下“下載/軟體開發套件”中的鏈接。有3個部分。
  1. AmebaD_Arduino_patch1_SDK”,請至少選擇 1 個 SDK。目前有 5 個最新發布的 SDK 選項。

  2. “AmebaD_Arduino_patch2_Tools”,請根據您的作業系統進行選擇。有 Windows、Linux 和 MacOS。

  3. “AmebaD_Arduino_Source_Code”,此部分為可選下載,用來參考最新原始碼。

下載選擇的文件,然後解壓(patch1 和patch2 是必須的)。有“Install_中文.doc”/“Install_中文.pdf”供您參考安裝步驟。根據您的系統,請運行“Offline_SDK_installation_tool”文件夾中的安裝工具。

安裝工具運行成功後,您可以打開Arduino IDE並選擇 “tools” -> “Board“ -> “Boards Manager…”。嘗試在列表中找到“Realtek AmebaD Boards (32-bits ARM Cortex-M33 @200MHz)”,點擊“Install”,Arduino IDE開始下載AmebaD所需的文件。


最後,我們在“tools”->“Board”->“Ameba ARM (32-bits) Boards”->“RTL8722DM MINI”中選擇了AmebaD作為當前連接的開發板:

get-start-9

嘗試第一個範例

步驟一、編譯和上傳

Arduino IDE提供了很多內置的範例,可以在開發板上直接編譯、上傳和運行。這裡,我們以“Blink”為例進行第一次嘗試。
打開 “File”->“Examples”->“ 01.Basics”-> “Blink”:

get-start-10

Arduino IDE 打開一個帶有完整示例代碼的新視窗。

get-start-11

開發板上有 RTL8722DM MINI 的 LED,默認 “LED_BUILTIN” 是藍色的 LED
將 “LED_BUILTIN” 更改為 “LED_B” 或 “LED_G” 以使用不同的顏色。 板載 LED 選項 LED_B 和 LED_G (藍色和綠色)。

get-start-12

接下來,我們直接編譯示例代碼,點擊 “Sketch” -> “Verify/Compile”

get-start-13

Arduino IDE在IDE窗口的底部區域打印編譯消息。編譯完成後,會得到如下圖所示的消息:

get-start-14

之後,我們將把編譯後的代碼上傳到 RTL8722DM MINI。
請確保 RTL8722DM MINI 已連接到您的電腦,然後單擊 “Sketch” -> “Upload”。
Arduino IDE將先編譯,然後上傳。在上傳過程中,用戶需要將開發板調至上傳模式。 Arduino IDE會等待5秒鐘,等待開發板進入上傳模式。

get-start-15

想要進入上傳模式,首先按住UART_DOWNLOAD按鈕不放,然後輕按RESET按鈕。上傳成功后,你可以看到板載的綠色和藍色 LED熄滅。

get-start-16

用戶可選擇檢查開發板是否進入上傳模式。 打開串行監視器並查找“#Flash Download Start”。請注意,某些串口終端可能會顯示如下圖所示的未知字符是正常的。

get-start-17

同樣,在上傳過程中IDE會自動顯示消息。上傳過程需要相當長的時間 (大約30秒到1分鐘)。上傳完成後,您會看到 “Done uploading” 消息。