.. _changelog_v4_1_1:

v4.1.1
======

v4.1.1 standardizes the WiFi API, updates GC2145 / LSM6DSOX drivers, and fixes
:class:`machine.I2C` scan, ``sensor.read_reg``, and :func:`sensor.set_framerate`. The
WINC/NINA WiFi API changed — read the breaking changes below.

.. contents:: On this page
   :local:
   :depth: 1

Highlights
----------

- **Standardized WiFi API** — WINC matches the common MicroPython WiFi /
  :class:`network.WLAN` interface.
- **Driver updates** — GC2145 (with PLL fix) and LSM6DSOX.
- **Fixes** — :class:`machine.I2C` scan, ``sensor.read_reg``,
  :func:`sensor.set_framerate`, :func:`sensor.ioctl` argument checking.
- **Breaking:** the WINC/NINA WiFi API changed — see the breaking changes.

New features
------------

- **Arduino Portenta H7** — the ``ble_advertising`` helper is now frozen into
  the firmware.

Other changes and improvements
------------------------------

- Updated the LSM6DSOX IMU driver and the RP2 audio module; improved
  exception handling.

Bug fixes
---------

Camera and sensors:

- Fixed ``sensor.read_reg``, :func:`sensor.set_framerate`, and :func:`sensor.ioctl`
  argument checking; updated the GC2145 driver and fixed its PLL.

System:

- Fixed :class:`machine.I2C` bus scan, RP2 audio de-init, and a Nano RP2040
  Connect flash issue.

Hardware and board support
--------------------------

- **RP2 boards** — updated I2C pinout.
- **Arduino Nano 33 BLE Sense** — updated flash size.

Breaking API changes
--------------------

User-visible API breaks between v4.1.0 and v4.1.1. Scope: Python C-modules in
``modules/`` and Python libraries in ``scripts/libraries/``.

The breaking change is *minor* and affects WiFi networking only.

.. _v4_1_1_wifi:

WiFi API standardized *(minor)*
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The WINC1500 WiFi API was made compatible with the common MicroPython WiFi /
:class:`network.WLAN` interface (the constructor and usage changed, and WINC is now
registered as the default WLAN module when present). The NINA-W10
``ifconfig()`` argument order was also corrected. Scripts using the old
WINC-specific API or the previous NINA ``ifconfig()`` argument order must be
updated.

*Commits:* `f5391a388 <https://github.com/openmv/openmv/commit/f5391a388>`__,
`ae0d060e1 <https://github.com/openmv/openmv/commit/ae0d060e1>`__,
`6438a3c6e <https://github.com/openmv/openmv/commit/6438a3c6e>`__

Migration checklist
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Only WiFi scripts are affected: port WINC code to the standard
:class:`network.WLAN` interface and fix the NINA ``ifconfig()`` argument order
(:ref:`the WiFi API change <v4_1_1_wifi>`). All other scripts run unchanged.