====== KerOS firmware v4.2.2 (March 2020) ======

===== Changes from v4.1.6 =====

==== New features ====

  * Support for Wirnet™ iFemtoCell-evolution.
  * Add BNM support for iStation and iFemtoCell-evolution.
  * Add ''get_logs'' tool to simplify troubleshooting

==== Evolutions====

  * Improvement around gsmdiag (show status file by default).
  * Re-index eMMC device and always set it to /dev/mmcblk0 (instead xx0 for iBTS and xx1 for iFemtocell).
  * Disable watchdog self-refresh during kernel boot.

===== Restrictions =====

  * **SMS Feature**
    * SMS manager command doesn't work on sierra_0 on Dual WAN iBTS.
    * SMS is not working with dongle E3372s with some SIMs.
  * **Update**
    * IPK update status is in error for all packages if only one package installation failed.
  * **Network**
    * Network monitoring does not restart a service if a DNS problem occurs.
  * ** WiFi (iFemtoCell only) **
    * Impossible to connect with an Android system to Access Point WiFi of the gateway.
    * No fallback on WiFi.
    * Some instabilities with the WiFi interface.


===== Firmware =====

==== Compatibility ====

=== Hardware ===

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

++++Details|
  * **Wirnet iBTS**:
    * Fully compatible with Wirnet iBTS CPU module xxxATc03xxxx and above.
    * Partially compatible with Wirnet iBTS CPU module xxxATa01xxxx and ATb02xxxx (issue with reset Button).
  * **Wirnet iFemtoCell**:
    * Fully compatible with Wirnet iFemtoCell Board ID xxxBEb02xxxx, xxxBEc03xxxx, xxxBQa01xxxx and xxxBPa01xxxx.
    * Partially compatible with Wirnet iFemtoCell Board ID xxxBEa01xxxx.
    * List of compatible USB cellular dongles is available [[wiki:ifemtocell:cellular_backhaul_ifemto|here]].
  * **Wirnet iStation**:
    * Fully compatible with Wirnet iStation Board ID xxxCFb02xxxx, xxxCGb02xxxx, xxxCHb02xxxx and above.
  * **Wirnet iFemtoCell-evolution**:
    * Fully compatible with all Wirnet iFemtoCell-evolution Board ID xxxCVa01xxxx, xxxCWa01xxxx, xxxCXa01xxxx and above.
++++

=== 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 v4.0.x → In order to keep your data, first update in v4.0.x using ''liveburner'' package, this is MANDATORY.
  * Liveburner 4.2.2 package is compatible with 3.x and 4.x firmware.

<note warning>Due to multiple KerOS changes, **direct update in v4.2.2 IS NOT COMPATIBLE from firmware v3.x, v2.x and v1.x**.\\
In order to keep your data, it is required __first__ to update the gateway in v4.0 with the ''liveburner'' to be able to update it after with the ''KerOS'' package v4.2.2.\\
For the update in v4.0, please refer to the [[wiki:keros_custo:upgrade_keros3_to_4|Upgrade from KerOS version 3.x to 4.0 with custom liveburner]] page.</note>


==== Delivery ====

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

__KerOS :__ Update the Firmware\\
To update the firmware **from v4.0 or 4.1 to v4.2.2**, 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 4.2.2.
  * Reset the default password on your gateway.
  * Erase the whole partition to reinstall the firmware.
</note>

===== Download =====

  * KerOS IPK: {{ resources_multi_hardware::keros_4.2.2_klkgw-signed.ipk | keros_4.2.2_klkgw-signed.ipk}} md5: ''e018e5f821c86892b6555c9ed4cf2691''
  * Liveburner IPK: {{ resources_multi_hardware::liveburner_4.2.2_klkgw-signed.ipk | liveburner_4.2.2_klkgw-signed.ipk}} md5: ''cf8110d7567afb441bbac6d535da1f40''
  * 64-bit toolchain: {{ resources_multi_hardware:poky-glibc-x86_64-keros-toolchain-klkgw-4.2.2.sh | poky-glibc-x86_64-keros-toolchain-klkgw-4.2.2.sh}} md5: ''630ad15c58877abe5f37bd79a6926418''


===== 4.2.x History =====

   * 4.2.2 (March 2020):
    * Fix rare deadlock on iBTS
    * disable watchdog self-refresh during kernel boot
    * few fixes on 'get_logs'
   * 4.2.1 (January 2020):
    * few fixes on ntpd config and bnm
    * Add 'get_logs'
   * 4.2.0 (November 2019)