v2.8.0#

v2.8.0 es una versión enorme. Pone en marcha la OpenMV Cam H7 (STM32H7) con un codificador JPEG por hardware y ADC/DAC del H7, una enorme renovación de la API de image (grosor/relleno de dibujo, operaciones matemáticas/binarias, muchos filtros nuevos, umbralización de Otsu), hilos de MicroPython y el módulo de versión omv. Se fijó el orden de análisis de argumentos de Python y se eliminó image.mask_ellipse() — lee los cambios incompatibles a continuación.

Destacados#

  • OpenMV Cam H7 — nueva placa STM32H7 con un codificador JPEG por hardware y ADC / DAC del H7.

  • Renovación de image — grosor de línea, rellenos de formas, draw_arrow() / draw_image(), operaciones matemáticas/binarias completas y muchos filtros nuevos.

  • Umbralización de Otsu — histogram.get_threshold() y un objeto Threshold.

  • Hilos — soporte de _thread de MicroPython.

  • Módulo omv — información de versión / placa.

  • Incompatible: el orden de los argumentos posicionales de Python ahora es estricto y se eliminó image.mask_ellipse() — consulta los cambios incompatibles.

Nuevas funciones#

  • OpenMV Cam H7 — soporte para la placa STM32H7 con un codificador JPEG por hardware, ADC del H7 y DAC del H7.

  • Dibujo — se añadieron el thickness de línea, el fill de formas (rectángulo / círculo), el scale / kerning de texto, una palabra clave mono_space en draw_string(), image.draw_arrow() y image.draw_image() (dibujo de sprites / máscaras).

  • Operaciones matemáticas — se añadieron add(), sub(), mul(), div(), min(), max(), difference(), blend(), replace() (con hmirror / vflip / mask) y remove_shadows(); las operaciones básicas ahora aceptan un valor escalar/de color aplicado a todos los píxeles.

  • Binario / morfología — un nuevo tipo de imagen binaria y binary(); las operaciones de línea y erode() / dilate() aceptan máscaras; se añadieron open() / close() / top_hat() / black_hat().

  • Filtros — se añadieron cartoon, flood_fill, bilateral, laplacian, los alias blur / gaussian_blur y la ecualización de histograma adaptativa (histeq(adaptive=, clip_limit=, mask=)).

  • Estadísticas — get_statistics() / get_histogram() aceptan una lista de umbrales de color e invert; se añadieron el histogram.get_threshold() de Otsu y un objeto Threshold.

  • CMSIS CNN — se añadió image.classify_object() con un ejemplo cnn.py (reemplazado por el módulo nn en la v3.0.0).

  • Hilos — se habilitó el módulo _thread de MicroPython.

  • Módulo omv — se añadió información de versión (version_string, arch, board_type, board_id); se habilitaron el bus I2C4 de machine y las funciones especiales matemáticas (erf, gamma, …); se añadieron ejemplos de motor-shield y muchos scripts de ejemplo nuevos.

Otros cambios y mejoras#

  • El reloj externo del sensor del H7 se redujo a 48 MHz (mejor calidad de imagen, menor FPS); la calidad JPEG baja/alta ahora es configurable por placa (y ajustada para el H7); se añadió un gating de funciones imlib_config.h por placa (todas las funciones de imagen permanecen habilitadas en el firmware de fábrica); se actualizó el MicroPython incluido.

Correcciones de errores#

Procesamiento de imágenes:

  • Se corrigieron image.save() sin extensión de archivo, el mapeo de gain_db / gain_db_ceiling para el OV2640 / OV7725 / OV9650 / MT9V034, la ganancia excesiva en sharpen(), el ruido en los bordes morfológicos, una división por cero en una operación de imagen y un fallo por desbordamiento de pila con un tamaño de kernel de filtro demasiado grande (ahora un error limpio).

Sistema:

  • Se protegió el búfer USB VCP con una sección atómica (corrupción serie, #313), se corrigieron la conectividad USB en Windows, el montaje del sistema de archivos de la memoria flash interna si falla la tarjeta SD, el valor PLLP de set_frequency() de cpufreq y un error de flasheo de firmware del gestor de arranque (bootloader).

Hardware y soporte de placas#

  • OpenMV Cam H7 (STM32H7) — nueva placa con un codificador JPEG por hardware y ADC / DAC del H7.

  • machine — se habilitó el bus I2C4.

Cambios incompatibles en la API#

Rupturas de la API visibles para el usuario entre v2.7.0 y v2.8.0. Alcance: módulos C de Python en modules/ y bibliotecas de Python en scripts/libraries/.

Ambos cambios incompatibles son minor y solo afectan a los scripts que usaban la función relevante. Cada hash de commit enlaza a su diff en GitHub.

El orden de los argumentos posicionales de Python ahora es estricto (minor)#

El análisis de argumentos en los módulos C de Python (image / sensor / fir / gif / lcd / mjpeg) ahora lee los argumentos posicionales antes que las palabras clave y fija el orden posicional. Combinado con las nuevas palabras clave en los métodos de dibujo (draw_line() / draw_rectangle() / draw_circle() / draw_string() / draw_cross() / draw_keypoints() que ganaron thickness / fill / scale / size), el código que pasaba parámetros fuera de orden de forma posicional — o que pasaba un color posicional después de uno de los nuevos argumentos — debe usar argumentos por palabra clave o el orden posicional documentado.

Commits: e0e112468, fc74e70c3

image.mask_ellipse() eliminado (minor)#

Se eliminó image.mask_ellipse(). Los scripts que lo llamaban deben eliminar la llamada o usar una ROI / imagen de máscara explícita en su lugar.

Commits: d7159fba3

Lista de comprobación de migración#

Pasa los argumentos por palabra clave (o en el orden posicional documentado), especialmente color en los métodos de dibujo (el cambio de orden de argumentos), y elimina las llamadas a image.mask_ellipse() (la eliminación de mask_ellipse). Todos los demás scripts se ejecutan sin cambios.