13.3. OpenMV Python 软件包

openmv PyPI 软件包是用于从桌面或单板计算机的 Python 程序驱动 OpenMV Cam 的主机端 Python 库。它通过 USB 连接到摄像头、上传并执行脚本、将帧流式传回、读取运行中脚本的 stdout,并通过具名通道(channel)交换任意二进制数据。其底层运行的正是 IDE 所使用的同一套协议,因此 IDE 对摄像头能做的任何事情,Python 程序也都能做。

有两种入门方式。随附的 openmv 命令行工具会打开一个查看器,是验证软件包已安装且摄像头可访问的最快方式。openmv.Camera 类则是希望自行驱动摄像头的 Python 代码的入口点——无头捕获、自动化测试装置、自定义桌面 GUI,或 IDE 未涵盖的任何其他应用程序。

13.3.1. 安装

该软件包位于 PyPI 上:

pip install openmv

需要 Python 3.12 或更新版本。安装时会自动拉取其依赖项:用于 USB 串口传输的 pyserial、用于帧解码的 numpy、用于 CLI 查看器的 pygame,以及用于分析器的 pyelftools