v4.0.0#

v4.0.0 je hlavní vydání v3 → v4. Zavádí moderní API sensor pro vícesnímkové bufferování (dvojité / trojité bufferování a video FIFO), callback při dokončení snímku, modul Bluetooth (stack NimBLE) s podporou Portenty, první ovladač kamery MT9M114, snímání z kamery odlehčené přes MDMA, podporu Bayer/JPEG v image.draw_image() a skok na MicroPython 1.15. Starší režim streamování byl odstraněn a sensor.set_windowing() byl přepracován — přečtěte si nekompatibilní změny níže.

Hlavní novinky#

  • Vícesnímkové bufferování — sensor získává dvojité bufferování, trojité bufferování a režim video FIFO pro vyšší a plynulejší snímkovou frekvenci.

  • Callback při dokončení snímku — zaregistrujte callback, který se spustí, jakmile je nový snímek připraven, pro neblokující snímací pipeline.

  • Bluetooth — modul bluetooth postavený na stacku NimBLE, povolený na Arduino Portenta H7 (s příkladem BLE).

  • MT9M114 — první ovladač senzoru kamery.

  • Rychlejší snímání — odlehčení snímání dat z kamery přes MDMA; draw_image() nyní přijímá zdroje/cíle ve formátu Bayer a JPEG.

  • MicroPython 1.15 — přiložený MicroPython byl aktualizován z 1.13 na 1.15.

  • Nekompatibilní: starší režim streamování byl odstraněn a sensor.set_windowing() byl přepracován — viz nekompatibilní změny.

Nové funkce#

  • Vícenásobné bufferování senzoru — přidány sensor.set_framebuffers() / sensor.get_framebuffers() a režimy SINGLE_BUFFER / DOUBLE_BUFFER / TRIPLE_BUFFER / VIDEO_FIFO, plus sensor.get_frame_available() pro dvojité, trojité a video-FIFO snímání.

  • Callback při dokončení snímku — přidán sensor.set_frame_callback(), takže Python callback se spustí při dokončení každého nového snímku.

  • Bluetooth — přidán modul bluetooth postavený na stacku NimBLE (submodul NimBLE, ovladač CYW-BT), povolený na Arduino Portenta H7 s příkladem BLE.

  • MT9M114 — přidán první ovladač senzoru kamery MT9M114.

  • draw_image — přidána podpora debayeringu a kopírování JPEG, takže image.draw_image() přijímá zdrojové/cílové obrazy ve formátu Bayer a JPEG.

  • Odlehčení snímání přes MDMA — snímání dat z kamery je odlehčeno na MDMA pro vyšší propustnost.

  • Argument barevné palety lze nyní zakázat předáním -1 (jelikož None je vyhrazeno jako platný argument).

Další změny a vylepšení#

  • Přechod na novou softwarovou implementaci I2C; sladění s upstream MicroPythonem; konfigurace ulab pro jednotlivé desky; povoleny základní vestavěné moduly pro OpenMV 2; spravedlivější zamykání čtení snímkového bufferu; podpora mutexů rozšířena na Cortex-M0/M0+ s timeoutem zámku.

Opravy chyb#

Kamera a zpracování obrazu:

  • Opravena spolehlivost inicializace FLIR Lepton na desce Pure Thermal, zpracování JPEG bufferu / pauzy u ImageIO, nastavení vflip/hmirror u HM01B0, vyprázdnění JPEG bufferu při zneplatnění obrazu a příznak cropped, který byl nastaven při neplatné velikosti snímku.

Systém a konektivita:

  • Opraveno vyprazdňování USB příkazů a příkaz reset-to-bootloader, inicializace mutexu, zdroj hodin UART, define kódové stránky FatFS, zpracování ACK mimo pásmo u WINC1500, ladění WiFi a USB PID u Nano33; izolovány vyhrazené analogové pady.

Hardware a podpora desek#

  • MT9M114 senzor kamery (první ovladač).

  • Arduino Portenta H7 — povoleno Bluetooth (NimBLE) s příkladem BLE.

  • Arduino Nano RP2040 Connect / Nano 33 BLE Sense — příznak WiFi-debug zakázán tam, kde není podporován; přidán příklad blikání; oprava USB PID.

Nekompatibilní změny API#

Uživatelsky viditelné nekompatibility API mezi v3.9.4 a v4.0.0. Rozsah: Python C-moduly v modules/ a Python knihovny v scripts/libraries/.

Každá změna je označena svým dopadem:

  • major — ovlivňuje většinu skriptů; téměř jistě budete muset upravit kód.

  • minor — úzké API; ovlivňuje pouze skripty, které jej používaly.

  • behavior — stejné API, jiné výsledky; znovu zkontrolujte doladěné skripty.

Změny jsou seskupeny podle dopadu v tomto pořadí. Pokud chcete jen upravit svůj kód, přejděte na kontrolní seznam migrace na konci. Každý hash commitu odkazuje na svůj diff na GitHubu.

Odstraněn režim streamování (major)#

Starší režim streamování senzoru byl odstraněn ve prospěch nového API pro vícesnímkové bufferování. Kód, který povoloval režim streamování, musí přejít na sensor.set_framebuffers() s DOUBLE_BUFFER / TRIPLE_BUFFER / VIDEO_FIFO a snímání řídit pomocí sensor.snapshot() / sensor.get_frame_available().

Commity: a42f3a647

sensor.set_windowing() přepracován (behavior)#

sensor.set_windowing() byl výrazně zpružněn: nyní přijímá více forem argumentů (n-tici oblasti, nebo šířku/výšku vystředěnou, nebo x, y, w, h) a okno vyhodnocuje relativně k aktuálnímu rozlišení. Skripty, které předávaly argumenty oříznutí ve starém pevném tvaru, mohou vybrat jinou oblast a měly by být znovu zkontrolovány.

Commity: 3e9c43554

MicroPython 1.13 → 1.15 (behavior)#

Přiložené jádro MicroPythonu bylo aktualizováno z 1.13 na 1.15 (přes 1.14). Chování standardní knihovny a jazyka odpovídá upstream MicroPythonu 1.15; znovu zkontrolujte skripty, které závisí na chování micropython / standardních modulů specifickém pro danou verzi.

Commity: 364eea6c7, 26c5376b0

Odstraněn argument update_jpeg_buffer u ImageIO (minor)#

Aktualizace JPEG bufferu u ImageIO byla přepracována tak, aby se buffer odvozoval z argumentu zdrojového obrazu, a explicitní argument update_jpeg_buffer byl odstraněn. Skripty, které předávaly update_jpeg_buffer do ImageIO, musí tento argument vypustit.

Commity: 5c6937bd1

Kontrolní seznam migrace#

Pro čistý přechod na v4.0.0 je typická práce následující:

  1. Nahraďte jakékoli použití odstraněného režimu streamování novým API pro vícenásobné bufferování sensor.set_framebuffers() (odstraněn režim streamování).

  2. Znovu zkontrolujte volání sensor.set_windowing() vůči přepracovanému, pružnějšímu zpracování argumentů (změna oříznutí).

  3. Znovu ověřte skripty závisející na chování MicroPythonu specifickém pro danou verzi vůči MicroPythonu 1.15 (povýšení MicroPythonu).

  4. Vypusťte argument update_jpeg_buffer z volání ImageIO (změna ImageIO).

Všechny ostatní skripty běží beze změny.