changelog/ide: third accuracy pass against qt-creator diffs

Re-verify every IDE release page against the real commit diffs and correct
residual overstatements, omissions, and mischaracterizations found on a third
adversarial read. Notable fixes: v4.1.3 (RT1062 is a pinout entry, not flash
support), v1.2.0 (the USB transport drops packetizing for a single flush),
v4.7.0 (added omitted Edge Impulse/Google models and ONNX support), and
consistent Highlights formatting across all pages. 46 pages updated.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: kwagyeman

docs/changelog/ide/v1.0.0.rst

@@ -5,7 +5,7 @@ v1.0.0
 
 v1.0.0 is the first public release of OpenMV IDE, a customized Qt Creator
 build (Qt Creator 4.0.2) tailored for developing on the OpenMV Cam. It adds
-USB auto-discovery and connection, on-cam script execution, a live frame
+USB serial discovery and connection, on-cam script execution, a live frame
 buffer and histogram, and Python traceback navigation. There are no breaking
 changes, as this is the initial release.
 
@@ -19,8 +19,8 @@ Highlights
 - **OpenMV-branded Qt Creator** with its own splash screen, an ``Examples``
   menu, and a Python editor that opens new untitled ``.py`` files pre-filled
   with a sensor snapshot template for the OpenMV Cam.
-- **Connect** auto-discovers the OpenMV Cam over USB serial and reads back the
-  board firmware version, shown in the status bar.
+- **Connect** enumerates serial ports matching the OpenMV Cam VID/PID and
+  reads back the board firmware version, shown in the status bar.
 - **Run on cam** with ``Connect``/``Disconnect``/``Start``/``Stop`` toolbar
   controls: ``Start`` (``Ctrl+R``) sends the current script to the cam and
   ``Stop`` halts it.
@@ -52,10 +52,10 @@ New features
   higher framerate, a disable toggle for maximum performance, and a live FPS
   label.
 - **Save image and templates.** Right-click context actions on the Frame
-  Buffer save the displayed image to disk (BMP/JPG/PNG/PPM) and, via
-  rubber-band region selection, save a template image (BMP/JPG/PGM/PPM) of the
-  selected region, or a keypoint/feature descriptor (``.lbp``/``.ff``),
-  directly onto the cam's drive.
+  Buffer save the displayed image to disk (BMP/JPG/PNG/PPM) and save a
+  template image (BMP/JPG/PGM/PPM) of either the full frame or an optional
+  rubber-band-selected region, or a keypoint/feature descriptor
+  (``.lbp``/``.ff``), directly onto the cam's drive.
 - **Histogram panel.** A ``Histogram`` panel plots the current frame's channel
   distribution and can be switched between RGB, Grayscale, LAB, and YUV color
   spaces.
@@ -83,9 +83,11 @@ Platform and tool support
 
 - **Qt Creator base:** 4.0.2.
 - The plugin communicates with the cam over a custom USB-debug serial
-  protocol. Protocol-level support for a flash bootloader (start, reset,
-  erase, write) is present in the IO layer, but no firmware-update menu or
-  button exposes it to users in this release.
+  protocol. Several protocol-level capabilities are present in the IO layer
+  but are not surfaced in the UI in this release: a flash bootloader (start,
+  reset, erase, write), camera-attribute controls (contrast, brightness,
+  saturation, gain ceiling), a system-reset command, and a frame-update path.
+  None of these are wired to a menu, button, or widget for users yet.
 
 Breaking changes
 ----------------

docs/changelog/ide/v1.1.0.rst

@@ -59,12 +59,12 @@ New features
   Cam``) and reset the camera (``Reset OpenMV Cam``). ``Stop`` gained a
   ``Ctrl+T`` shortcut.
   (`9fc3dfa5a <https://github.com/openmv/qt-creator/commit/9fc3dfa5a>`__,
-  `889bc38fb <https://github.com/openmv/qt-creator/commit/889bc38fb>`__,
-  `a175bff39 <https://github.com/openmv/qt-creator/commit/a175bff39>`__)
+  `889bc38fb <https://github.com/openmv/qt-creator/commit/889bc38fb>`__)
 - **Update notification and local docs.** The IDE checks openmv.io on startup
