v4.0.0

v4.0.0 to główne wydanie v3 → v4. Wprowadza nowoczesne API buforowania wielu ramek sensor (podwójne / potrójne buforowanie oraz wideo FIFO), wywołanie zwrotne zakończenia ramki, moduł Bluetooth (stos NimBLE) z obsługą Portenta, początkowy sterownik kamery MT9M114, przechwytywanie obrazu z odciążeniem MDMA, obsługę Bayer/JPEG w image.draw_image() oraz skok do MicroPython 1.15. Usunięto starszy tryb strumieniowania, a sensor.set_windowing() został przerobiony — przeczytaj poniższe przełomowe zmiany.

Najważniejsze zmiany

  • Buforowanie wielu ramek — sensor zyskuje podwójne buforowanie, potrójne buforowanie oraz tryb wideo FIFO dla wyższej, płynniejszej liczby klatek.

  • Wywołanie zwrotne zakończenia ramki — zarejestruj wywołanie zwrotne uruchamiane, gdy nowa ramka jest gotowa, dla nieblokujących potoków przechwytywania.

  • Bluetooth — moduł bluetooth zbudowany na stosie NimBLE, włączony na Arduino Portenta H7 (z przykładem BLE).

  • MT9M114 — początkowy sterownik sensora kamery.

  • Szybsze przechwytywanie — odciążenie MDMA dla przechwytywania danych kamery; draw_image() akceptuje teraz źródła/cele Bayer i JPEG.

  • MicroPython 1.15 — dołączony MicroPython został zaktualizowany z 1.13 do 1.15.

  • Przełomowe: usunięto starszy tryb strumieniowania, a sensor.set_windowing() został przerobiony — zobacz przełomowe zmiany.

Nowe funkcje

  • Wielobuforowanie sensora — dodano sensor.set_framebuffers() / sensor.get_framebuffers() oraz tryby SINGLE_BUFFER / DOUBLE_BUFFER / TRIPLE_BUFFER / VIDEO_FIFO, a także sensor.get_frame_available() dla przechwytywania podwójnego, potrójnego i wideo FIFO.

  • Wywołanie zwrotne zakończenia ramki — dodano sensor.set_frame_callback(), dzięki czemu wywołanie zwrotne Pythona uruchamia się po zakończeniu każdej nowej ramki.

  • Bluetooth — dodano moduł bluetooth oparty na stosie NimBLE (submoduł NimBLE, sterownik CYW-BT), włączony na Arduino Portenta H7 wraz z przykładem BLE.

  • MT9M114 — dodano początkowy sterownik sensora kamery MT9M114.

  • draw_image — dodano obsługę debayerowania i kopiowania JPEG, dzięki czemu image.draw_image() akceptuje obrazy źródłowe/docelowe Bayer i JPEG.

  • Odciążenie przechwytywania MDMA — przechwytywanie danych kamery jest odciążane na MDMA dla wyższej przepustowości.

  • Argument palety kolorów można teraz wyłączyć, przekazując -1 (ponieważ None jest zarezerwowane jako prawidłowy argument).

Pozostałe zmiany i ulepszenia

  • Przełączono na nową programową implementację I2C; zsynchronizowano z głównym repozytorium MicroPython; konfiguracja ulab per płytka; włączono podstawowe wbudowane moduły dla OpenMV 2; sprawiedliwsze blokowanie odczytu bufora ramki; obsługa muteksów rozszerzona na Cortex-M0/M0+ z limitem czasu blokady.

Poprawki błędów

Kamera i obrazowanie:

  • Naprawiono niezawodność inicjalizacji FLIR Lepton na płytce Pure Thermal, obsługę bufora JPEG / pauzy ImageIO, ustawienia vflip/hmirror HM01B0, opróżnianie bufora JPEG przy unieważnieniu obrazu oraz flagę cropped, która była ustawiana, gdy framesize był nieprawidłowy.

