# RTL8722DM_MINI-操作手冊

## 參考資料

* [各範例程式](https://www.amebaiot.com/zh/amebad-arduino-peripherals-examples/#ambd-arduino-peripherals)
* [Notion-Ameba School 教案整理]()

## 工作環境

AmebaD RTL8722DM_MINI 目前支持Windows XP/7/8/10 32位元/64位元，Linux以及Mac作業系統。在本文檔中，請使用1.8.12或更高版本的Arduino IDE。

## AmebaD RTL8722DM_MINI 介紹

Ameba是一個易於編程的微控制器平台，可用於開發各種物聯網應用程序。

AmebaD有各種外圍接口，包括WiFi, GPIO INT, I2C, UART, SPI, PWM, ADC。通過這些接口，AmebaD可以連接LED、開關、壓力計、濕度計、PM2.5粉塵傳感器等電子元件。
Ameba所收集的數據可以通過WiFi無線上傳，並被智能設備上的應用程序使用，實現物聯網的應用。


AmebaD和Arduino Uno的尺寸類似，如上圖所示。


RTL8722DM_MINI使用Micro USB來供電，這在許多智能設備中很常見。

## 引腳
RTL8722DM_MINI的引腳圖和功能請參考下圖和表格。


## 設置開發環境

### 步驟1: 安裝驅動程序

首先，通過Micro USB將RTL8722DM_MINI連接到電腦:


如果這是您第一次將RTL8722DM_MINI連接到您的電腦，那麼RTL8722DM_MINI的USB驅動程序將自動安裝。
你可以在你電腦的裝置管理員中檢查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 AmebaD Boards (32-bits ARM Cortex-M4 @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打開一個帶有完整示例代碼的新視窗。


開發板上有TRL8722DM_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將先編譯，然後上傳。在上傳過程中，用戶需要將開發板調至上傳模式。 Arduino IDE會等待5秒鐘，等待開發板進入上傳模式。


想要進入上傳模式，首先按住UART_DOWNLOAD按鈕不放，然後輕按RESET按鈕。如果成功的話，您應該會在開發板上看到閃爍的綠色LED，之後就可以放開按鍵。


同樣，在上傳過程中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開始閃爍。
如果您遇到任何問題，請參考故障排除。