-  for a newer IDE version and shows a download notification. The docs and
-  pinout ``Help`` actions now open locally bundled HTML documentation instead
-  of the website.
+  for a newer IDE version and shows a download notification. The ``Docs``
+  ``Help`` action now opens locally bundled HTML documentation
+  (``html/index.html``) and the pinout action opens the bundled pinout image
+  (``html/_images/pinout.png``) instead of the website.
   (`a175bff39 <https://github.com/openmv/qt-creator/commit/a175bff39>`__,
   `50375ee95 <https://github.com/openmv/qt-creator/commit/50375ee95>`__)
 - **Binary and grayscale frame buffer.** The frame buffer viewer now renders
@@ -116,11 +116,13 @@ Bug fixes
 
 - Improved serial-port handling on macOS (filter to port names containing
   ``cu``) and Linux (clearer permission-denied guidance suggesting ``sudo
-  adduser <user> dialout``), suppressed an SSL warning, and made bootloader
-  dialogs application-modal with longer command timeouts for reliability.
+  adduser <user> dialout``), suppressed an SSL warning, made bootloader
+  dialogs application-modal, and adjusted bootloader timing and timeouts for
+  reliability.
   (`a175bff39 <https://github.com/openmv/qt-creator/commit/a175bff39>`__,
-  `30eb9e0dc <https://github.com/openmv/qt-creator/commit/30eb9e0dc>`__,
-  `552803018 <https://github.com/openmv/qt-creator/commit/552803018>`__)
+  `552803018 <https://github.com/openmv/qt-creator/commit/552803018>`__,
+  `a871bfb48 <https://github.com/openmv/qt-creator/commit/a871bfb48>`__,
+  `30eb9e0dc <https://github.com/openmv/qt-creator/commit/30eb9e0dc>`__)
 - The IDE now opens the ``helloworld.py`` example automatically when no
   document is open on launch and reliably closes the splash screen, fixing
   edit-window and startup state issues.
@@ -137,8 +139,7 @@ Platform and tool support
 - **New board:** Cortex-M7 OpenMV Cam (STM32F769, ``OMV7``) is now supported
   alongside the Cortex-M4 OpenMV Cam (STM32F427, ``OMV2``), with per-board
   firmware directories and board-string auto-detection via ``boards.txt``.
-  (`a175bff39 <https://github.com/openmv/qt-creator/commit/a175bff39>`__,
-  `50375ee95 <https://github.com/openmv/qt-creator/commit/50375ee95>`__)
+  (`a175bff39 <https://github.com/openmv/qt-creator/commit/a175bff39>`__)
 - **Bundled firmware:** updated to 1.7.0 and then to 1.8.0 for both ``OMV2``
   and ``OMV7`` boards; the bootloader minimum/compatible firmware version is
   1.6.0.

docs/changelog/ide/v1.2.0.rst

@@ -19,11 +19,9 @@ Highlights
 - **Run Bootloader** workflow under ``Tools`` lets you flash a ``.bin``
   firmware file, optionally erase the internal file system, and
   automatically recover bricked cameras via a board-type picker.
-- **USB/serial transport overhaul** splits commands into fixed-size USB
-  packets with per-command start/end delays, fixing communication
+- **USB/serial transport overhaul** writes each command in a single
+  flush with optional per-command start/end delays, fixing communication
   reliability on Windows, Mac, and Linux.
-- **Command auto-retry** re-sends a timed-out USB serial command instead
-  of failing immediately, improving connection reliability.
 - **New examples** for LBP face recognition, Canny edge detection, and
   Hough line finding.
 - **Bundled firmware** for the OpenMV Cam M4 (OMV2) updated to 1.9.0.
@@ -67,11 +65,6 @@ Other changes and improvements
 Bug fixes
 ---------
 
