v4.5.3

v4.5.3 je rozsáhlé vydání: autofokus OV5640, kreslení čar s vyhlazováním, do hlavní větve začleněný hardwarový JPEG dekodér, výrazné rozšíření možností i.MX RT (RT1060) a široká sada oprav kamery/ISP. Několik zřídka používaných metod obrazu bylo odstraněno a některá ISP/display API se změnila — přečtěte si níže uvedené zásadní změny.

Hlavní novinky

  • Autofokus OV5640 — povolen na OpenMV 4 / 4 Plus / RT1060 (sensor.ioctl(sensor.IOCTL_TRIGGER_AUTO_FOCUS)), s příkladem.

  • Vyhlazené (anti-aliased) draw_line() a do hlavní větve začleněný hardwarový JPEG dekodér STM32 (rychlejší dekomprese JPEG).

  • OpenMV RT1060 získalo ulab, ISP operace, set_framerate() / set_frame_callback(), mnohem větší snímkový buffer (frame buffer) a CAN ovladač.

  • Zásadní změna: Image.div() / cartoon() / mul() byly odstraněny a některá ISP/display API se změnila — viz zásadní změny.

Nové funkce

  • Autofokus OV5640 — firmware autofokusu je povolen na OPENMV4, OPENMV4P a OPENMV RT1060; spustíte jej pomocí sensor.ioctl(sensor.IOCTL_TRIGGER_AUTO_FOCUS). Byl přidán nový příklad 07-Sensor-Control/autofocus.py.

  • Kreslení čar s vyhlazováním — draw_line() získalo vyhlazování (anti-aliasing).

  • Vlastní SPI display kontroléry — SPIDisplay nyní přijímá klíčové slovo controller= a vystavuje hook bus_write pro vlastní inicializační/příkazové sekvence.

  • Vylepšení Image.ccm() — nyní přijímá vnořené matice 3x3 / 4x3 / 3x4 / 4x4 a ulab pole (s volitelným řádkem offsetu pro každý kanál); přidán příklad korekce barev.

  • Záznam JPEG na i.MX RT — záznam sensor.JPEG na Arduino Portenta/Nicla Vision/Giga, plus set_framerate() a set_frame_callback() na portu mimxrt.

  • Validace TFLite modelu — modely nyní nesou hash pořadí operátorů a velikost množiny operátorů.

  • WiFi — přidány konstanty režimů zabezpečení CYW43; nové příklady skriptů pro řízení desky i.MX RT (Pin/ADC/CAN/I2C/PWM/SPI/UART/…).

Další změny a vylepšení

  • MicroPython aktualizován na 1.22; CMSIS aktualizováno na 5.9.0.

  • Do hlavní větve začleněný hardwarový JPEG dekodér STM32 — rychlejší dekomprese JPEG na čipovém kodeku.

  • Optimalizovány Image.invert() / negate() a binární/matematické operace s obrazem (CMSIS intrinsics).

  • Knihovny rpc a vl53l1x byly upraveny pro přenositelnost (místo pyb používají machine / time), takže běží i na portech mimo STM32.

  • DMA akcelerovaný memcpy snímkového bufferu na OpenMV H7 / H7 Plus / Pro / Pure Thermal a Arduino Giga / Nicla Vision / Portenta H7; STM32 nyní skenuje I2C zařízení jednou za skenování pro rychlejší start.

Opravy chyb

Kamera a senzory:

  • Opraveno XCLK kamery STM32 na skutečný 50% pracovní cyklus a chyba, když je frekvence hodin kamery nastavena na nulu; opraveny Bayer crop+transpozice, posun barev YUV422 a set_windowing() na portu mimxrt.

  • Opraveno čtení chip-ID GC2145 a hmirror/vflip na otočených úchytech; opraveno PAJ6100 na RT1062 a přetečení SPI bufferu PixArt PAJ7620/PAW3902.

