====== Wanesy Wave firmware v2.2.0 (July 2022) ======

===== Changes from previous version =====

==== New features ====
  * WiFi Sniffer Mode

===== Restrictions =====

   * If the installed firmware is 1.8.0 or lower, firmware upgrade procedure must respect specific order described in section below.


===== Firmware =====

==== Compatibility ====

=== Hardware ===

This release is compatible with the following Wanesy Wave revisions:

  * **Wanest Wave 868**:
    * Fully compatible with Wanesy Wave Board ID xxxDAcxxxxxx, xxxDAdxxxxxx, xxxDAexxxxxx.
  * **Wanesy Wave 915**:
    * Fully compatible with Wanesy Wave Board ID xxxDBcxxxxxx, xxxDBdxxxxxx, xxxDBexxxxxx, xxxDBfxxxxxx .


=== Software ===

  * STM32 MCU firmware Ver. 2.2.0
  * ESP32 MCU firmware Ver. 2.2.0


==== Delivery ====

<note important>
The firmware is released in two files: __STM32 MCU__ firmware binary 'kbin' file and __ESP32 MCU__ firmware binary file.\\
</note>

__STM32 MCU :__ \\
To update the firmware, follow instruction on the Firmware update section of the Setup page: [[wiki:setup:setup_wave#firmware_update|click here]].

__ESP32 MCU:__ \\
To update the firmware, follow instruction on the Firmware update section of the Setup page: [[wiki:setup:setup_wave#firmware_update|click here]].



===== Download =====

==== Wi-Fi: Firmware update ====
<note warning>Please check your firmware version before updating and follow the instructions in the corresponding section</note>
=== Installed firmware is v1.9.0 or higher version ===

Regular firmware update can be followed (update ESP32 first), please read {{:documentation:E-CON-Wanesy_Wave_FW_Update_WiFi_V1.2.pdf |}} available in the [[wiki:setup:setup_wave|Wanesy™ Wave Setup: Documentation]] section.

=== Installed firmware is v1.8.0 or lower version ===

If the installed firmware is v1.8.0 or lower version, the firmware update procedure must respect the specific order described below (**<fc #ff0000>update STM32 first</fc>**):
<note important>

^ steps     ^ STM32 version      ^ ESP32 version          ^ SSID          ^ Actions ^
| #1    | v1.7.0/v1.8.0     | v1.7.0/v1.8.0        | optout_klk/wave_xxxx        | **Place product upright away from wall or table**|
|:::|:::|:::|:::|Upload STM32 v2.0.1 image|
|:::|:::|:::|:::|Wait until green LED is back ON (ie. no longer blinking)|
| #2    | v2.0.1     | v1.7.0/v1.8.0        | optout_klk/wave_xxxx        | Verify STM32 version in device_info.txt file |
|:::|:::|:::|:::|Upload ESP32 v2.0.1 image|
| #3    | v2.0.1     | v2.0.1        | wave_xxxx        | Verify ESP32 version in esp32_version.txt file (displayed version is 2.0.0)|
</note>
  * **Wanesy Wave 868**: {{ :wiki:resources:wifiupdate_wanesywave_eu868_v2.2.0_20220707_revs_cde.zip |}}
    * STM32 file: ''stm32_wanesywave_EU868_v2.2.0_DAcde.kbin'' (md5: 39f7e4136948d2380473e6092e020ef4).
    * ESP32 file: ''esp32_firmware_v2.2.0.bin'' (md5: 661949ff2cf24e5b93b2b92e54dce98e).

  * **Wanesy Wave 915**: {{ :wiki:resources:wifiupdate_wanesywave_us915_v2.2.0_20220707_revs_cdef.zip |}}
    * STM32 file: ''stm32_wanesywave_US915_v2.2.0_DBcdef.kbin'' (md5: b95353709a8bc3a354f09d210a1bba43).
    * ESP32 file: ''esp32_firmware_v2.2.0.bin'' (md5: 661949ff2cf24e5b93b2b92e54dce98e).

==== Wi-Fi: region configuration ====

  * **Wanesy Wave 868**: {{ :wiki:resources:region_conf_wifiupdate_wanesywave_868_v1.8.0_20210421_revs_cde.zip |}}
    * cmd_region_EU868.txt
    * cmd_region_IN865.txt

  * **Wanesy Wave 915**: {{ :wiki:resources:region_conf_wifiupdate_wanesywave_915_v1.8.0_20210421_revs_cdef.zip |}}
    * cmd_region_US915.txt
    * cmd_region_AU915.txt
    * cmd_region_AS923.txt

===== History =====
   * 2.2.0 (June 2022):
    * WiFi Sniffer Mode
   * 2.1.0 (March 2022):
    * Dwell Time Applicative Configuration
   * 2.0.1 (October 2021):
    * BLE Asset Monitoring
    * LoRaWan region setting resilient to factory reset
   * 1.9.0 (May 2021):
    * Improve BLE scan robustness
    * Maximize WiFi STM32 FW update success
    * Earlier initialization of critical GPIOs
   * 1.8.0 (February 2021):
    * Support of multiple regional parameters.
    * Use unconfirmed TX on LoRaWAN services.
    * Wi-Fi update over HTTP.
    * Access Point SSID personal identification based on EUI.
    * Limit duration of Wi-Fi access point availability.
   * 1.7.0 (June 2020):
    * Initial release for Wanesy Wave.