-- Added an automatic retry mechanism for USB serial commands so a
-  timed-out command is re-sent (up to ``USBDBG_COMMAND_RETRY`` times)
-  instead of failing immediately, improving connection reliability
-  especially on Windows
-  (`e0762a78e <https://github.com/openmv/qt-creator/commit/e0762a78e>`__).
 - Fixed SD-card auto-detection so the "set port path" feature checks the
   correct mount root per OS (``/Volumes`` on Mac, ``/media`` on Linux)
   and matches FAT/MSDOS filesystem types case-insensitively
@@ -83,11 +76,12 @@ Platform and tool support
 
 - **Qt Creator base:** 4.0.2.
 - **OpenMV Cam M4 (OMV2) bundled firmware:** updated to 1.9.0.
-- **USB/serial transport** reworked to split commands into fixed-size USB
-  packets (60-byte ``PACKET_LEN``) with per-command start/end delays,
-  fixing serial communication reliability across Windows, Mac, and Linux
+- **USB/serial transport** reworked so each command is written in a
+  single flush with optional per-command start/end delays
+  (``SET_START_END_DELAY``), fixing serial communication reliability
+  across Windows, Mac, and Linux. An interim per-command packetizing
+  approach was replaced before release
   (`89464818f <https://github.com/openmv/qt-creator/commit/89464818f>`__,
-  `bd70d60fc <https://github.com/openmv/qt-creator/commit/bd70d60fc>`__,
   `8b5ebadbb <https://github.com/openmv/qt-creator/commit/8b5ebadbb>`__).
 - **Windows driver installers** reworked to handle 64-bit (WOW64)
   systems and quote paths, making OpenMV/pybcdc INF driver installation

docs/changelog/ide/v1.3.0.rst

@@ -30,6 +30,9 @@ Highlights
 - **DFU firmware flashing on every platform.** Firmware can now be flashed
   over DFU on Windows, macOS, Linux x86 and Linux x86_64, and the firmware
   picker accepts ``.dfu`` files in addition to ``.bin``.
+- **Automatic DFU fallback.** When the serial bootloader cannot be reached
+  during a firmware update, the IDE now offers to upgrade over the camera's
+  DFU bootloader instead, guiding you through adding a ``BOOT``/``RST`` jumper.
 
 New features
 ------------
@@ -54,6 +57,13 @@ New features
   that auto-toggles on the chosen file extension added in ``b2ac8defe``
   (`4ad2be5f9 <https://github.com/openmv/qt-creator/commit/4ad2be5f9>`__,
   `b2ac8defe <https://github.com/openmv/qt-creator/commit/b2ac8defe>`__).
+- **Automatic DFU fallback on bootloader failure.** When a ``.bin`` firmware
+  update cannot start the serial bootloader, the IDE now reports ``Unable to
+  connect to the bootloader!`` and then offers to upgrade using the camera's
+  DFU bootloader instead, warning that DFU erases the internal flash file
+  system and walking you through adding a ``BOOT``/``RST`` jumper wire and
+  reconnecting before it runs ``DfuSeCommand.exe`` (Windows)
+  (`4ad2be5f9 <https://github.com/openmv/qt-creator/commit/4ad2be5f9>`__).
 - **HoG example.** Added a Histogram of Oriented Gradients visualization
   example (``09-Feature-Detection/hog.py``) using ``img.find_hog()``
   (`b03a707f7 <https://github.com/openmv/qt-creator/commit/b03a707f7>`__).
@@ -71,12 +81,14 @@ Other changes and improvements
   `1d72fe4bf <https://github.com/openmv/qt-creator/commit/1d72fe4bf>`__,
   `b4cf2fe43 <https://github.com/openmv/qt-creator/commit/b4cf2fe43>`__,
   `c60936d5f <https://github.com/openmv/qt-creator/commit/c60936d5f>`__).