Zpracování obrazu:

  • Opraveno ořezávání roi v find_rects(), zkracování zlomkového offsetu v morph(), výchozí hodnoty kontrastu/jasu v image.gamma(), A/B offsety v get_threshold() na RGB565 a dekódování JPEG rozměrů, které nejsou násobkem 8.

Systém a knihovny:

  • machine.LED.value() bez argumentu nyní vrací stav LED místo jeho vymazání; opraven deinit SPI SSEL na sdílené sběrnici, machine.deepsleep() na RT1062, pád TF při chybějících operátorech a automatická aktivace NIC WINC1500/ninaw10 při connect().

Hardware a podpora desek

  • OpenMV RT1060 — povoleny ulab a ISP operace, větší snímkový buffer (10M→20M) / fb_alloc (2M→11M), obnoven CAN ovladač, více haldy.

  • Arduino GIGA — podpora kamery GC2145, s automatickou detekcí GC2145/OV5640 (sdílejí I2C adresu).

  • i.MX RT — podpora záznamu sensor.JPEG.

Zásadní změny API

Uživatelsky viditelné změny API mezi v4.5.2 a v4.5.3. Rozsah: Python C-moduly v modules/ a Python knihovny v scripts/libraries/.

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

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

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

Změny jsou seskupeny podle dopadu v tomto pořadí. Pokud chcete jen přenést 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é metody obrazu (minor)

Image.div(), Image.cartoon() (a její příklad) a Image.mul() byly odstraněny.

Commits: 7c932602e, 055a468b8, 4fe7fb63b

API modulu display (minor)

Starší záložní název modulu udisplay byl odstraněn — modul je registrován pouze jako display. Metody dsi_write() / dsi_read() určené pouze pro DSI byly nahrazeny metodami bus_write() / bus_read(), které jsou nyní dostupné na všech display kontrolérech.

Commits: 7df6694c3, 7d1f378a0

Změny API MQTT a tf.regression (minor)

MQTTClient knihovny mqtt byl přepracován: port je nyní povinný, byla přidána nová konstruktorová klíčová slova ssl_params / callback a argument timeout u connect(), staré výchozí hodnoty ssl= / port=0 byly odstraněny a check_msg() je nyní neblokující. tf.regression() byla přepsána — její signatura je nyní regression(model, array) a zpracovává 1D/2D/3D a kvantované (int8) modely.

Commits: d12874c63, c5ec576c1

Změny chování ISP / senzoru (behavior)

Image.awb() byla přepracována — gray-world (výchozí) vs white-patch (max=True) je nyní explicitní a argument max plus argumenty gamma / contrast / brightness metody Image.gamma() jsou nyní pouze klíčové (poziční volání musí být upravena). Transpozice obrazu je nyní zakázána pro YUV422 (dříve produkovala nesprávný výstup) a posun barev YUV422 byl opraven tak, aby odpovídal Bayeru. Cesta JPEG na STM32 nyní vyvolá chybu při nesouladu geometrie JPEG místo produkce poškozeného obrazu a režim WiFi AP nyní aplikuje výchozí režim zabezpečení na portech STM32 a i.MX RT.

Commits: 36d5cecbd, 00500ccde, c1eeaefd6, 333fb2b5f, 55cab8733, c7d40f6af

Kontrolní seznam migrace

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

  1. Přestaňte používat Image.div() / cartoon() / mul() (odstraněné metody).

  2. Importujte modul display jako display a přepněte dsi_write/ dsi_read na bus_write/bus_read (změna API display).

  3. Aktualizujte konstrukci MQTTClient (port je povinný; ssl_params/callback) a všechna volání tf.regression() (změny API knihoven).

  4. Předávejte awb() max a gamma() gamma/contrast/ brightness jako klíčové argumenty a znovu zkontrolujte předpoklady YUV422/transpozice a zabezpečení režimu AP (změny ISP/senzoru).