🥭MangoBox

LEARNING RESOURCES

教學資源中心

從第一次接上 Mango X2,到完成課堂專題;你需要的文件、範例與解答都集中在這裡。

RESOURCE DIRECTORY

想找什麼?
從這裡開始。

依照你的需求選擇分類,直接前往最需要的內容。

FREQUENTLY ASKED

常見問題

依照主題快速找到答案。所有解答都在同一頁直接呈現,不需要跳到其他頁面。

FAQ安裝與入門

Q

第一次使用 Mango X2,要先安裝什麼?

01
A

先到下載中心選擇 MangoThonny 安裝版(Installer);需要免安裝環境時可選可攜版(Portable)。接著依開始使用頁面設定執行環境,並確認開發板與 Runtime 相符。

Q

沒有實體裝置也能開始學習嗎?

02
A

可以先在 MangoThonny 的 Host / CPython 環境使用 virtual 模式,練習支援模擬的輸出功能;這不是網頁內的模擬器。實體感測器、接線與硬體反應仍需接上裝置驗證。

Q

要從哪一門課開始?

03
A

完全沒有 Python 經驗,可以先從「第一個 Mango X2 Python 程式」開始,再依序練習 LED、按鈕與事件互動。

FAQ裝置與連線

Q

電腦找不到 Mango X2 怎麼辦?

01
A

先確認 USB 線可傳輸資料,再檢查連接埠與開發板型號。依裝置管理工具指南確認 Board、Target 與 Runtime,並關閉其他占用序列埠的程式。

Q

程式執行了,但裝置沒有反應?

02
A

先對照課程最下方的執行環境與版本。Host / CPython 課程須確認 hardware 或 mirror 模式、Runtime 與連線設定;MicroPython 程式請依對應文件操作,兩種環境不可混用。

Q

LED、OLED 或蜂鳴器只有部分功能正常?

03
A

先使用課程中的常用 I/O 檢測範例,確認範例涵蓋的元件。若單一元件異常,再對照硬體說明檢查接腳、供電與程式呼叫;此範例不代表整塊板子的所有功能都已測試。

FAQ課程與學習

Q

程式碼可以直接複製使用嗎?

01
A

先確認課程指定的開發板、執行環境與版本,再下載或複製範例。執行成功後一次修改一個參數,觀察顏色、文字、聲音或事件行為的變化。

Q

課程中的 Hardware、Virtual、Mirror 有什麼不同?

02
A

這三種模式用於 Host / CPython:Hardware 控制實體裝置,Virtual 使用模擬環境,Mirror 同時呈現支援的實體與模擬效果。支援範圍請查閱 Host Python API;不要直接套用到 MicroPython。

Q

看到錯誤訊息時該怎麼處理?

03
A

先查看錯誤最後一行,確認檔名、行號與拼字;若與連線有關,再依序檢查 USB、序列埠及執行模式。

FAQ教室使用

Q

一個班級要怎麼快速完成環境設定?

01
A

教師可依教室權限統一安裝 Installer,或準備解壓縮完成的 Portable。課前核對課程版本、開發板與 Runtime,測試線材及連線,再讓學生執行第一個範例。

Q

學生沒有帶裝置,還能跟上進度嗎?

02
A

可先完成 Python 語法與支援 virtual 模式的練習。需要實體輸入、感測器或接線的章節,請安排共用裝置,之後再確認硬體效果。

Q

如何確認每台裝置都能正常使用?

03
A

依本次課程要用的元件逐項測試,記錄 OLED、LED、蜂鳴器或按鈕的結果;其餘感測器與擴充設備需另外測試。

QUICK DIAGNOSIS

還是不確定問題在哪裡?

依序確認線材、開發板型號、Runtime 與序列埠。工具指南提供裝置設定與故障排除說明。
前往故障排除流程