-- Windows DFU and serial driver installation is now silent/unattended,
-  switching the driver scripts to ``dpinst``-based installers instead of
-  interactive ``InfDefaultInstall``, and the VCP serial driver installer was
-  fixed and added
+- Windows serial-port driver installation is now silent/unattended, switching
+  the ``openmv.cmd``/``pybcdc.cmd`` driver scripts to ``dpinst``-based
+  installers instead of interactive ``InfDefaultInstall``, and the Visual C++
+  Redistributable installer (``vcr.cmd``, running ``vcredist_x86.exe`` and
+  ``vcredist_x64.exe`` quietly) was added and fixed
   (`a5a6e0590 <https://github.com/openmv/qt-creator/commit/a5a6e0590>`__,
   `754d0776d <https://github.com/openmv/qt-creator/commit/754d0776d>`__,
+  `b0be97e3e <https://github.com/openmv/qt-creator/commit/b0be97e3e>`__,
   `452a29f0d <https://github.com/openmv/qt-creator/commit/452a29f0d>`__,
   `c051c6e30 <https://github.com/openmv/qt-creator/commit/c051c6e30>`__,
   `ad1b674ef <https://github.com/openmv/qt-creator/commit/ad1b674ef>`__,

docs/changelog/ide/v1.4.0.rst

@@ -67,10 +67,11 @@ Other changes and improvements
   moved from ``Ctrl+T`` to ``Ctrl+R``
   (`e7803d33c <https://github.com/openmv/qt-creator/commit/e7803d33c>`__).
 - IDE network endpoints were repointed to the new openmv.io hosts: forums to
-  ``forums.openmv.io``, the download page to ``openmv.io/pages/download``, and
-  the version-check and resource-zip downloads to ``upload.openmv.io``
-  (`e7803d33c <https://github.com/openmv/qt-creator/commit/e7803d33c>`__,
-  `e899abcca <https://github.com/openmv/qt-creator/commit/e899abcca>`__).
+  ``forums.openmv.io`` and the download page to ``openmv.io/pages/download``
+  (`e7803d33c <https://github.com/openmv/qt-creator/commit/e7803d33c>`__), and
+  the version-check, resources-version, and resources-zip downloads to
+  ``upload.openmv.io``
+  (`e899abcca <https://github.com/openmv/qt-creator/commit/e899abcca>`__).
 
 Bug fixes
 ---------
@@ -90,6 +91,10 @@ Bug fixes
   pick the first drive instead of incorrectly suppressing the selection
   (`4fda9a7d6 <https://github.com/openmv/qt-creator/commit/4fda9a7d6>`__,
   `e7803d33c <https://github.com/openmv/qt-creator/commit/e7803d33c>`__).
+- Fixed rendering of binary (1bpp) frame-buffer images by aligning each row to
+  32 bits instead of 8 bits, so binary images streamed from the OpenMV Cam
+  display correctly instead of with garbled/misaligned rows
+  (`e7803d33c <https://github.com/openmv/qt-creator/commit/e7803d33c>`__).
 
 Platform and tool support
 -------------------------

docs/changelog/ide/v1.5.0.rst

@@ -22,7 +22,8 @@ Highlights
   highlighting, sourced from a keyword database auto-generated from the bundled
   HTML documentation.
 - **AprilTag Generator** renders printable tag-image sheets for the TAG16H5,
-  TAG25H7, TAG25H9, TAG36H10, TAG36H11, and ARTOOLKIT families.
+  TAG25H7, TAG25H9, TAG36H10, TAG36H11, and AR-TOOLKIT families (the menu label
+  for the last reads ``ARKTOOLKIT``).
 - **Robust serial output:** a UTF-8-aware parser strips and handles control
   characters so binary data no longer corrupts printed text.
 - **OpenMV firmware 2.2.0** is now bundled, with new AprilTag and 3D-pose
@@ -50,8 +51,10 @@ New features
   `a2f4b2f25 <https://github.com/openmv/qt-creator/commit/a2f4b2f25>`__).
 - **AprilTag Generator** under ``Machine Vision Tools`` renders printable
   tag-image PNG sheets for the TAG16H5, TAG25H7, TAG25H9, TAG36H10, TAG36H11,