System i łączność:

  • Naprawiono opróżnianie komend USB i komendę resetu do bootloadera, inicjalizację muteksów, źródło zegara UART, definicję strony kodowej FatFS, obsługę ACK poza pasmem WINC1500, debugowanie WiFi oraz USB PID Nano33; odizolowano dedykowane pady analogowe.

Sprzęt i obsługa płytek

  • Sensor kamery MT9M114 (początkowy sterownik).

  • Arduino Portenta H7 — włączony Bluetooth (NimBLE) z przykładem BLE.

  • Arduino Nano RP2040 Connect / Nano 33 BLE Sense — flaga debugowania WiFi wyłączona tam, gdzie nie jest obsługiwana; dodano przykład blinky; poprawka USB PID.

Przełomowe zmiany API

Widoczne dla użytkownika zmiany API między v3.9.4 a v4.0.0. Zakres: moduły C Pythona w modules/ oraz biblioteki Pythona w scripts/libraries/.

Każda zmiana jest oznaczona swoim wpływem:

  • major — dotyczy większości skryptów; niemal na pewno konieczne będzie przeniesienie kodu.

  • minor — wąskie API; dotyczy tylko skryptów, które z niego korzystały.

  • behavior — to samo API, inne wyniki; sprawdź ponownie 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 hash commita prowadzi do jego diffu na GitHubie.

Usunięto tryb strumieniowania (major)

Starszy tryb strumieniowania sensora został usunięty na rzecz nowego API buforowania wielu ramek. Kod, który włączał tryb strumieniowania, musi przejść na sensor.set_framebuffers() z DOUBLE_BUFFER / TRIPLE_BUFFER / VIDEO_FIFO i sterować przechwytywaniem za pomocą sensor.snapshot() / sensor.get_frame_available().

Commity: a42f3a647

sensor.set_windowing() przerobiony (behavior)

sensor.set_windowing() został uczyniony znacznie bardziej elastycznym: akceptuje teraz wiele form argumentów (krotkę obszaru, lub wyśrodkowaną szerokość/wysokość, lub x, y, w, h) i rozwiązuje okno względem bieżącej rozdzielczości. Skrypty, które przekazywały argumenty okienkowania w starej, sztywnej formie, mogą wybrać inny obszar i powinny zostać ponownie sprawdzone.

Commity: 3e9c43554

MicroPython 1.13 → 1.15 (behavior)

Dołączony rdzeń MicroPython został zaktualizowany z 1.13 do 1.15 (poprzez 1.14). Zachowanie biblioteki standardowej i języka jest zgodne z głównym MicroPython 1.15; sprawdź ponownie skrypty zależne od zachowania micropython / modułów standardowych specyficznego dla wersji.

Commity: 364eea6c7, 26c5376b0

Usunięto argument update_jpeg_buffer ImageIO (minor)

Aktualizacja bufora JPEG ImageIO została przerobiona tak, aby wyprowadzać bufor z argumentu źródłowego obrazu, a jawny argument update_jpeg_buffer został usunięty. Skrypty, które przekazywały update_jpeg_buffer do ImageIO, muszą porzucić ten argument.

Commity: 5c6937bd1

Lista kontrolna migracji

Aby czysto przenieść się na v4.0.0, typowa praca to:

  1. Zastąp wszelkie użycia usuniętego trybu strumieniowania nowym API wielobuforowania sensor.set_framebuffers() (usunięto tryb strumieniowania).

  2. Sprawdź ponownie wywołania sensor.set_windowing() względem przerobionej, bardziej elastycznej obsługi argumentów (zmiana okienkowania).

  3. Zweryfikuj ponownie skrypty zależne od zachowania MicroPython specyficznego dla wersji względem MicroPython 1.15 (aktualizacja MicroPython).

  4. Porzuć argument update_jpeg_buffer z wywołań ImageIO (zmiana ImageIO).

Wszystkie pozostałe skrypty działają bez zmian.