v4.5.3

v4.5.3 to duże wydanie: autofokus OV5640, rysowanie linii z antyaliasingiem, zintegrowany z głównym drzewem sprzętowy dekoder JPEG, znaczne rozszerzenie możliwości i.MX RT (RT1060) oraz szeroki zestaw poprawek kamery/ISP. Kilka rzadko używanych metod obrazu zostało usuniętych, a niektóre API ISP/wyświetlacza uległy zmianie — zapoznaj się z przełomowymi zmianami poniżej.

Najważniejsze zmiany

  • Autofokus OV5640 — włączony na OpenMV 4 / 4 Plus / RT1060 (sensor.ioctl(sensor.IOCTL_TRIGGER_AUTO_FOCUS)), wraz z przykładem.

  • Rysowanie draw_line() z antyaliasingiem oraz zintegrowany z głównym drzewem sprzętowy dekoder JPEG STM32 (szybsza dekompresja JPEG).

  • OpenMV RT1060 zyskał ulab, operacje ISP, set_framerate() / set_frame_callback(), znacznie większy bufor ramki oraz sterownik CAN.

  • Zmiana przełomowa: metody Image.div() / cartoon() / mul() zostały usunięte, a niektóre API ISP/wyświetlacza uległy zmianie — zobacz przełomowe zmiany.

Nowe funkcje

  • Autofokus OV5640 — oprogramowanie układowe autofokusa jest włączone na OPENMV4, OPENMV4P oraz OPENMV RT1060; wyzwól je za pomocą sensor.ioctl(sensor.IOCTL_TRIGGER_AUTO_FOCUS). Dodano nowy przykład 07-Sensor-Control/autofocus.py.

  • Rysowanie linii z antyaliasingiem — draw_line() zyskało antyaliasing.

  • Niestandardowe kontrolery wyświetlaczy SPI — SPIDisplay przyjmuje teraz słowo kluczowe controller= i udostępnia hak bus_write do niestandardowych sekwencji inicjalizacji/poleceń.

  • Ulepszenie Image.ccm() — przyjmuje teraz zagnieżdżone macierze 3x3 / 4x3 / 3x4 / 4x4 oraz tablice ulab (z opcjonalnym wierszem przesunięcia dla każdego kanału); dodano przykład korekcji kolorów.

  • Przechwytywanie JPEG na i.MX RT — przechwytywanie sensor.JPEG na Arduino Portenta/Nicla Vision/Giga, a także set_framerate() i set_frame_callback() na porcie mimxrt.

  • Walidacja modeli TFLite — modele zawierają teraz skrót porządku operatorów oraz rozmiar zbioru operatorów.

  • WiFi — dodano stałe trybów zabezpieczeń CYW43; nowe przykładowe skrypty sterowania płytą i.MX RT (Pin/ADC/CAN/I2C/PWM/SPI/UART/…).

Inne zmiany i ulepszenia

  • MicroPython zaktualizowany do 1.22; CMSIS zaktualizowany do 5.9.0.

  • Zintegrowany z głównym drzewem sprzętowy dekoder JPEG STM32 — szybsza dekompresja JPEG na wbudowanym kodeku.

  • Zoptymalizowano Image.invert() / negate() oraz binarne/matematyczne operacje na obrazach (intrinsics CMSIS).

  • Biblioteki rpc i vl53l1x zostały uprzenośnione (używają machine / time zamiast pyb), dzięki czemu działają na portach innych niż STM32.

  • Przyspieszany przez DMA memcpy bufora ramki na OpenMV H7 / H7 Plus / Pro / Pure Thermal oraz Arduino Giga / Nicla Vision / Portenta H7; STM32 skanuje teraz urządzenia I2C raz na skanowanie, co przyspiesza rozruch.

Poprawki błędów

Kamera i sensory:

  • Naprawiono XCLK kamery STM32, zapewniając prawdziwy 50% cykl pracy, oraz błąd występujący przy ustawieniu częstotliwości zegara kamery na zero; naprawiono kadrowanie+transpozycję Bayer, przesunięcie kolorów YUV422 oraz set_windowing() na porcie mimxrt.

  • Naprawiono sondowanie identyfikatora układu GC2145 oraz hmirror/vflip na obróconych montażach; naprawiono PAJ6100 na RT1062 oraz przepełnienie bufora SPI PixArt PAJ7620/PAW3902.

Przetwarzanie obrazu:

  • Naprawiono przycinanie roi w find_rects(), obcinanie ułamkowego przesunięcia w morph(), domyślne wartości kontrastu/jasności w image.gamma(), przesunięcia A/B w get_threshold() na RGB565 oraz dekodowanie JPEG wymiarów niebędących wielokrotnością 8.

