.. _changelog_ide_v2_2_0:

v2.2.0
======

v2.2.0 expands the bundled examples and tooling, adds log-saving and video
rescaling to the IDE, hardens the DFU flashing path, and refreshes the bundled
camera firmware to 3.3.1. It remains based on Qt Creator 4.0.2, and there are
no breaking changes to existing projects.

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

Highlights
----------

- **Save** buttons added to the serial terminal and to the message/log output
  panes export their contents to a ``.txt`` file.
- **Video rescaling** lets you set a new width (aspect ratio preserved) when
  saving or converting a recorded video.
- **Threshold Editor** gains a **Reset Sliders** button to restore grayscale
  or LAB thresholds to their full default ranges.
- **New examples** for the IMU, Distance, TV, and Global Shutter shields,
  Lepton radiometry, CPU frequency scaling, and a chars74k machine-learning
  model.
- **Bundled camera firmware** updated to 3.3.1 and the DFU flashing path
  hardened for more reliable upgrades.

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

- Added a **Save** button to the OpenMV serial terminal and to the Core
  message/log output panes that exports the log contents to a ``.txt`` file.
  (`fba4cd119 <https://github.com/openmv/qt-creator/commit/fba4cd119>`__)
- When saving or converting a recorded video the IDE now asks whether to
  rescale it and lets you enter a new width (aspect ratio preserved), which is
  passed to ffmpeg via ``-vf scale``.
  (`db13b4f2f <https://github.com/openmv/qt-creator/commit/db13b4f2f>`__)
- The **Threshold Editor** color-tracking tool gained a **Reset Sliders**
  button that restores the grayscale (0-255) or LAB (L 0-100, A/B -128..127)
  thresholds to their full default ranges.
  (`a16d7a613 <https://github.com/openmv/qt-creator/commit/a16d7a613>`__)
- Added new **IMU Shield**, **Distance Shield**, and **TV Shield** example
  folders (``imu_read.py``, ``distance_read.py``, ``tv.py``) plus an updated
  MAVLink optical-flow example.
  (`f4468637b <https://github.com/openmv/qt-creator/commit/f4468637b>`__)
- Expanded the bundled example set with CPU frequency scaling, Lepton
  radiometry object-temperature, **Global Shutter** (high-fps/triggered), new
  drawing (ellipse/keypoints) and image-filter (gamma/negative) examples, plus
  ``100-Libraries`` helpers (MQTT, BNO055, VL53L1X).
  (`03a5696ae <https://github.com/openmv/qt-creator/commit/03a5696ae>`__)
- Added a **Machine Learning** chars74k character-recognition example and a new
  chars74k neural-network model, and refreshed the bundled smile model.
  (`9d5198204 <https://github.com/openmv/qt-creator/commit/9d5198204>`__)
- Bundled a **ROS** (Robot Operating System) integration package
  (``openmv_cam``) into the IDE distribution and updated the bundled LabVIEW
  OpenMV interface package.
  (`b43921a48 <https://github.com/openmv/qt-creator/commit/b43921a48>`__,
  `a209fdc0c <https://github.com/openmv/qt-creator/commit/a209fdc0c>`__)

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

- After the first run of the helloworld example a one-time **More Examples**
  dialog now points users to ``File -> Examples`` (with a "Don't show this
  again" checkbox), and the post-firmware-upgrade message was reworded to note
  the RGB LED blinking blue when self-test completes.
  (`06e4f7436 <https://github.com/openmv/qt-creator/commit/06e4f7436>`__)
- Hardened the DFU flashing path: pydfu now retries clear-status until
  ``DFU_IDLE`` and raises the USB control-transfer timeout to 5000ms, and the
  Linux udev rules were rewritten to reliably match the OpenMV DFU
  (``0483:df11``) and serial (``1209:abd1``) devices and create
  ``/dev/openmvdfu`` and ``/dev/openmvcam`` symlinks.
  (`49e40e8f9 <https://github.com/openmv/qt-creator/commit/49e40e8f9>`__)
- MicroPython runtime error messages reported in the IDE are now passed through
  ``tr()`` so they can be localized.
  (`ff8bcf094 <https://github.com/openmv/qt-creator/commit/ff8bcf094>`__)
- Refreshed the bundled offline HTML reference documentation, adding new
  ``omv.cpufreq`` and ``omv.tv`` module pages and updating the ``omv.fir``,
  ``omv.image``, and ``omv.sensor`` pages plus new tutorial overview and
  system-architecture pages.
  (`33deb09a5 <https://github.com/openmv/qt-creator/commit/33deb09a5>`__)

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

- **Qt Creator base:** 4.0.2.
- **Bundled OpenMV camera firmware:** updated from 3.2.0 to 3.3.1 for
  OPENMV2/OPENMV3/OPENMV4 (firmware, bootloader, openmv, and UVC binaries).
  (`8a3230df4 <https://github.com/openmv/qt-creator/commit/8a3230df4>`__)
- **Windows DFU driver:** the installer now detects Windows 10 and installs a
  dedicated Win10 signed STTube driver, and a separate STM32L DfuSe tool/driver
  set was bundled.
  (`89f57e10a <https://github.com/openmv/qt-creator/commit/89f57e10a>`__,
  `e4ef66f12 <https://github.com/openmv/qt-creator/commit/e4ef66f12>`__)
- **ffmpeg/ffprobe:** refreshed the bundled ffmpeg/ffprobe binaries used for
  video conversion for the Linux targets (linux-arm/Raspberry Pi, linux-x86,
  linux-x86_64) and macOS, dropping the unused ffserver and 10-bit ffmpeg
  variants on the Linux targets.
  (`6ea2f68a4 <https://github.com/openmv/qt-creator/commit/6ea2f68a4>`__)
- **Windows FTDI USB-serial driver:** updated the bundled driver package.
  (`919bd1d8d <https://github.com/openmv/qt-creator/commit/919bd1d8d>`__)

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

None. Existing projects and workflows continue to work unchanged; the Qt
Creator base remains 4.0.2.