.. _changelog_v1_3_0:

v1.3.0
======

v1.3.0 is a big feature release: it introduces **WiFi-shield support** (the
**WINC1500** :class:`network.WINC` driver and the ``usocket`` socket API with
firmware-management tools), a new :mod:`fir` thermal-IR module, :mod:`sensor`
white-balance / mirror / flip setters, :func:`sensor.skip_frames`, and
``mean`` / ``median`` / ``mode`` / ``midpoint`` image filters. It introduces
**no breaking API changes** — v1.2.0 scripts run unchanged.

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

Highlights
----------

- **WiFi shield** — WINC1500 :class:`network.WINC` (scan / connect / ifconfig) and
  the ``usocket`` socket API (TCP/UDP, DNS, timeouts) with firmware
  update/dump/version tools.
- :mod:`fir` module — thermal-IR (MLX) sensor support.
- **Sensor** — ``set_whitebal()`` / ``set_hmirror()`` / ``set_vflip()`` and
  ``skip_frames()``.
- **Filters** — ``image.mean()`` / ``median()`` / ``mode()`` / ``midpoint()``.
- **No breaking API changes** — reflash and your v1.2.0 scripts run
  unchanged.

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

- **WiFi shield (WINC1500)** — added the :class:`network.WINC` driver (WiFi scan,
  connect, ifconfig) and the ``usocket`` socket API: ``send()`` / ``recv()``,
  ``bind()`` / ``sendto()`` / ``recvfrom()``, ``listen()`` / ``accept()``,
  ``settimeout()`` / blocking timeouts, and DNS (with async socket/DNS
  callbacks), plus ``winc.fw_update()`` / ``winc.fw_dump()`` /
  ``winc.fw_version()`` firmware tools and WiFi example scripts (scan,
  connect, TCP client, DNS, NTP, MJPEG streamer).
- :mod:`fir` — added the :mod:`fir` thermal-IR module
  (``init`` / ``deinit`` / ``read_ta`` / ``read_ir`` / ``draw_ta`` /
  ``draw_ir``, with internal scaling/blending) and ``fir.py`` / ``fir_lcd.py``
  examples.
- **Sensor** — added ``sensor.set_whitebal()``, :func:`sensor.set_hmirror`,
  :func:`sensor.set_vflip`, and :func:`sensor.skip_frames` (settle the camera
  after changing settings).
- **Image filters** — added ``image.mean()``, ``image.median()``,
  ``image.mode()``, and ``image.midpoint(ksize, bias=)``.
- Added a rewritten BLE driver/example and an MLX IR-table generator tool.

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

- Reorganized the example scripts into numbered, Arduino-style topic
  directories (01-Basics, etc.) and added save / GIF / MJPEG examples; added
  a "copy color" auto-threshold color-blob tool to OpenMV IDE.

Bug fixes
---------

- Fixed the WINC1500 ``gethostbyname`` / DNS IP byte order, ``fw_update()``
  firmware verification, and shipped an updated single WINC firmware image.

Hardware and board support
--------------------------

- **WiFi shield** — WINC1500 (firmware 19.4.4).
- :mod:`fir` — MLX thermal-IR sensor.

Breaking API changes
--------------------

v1.3.0 introduces **no breaking Python API changes**. Scripts that ran on
v1.2.0 run unchanged on v1.3.0 — just reflash the firmware. (The WINC1500
WiFi/``usocket`` stack and the :mod:`fir` thermal module are new in this
release; their internal API was finalized within v1.3.0.)