使用 MicroPython 檔案存取 - io

目錄

• MicroPython 函式庫說明
• io – 輸入/輸出
• 參考資料

本次的範例中會使用到 ESP32-CAM 的檔案存取、燈號控制、Wi-Fi、時間、拍照、網路等功能，接下來會逐步介紹如何使用這些功能。

MicroPython 函式庫說明

MicroPython 提供 Python 標準函式庫功能的內建模塊（例如 os、time）以及 MicroPython 特定的模塊（例如 bluetooth, machine）。大多數標準函式庫模塊實現了等效 Python 模塊的一部分功能，並且在少數情況下提供了一些 MicroPython 特定的擴展（例如 array, os），但由於資源限制或其他限制，某些韌體版本可能不包括官方手冊的所有功能。

以下 Python 的標準函式庫已經過「微化」以適應 MicroPython 的理念，它們提供該模塊的核心功能，旨在成為標準 Python 庫的直接替代品。

• array – 數字數據的陣列
• binascii – 二進制/ASCII 轉換
• builtins – 內建函數和異常
• cmath – 複數的數學函數
• collections – 集合和容器類型
• errno – 系統錯誤代碼
• gc – 控制垃圾收集器
• hashlib – 雜湊算法
• heapq – 堆隊列算法
• io – 輸入/輸出流
• json – JSON 編碼和解碼
• math – 數學函數
• os – 基本的「操作系統」服務
• random – 生成隨機數
• re – 簡單的正則表達式
• select – 等待一組流上的事件
• socket – 網絡插座模塊
• ssl – SSL/TLS 模塊
• struct – 打包和解包原始數據類型
• sys – 系統特定的功能
• time – 時間相關函數
• uasyncio — 異步 I/O 調度程序
• zlib – zlib 解壓
• _thread – 多線程支持

原則上，標準模塊都實現了相應 CPython 模塊的一個子集，有關更多信息，可以參閱原始 CPython 文檔。CPython 是 Python 編程語言的參考實現，也是最著名的一種。然而，它是眾多實現中的一種（包括 Jython、IronPython、PyPy 和 MicroPython）。雖然 MicroPython 的實現與 CPython 有很大不同，但它旨在盡可能保持兼容性。

io – 輸入/輸出

io.open(file, mode='r', buffering=-1, encoding=None, errors=None, newline=None, closefd=True, opener=None)
打開一個檔案，並返回檔案物件，使用 open() 方法一定要保證關閉檔案物件，即呼叫 close() 方法。所有移植物件(port)都需要支持模式參數(mode)，但對其他參數的支持因移植物件而異。

參數說明:

• file: 必需，檔案路徑（相對或者絕對路徑）。
• mode: 可選，檔案打開模式
• buffering: 設置緩衝
• encoding: 一般使用utf8
• errors: 報錯級別
• newline: 區分換行符
• closefd: 傳入的file參數類型
• opener: 設置自定義開啓器，開啓器的返回值必須是一個打開的檔案描述符。

表 1. open() 打開模式(mode)

表 2. 檔案物件常見的方法

以下為寫入一個檔案，再將數據讀取出來。
參考代碼

import io
f = open('myfile.txt', 'w')
f.write('''Jupyter 是基於網頁的用於交互計算的應用程序，
可被應用於全過程計算：開發、文檔編寫、
運行代碼和展示結果。''')
f.close()

f = open('myfile.txt')
print(f.read())
f.close()

輸出結果為：

151
Jupyter 是基於網頁的用於交互計算的應用程序，
可被應用於全過程計算：開發、文檔編寫、
運行代碼和展示結果。

下圖是使用 Thonny 的執行結果

1. 將程式碼儲存在 MicroPython 設備(ESP32-CAM) 中
2. 點擊執行按鈕後，可以在下方視窗看到結果。

圖 1. 使用Thonny執行結果

可以在上方工具列上的選擇 檢視->檔案，就會出現左方的檔案窗格

圖 2. 顯示左方的檔案窗格

參考資料

• mPython help documentation, https://mpython.readthedocs.io/en/master/index.html
• MicroPython 文檔, http://micropython.86x.net/en/latet/index-2.html
• MicroPython documentation, https://docs.micropython.org/en/latest/index.html