System i biblioteki:

  • machine.LED.value() bez argumentu zwraca teraz stan diody LED zamiast go czyścić; naprawiono deinicjalizację SPI SSEL na współdzielonej magistrali, machine.deepsleep() na RT1062, awarię TF przy brakujących operatorach oraz automatyczną aktywację karty sieciowej WINC1500/ninaw10 przy connect().

Obsługa sprzętu i płyt

  • OpenMV RT1060 — włączono ulab i operacje ISP, większy bufor ramki (10M→20M) / fb_alloc (2M→11M), przywrócono sterownik CAN, więcej sterty.

  • Arduino GIGA — obsługa kamery GC2145, z automatycznym wykrywaniem GC2145/OV5640 (współdzielą adres I2C).

  • i.MX RT — obsługa przechwytywania sensor.JPEG.

Przełomowe zmiany w API

Widoczne dla użytkownika zmiany przełomowe w API między v4.5.2 a v4.5.3. Zakres: moduły C Pythona w modules/ oraz biblioteki Pythona w scripts/libraries/.

Każda zmiana jest oznaczona swoim wpływem:

  • minor — wąskie API; dotyczy tylko skryptów, które go używały.

  • behavior — to samo API, inne wyniki; ponownie sprawdź dostrojone skrypty.

Zmiany są pogrupowane według wpływu w tej kolejności. Jeśli chcesz po prostu przenieść swój kod, przejdź do listy kontrolnej migracji na końcu. Każdy skrót commita prowadzi do jego diffa na GitHubie.

Usunięte metody obrazu (minor)

Metody Image.div(), Image.cartoon() (oraz jej przykład) i Image.mul() zostały usunięte.

Commity: 7c932602e, 055a468b8, 4fe7fb63b

API modułu wyświetlacza (minor)

Usunięto starszy zamiennik nazwy modułu udisplay — moduł jest rejestrowany wyłącznie jako display. Metody dsi_write() / dsi_read() dostępne tylko dla DSI zostały zastąpione przez bus_write() / bus_read(), które są teraz dostępne na wszystkich kontrolerach wyświetlaczy.

Commity: 7df6694c3, 7d1f378a0

Zmiany API MQTT i tf.regression (minor)

Klasa MQTTClient biblioteki mqtt została przebudowana: port jest teraz wymagany, dodano nowe słowa kluczowe konstruktora ssl_params / callback oraz argument timeout w connect(), usunięto stare domyślne wartości ssl= / port=0, a check_msg() jest teraz nieblokujące. tf.regression() zostało przepisane — jego sygnatura to teraz regression(model, array) i obsługuje modele 1D/2D/3D oraz skwantyzowane (int8).

Commity: d12874c63, c5ec576c1

Zmiany zachowania ISP / sensora (behavior)

Image.awb() zostało przebudowane — tryb gray-world (domyślny) kontra white-patch (max=True) jest teraz jawny, a argument max oraz argumenty gamma / contrast / brightness metody Image.gamma() są teraz wyłącznie słowami kluczowymi (wywołania pozycyjne muszą zostać zaktualizowane). Transpozycja obrazu jest teraz wyłączona dla YUV422 (wcześniej dawała nieprawidłowy wynik), a przesunięcie kolorów YUV422 zostało skorygowane tak, by odpowiadało Bayer. Ścieżka JPEG STM32 zgłasza teraz błąd przy niezgodności geometrii JPEG zamiast tworzyć uszkodzony obraz, a tryb AP WiFi stosuje teraz domyślny tryb zabezpieczeń na portach STM32 oraz i.MX RT.

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

Lista kontrolna migracji

Dla czystego przeniesienia do v4.5.3 typowa praca to:

  1. Zaprzestań używania Image.div() / cartoon() / mul() (usunięte metody).

  2. Importuj moduł wyświetlacza jako display i przełącz dsi_write/ dsi_read na bus_write/bus_read (zmiana API wyświetlacza).

  3. Zaktualizuj konstruowanie MQTTClient (port jest wymagany; ssl_params/callback) oraz wszelkie wywołania tf.regression() (zmiany API bibliotek).

  4. Przekazuj argumenty max w awb() oraz gamma/contrast/ brightness w gamma() jako argumenty słów kluczowych i ponownie sprawdź założenia dotyczące YUV422/transpozycji oraz zabezpieczeń trybu AP (zmiany ISP/sensora).