====== Wirnet iBTS KerOS firmware v4.0.2 (March 2018) ======

===== Changes from v3.4.5 =====

==== New features ====

  * Writable File system.
  * Add web interface. 
  * Add SMS management.
  * Add KerOS REST API access. 
  * New backup management system.
  * New package management system.

==== Evolutions====

  * Kernel updated to 4.14.9.
  * Global package update.
  * Discovery performance and stability improved.
  * ''CONFIG_IP_MULTIPLE_TABLES'' is now present on KerOS 4.0.x.
  * IPSec connection with basic PSK authenticated configuration and without ProvenCore works on keros 4.0.x.
  * IPTABLES logging added in ''/var/log/messages'', also visible on the console.
  * Bootcount in U-boot and in ''/tmp/board_info.json'' on KerOS 4.0.x.




===== Restrictions =====

  * **Configuration**
    * The result returned for the field ''rpmb_status'' in file ''/tmp/boar_info.json'' is not correct. This field must not be taken into account in firmware version 4.X. 
    * BNM frequency configuration files depending on the board (bnm-868.conf, bnm-923.conf, bnm-915.conf) are not kept by default when upgrading the gateway.
  * **Security**
    * Provenrun ''rpmb-status'' is not working on kernel 4.14.
  * **SMS Feature**
    * SMS command ''_operator'' doesn't receive a response when it's OK.
    * SMS manager command doesn't work on sierra_0 on Dual WAN iBTS.
  * **System**
    * Possible Kernel errors when using fixnetwork.
    * Default behavior of the ''store-config'' tool is to save the file ''/user/login'' that is not present in KerOS 4.x firmware.
  * **Update**
    * IPK update status is in error for all packages if only one package installation failed.
  * **Web Interface**
    * System manager error in the "Administration" menu when trying to configure a static IP whereas cellular backhaul is already defined as default connection (''main.conf'').
    * After a time modification more than 12h (token validity), the board does not reboot after pressing the "Reboot gateway" button.
    * When editing a cellular operator that is not used, it returns an error.
    * Sometimes GSM status stays green although the cellular is disconnected.


===== Firmware =====

==== Compatibility ====

=== Hardware ===

  * Fully compatible with Wirnet iBTS ATc03 architecture and above.
  * Partially compatible with Wirnet iBTS ATa01 and ATb02 architecture (issue with reset Button).

=== Software ===

  * Compatible with Wirnet iBTS products with Kerlink Production fuses or without any fuses flashed.
  * Simple update (''keros.ipk'') incompatible with firmware older than v4.x → Use of ''liveburner'' package is MANDATORY.
  * Update from v1.x or v2.x to v4.x is not compatible, it is MANDATORY that the firmware is at least in firmware v3.x.
  * ProvenCore firmware and utilities (uploader) changed as of v3.1.0, and files to be uploaded to the ProvenCore have to be processed by ''pnrcipher'' before uploading.

<note warning>Due to multiple KerOS changes, **direct update in v4.x IS NOT COMPATIBLE from firmware v2.x & v1.x**.\\
It is required __first__ to update the gateway in v3.x to be able to update it after with the ''liveburner'' package v4.x.\\
For the update in v3.x, please refer to the [[http://wikikerlink.fr/wirnet-ibts/doku.php?id=resources:resources_keros_fw_3.4.5|Wirnet iBTS wiki, firmware v3.4.5]] page.</note>

==== Delivery ====

<note important>
The firmware is released only in one format: __Liveburner__.

To update the firmware **from v3.x to v4.x**, it is mandatory to use the ''liveburner'' package.
See [[wiki:keros_custo:upgrade#upgrade_using_a_keros_package|system upgrade]] page. 
</note>


===== Download =====

  * Liveburner IPK: {{ :resources_ibts:liveburner_4.0.2_klk-lpbs-signed.ipk | liveburner_4.0.2_klk-lpbs-signed.ipk}} md5: ''291d0fea051ba6cbe53e5c5c00307c0f''
  * 64-bit toolchain: {{ :resources_ibts:poky-glibc-x86_64-keros-toolchain-klk-lpbs-4.0.2.sh | poky-glibc-x86_64-keros-toolchain-klk-lpbs-4.0.2.sh}} md5: ''19bcac3b0cf3aace9e314f972ed2e938''

Hotfix(s) only applicable for this firmware version:

      * {{ :resources_ibts:hotfix-4.0.2-fix-bad-taiclock-with-leap-second_1.0-r0_armv7ahf-neon.ipk |}}; md5 ''6731763af9fc916af526437e3805ea31'': This hotfix is used to enable the International Atomic Time, so LoRa class B can be used.
      * hotfix-enable-tai_1.0.0_klk_lpbs.ipk: DELETED and replace by hotfix-4.0.2-fix-bad-taiclock-with-leap-second_1.0-r0_armv7ahf-neon.ipk