Wirnet™ i-series

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Setup of Wirnet™ iFemtoCell-evolution Gateway ======

===== Documentation =====

  * Leaflet (contains the list of accessories): {{ :documentation:commercial_leaflet_wirnet_ifemtocell-evolution_v2.4.pdf |}}\\
  * Product Description: {{ :documentation:e-con-product_description_wirnet_ifemtocell_evo-v2.0.pdf |}}
  * Quick start guide: {{ :documentation:e-dmk-quick-start-guide-wirnet_ifemtocell-evolution_v5.0.pdf |}}\\
  * Web services documentation:  [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:resources:resources#keros_web_services_documentation|click here]] \\
  * SMS documentation:  [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:resources:resources#keros_sms_documentation|click here]]
  * Application notes: [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:resources:resources#application_notes|click here]]
  * Software architecture: [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:general:software_arch|click here]]
  * Accessories documentation: [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:resources:resources#accessories_documentations|click here]]
  * Installation recommendations: [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:ifemtocell-e:installation_ifevo|click here]]

===== Zero Touch provisioning (ZTP) feature =====

The KerOS FW 4.3.3 integrates the Zero Touch provisioning (ZTP) feature.\\
When you receive the gateway, you don’t need anymore to install software or to configure it, it is plug&play: you connect the gateway to the network with an Ethernet connection and the gateway will be automatically self-provisioned and configured for your needs. \\

Supported configuration includes:
  * Connection to Kerlink Wanesy Management Center (WMC).
  * 4G backhaul configuration.
  * Chirpstack or TTN configuration.

ZTP feature is available when the gateway boots for the first time with an available internet connection.
<note important>The gateways already deployed or upgraded with KerOS FW 4.3.3 are not concerned by ZTP feature, only the gateways natively produced with KerOS FW 4.3.3 (and later versions) are concerned.</note>
<note warning>The gateway must remain powered up and connected to Internet with Ethernet during the entire ZTP process.</note>

To enable ZTP on a gateway, it must be pre-declared on Kerlink ZTP Management server. 
Please contact Kerlink for more information at [[support@kerlink.fr]].


===== Connection to the gateway =====

Connection to the gateway can either be done via:

  * SSH:  [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:systeme_mana:connection_credentials#network_shell_access_ssh|click here]]. 
  * Debug probe:  [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:ifemtocell-e:connect_ifevo#debug_probe|click here]].
  * Web Interface:  [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:systeme_mana:webui#Web Interface|click here]].
  * USB-C:  [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:ifemtocell-e:connect_ifevo#local_connection_usb#USB-C|click here]].



===== Firmware update and configuration =====

<note> A simplified upgrade method is proposed to configure the Wirnet™ Gateways with the Wanesy™ Management Center. This method is called the [[http://wikikerlink.fr/wanesy-ran/doku.php?id=wiki:wiki3:magic_link|Magic Link]].

The Magic Link is a command line, based on ''wget'' that automatically downloads the required embedded software, configures the VPN connection, configures the packet forwarder with the adapted default configuration, all in one step.</note>

<note warning>
The iFemtoCell and the iFemtoCell-evolution are 2 different products.
Compatible firmware for iFemtoCell-evolution are firmwares 4.2.2 and above. Older firmware **MUST not** be installed on iFemtoCell-evolution. It will brick the gateway.
</note>
====Check the firmware version:====
Use the FAQ chapter “How to read the software version”:  [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:support:faq#how_to_read_software_version|click here]]\\

====Download the last firmware version:====

=== Upgrade with configuration lost (if the gateway is new, use this case) ===

  * Go on the KerOS firmware last version page:  [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:firmware:lastversion|click here]]. 
  * On the bottom of the page download the **liveburner IPK** file. This upgrade will factory reset the gateway and upgrade it with the last version. The current configuration is erased.

=== Upgrade with configuration preservation===

== Upgrade from KerOS version A.x to A.y (same major version)== 

  * Go on the KerOS firmware last version page:  [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:firmware:lastversion|click here]]. 
  * On the bottom of the page download the **KerOS IPK** file.
  * If specific files need to be preserved consult the upgrade information page:  [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:keros_custo:upgrade#upgrade_process|click here]].

== Major version upgrade from KerOS version 4.3.3 to 5.5.4==
KerOS v5.x introduces some important modifications. If some elements, like the configuration, need to be kept during the upgrade from version 4.3.3 to 5.5.4, a specific upgrade must be follow. The procedure is described on the "Major version upgrade with a custom liveburner" page:  [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:keros_custo:upgrade_major_version|click here]].


==== Update the firmware:====

Update of the gateway's firmware can be done over Network, USB or Web interface. 
Use the previously downloaded IPK file (liveburner or KerOS) and follow the indication of the dedicated page Software updates:  [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:keros_custo:sw_updates|click here]].

===== Packet Forwarder activation and configuration =====

Kerlink provides a packet forwarder (CPF) compatible with Wirnet iFemtoCell-evolution gateways. A packet forwarder is the main program of a LoRa gateway. It has to be installed and configured to implement a LoRaWAN network. 

==== Packet forwarder activation ====

Starting with Wirnet gateways firmware version v4.3.0, packet forwarder is included in the firmware. The CPF does not need to be installed. The CPF needs to be enable. To consult how to enable the CPF: [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:keros_custo:keros_applications_configuration|click here]]. 


++++ Pre-compiled packet forwarder installation - firmware before 4.3 |
  * Find which is the last CPF version compatible with your gateway firmware in the compatibility matrix: [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:resources:resources#packet_forwarder_compatibility_matrix|click here]]
  * Go on the page dedicated to the CPF version needed. Quick link to the last CPF version page:  [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:lora:cpf_last_version|click here]].
  * Download the **“lorad”** and **“lorafwd”** .ipk packages files available at the end of the page.
  * Install the .ipk files using the instructions of the software updates page:  [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:keros_custo:sw_updates|click here]]

++++

==== Packet Forwarder configuration ====

Once the packet forwarder is installed on the gateway, it must be configured to be functional.
  * Go on the Kerlink Common Packet forwarder page and select your CPF version:  [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:lora:cpf#installation_and_configuration|click here]].
  * On the CPF configuration page look at the chapter "How to configure and monitor the packet forwarder?"

===== Factory reset =====
If needed the factory reset of the gateway is feasible. Consult the stock restore process:  [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:systeme_mana:features#stock_restore|click here]]

===== Get the logs =====
To simplify the log gathering process, Kerlink developed automatic log gathering methods. Consult the Automatic log gathering chapter:  [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:support:troubleshoot#automatic_log_gathering|click here]]


===== Connect an iFemtoCell-evolution to WMC =====

  * Please contact Kerlink Support team at [[support@kerlink.fr]] to get a Magic Link to update the gateway with the relevant firmware and embedded applications.
  * [[https://wikikerlink.fr/wanesy-ran/doku.php?id=wiki:wiki3:quickstart|How to connect a gateway to WMC?]]


===== Connect an iFemtoCell-evolution to AWS IoT Core =====

  * Please contact Kerlink Support team at [[support@kerlink.fr]] to get a Magic Link to update the gateway with the relevant firmware.
  * [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:lora:aws|How to connect a gateway to AWS IoT Core?]]

===== Connect an iFemtoCell-evolution to The Things Network =====

[[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:keros_custo:keros_applications_configuration#connect_a_wirnet_i-series_gateway_to_the_things_network|How to connect a gateway to The Things Network?]]


===== Connect an iFemtoCell-evolution to ChirpStack =====

[[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:keros_custo:keros_applications_configuration#connect_a_wirnet_i-series_gateway_to_chirpstack|How to connect a gateway to ChripStack?]]



===== LoRaWAN protocol =====
Kerlink is a member of LoRa Alliance and the Kerlink gateway is compatible with LoRaWAN protocol.
If you need information about LoRaWAN network protocol please contact the LoRa Alliance and request LoRaWAN specification : [[https://lora-alliance.org/lorawan-for-developers]]

===== Register to wiki update notifications =====
You can register for Wiki update notifications by clicking on the envelope icon (“Manage subscriptions”) on the right side of the page.
Wirnet™ i-series

User Tools

Site Tools

Page Tools
