====== Setup of iFemtoCell-evolution Hotspot======

{{images:wirnetifemtocellevolution.png?200}}

  * {{ :e-dmk-quick-start-guide-wirnet_ifemtocell-evolution_v3.0-1.pdf |Wirnet iFemtoCell-evolution - Quick start guide}}\\
  * **Content of the box:** iFemtoCell-evolution + Indoor antenna + Power supply
  * **Available connections:** **Ethernet*** (preferred) & Cellular 4G

**Ethernet*** The maximum Ethernet cable length is 100m

===== Install the Hotspot =====
<note important>For best mining performance, place the hotspot on the roof or high up. It is very important to maintain the antenna vertically and without any obstacle at 20 cm around. \\ Avoid placing the hotspot in places where it cannot see the outside world: in basements, in cabinets, behind TVs, metal screens.\\
You can manage, plan and optimize your hotspot locations using [[https://hotspotty.net/manage-plan-optimize-hotspot-locations/|Hotspotty]]</note>

{{images:warning_install_fevo.png?600}} \\     
The Wirnet iFemtoCell-evolution may be mounted on a wall using the two oblong holes. \\     
Only two screws (not included) are needed, all mounting information is mentioned on the following drawing: **/!\ Never use hooks!**\\     
{{images:ifemto.png?200}} \\     
{{images:warning_connection.png?700}} \\     
Once the Wirnet iFemtoCell-evolution is installed, you can select up to 2 technologies to access to Internet for the data backhaul: \\     
  * Ethernet connection, requiring an Ethernet access through a dedicated RJ45 cable (not included) \\     
  * 4G/3G cellular connection, requiring an USIM (not included) and a data subscription (not included)
Note that both configurations can be used in parallel. For example, RJ45 Ethernet with a 4G/3G link as a backup. \\     
{{images:install.png?600}} \\     
 \\     
Once the LoRa RF antenna, the Ethernet cable (if used) or the 4G/3G (with USIM card inserted) and the power supply jack connector are plugged, the Wirnet iFemtoCellevolution can be powered ON by connecting the power supply.

===== Power On the Hotspot & LED status =====
Once the LoRa RF antenna, the Ethernet cable (if used) or the 4G/3G (with USIM card inserted) and the power supply jack connector are plugged, the Wirnet iFemtoCellevolution can be powered ON by connecting the power supply. \\     
The button available on the right of the hotspot and accessible thanks to a tool with a 1mm diameter allows to reset the hotspot as follow:\\     
  * The ON/OFF/RST button must be pressed during 1s to reboot the hotspot.
  * A long press for 5s turns off the hotspot.
  * A short press turns on the hotspot.
{{images:led_fevo.png?400}}

===== Connection to the Hotspot =====
==== Connect to Web interface ====
<note important>**DO NOT CLICK on RESET FACTORY button** as it will remove the Helium miner software from your Hotspot. \\ The feature is reserved to technical Support Team</note>

++++The easiest way to connect to your hotspot is to address it by name.| 
Wirnet gateways are named after their serial number, as described below, with XXXXXX replaced by the last six hexadecimal digits from the board ID.

  * **Wirnet iFemtoCell-evolution:**''http://klk-fevo-XXXXXX.local ''

For the Wirnet iFemtoCell with 704BEc1234AB as board ID, the hostname will be: **klk-wifc-1234AB**. 

It is also possible to enter the IP address of your hotspot into your browser’s URL bar (Make sure your computer is on the same local network).\\

The default credentials are:\\
Login:''admin''\\
Password:''pwd4admin''\\
It's very recommended to change them.\\

{{:images:WI_overview.png?1000|}}
++++
++++ Using local connection through USB-C.|
You can connect a PC directly to the  iFemtoCell-evolution with a USB cable. In this mode, the hotspot 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 hotspot IP 192.168.120.1.
  * In particular case you are using a DHCP server on your computer, hotspot will directly obtain an IP address. A connection can then be done on this IP address.
{{images:usb-c_connection.png?600}} ++++

==== Network setup ====
The network can be easily configured thanks to the web interface.

++++ Ethernet (default) |
Simplest and preferred. Available on all Kerlink hotspots\\

= >  Plug the hotspot to the WAN access point with an Ethernet cable. The connection will be established automatically.\\
\\
  * You can enabled/disabled the Ethernet connection but be careful of the consequences of disabling
<note warning>
  * If you turn OFF IPv4 configuration, you are disconnected from the web interface and Ethernet is fully disabled!
</note>
  * You can configure your IPV4 connection:
    * DHCP.
    * Manual: Use a static IP.
    * OFF: Will turn OFF the IPv4 configuration.

{{:images:wi_network_ethernet.png?1000|}}
++++

++++ Cellular |
<note important>If you are using cellular connection, your hotspot will stay in relayed mode.\\
Please see [[#4.3 Network configuration|4.3 Network configuration]]</note>
The cellular access can be configured in the web interface.\\
Cellular connection requires an USIM and a data subscription (not included)\\

  * Insert SIM 
  * If it does not work out of the box, you may need to configure APN of the SIM card on the web interface 
  * If so, enter the MCC/MNC corresponding to your network operator

{{:images:wi_network_GSM.png?1000|}}

<note important>
  * If a Roaming SIM card is inserted in the hotspot, the **MCC/MNC** codes to configure should be those ones of the SIM and not those of the local operator.
  * The **APN** to configure is the one of the SIM provider also, not the one of the local operator.
</note>
**To test if the configuration is the good one, please just unplugg Ethernet cable and wait for some minutes, the backhaul should automaticaly switch to cellular connection.**
You may use the onboarding dashboard to check connectivity after 15-30 minutes.
++++

The Full Miner communicates over a peer-to-peer (P2P) network and needs to connect to the remote port 44158. \\
**The Light Hotspot → Validator connection is a standard gRPC connection. The default port Validators listen on is 8080 so Hotspots should be able to connect Outbound to that port.** \\
Hence, other miners must have this port forwarded to their miner IP address, and so should you. Indeed, other miners will want to connect to your miner too. \\
More info on port forwarding can be found on Helium documentation:\\
  * [[https://docs.helium.com/troubleshooting/understanding-witnesses/#relayed-hotspots-and-the-importance-of-opening-ports|Why open ports? ]]
  * [[https://docs.helium.com/troubleshooting/network-troubleshooting/|Network troubleshooting ]]

<note important>Do not expose/port forward the TCP port 80 from the outside. </note>

===== Firmware and Miner updates =====
Firmware and miner updates are managed by KERLINK. 

===== Factory reset =====
<note warning>It will delete Helium on your Hotspot. DO NOT USE except if your reseller asked you to factory reset your Hotspot! </note>

===== LoRaWAN protocol =====
Kerlink is a member of LoRa Alliance and the Kerlink hotspot 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]]