.. _changelog_ide_v4_8_4:

v4.8.4
======

v4.8.4 is a reliability and connection-handling release built on the existing
Qt Creator 14.0.2 base. It improves USB-drive-to-serial-port matching on
macOS, makes camera connect and resync more robust, widens the
STMicroelectronics model-zoo catalog, and fixes an Alif firmware-loading bug
that could brick boards. There are no breaking changes for user projects.

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

Highlights
----------

- **macOS drive matching** now resolves a mounted drive's USB serial number
  by walking the DiskArbitration/IOKit registry, correctly pairing camera
  storage drives with their serial port.
- **Safer Alif firmware loading** no longer erases the MRAM ``APP`` region,
  which was bricking boards.
- **More reliable connections** thanks to longer connect timeouts, a
  retry-with-grace resync, and a single-removable-drive fallback when strict
  serial-number matching fails.
- **Wider STMicroelectronics model zoo**, now available on
  ``OPENMV_RT1060``, ``OPENMV4P``, ``ARDUINO_GIGA``,
  ``ARDUINO_PORTENTA_H7``, and ``ARDUINO_NICLA_VISION``.
- **Cleaner System Information** panels rendered as aligned monospaced rich
  text with a multi-line protocol-capabilities section.

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

- On macOS, the IDE resolves a mounted drive's USB serial number by walking
  the DiskArbitration/IOKit registry from the volume mount path up to the USB
  device node, fixing serial-port-to-drive matching for camera storage drives
  (`35fd08410 <https://github.com/openmv/qt-creator/commit/35fd08410>`__). The
  DiskArbitration and CoreFoundation includes are wrapped in a
  ``Q_OS_MAC`` guard so non-Mac builds compile cleanly
  (`5940f3f77 <https://github.com/openmv/qt-creator/commit/5940f3f77>`__).
- When strict serial-number drive matching fails but exactly one removable
  drive is present, the IDE now falls back to using that single drive as the
  camera's mount path
  (`92d13cb10 <https://github.com/openmv/qt-creator/commit/92d13cb10>`__).
- Camera resync now uses a longer first-attempt connection timeout and
  retries with a one-second grace timeout, recreating the transport on each
  attempt to make initial connections more reliable
  (`2343a9211 <https://github.com/openmv/qt-creator/commit/2343a9211>`__).
- The device System Information and host/device stats panels now render as
  monospaced rich text with realigned columns and a multi-line
  protocol-capabilities section for clearer formatting
  (`549a6acfa <https://github.com/openmv/qt-creator/commit/549a6acfa>`__).
- STMicroelectronics model-zoo entries are now available on more boards,
  extending the catalog to ``OPENMV_RT1060``, ``OPENMV4P``,
  ``ARDUINO_GIGA``, ``ARDUINO_PORTENTA_H7``, and ``ARDUINO_NICLA_VISION`` in
  addition to ``OPENMV_AE3`` and ``OPENMV_N6``
  (`ea75eea5f <https://github.com/openmv/qt-creator/commit/ea75eea5f>`__).

Bug fixes
---------

- Fixed Alif firmware loading so it no longer erases the MRAM ``APP`` region,
  which was bricking boards; the IDE now prompts the user to disconnect the
  camera and turn off the hard-maintenance-mode switch, and to leave the
  camera unconnected until instructed to reconnect it
  (`886290d46 <https://github.com/openmv/qt-creator/commit/886290d46>`__).
- The new (V2) serial protocol probe is now correctly gated to run only on
  cameras that do *not* have the legacy OpenMV USB VID/PID (i.e. newer
  cameras), fixing a VID/PID comparison typo that compared
  ``productIdentifier`` twice instead of ``vendorIdentifier`` and a gating
  condition that previously ran the probe on the wrong devices
  (`b43b485ed <https://github.com/openmv/qt-creator/commit/b43b485ed>`__,
  `c86d83870 <https://github.com/openmv/qt-creator/commit/c86d83870>`__).

Platform and tool support
-------------------------

- **Qt Creator base:** 14.0.2.
- **STMicroelectronics model zoo** catalog extended to ``OPENMV_RT1060``,
  ``OPENMV4P``, ``ARDUINO_GIGA``, ``ARDUINO_PORTENTA_H7``, and
  ``ARDUINO_NICLA_VISION`` in addition to ``OPENMV_AE3`` and ``OPENMV_N6``.

Breaking changes
----------------

None. This release contains no scripting-API or user-project workflow breaks.