-  and ARTOOLKIT tag families over a selectable tag-ID range. The menu also gains
-  a ``QRCode Generator`` link, and tag menu labels now show tag counts
+  and AR-TOOLKIT tag families over a selectable tag-ID range. The menu item for
+  the last family reads ``ARKTOOLKIT Family`` (a typo in the build) even though
+  the family itself is ``artoolkit``. The menu also gains a
+  ``QRCode Generator`` link, and tag menu labels now show tag counts
   (`ec72bf2f4 <https://github.com/openmv/qt-creator/commit/ec72bf2f4>`__,
   `71f78a539 <https://github.com/openmv/qt-creator/commit/71f78a539>`__).
 

docs/changelog/ide/v1.6.0.rst

@@ -122,9 +122,10 @@ Platform and tool support
   ``find_line_segments.py`` examples, and a ``sensor.set_vsync_output()``
   method
   (`f0cd4d75c <https://github.com/openmv/qt-creator/commit/f0cd4d75c>`__). The
-  2.4.0 -> 2.4.1 step renamed the binary image operations to ``b_and`` /
-  ``b_or`` / ``b_nand`` / ``b_nor`` / ``b_xor`` / ``b_xnor`` (the legacy
-  ``nand`` / ``nor`` / ``xor`` / ``xnor`` names are retained as aliases)
+  2.4.0 -> 2.4.1 step added the new ``b_and`` / ``b_or`` logical AND/OR image
+  operations and renamed ``nand`` / ``nor`` / ``xor`` / ``xnor`` to
+  ``b_nand`` / ``b_nor`` / ``b_xor`` / ``b_xnor`` (the legacy names are
+  retained as aliases)
   (`4fc16559e <https://github.com/openmv/qt-creator/commit/4fc16559e>`__).
 - **Windows drivers:** reworked the DfuSe / FTDI / OpenMV / PybCDC driver
   install command scripts and bundled the previously-missing DfuSe and

docs/changelog/ide/v1.7.0.rst

@@ -38,11 +38,12 @@ New features
 - **Serial frame-buffer chunking and reassembly.** Frame-buffer transfers are
   split into MTU-sized chunks and reassembled in a pixel buffer, so large
   frames can be moved over the debug serial link using a default MTU. A
-  runtime MTU auto-negotiation handshake is present in the code but gated off
-  at release (the firmware version check is set to ``9.9.9``, which no shipped
-  firmware reports), so cameras use the default MTU and no negotiation occurs
-  (`96458ccef <https://github.com/openmv/qt-creator/commit/96458ccef>`__,
-  `abd1dacb9 <https://github.com/openmv/qt-creator/commit/abd1dacb9>`__).
+  runtime MTU auto-negotiation handshake was added with its firmware version
+  gate set to 2.5.0, matching the 2.5.0 firmware bundled in the same commit
+  (`96458ccef <https://github.com/openmv/qt-creator/commit/96458ccef>`__). The
+  gate was then raised to ``9.9.9`` for release, which no shipped firmware
+  reports, so cameras use the default MTU and no negotiation occurs
+  (`abd1dacb9 <https://github.com/openmv/qt-creator/commit/abd1dacb9>`__).
 - **Flush/eject on disconnect-with-reset.** Disconnecting with reset now
   flushes the camera's USB mass-storage drive before reset: on Windows the
   drive is force-ejected, while on Linux and macOS the drive's filesystem is

docs/changelog/ide/v1.8.0.rst

@@ -30,7 +30,8 @@ Highlights
 - **Video Tools menu.** ``Tools > Video Tools`` adds **Convert Video File** and
   **Play Video File**, using a bundled ffmpeg/ffplay to transcode and play
   videos and transparently converting ``ImageWriter`` ``.bin`` recordings to
