====== KerOS firmware v5.5.4 (July 2022) - OBSOLETE ======

===== Changes from v4.3.3 =====

==== Release corrections ====
  * No NTP synchronization with GPS without internet <fc #008000> - solved</fc>
  * APN v.sarenet.es is refused by Ofono <fc #008000> - solved</fc>

==== New features ====
  * Support of Wirnet iZeptoCell Ethernet
  * Support of Helium network


==== Evolutions====
  * Linux Kernel update to new LTS (Long Term Support)
    * Linux Kernel LTS 5.4
    * Yocto 3.1.7
    * Upgrade to OpenSSL 1.1.1k
    * Upgrade to Connman 1.39 and Ofono 1.31
    * Upgrade of Python from 2.x to 3.x
  * New Secure Core software (needed for Helium miner)
===== Restrictions =====
  *** IPSec is not yet supported **
  * 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.3.3, 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 (please contact Kerlink if you plan to use one)


===== Firmware =====

==== Compatibility ====

=== Hardware ===

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

++++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.
  * **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.
  * **Wirnet iZeptoCell**:
    * Fully compatible with all Wirnet iFemtoCell-evolution Board ID.
++++

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

<note warning>Installation of SPN firmware from version 5.X is not possible. You will have to downgrade from 5.X to 4.3.3-2 (available bellow).</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.5.4.
  * Reset the default password on your gateway.
  * Erase the whole partition to reinstall the firmware.
</note>

===== Download =====

  * Liveburner IPK 4.3.3-2: {{ :resources_multi_hardware::liveburner_4.3.3-2_klkgw-signed.ipk}} md5: ''12CFEFB8D4630A34AA90C77E6C73A193''
  * 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.5.4.sh}} md5: ''d122065a695705d1df8b29e80799e935''