====== KerOS firmware v5.7.2 (February 2023) ======

===== Changes from v5.5.4 =====

==== Release corrections ====

  * Fix security vulnerabilities on KerOS API
  * Trigger autorestart of GWMP sockets when uplink message are timed out
  * [[wiki:systeme_mana:time_management#network_configuration|Define pools]] instead of servers for NTP synchronization
  * Properly stop and restart LoRaWAN frames reception when applying a different channel plan

==== New features ====

  * [[wiki:lora:advanced_features#lorawan_frame_filtering|Advanced LoRaWAN frames filtering]] (normal and reverse) with the support of :
    * Multiple ranges filters for NetID, JoinEUI and DevEUI 
    * Proprietary frames
  * [[wiki:network_mana:backhaul#cellular_configuration|Support default generic APN configuration]] (no MCC/MNC needed), by default set to BICS APN in provisioning file
  * Limited support of [[wiki:quickstart:quickstart_izepto_cellular|Wirnet iZeptoCell Cellular]], see restrictions for more details

==== Evolutions====

  * Make ZTP more robust against backhaul disconnections
  * Set network monitoring enabled by default
  * [[wiki:systeme_mana:webui:zcel|Prevent disabling cellular backhaul]] on WebUI for new product iZeptoCell-Cellular
  * Set a [[wiki:network_mana:backhaul#network_auto-connection_and_fallback|fallback DNS server]] configuration by default
  * Automatically adjust TCP packets (fragmentation) depending on backhaul MTU
  * Add [[wiki:support:troubleshoot#automatic_log_gathering|option --minimal/-m]] for get_logs script to get a smaller logs archive
  * Support of Japan version of WAN modem installed in iFemtocell-evo 923 and iStation 923

==== Restrictions ====
  * Some issues with the Wi-Fi interface (instabilities, no fallback...) on Wirnet iFemtoCell
  * When upgrading from KerOS firmware 4.x, all trustzone secrets are lost
  * When upgrading from KerOS FW 4.x, a hardware reset is necessary for FW 5.x burner to correctly detect USB
  * Update status for an update from KerOS FW 5.1.x, FW 5.2.x or FW 5.3.x is in error, but the update is working fine
  * No more support of GSM dongles


===== Firmware =====

==== Compatibility ====

  * Compatible with Wirnet™ i-series gateways (Wirnet iBTS, Wirnet iFemtoCell, Wirnet iStation, Wirnet iFemtoCell-evolution, Wirnet iZeptoCell Ethernet, Wirnet iZeptoCell Cellular).

{{:images:compatibility-5.7.2.jpg?1100|}}

=== Software ===

  * Compatible with Wirnet™ i-series gateways secured with Kerlink Production fuses or without any fuses flashed.
  * Regular update (''keros.ipk'') is **incompatible** with firmware older than v5.x

<note important>
  * To upgrade the system from KerOS version 4.3.3 to KerOS version 5.x the use of a liveburner is MANDATORY. Two possibilities are available:
    * Upgrade with a custom liveburner. It allows to keep some elements like gateway configuration. To use a custom liveburner, please refer to the dedicated page: [[wiki:keros_custo:upgrade_major_version|Major version upgrade with a custom liveburner]].
    * Upgrade with a regular liveburner (erasing the whole partition to reinstall the firmware)
</note>

==== Delivery ====

<note important>
The firmware is released in two formats: __KerOS__ and __Liveburner__.\\

__KerOS :__ Update the Firmware\\
To update the firmware **from v5.x**, the regular update procedure can be used.
See [[wiki:keros_custo:upgrade#upgrade_using_a_keros_package|system upgrade]] page.

\\
__Liveburner :__ Reset the Firmware of the product
  * Update stock restore version with FW 5.7.2.
  * Reset the default password on your gateway.
  * Erase the whole partition to reinstall the firmware.
</note>

===== Download =====

  * KerOS IPK:{{ :resources_multi_hardware::keros_5.7.2_klkgw-signed.ipk}} md5: ''dbc5eaf5f7cbdae2691f74d98a259a58''
  * Liveburner IPK 5.7.2: {{ :resources_multi_hardware::liveburner_5.7.2_klkgw-signed.ipk}} md5: ''197c9c8f14952b1bf8339ad4c5863c2f''
  * Liveburner IPK 4.3.3-2: {{ :resources_multi_hardware::liveburner_4.3.3-2_klkgw-signed.ipk}} md5: ''12CFEFB8D4630A34AA90C77E6C73A193''
  * Custom liveburner IPK: {{ :resources_multi_hardware::custom-liveburner_5.7.2_klkgw-signed.ipk}} md5: ''455a15b7b10dae4171a2e8b1b04fdf79''
  * Update liveburner package: {{ :resources_multi_hardware::update_liveburner_package-v5.5.4.tar.gz}} md5: ''b34113c633b829de2422e297ccdb1f53''
  * 64-bit toolchain: {{ :resources_multi_hardware::poky-glibc-x86_64-keros-toolchain-klkgw-5.7.2.sh}} md5: ''25044a8909fa95749ad2eb8bcf52e00d''