====== Setup of Wirnet™ iZeptoCell Ethernet Gateway ======

<note warning>First official version compatible with Wirnet iZeptoCell is version 5.5.4. \\
**Wirnet™ iZeptoCell Gateways can ONLY be used with CPF and Basic Station Packet Forwarder. \\
It's NOT possible to install external agents.** </note>

===== Documentation =====

  * Leaflet (contains the list of accessories): {{ :documentation:commercial_leaflet_wirnet_izeptocell_ethernet_v2.0.pdf |}}\\
  * Quick start guide: {{ :documentation:quick_start_guide__izeptocell_ethernet__v5.pdf |}}
  * Web services documentation:  [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:resources:resources#keros_web_services_documentation|click here]] \\
  * Software architecture: [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:general:software_arch|click here]]
  * Installation recommendations: {{ :documentation:an-klk03357_-_lorawan_gateways_installation_recommendations_-_v1.2.pdf | Gateways installation recommendations}}

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

  * [[wiki:systeme_mana:ztp|Zero Touch Provisioning (ZTP)]]
===== 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]]. 
  * Web Interface:  [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:systeme_mana:webui#Web Interface|click here]].
  * ++ Local connection|
\\
You can connect a PC directly to the Wirnet iZeptoCell with a USB cable. In this mode, the gateway will simulate an ethernet device. \\
In nominal case, after few seconds, your PC will obtain an IP address and you will be able to start a SSH client or HTTP connection on gateway IP 192.168.120.1. \\
In particular case you are using a DHCP server on your computer, gateway will directly obtain an IP address. A connection can then be done on this IP address.\\
See [[wiki:systeme_mana:connection_credentials#default_password|here for more information]] about SSH/HTTP connection details.
++
===== 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>


====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]]\\
First official version compatible with Wirnet iZeptoCell is version 5.5.4.

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

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

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]]. 

==== Packet Forwarder configuration ====

Once the packet forwarder is activated 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 iZeptoCell 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 iZeptoCell to AWS IoT Core =====

See [[wiki:lora:basic_station_forwarder#aws_lns_configuration_tool|AWS LNS configuration tool]]


===== Connect an iZeptoCell to The Things Network =====

See [[wiki:lora:basic_station_forwarder#ttn_lns_configuration_tool|TTN LNS configuration tool]]

===== Connect an iZeptoCell to Loriot =====

See [[wiki:lora:basic_station_forwarder#loriot_lns_configuration_tool|Loriot LNS configuration tool]]


===== Connect an iZeptoCell 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 ChirpStack?]]



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

===== Administrative information =====
[[https://wikikerlink.fr/faq/doku.php?id=home#administrative_information|Administrative information]]