Frequently Asked Questions

General

什麼是 Ameba Arduino?
它是用於 Ameba 開發板的第三方 Arduino SDK。
什麼是 Ameba MicroPython?
它是 Ameba 開發板官方支持的 MicroPython 端口。更多信息請參考 MicroPython 官網。
Ameba Arduino 和 Ameba MicroPython 之間的主要區別是什麼？
他們使用不同的編程語言。 Ameba Arduino 使用 C++，而 Ameba MicroPython 使用 Python。
官方開源的 Ameba 開發板有哪些？
AMB21/22, AMB23, AMB01, AMB02
哪裡可以買到 Ameba 開發板？
您可以從 Buy Ameba Boards 獲取 Ameba 開發板購買資訊
哪裡可以找到 Ameba 開發板的開源 SDK？
可以在 Github 找到開源 SDK
如果在使用 Ameba 開發板時遇到問題，應該聯繫誰？
您可以在我們的論壇上提問。
或者您可以在相應的 GitHub repositories 中提出問題。

Hardware

[AMB01, AMB21/22, AMB23, BW16] 在哪裡可以找到 Ameba 開發板的引腳圖？
可以查看每個 Ameba 開發板的”入門指南”頁面，透過 Ameba ARDUINO 查看引腳圖

[AMB21/22] 參考連結

[AMB23] 參考連結

[BW16] 參考連結

[AMB01] 參考連結
 [AMB01, AMB21/22, AMB23, BW16] 什麼是A0、A1、A2、A3、A4、A5、A6，在Ameba開發板上哪裡可以找到？
A0、A1、A2 等是指支持 ADC 功能的引腳。例如，在 AMB23 上，連接到 D1 到 D7 以實現 ADC 功能。

其他板子請分別參考各自的引腳表格。

[AMB21/22]參考連結

[AMB23] 參考連結

[BW16] 參考連結

[AMB01] 參考連結
 [AMB01, AMB21/22, AMB23, BW16] Ameba開發板上的RX TX引腳在哪裡找？
請分別參考引腳表格。

[AMB21/22] 參考連結

[AMB23] 參考連結

[BW16] 參考連結

[AMB01] 參考連結
 [AMB01, AMB21/22, AMB23, BW16] 鑑於說明都是針對 Arduino 板，要如何知道 Ameba 開發板上的哪個引腳連接到所有基本範例？
請參閱每個開發板的相應連結。

[AMB21/22] 參考連結

[AMB23] 參考連結

[BW16] 參考連結

[AMB01] 參考連結

如果引腳或是程式碼有任何更改，將在”Remarks”/”Comments”部分註明。
[AMB21/22, AMB23, BW16] 如何知道我的板子是否成功進入下載模式？
首先，打開串行監視器並進入下載模式。如果有成功進入下載模式，將在串行監視器中看到”#Flash Download Start”。
[AMB21/22, AMB23, BW16] 上傳和下載模式有什麼區別？
是一樣的，都是將bin文件燒錄到Ameba開發板中。
[AMB21/22, AMB23] AMB21/22和AMB23的主要區別是什麼？
他們使用相同的芯片，但是PCB 的尺寸不同，並提供不同數量的引腳和功能。
[AMB21/22, AMB23] AMB21/22 和 AMB23 是否有用戶可配置的按鈕和 LED？
AMB21/22 沒有任何用戶可配置的按鈕和 LED。
AMB23 有 1 個用戶可配置的按鈕和 2 個用戶可配置的 LED。
[AMB21/22, AMB23] AMB21/22 和 AMB23 支持哪些藍牙標準？
兩個都支持 BLE 5.0。不支持Classic藍牙 (BR/EDR)。
[AMB21/22, AMB23] 支持哪些 BLE 角色？
AMB21/22 和 AMB23 可以作為 BLE Central 或 BLE Peripheral 設備運行。
[AMB21/22, AMB23] AMB21/22 和 AMB23 上的所有引腳都可用嗎？
不，標有”NC”的那些沒有連接到任何引腳，因此無法使用。
[AMB21/22, AMB23] AMB21/22 和 AMB23 是否支持 XIP（execute in place）？
是的，有支持。
[AMB21/22, AMB23] AMB21/22 和 AMB23是否支持5G WiFi？
AMB21 和 AMB23 支持雙頻 2.4G + 5G WiFi。 AMB22 僅支持單頻 2.4G WiFi。
[AMB21/22, AMB23] 如何進入下載模式？
按住 UART DOWNLOAD 按鈕。然後按下 RESET 按鈕並放開 UART DOWNLOAD 和 RESET 按鈕。
[AMB21/22, AMB23] 為什麼找不到開發板作為藍牙設備？
請確保天線連接正確。並檢查您的程式碼以獲取正確的藍牙配置。
[AMB21/22, AMB23] 如果程式碼沒有像我預期的那樣運行怎麼辦？
可以嘗試使用 printf 和 Serial.print 語法來檢查您的程序。如果問題仍然存在，可以在論壇尋求幫助。
[AMB21/22, AMB23] 為什麼連接開發板UART後串行終端沒有輸出？
開發板默認配置為 115200 baud rate，請檢查您的串口是否配置為 115200。
[AMB21/22, AMB23] 為什麼我的 WiFi 信號有時很弱？
RTL8722CSM/RTL8722DM 的默認天線使用 I-Pex 連接器。請更換/連接 I-Pex 連接器天線。
[AMB21/22, AMB23] 為什麼我的電路板不通電？
請確保電阻 R43 旁邊的連接器 J38 已連接。連接器用於將電源連接到 IC。
[AMB21/22, AMB23] 如果在將開發板連接到電腦時遇到驅動程序問題怎麼辦？
請到 https://ftdichip.com/drivers/ 獲取 USB 驅動程序。
[AMB21/22] 在下載模式下，閃爍的綠色和紅色 LED 的作用是什麼？
當綠色 LED 閃爍時，表示該開發板正在等待下載模式。當紅色 LED 閃爍時，表示正在將代碼下載到板子上。
[BW16] 我必須在 BW16 上永久連接 D1 – D5 和 D0 – D4 嗎？
不需要。您只需連接它當使用板載 USB 上傳到 BW16。
[BW16] 為什麼即使按照所有步驟也無法進入上傳模式？

