docs: pyb class split + ml audit, display/csi/sensor description expansion

- Split pyb.ADCAll, pyb.PinAF and pyb.TimerChannel into their own pages and
  toctree entries; tighten the host-class descriptions.
- Audit every pyb class (ADC, CAN, DAC, ExtInt, Flash, I2C, LED, Pin, Servo,
  SPI, Timer, UART, USB_HID, USB_VCP) for OpenMV-correct pin maps,
  per-board availability, reformatted examples and shorter line lengths.
- Cross-check ml library docs against scripts/libraries/ml/: keyword-only
  Model(postprocess=...), draw_predictions gains the missing scores= arg
  and "point" format value, mediapipe return shapes corrected, darknet/
  mediapipe _NO_DETECTION empty-tuple noted, remove dead ml.utils.mod.
- Expand descriptions and add runnable examples for csi, sensor, fir, tof,
  imu, omv and the display module + every display class (SPIDisplay,
  RGBDisplay, DSIDisplay, TVDisplay, DisplayData, PWMBacklight); scope
  RGBDisplay's display_on/HDMI note to the Pure Thermal specifically.
- Move the senml example under the initial module description.
- Misc: drop default-channel-8 claim on TVDisplay, fix PWMBacklight pin
  type, smaller fixes on bmi270/dht/ds18x20/espflash/neopixel/ssd1306/
  pca9674a/gt911/romfs/onewire/index/alif/mimxrt.

Author: kwagyeman

docs/library/bmi270.rst

@@ -46,7 +46,8 @@ Classes
 
    ``cs``
       Reserved for SPI mode. Must be left as ``None``; SPI is not
-      currently implemented.
+      currently implemented and supplying a non-I2C bus raises
+      ``ValueError``.
 
    ``address``
       7-bit I2C address of the device. Defaults to ``0x68``; some boards

docs/library/dht.rst

@@ -5,16 +5,14 @@
    :synopsis: DHT11 and DHT22 temperature/humidity sensor driver
 
 The :mod:`dht` module provides drivers for the DHT11 and DHT22 (also known
-as AM2302) low-cost temperature and humidity sensors. The single-wire
-protocol is implemented in C by the underlying port (``machine.dht_readinto``,
-``esp.dht_readinto`` or ``pyb.dht_readinto`` depending on platform).
+as AM2302) low-cost temperature and humidity sensors.
 
 Example::
 
     from machine import Pin
     from dht import DHT22
 
-    d = DHT22(Pin("P4"))
+    d = DHT22(Pin("P7"))
     d.measure()
     print(d.temperature(), d.humidity())
 

docs/library/ds18x20.rst

@@ -15,7 +15,7 @@ Example::
     from onewire import OneWire
     from ds18x20 import DS18X20
 
-    ds = DS18X20(OneWire(Pin("P5")))
+    ds = DS18X20(OneWire(Pin("P7")))
     roms = ds.scan()
 
     ds.convert_temp()

docs/library/espflash.rst

@@ -15,13 +15,17 @@ The driver toggles ``RESET`` and ``GPIO0`` to put the ESP32 into download mode,
 then issues SLIP-framed commands to read the flash size, configure the SPI
 interface, write the firmware image and verify it via an MD5 digest.
 
-Example::
+Example for the Arduino Nano RP2040 Connect (the only OpenMV-supported
+board where ``espflash`` is currently frozen). The NINA-W102's reset and
+boot-strap pins are RP2040 ``GPIO 3`` and ``GPIO 2`` respectively, and
+the NINA's ``UART0`` is wired to RP2040 ``UART1`` (``TX = GPIO 8``,
+``RX = GPIO 9``)::
 
     from machine import Pin, UART
     from espflash import ESPFlash
 
-    reset = Pin("ESP_RESET", Pin.OUT)
-    gpio0 = Pin("ESP_GPIO0", Pin.OUT)
+    reset = Pin(3, Pin.OUT)                                    # NINA RESET
+    gpio0 = Pin(2, Pin.OUT)                                    # NINA GPIO0
     uart = UART(1, 115200, timeout=1000)
 
     esp = ESPFlash(reset, gpio0, uart)

docs/library/index.rst

@@ -211,29 +211,35 @@ on each board. All the modules in *Common*, *Frozen Python helpers*, and
 *Networking helpers* (above) are available on every camera board unless
 otherwise noted.
 
