###### tags: `Thonny`

# 連接控制板撰寫 MicroPython 程式

[TOC]

Thonny 開發環境預設會採用其內建的 Python 作為執行環境, 讓你可以開發一般電腦的 Python 程式, 如果要開發微控制板的 MicroPython 程式, 就需要額外的準備工作。

## 安裝驅動程式

要讓電腦連接控制板, 需要先安裝控制板上 USB 晶片的驅動程式, 旗標科技的產品主要控制板使用的是 CH340 晶片, 如果你購買的產品是《[用 Python 學 AIoT 智慧聯網](https://www.flag.com.tw/books/product/FM623A)》、《[Python 黑科技 -- 電話按鍵竊聽器、雷射/風速傳訊器](https://www.flag.com.tw/books/product/FM626A)》、《[Unity × 遊戲手把 虛實整合互動遊戲設計](https://www.flag.com.tw/books/product/FM629A)》, 其中控制板的 USB 晶片是 CP2102, 以下就分別說明兩種 USB 晶片的驅動程式安裝程序。

:::info
Mac 與 Linux 並**不需要安裝驅動程式**, 可略過直接進入[設定 Thonny 連接控制板](#%E8%A8%AD%E5%AE%9A-Thonny-%E9%80%A3%E6%8E%A5%E6%8E%A7%E5%88%B6%E6%9D%BF)的步驟。
:::

### 安裝 CH340 晶片驅動程式

1. 請至 [CH340 晶片官網](http://www.wch.cn/downloads/CH341SER_EXE.html)下載驅動程式：


請往下捲按**下載**。

1. 執行下載的檔案：

:::info
若出現安全性畫面, 請按**仍要安裝**或是 **Install anyway**：

:::


按 **INSTALL** 繼續。

1. 經過一段時間後就可以安裝完成：


:::info
如果看到安裝失敗：


可以先用 USB 傳輸線連接電腦與控制板, 再重新按下 **INSTALL**, 應該就可以正常安裝了。
:::

1. 關閉安裝視窗。

### 安裝 CP2102 晶片的驅動程式

1. 請至[官網下載](https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers)驅動程式：


切換到 **DOWNLOADS** 頁次, 往下捲動：


點選 **CP210x Universal Windows Driver** 下載。

2. 解開下載的檔案, 依據平台執行對應的安裝檔案：


:::info
若出現安全性畫面, 請按**仍要安裝**或是 **Install anyway**：

:::

3. 按**下一步**：


4. 完成安裝, 按**完成**：


## 設定 Thonny 連接控制板

1. 開啟 Thonny, 執行『**執行/選擇直譯器**』功能表指令, 開啟**選項**視窗的**直譯器**頁次：


在**Thonny 該使用哪一種直譯器或設備來執行你的程式**這一項請選取**MicroPython(一般)**。

1. 請用 USB 傳輸線連接你的控制板與電腦。

3. 點開**連接埠**選項：


旗標科技使用的控制板在 Windows 上的連接埠名稱為 "USB-SERIAL CH340", CH340 是 USB 晶片的型號, 後面括號內的 "COMX" 是連接埠的序號, 如果接上多片控制板, 序號都會不同。

如果你購買的產品是《[用 Python 學 AIoT 智慧聯網](https://www.flag.com.tw/books/product/FM623A)》、《[Python 黑科技 -- 電話按鍵竊聽器、雷射/風速傳訊器](https://www.flag.com.tw/books/product/FM626A)》、《[Unity × 遊戲手把 虛實整合互動遊戲設計](https://www.flag.com.tw/books/product/FM629A)》, 其中控制板的 USB 晶片是 CP2102, 在連接埠清單中顯示的名稱會是 "Silicon Labs CP210x" 開頭：


請依照所使用的控制板選取連接埠後按**確認**。

:::info
**Mac 下的連接埠名稱**

如果你使用的是 Mac 電腦, 連接埠名稱略有不同, 對應到剛剛提到的兩種 USB 晶片, CH340 在清單中顯示的名稱如下：


而 CP2102 晶片在清單中的顯示名稱為：


其實只要認括號內有 "cu.usbserial" 字樣即可。
:::

:::info
**Linux 下的連接埠名稱**

如果你使用的是 Linux, 連接埠名稱也不一樣, 對應到剛剛提到的兩種 USB 晶片, CH340 在清單中顯示的名稱如下：


而 CP2102 晶片在清單中的顯示名稱為：


其實只要認括號內有 "ttyUSB" 字樣即可, 後面的數字一樣是序號。
:::

2. 設定好後即可連上控制板：


只要在下方的**互動環境(Shell)**窗格中看到 "MicroPython" 字樣就可以了。

:::info
如果在底下的**互動環境(Shell)** 沒有看到 "MicroPython" 字樣, 請按一下上方工具列中的 **STOP** 按鈕：


如果怎麼按都看不到 "MicroPython" 字樣, 很可能是控制板上並沒有燒錄 MicroPython 韌體, 請依照〈[燒錄 MicroPython 韌體](https://hackmd.io/@flagmaker/rJECwzUfF)〉重新燒錄韌體。
:::