確保您已按照所有說明進入下載模式。如果問題仍然存在，請在論壇提出問題
[BW16] BW16 是否有用戶可配置的按鈕和 LED？
BW16 有 1 個用戶可配置的 RGB LED。
[BW16] BW16 是否支持 5GHz 網絡？
有支持
[AMB01] 如何使用 NFC 功能？
要在 AMB01 上使用 NFC 功能，需要先將 NFC 天線焊接在板上。有關詳細信息，請參閱 NFC 範例。

Software - Arduino SDK & Examples

所有開發板/電腦的 COM 端口號是否不同？
是的
為了使用 Ameba 開發板，我需要下載哪些軟體？
取決於您打算使用的 SDK 和 IDE，您可以查看這裡並根據您使用的 Ameba 開發板參考”入門指南”頁面。
我可以在不使用 Arduino IDE 的情況下使用 Ameba 開發板嗎？
可以
我可以使用哪些工具來查看log？
使用任何終端工具，例如 SecureCRT/teraterm/putty 等。
如果我使用的是 Windows 11，還能運行 Ameba 開發板嗎？

可以

在 Arduino IDE “Boards Manager” 中找不到 Ameba 開發板，該怎麼辦？
檢查 json 連結是否已添加到 Arduino IDE 中的“Preferences”（從每個 Ameba 開發板的“入門指南”頁面中找到相應的 json 連結）。

如果在Arduino IDE的“Boards Manager”中仍然找不到Ameba開發板，可以從這裡下載離線包。
為了防止出現亂碼，必須在串行監視器中設置什麼baud rate？
設置端口baud rate，需要和 ino 文件中設置的baud rate一致。例如，“Serial.begin(9600);”
哪裡可以找到 Arduino IDE 中的串行監視器？
您可以通過點擊在 Arduino IDE 的右上角找到串行監視器
哪裡可以找到 Arduino IDE 中的Serial Plotter？
您可以在 “Tool” -> “Serial Plotter” 中找到它。
在 Arduino IDE 中上傳之前我是否需要先編譯？
不用，因為上傳命令包括編譯和上傳。
我可以將 .cpp 和 .h 文件與 .ino 文件一起在 Arduino IDE 中運行嗎？
可以
如何在 Arduino IDE 上添加文件？
添加文件的快捷鍵是“Ctrl+Shift+N”並重命名相應的文件。
如何在 Arduino IDE 上安裝 Ameba 庫？
從 Github 下載libraries並按照 https://docs.arduino.cc/software/ide-v1/tutorials/installing-libraries 安裝。
串口監視器在 Linux 上無法打開，該如何解決？
首先，請嘗試 Arduino 網站上的說明 https:// docs.arduino.cc/software/ide-v1/tutorials/Linux。

如果之後仍然遇到同樣的問題，請卸載 IDE，然後在 Arduino IDE 根目錄下使用終端重新安裝，並在終端中鍵入以下命令：sudo ./install.sh
使用AMB01時出現 “ERR: Cannot find ameba on mbed driver! Please re-plug Ameba”該如何解決 ?

