.. _changelog_ide_v2_6_8:

v2.6.8
======

v2.6.8 refreshes the bundled firmware to 3.8.0, reorganizes the example
library into ``Arduino`` and ``OpenMV`` folders, and updates the bundled API
documentation used by the help and autocomplete systems. It remains based on
Qt Creator 4.0.2. The example reorganization changes the ``Examples`` menu
paths; see Breaking changes below.

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

Highlights
----------

- **Bundled firmware 3.8.0** for OPENMV2, OPENMV3, OPENMV4, OPENMV4P, and
  PORTENTA.
- **Reorganized examples** into top-level ``Arduino`` and ``OpenMV`` folders,
  with new ``37-Audio`` and ``38-Ethernet`` categories and new image-drawing
  tests.
- **Refreshed API documentation** adding ``network.LAN``, ``network.WLAN``,
  ``omv.audio``, ``omv.micro_speech``, and ``uasyncio`` and dropping the
  obsolete ``omv.nn`` and ``omv.time`` references for the docs and autocomplete.
- **Fixed module-documentation parsing** so multi-section module docs are read
  correctly for help and autocomplete.

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

- **Reorganized example library** into ``Arduino`` and ``OpenMV`` top-level
  folders. New categories were added, including ``37-Audio`` (``audio_fft``,
  ``micro_speech``) and ``38-Ethernet`` (``http_client``, ``http_client_ssl``,
  ``peer_to_peer``), along with new ``03-Drawing`` image-drawing tests for
  alpha blending, alpha table, and scale up/down. The default ``helloworld.py``
  path and the Register dialog text were updated to match the new
  ``Examples->OpenMV->Basics`` location. During the reorg three
  thermopile-shield examples were removed outright:
  ``AMG8833_camera_lcd.py``, ``MLX90621_camera_lcd.py``, and
  ``MLX90640_camera_lcd.py``; their ``*_camera.py``, ``*_overlay.py``, and
  ``*_overlay_lcd.py`` siblings were retained and moved into the new tree
  (`49e63811f <https://github.com/openmv/qt-creator/commit/49e63811f>`__,
  `e2bac7aa8 <https://github.com/openmv/qt-creator/commit/e2bac7aa8>`__).

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

- **Refreshed bundled MicroPython/OpenMV API documentation** used by the IDE's
  docs and autocomplete. New modules include ``network.LAN``, ``network.WLAN``,
  ``omv.audio``, ``omv.micro_speech``, and ``uasyncio``, with updated
  ``omv.image`` and ``omv.lcd`` references; the obsolete ``omv.nn`` and
  ``omv.time`` module references were removed from the docs and autocomplete
  (`d45f145b0 <https://github.com/openmv/qt-creator/commit/d45f145b0>`__).
- Normalized the module-section ids in the bundled library index to the
  canonical Sphinx ``module-<name>`` form for ``ulab``, ``pid``, ``bno055``,
  ``ssd1306``, ``tb6612``, ``vl53l1x``, ``modbus``, and ``mqtt``, which the
  documentation parser was updated to recognize
  (`c58a6e332 <https://github.com/openmv/qt-creator/commit/c58a6e332>`__).
- The DFU firmware-update and video-conversion output dialogs now render their
  log text in the editor's fixed-width font for readability
  (`94440b081 <https://github.com/openmv/qt-creator/commit/94440b081>`__).

Bug fixes
---------

- Fixed the module-documentation HTML parser so it iterates all module sections
  and tolerates dotted ids up to five segments, so multi-section module docs are
  parsed correctly for the help and autocomplete system
  (`1044a84d0 <https://github.com/openmv/qt-creator/commit/1044a84d0>`__).
- Reverted the "DFU firmware update complete!" confirmation message back to
  plain text. An earlier attempt to bold the header by wrapping it in
  ``<b></b>`` tags caused the literal HTML tags to be shown in the message box,
  so the tags were removed
  (`26f02ab08 <https://github.com/openmv/qt-creator/commit/26f02ab08>`__,
  `5ac140a0d <https://github.com/openmv/qt-creator/commit/5ac140a0d>`__).

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

- **Qt Creator base:** 4.0.2.
- **Bundled OpenMV firmware:** 3.6.9 -> 3.8.0 for OPENMV2, OPENMV3, OPENMV4,
  OPENMV4P, and PORTENTA, rebuilding the firmware, bootloader, and UVC
  binaries and DFU images
  (`d37de33f7 <https://github.com/openmv/qt-creator/commit/d37de33f7>`__).

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

- The bundled examples were reorganized into two top-level folders,
  ``Arduino`` and ``OpenMV``, so the ``Examples`` menu paths changed. For
  example, ``Examples->Basics->helloworld.py`` is now
  ``Examples->OpenMV->Basics->helloworld.py``. Any external references or
  muscle-memory pointing at the old example paths will be off. This affects
  example navigation only; it does not break user project scripts.
- Three thermopile-shield examples were removed from the bundled library:
  ``AMG8833_camera_lcd.py``, ``MLX90621_camera_lcd.py``, and
  ``MLX90640_camera_lcd.py``. The remaining ``*_camera.py``, ``*_overlay.py``,
  and ``*_overlay_lcd.py`` variants for each sensor were retained and moved
  into the new example tree
  (`49e63811f <https://github.com/openmv/qt-creator/commit/49e63811f>`__).