.. _changelog_ide_v4_8_7:

v4.8.7
======

v4.8.7 focuses on board recovery and registration, adding direct
``bootloader.bin`` recovery for STM32 and Alif boards and moving the
camera registration and license flow onto new POST-based server endpoints.
It is built on Qt Creator 14.0.2 and contains no breaking changes for user
projects, aside from one removed default macOS keyboard shortcut noted below.

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

Highlights
----------

- **STM32 recovery** can now load a ``bootloader.bin`` file directly via the
  ST Cube Programmer and prompts for a board type when recovering hidden
  boards.
- **Alif recovery** can now load a ``bootloader.bin`` file directly.
- **Example auto-scaling** down-scales example scripts from VGA to QVGA on
  older cameras (M4, M7, H7, NICLA, NICLAV) so they run within their
  resolution limits.
- **Registration overhaul** moves the network calls to new POST endpoints,
  always pings the server with the board type, and reports clear errors and a
  green ``Registered`` toolbar button.
- **macOS Connect shortcut** is fixed by removing a conflicting default key
  binding.

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

- **STM32 bootloader.bin recovery.** STM32 recovery now supports loading a
  ``bootloader.bin`` file directly, and presents a board-type selection
  dialog when recovering hidden boards, replacing the previous error that
  only ``bootloader.dfu`` files were allowed. When the board uses the ST
  Cube Programmer, the bundled firmware and the selected ``bootloader.bin``
  are copied to a temp directory and handed to the existing Cube Programmer
  factory-programming flow. For non-Cube-Programmer STM32 boards, a ``.bin``
  firmware path is now flashed with ``dfu-util`` options
  ``-a 0 -s 0x08000000`` instead of ``-a 0 -s :leave``
  (`18b06325f <https://github.com/openmv/qt-creator/commit/18b06325f>`__).
- **Alif bootloader.bin recovery.** Alif boards can now be recovered by
  loading a ``bootloader.bin`` file directly; it is copied over the bundled
  firmware in a temp directory before invoking the Alif download tool
  (`2a36d5e3b <https://github.com/openmv/qt-creator/commit/2a36d5e3b>`__).

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

- **Example auto-scaling.** Older cameras (M4, M7, H7, NICLA, NICLAV) now
  automatically have example scripts down-scaled from VGA to QVGA so the
  examples run within their reduced resolution limits
  (`5adb51a81 <https://github.com/openmv/qt-creator/commit/5adb51a81>`__).
- **POST-based registration endpoints.** Camera registration and license
  network calls were switched from GET query-string URLs to POST
  form-encoded requests against the new ``insert.php``, ``register.php``, and
  ``check.php`` server endpoints
  (`d5565e050 <https://github.com/openmv/qt-creator/commit/d5565e050>`__).
- **Clearer registration errors.** Registration now shows clear error dialogs
  when the board type is not available for a form key or the per-board-type
  registration limit has been reached
  (`feaa2ecd9 <https://github.com/openmv/qt-creator/commit/feaa2ecd9>`__).

Bug fixes
---------

- Fixed the connect/register flow so it always pings the OpenMV server with
  the board type even without a form key, restoring board registration and
  license checks that were previously skipped
  (`f487fe0d9 <https://github.com/openmv/qt-creator/commit/f487fe0d9>`__).
- Fixed the connected-camera sensor name string to correctly hide sensors
  flagged as hidden, showing only the visible sensor types
  (`8afa4cb18 <https://github.com/openmv/qt-creator/commit/8afa4cb18>`__).
- Fixed the **Install the Latest Development Release** dialog so it again
  displays the firmware release notes after GitHub changed its release-page
  HTML markup
  (`690dcd67d <https://github.com/openmv/qt-creator/commit/690dcd67d>`__).
- Fixed the toolbar to show a green ``Registered`` button after a successful
  registration with a form key, and to hide it when no form key is used
  (`c3b0800f3 <https://github.com/openmv/qt-creator/commit/c3b0800f3>`__).
- Fixed the camera Connect keyboard shortcut on macOS by removing the
  conflicting default ``Ctrl+E`` / ``Cmd+E`` Enter Find String binding
  (`44479b435 <https://github.com/openmv/qt-creator/commit/44479b435>`__).
- Added 10 ms sleeps when a camera channel lock fails to avoid a busy-loop
  live-lock during profile reads and frame streaming
  (`dcc0c7e95 <https://github.com/openmv/qt-creator/commit/dcc0c7e95>`__).

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

- **Qt Creator base:** 14.0.2.

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

- The default ``Ctrl+E`` (``Cmd+E`` on macOS) shortcut for the **Enter Find
  String** action is no longer bound, freeing it for the camera Connect
  shortcut on macOS. The find-buffer feature itself is unchanged and can be
  rebound under ``Preferences`` if desired
  (`44479b435 <https://github.com/openmv/qt-creator/commit/44479b435>`__).

Otherwise this release contains no user-visible workflow or behavior breaks
for existing projects.