檢查您是否已更新 DAP 固件。請參考連結了解如何更新 DAP 固件。
出現 “failed to open COM port” 錯誤該如何解決 ??

1. 檢查是否在 Arduino IDE 上正確選擇了開發板和 COM 端口。
2. 檢查是否是硬體問題。
3. 如果問題依然存在，請在論壇提出問題。
使用Cygwin時出現錯誤 "The program can't start because cygwin1.dll is missing from your computer. Try reinstalling the program to fix this problem." 該如何解決?

在C槽查找cygwin資料夾，然後在bin文件夾中查找cygwin1.dll，將cygwin1.dll添加到“C:windows”目錄下。
為何會出現錯誤 “RuntimeException: Error opening serial port COM3: port busy“?

同時只有 1 個串行監視器可以訪問 1 個特定的 COM 端口。在上面的範例中，有兩個串行監視器試圖打開同一個 COM 端口。
對於network範例，SSID 和密碼是否必須與我的電腦連接的相同？
建議連接到與電腦相同的網絡。
D13 指的是什麼？

D13 是指 Ameba 開發板上的 Pin 13。您可以參考連結上“入門指南”下每個開發板的引腳圖
如何將 LED 連接到引腳 13？
按照連結上“入門指南”中的範例進行操作
除了範例中提到的 Arduino Uno 之外，我可以使用其他 Arduino 板嗎？
可以，但是接線與使用 Arduino Uno 不同。建議參考正在使用的板子的引腳圖。
連接D7時，為什麼AMB21/22的LED不會亮？
D7 在 AMB21/22 上是 NC。 NC 是“Not Connected。
在 BLE 應用程序中找不到設備名稱，該如何處理？
確保您的藍牙和定位服務都已打開。
為什麼無法編譯開發板？
請從 here 安裝補丁和必要的 Arduino 庫。安裝說明可以在readme文件中找到。
即使重新啟動 Arduino IDE，也看不到網絡端口應該怎麼辦？
您的電腦和開發板上應使用相同的網絡。

Software - MicroPython SDK & Examples

將程式碼從範例複製到 Tera Term 時如何避免縮行錯誤？
詳情請參閱https://ttssh2.osdn.jp/。
可以使用所有在線提供的 Python 庫嗎？
不，MicroPython 僅支持一般Python 標準庫的一小部分。但是這可以通過將一般 python 庫移植到 MicroPython 來完成。
MicroPython 固件編譯失敗
在構建過程中，一些用戶可能會遇到暫停進程的錯誤，這是由於缺少系統環境設置，可以參考如下，

1.python相關的錯誤
默認情況下，MicroPython 使用 python3 運行 MicroPython 的構建腳本，如果遇到與 python 相關的錯誤，可能是因為 Python3 可執行文件的路徑未添加到系統環境變量中。
但是，如果已經添加了環境變量但無法完成構建，您可以嘗試，

1）重新啟動你的電腦
2) 在終端輸入“python”，如果顯示的python是python3，請添加
PYTHON = python
到“port/rtl8722”文件夾下“Makefile”的第二行

2. MPY-CROSS相關的錯誤
如果出現mpy-cross錯誤，則需要執行以下步驟，
1）到“MicroPython_RTL8722/mpy-cross”文件夾
2) 打開你的 Cygwin/Linux 終端並輸入 make

等待 make 完成構建 MicroPython 編譯器，這樣應該可以修復錯誤
為什麼我經常收到 REPL “syntax error”？
請注意 MicroPython 僅支持 Python 3 語法。
如何將我的 python 腳本上傳到 Ameba？
將 python 代碼上傳到 Ameba 有 3 種方法，

1.通過REPL一般模式
在正常的 REPL 模式下，你可以將你的代碼逐行黏貼到 REPL 中，並讓它們依順序執行，請注意在使用條件檢查時，語法會自動縮行，如“if”或“while”，不正確的縮行會導致輸入的腳本錯誤

2.通過REPL黏貼模式
在普通REPL模式下，按“Ctrl”+“e”將進入黏貼模式，黏貼模式只允許黏貼一大塊完整的代碼，不完整的代碼或黏貼後編輯會弄亂你的語法並導致錯誤

3. 通過 mp_frozenmodules
通過將您的python腳本放入“rtl8722”資料夾下的“mp_frozenmodules”資料夾中，您的代碼將嵌入到MicroPython固件中並上傳到Ameba，之後您只需導入python腳本的名稱即可使用它。如果您使用此方法遇到語法錯誤，您最好再次檢查您的 python 代碼語法。