13.3. OpenMV Python-pakket

Het openmv PyPI-pakket is de host-zijdige Python-bibliotheek voor het aansturen van een OpenMV Cam vanuit een Python-programma op een desktop of single-board-computer. Het maakt via USB verbinding met de cam, uploadt en voert scripts uit, streamt frames terug, leest stdout van het draaiende script en wisselt willekeurige binaire data uit via benoemde kanalen. Hetzelfde protocol dat de IDE gebruikt draait eronder, dus alles wat de IDE met een cam doet, kan een Python-programma ook doen.

Twee manieren om te beginnen. De meegeleverde openmv opdrachtregeltool opent een viewer en is de snelste manier om te verifiëren dat het pakket geïnstalleerd is en een cam bereikbaar is. De openmv.Camera klasse is het toegangspunt voor Python-code die zelf een cam wil aansturen – headless vastlegging, geautomatiseerde testopstellingen, aangepaste desktop-GUI’s, of elke andere applicatie die de IDE niet dekt.

13.3.1. Installeren

Het pakket staat op PyPI

pip install openmv

Python 3.12 of nieuwer is vereist. De installatie haalt zijn afhankelijkheden automatisch binnen: pyserial voor het USB-serieel-transport, numpy voor framedecodering, pygame voor de CLI-viewer, en pyelftools voor de profiler.