====== Wanesy Wave firmware v2.1.0 (March 2022) ======

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

==== New features ====
  * Dwell Time Applicative Configuration (AS923 only)

===== 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 revision:

  * **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.1.0
  * ESP32 MCU firmware Ver. 2.1.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 ====

=== 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, firmware update procedure must respect the specific order described below (update STM32 first):
<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.1.0_20220303_revs_cde.zip |}}
    * STM32 file: ''stm32_wanesywave_EU868_v2.1.0_DAcde.kbin'' (md5: 1597e8adef1b3b8d45e2cdc188726e5d).
    * ESP32 file: ''esp32_firmware_v2.1.0.bin'' (md5: 4d59916be12171d75e225273f130d752).

  * **Wanesy Wave 915**: {{ :wiki:resources:wifiupdate_wanesywave_us915_v2.1.0_20220303_revs_cdef.zip |}}
    * STM32 file: ''stm32_wanesywave_US915_v2.1.0_DBcdef.kbin'' (md5: b1025f968e6c07ff2aeb4b69ef774295).
    * ESP32 file: ''esp32_firmware_v2.1.0.bin'' (md5: 4d59916be12171d75e225273f130d752).

==== 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.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.