-  MJPEG AVI first
+  MJPEG AVI first; **Play Video File** is available on Windows and macOS only,
+  since ffplay is not bundled for Linux/Raspberry Pi
   (`d35f8d1ca <https://github.com/openmv/qt-creator/commit/d35f8d1ca>`__,
   `8a99c994f <https://github.com/openmv/qt-creator/commit/8a99c994f>`__).
 - **OpenMV Cam H7 (OMV4).** The new STM32H743 board is now recognized and ships
@@ -44,15 +45,22 @@ New features
 ------------
 
 - **Configure OpenMV Cam settings file.** ``Tools`` adds a dialog to write the
-  cam's ``main.ini`` WiFi settings, including enabling WiFi, choosing client
-  versus access-point mode, SSID/password/security type, and the board name
+  cam's ``main.ini`` boot/WiFi settings, including enabling WiFi, choosing
+  client versus access-point mode, SSID/password/security type, the board
+  name, and a **Duplicate REPL on the UART on startup** option stored under the
+  ``main.ini`` boot settings
   (`69dc7dfbf <https://github.com/openmv/qt-creator/commit/69dc7dfbf>`__,
-  `39142ef70 <https://github.com/openmv/qt-creator/commit/39142ef70>`__).
+  `39142ef70 <https://github.com/openmv/qt-creator/commit/39142ef70>`__,
+  `061aacf15 <https://github.com/openmv/qt-creator/commit/061aacf15>`__).
 - **Networked terminal command-line options.** Added ``-open_udp_client_terminal``,
   ``-open_udp_server_terminal``, ``-open_tcp_client_terminal``, and
   ``-open_tcp_server_terminal`` alongside the existing serial terminal option
   (`6362066a8 <https://github.com/openmv/qt-creator/commit/6362066a8>`__,
   `d75209269 <https://github.com/openmv/qt-creator/commit/d75209269>`__).
+- **Additional command-line options.** Exposed ``-update_resources``,
+  ``-open_serial_terminal`` (``port_name:baud_rate``), ``-override_read_timeout``,
+  and ``-override_read_stall_timeout``
+  (`061aacf15 <https://github.com/openmv/qt-creator/commit/061aacf15>`__).
 - **Terminal server mode.** UDP/TCP terminal connections can now run in server
   mode, binding to a local port (port ``0`` picks any) instead of only
   connecting out to a host
@@ -132,8 +140,9 @@ Platform and tool support
   (`e14810382 <https://github.com/openmv/qt-creator/commit/e14810382>`__).
 - **Bundled OpenMV firmware:** bumped to 2.6.0 for OPENMV2/OPENMV3/OPENMV4
   (`e14810382 <https://github.com/openmv/qt-creator/commit/e14810382>`__).
-- **Bundled ffmpeg/ffplay:** static 3.3.3 builds added for Windows, macOS,
-  Linux x86, Linux x86_64, and Linux ARM (Raspberry Pi)
+- **Bundled ffmpeg/ffplay:** static 3.3.3 ffmpeg builds added for Windows,
+  macOS, Linux x86, Linux x86_64, and Linux ARM (Raspberry Pi); ffplay is
+  bundled only for Windows and macOS
   (`2193d7923 <https://github.com/openmv/qt-creator/commit/2193d7923>`__,
   `af92ad59e <https://github.com/openmv/qt-creator/commit/af92ad59e>`__).
 - **Raspberry Pi (Linux ARM):** builds enabled by disabling the offline-help

docs/changelog/ide/v1.8.1.rst

@@ -76,6 +76,9 @@ Other changes and improvements
 - Bundled HTML documentation was regenerated with expanded ``omv.image`` and
   ``omv.sensor`` module references and updated IDE overview text
   (`9c822f45b <https://github.com/openmv/qt-creator/commit/9c822f45b>`__).
+- The default tab width in the text editor was changed from 8 to 4 columns, so
+  tab characters in opened files now render at 4 columns
+  (`0d0636d37 <https://github.com/openmv/qt-creator/commit/0d0636d37>`__).
 
 Bug fixes
 ---------