-.. rubric:: OPENMV_N6 (STM32N6)
+.. rubric:: OpenMV N6
 
-OpenMV N6 (STM32N6 --- STMicroelectronics' first NPU-equipped MCU):
+STM32N657 (Cortex-M55 @ 800 MHz) with a 1 GHz on-chip NPU rated at
+600 GOPS INT8. Pairs the NPU with the PAG7936 1 MP global-shutter
+sensor.
 
 * :mod:`pyb` --- functions related to the board
 * :mod:`stm` --- functionality specific to STM32 MCUs
 * :mod:`ssd1306` --- OLED driver
 * :mod:`tb6612` --- TB6612 motor driver
 
-.. rubric:: OPENMV_AE3 (Alif Ensemble E3)
+.. rubric:: OpenMV AE3
 
-OpenMV AE3 (Alif Ensemble E3 MCU):
+Alif Ensemble E3 dual-core SoC: Cortex-M55 @ 400 MHz (HP) plus
+Cortex-M55 @ 160 MHz (HE), with two on-chip NPUs (400 MHz / 204 GOPS HP
+NPU + 160 MHz / 46 GOPS HE NPU).
 
 * :mod:`alif` --- Alif Ensemble SoC functions
 * :mod:`lsm6dsox` --- LSM6DSOX 6-axis IMU
 * :mod:`romfs` --- ROMFS helper utilities
 * :mod:`pca9674a` --- PCA9674A I2C expander driver
 
-.. rubric:: OPENMV_RT1060 (i.MX RT1060)
+.. rubric:: OpenMV Cam RT1062
 
-OpenMV RT1060:
+Low-power machine-vision board around the NXP i.MX RT1062
+(Cortex-M7 @ 600 MHz). Combines USB-C high-speed networking, Wi-Fi /
+Bluetooth and 10/100 Ethernet.
 
-* :mod:`mimxrt` --- functionality specific to NXP i.MXRT
+* :mod:`mimxrt` --- functionality specific to NXP i.MX RT
 * :mod:`dht` --- DHT11 and DHT22 temperature/humidity sensors
 * :mod:`onewire` --- 1-Wire bus protocol
 * :mod:`ds18x20` --- DS18x20 temperature sensor driver
@@ -242,9 +248,11 @@ OpenMV RT1060:
 * :mod:`tb6612` --- TB6612 motor driver
 * :mod:`pca9674a` --- PCA9674A I2C expander driver
 
-.. rubric:: OPENMVPT (Pure Thermal, STM32H7 + DVI/HDMI)
+.. rubric:: OpenMV Pure Thermal
 
-OpenMV Pure Thermal:
+Full-system thermal imaging board around the STM32H743
+(Cortex-M7 @ 480 MHz) with 64 MB external SDRAM, 32 MB QSPI flash, a
+hardware JPEG codec and DVI/HDMI output.
 
 * :mod:`pyb` --- functions related to the board
 * :mod:`stm` --- functionality specific to STM32 MCUs
@@ -257,9 +265,10 @@ OpenMV Pure Thermal:
 * :mod:`ssd1306` --- OLED driver
 * :mod:`tb6612` --- TB6612 motor driver
 
-.. rubric:: OPENMV2 / OPENMV3 / OPENMV4 / OPENMV4P (STM32)
+.. rubric:: OpenMV Cam H7 Plus
 
-Legacy STM32-based OpenMV camera boards:
+STM32H743 (Cortex-M7 @ 480 MHz) with 32 MB external SDRAM, 32 MB QSPI
+flash, a hardware JPEG codec and the OV5640 5MP camera module.
 
 * :mod:`pyb` --- functions related to the board
 * :mod:`stm` --- functionality specific to STM32 MCUs
@@ -270,35 +279,52 @@ Legacy STM32-based OpenMV camera boards:
 * :mod:`ssd1306` --- OLED driver
 * :mod:`tb6612` --- TB6612 motor driver
 
-.. rubric:: ARDUINO_GIGA (STM32H7 + touchscreen)
+.. rubric:: OpenMV Cam H7
 
-Arduino Giga R1 WiFi:
+STM32H743 (Cortex-M7 @ 480 MHz) with 1 MB internal SRAM, 2 MB internal
+flash and a hardware JPEG codec.
 
 * :mod:`pyb` --- functions related to the board
 * :mod:`stm` --- functionality specific to STM32 MCUs
 * :mod:`dht` --- DHT11 and DHT22 temperature/humidity sensors
 * :mod:`onewire` --- 1-Wire bus protocol
+* :mod:`ds18x20` --- DS18x20 temperature sensor driver
 * :mod:`neopixel` --- control of WS2812 / NeoPixel LEDs
-* :mod:`gt911` --- GT911 5-point capacitive touch controller
-* :mod:`ft5x06` --- capacitive touchscreen driver
+* :mod:`ssd1306` --- OLED driver
+* :mod:`tb6612` --- TB6612 motor driver
 
-.. rubric:: ARDUINO_PORTENTA_H7 (STM32H7)
+.. rubric:: OpenMV Cam M7
 
-Arduino Portenta H7:
+STM32F765 (Cortex-M7 @ 216 MHz) with 512 KB internal SRAM and 2 MB
+internal flash. Bundled with the OV7725 sensor.
 
 * :mod:`pyb` --- functions related to the board
 * :mod:`stm` --- functionality specific to STM32 MCUs
 * :mod:`dht` --- DHT11 and DHT22 temperature/humidity sensors
+* :mod:`onewire` --- 1-Wire bus protocol
 * :mod:`ds18x20` --- DS18x20 temperature sensor driver
+* :mod:`neopixel` --- control of WS2812 / NeoPixel LEDs
+* :mod:`ssd1306` --- OLED driver
+* :mod:`tb6612` --- TB6612 motor driver
+
+.. rubric:: OpenMV Cam M4
+
+STM32F427 (Cortex-M4 @ 180 MHz) with 256 KB internal SRAM and 1 MB
+internal flash. Bundled with the OV7725 sensor.
+
+* :mod:`pyb` --- functions related to the board
+* :mod:`stm` --- functionality specific to STM32 MCUs
+* :mod:`dht` --- DHT11 and DHT22 temperature/humidity sensors
 * :mod:`onewire` --- 1-Wire bus protocol
+* :mod:`ds18x20` --- DS18x20 temperature sensor driver
 * :mod:`neopixel` --- control of WS2812 / NeoPixel LEDs
-* :mod:`lora` --- LoRa modem driver
 * :mod:`ssd1306` --- OLED driver
 * :mod:`tb6612` --- TB6612 motor driver
 
-.. rubric:: ARDUINO_NICLA_VISION (STM32H7)
+.. rubric:: Arduino Nicla Vision
 
-Arduino Nicla Vision:
+22.86 × 22.86 mm machine-vision board around the STM32H747AII6
+dual-core SoC: Cortex-M7 @ 400 MHz plus Cortex-M4 @ 200 MHz.
 
 * :mod:`pyb` --- functions related to the board
 * :mod:`stm` --- functionality specific to STM32 MCUs
@@ -308,33 +334,40 @@ Arduino Nicla Vision:
 * :mod:`onewire` --- 1-Wire bus protocol
 * :mod:`neopixel` --- control of WS2812 / NeoPixel LEDs
 
-.. rubric:: ARDUINO_NANO_33_BLE_SENSE (Nordic nRF52840)
+.. rubric:: Arduino Portenta H7
 
-Arduino Nano 33 BLE Sense --- board-specific :doc:`imu <imu>` wrapper
-that selects between the LSM9DS1 (Rev 1) and BMI270 + BMM150 (Rev 2)
-sensor sets, plus:
+66 × 25 mm industrial dev board around the STM32H747XI dual-core SoC:
+Cortex-M7 @ 400 MHz plus Cortex-M4 @ 200 MHz.
 
-* :mod:`ubluepy` --- Bluetooth LE peripheral and central API on the
-  Nordic SoftDevice
-* :mod:`bmi270` --- BMI270 6-axis IMU
-* :mod:`bmm150` --- BMM150 3-axis magnetometer
-* :mod:`lsm9ds1` --- LSM9DS1 9-axis IMU
-* :mod:`hts221` --- HTS221 humidity/temperature sensor
-* :mod:`lps22h` --- LPS22HB/HH pressure sensor
-* :mod:`hs3003` --- HS3003 humidity/temperature sensor
-* :mod:`apds9960` --- proximity, gesture, and color sensor driver
+* :mod:`pyb` --- functions related to the board
+* :mod:`stm` --- functionality specific to STM32 MCUs
 * :mod:`dht` --- DHT11 and DHT22 temperature/humidity sensors
-* :mod:`onewire` --- 1-Wire bus protocol
 * :mod:`ds18x20` --- DS18x20 temperature sensor driver
+* :mod:`onewire` --- 1-Wire bus protocol
 * :mod:`neopixel` --- control of WS2812 / NeoPixel LEDs
+* :mod:`lora` --- LoRa modem driver
+* :mod:`ssd1306` --- OLED driver
+* :mod:`tb6612` --- TB6612 motor driver
 
-.. rubric:: ARDUINO_NANO_RP2040_CONNECT / RPI_PICO (RP2)
+.. rubric:: Arduino Giga R1 WiFi
+
+101 × 53 mm Mega-form-factor board around the STM32H747XI dual-core
+SoC: Cortex-M7 @ 480 MHz plus Cortex-M4 @ 240 MHz, with an on-board
+800x480 touchscreen.
+
+* :mod:`pyb` --- functions related to the board
+* :mod:`stm` --- functionality specific to STM32 MCUs
+* :mod:`dht` --- DHT11 and DHT22 temperature/humidity sensors
+* :mod:`onewire` --- 1-Wire bus protocol
+* :mod:`neopixel` --- control of WS2812 / NeoPixel LEDs
+* :mod:`gt911` --- GT911 5-point capacitive touch controller
+* :mod:`ft5x06` --- capacitive touchscreen driver
 
-RP2040-based boards. The Arduino Nano RP2040 Connect adds a few extra
-companion-chip drivers; the Raspberry Pi Pico ships only with the core
-upstream drivers.
+.. rubric:: Arduino Nano RP2040 Connect
 
-Arduino Nano RP2040 Connect:
+RP2040-based Nano-form-factor board with the U-blox NINA-W102
+Wi-Fi/Bluetooth module. *No longer actively supported; the last OpenMV
+firmware release for this board is retained for archival use.*
 
 * :mod:`espflash` --- ESP32 ROM bootloader firmware flasher
 * :mod:`lsm6dsox` --- LSM6DSOX 6-axis IMU
@@ -343,8 +376,21 @@ Arduino Nano RP2040 Connect:
 * :mod:`ds18x20` --- DS18x20 temperature sensor driver
 * :mod:`neopixel` --- control of WS2812 / NeoPixel LEDs
 
-Raspberry Pi Pico:
+.. rubric:: Arduino Nano 33 BLE Sense
+
+Nordic nRF52840 Nano-form-factor board with the on-board Arduino
+sensor suite. *No longer actively supported; the last OpenMV firmware
+release for this board is retained for archival use.*
 
+* :mod:`ubluepy` --- Bluetooth LE peripheral and central API on the
+  Nordic SoftDevice
+* :mod:`bmi270` --- BMI270 6-axis IMU
+* :mod:`bmm150` --- BMM150 3-axis magnetometer
+* :mod:`lsm9ds1` --- LSM9DS1 9-axis IMU
+* :mod:`hts221` --- HTS221 humidity/temperature sensor
+* :mod:`lps22h` --- LPS22HB/HH pressure sensor
+* :mod:`hs3003` --- HS3003 humidity/temperature sensor
+* :mod:`apds9960` --- proximity, gesture, and color sensor driver
 * :mod:`dht` --- DHT11 and DHT22 temperature/humidity sensors
 * :mod:`onewire` --- 1-Wire bus protocol
 * :mod:`ds18x20` --- DS18x20 temperature sensor driver

docs/library/mimxrt.rst

@@ -12,25 +12,68 @@ Classes
 
 .. class:: Flash()
 
-   Gets the singleton object for accessing the SPI flash memory. This class
-   gives access to the on-board SPI flash memory.
+   Get the singleton object that exposes the user-storage region of the
+   on-board QSPI flash as a :class:`vfs.AbstractBlockDev`-compatible block
+   device. Block numbers are relative to the start of that region, not
+   the physical start of flash.
 
    In most cases, to store persistent data on the device, you'll want to
-   use a higher-level abstraction, for example the filesystem via Python's
-   standard file API, but this interface is useful to :ref:`customise the
-   filesystem configuration <filesystem>` or implement a low-level storage
-   system for your application.
+   use a higher-level abstraction -- for example the filesystem via
+   Python's standard file API. This interface is useful to
+   :ref:`customise the filesystem configuration <filesystem>` or
+   implement a low-level storage system for your application.
+
+   The object also implements the buffer protocol, allowing read-only
+   memory-mapped access to the entire flash storage region via the QSPI
+   XIP base. This makes a zero-copy view of the region available without
+   issuing any flash reads::
+
+      flash = mimxrt.Flash()
+      view = memoryview(flash)
+      magic = bytes(view[:4])      # read the first 4 bytes directly from XIP
+
+   The block size used by the underlying flash sectors can be queried at
+   runtime with :meth:`ioctl(5, 0) <ioctl>`.
 
    .. method:: readblocks(block_num: int, buf: bytearray) -> None
                readblocks(block_num: int, buf: bytearray, offset: int) -> None
-               writeblocks(block_num: int, buf: bytes) -> None
+
+      Read bytes from the flash into ``buf``. Two overloads expose the
+      simple and extended interfaces:
+
+      **Simple form** (``readblocks(block_num, buf)``): reads whole
+      blocks starting at block index ``block_num``. ``len(buf)`` must be
+      a multiple of the flash block size.
+
+      **Extended form** (``readblocks(block_num, buf, offset)``): reads
+      ``len(buf)`` bytes -- not necessarily a whole number of blocks --
+      starting at byte ``offset`` within block ``block_num``.
+      ``len(buf)`` has no alignment constraint.
+
+   .. method:: writeblocks(block_num: int, buf: bytes) -> None
                writeblocks(block_num: int, buf: bytes, offset: int) -> None
-               ioctl(cmd: int, arg: int) -> Optional[int]
 
-      These methods implement the simple and extended
-      :ref:`block protocol <block-device-interface>` defined by
-      :class:`vfs.AbstractBlockDev`.
+      Write bytes from ``buf`` to the flash. Two overloads expose the
+      simple and extended interfaces:
+
+      **Simple form** (``writeblocks(block_num, buf)``): writes whole
+      blocks starting at block index ``block_num``. ``len(buf)`` must be
+      a multiple of the flash block size. Each affected block is erased
+      automatically before being written.
+
+      **Extended form** (``writeblocks(block_num, buf, offset)``):
+      writes ``len(buf)`` bytes -- not necessarily a whole number of
+      blocks -- starting at byte ``offset`` within block ``block_num``.
+      ``len(buf)`` has no alignment constraint, and **no implicit erase
+      is performed** -- the caller must ensure the affected blocks have
+      been erased via a prior :meth:`ioctl(6, block_num) <ioctl>` call.
+
+      Raises ``OSError`` if the underlying flash erase or write
+      operation fails.
+
+   .. method:: ioctl(cmd: int, arg: int) -> Optional[int]
 
-      The block size can be queried by calling ``ioctl(5, 0)``. Block numbers
-      are relative to the start of the user flash storage area, not the physical
-      start of flash memory.
+      Standard :class:`vfs.AbstractBlockDev` ioctl entry point. See
+      :meth:`vfs.AbstractBlockDev.ioctl` for the full list of ``cmd``
+      values. ``cmd=5`` returns the flash block size in bytes; ``cmd=6``
+      erases the block with index ``arg``.

docs/library/neopixel.rst

@@ -7,8 +7,7 @@
 This module provides a driver for WS2812 / NeoPixel LED strips. The driver
 relies on `machine.bitstream()` to generate the precisely timed signal the LEDs
 expect, so it works on any port whose ``machine`` module implements
-``bitstream``. It is included by default on the current OpenMV Cams and on
-the supported Arduino boards.
+``bitstream``.
 
 The application sets pixel data via item assignment or `NeoPixel.fill()` and
 then calls `NeoPixel.write()` to update the strip. Each pixel is exposed as an
@@ -20,8 +19,8 @@ Example::
     import machine
     import neopixel
 
-    # 32 LED strip connected to pin P8.
-    n = neopixel.NeoPixel(machine.Pin("P8"), 32)
+    # 32 LED strip connected to pin P7.
+    n = neopixel.NeoPixel(machine.Pin("P7"), 32)
 
     # Draw a red gradient.
     for i in range(32):