====== AWS IoT Core for LoRaWAN - Kerlink documentation ======

<note important>For gateways configured with version 4.4.1 for AWS, it's necessary to install [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:firmware:lastversion#download|Liveburner IPK 5.X]] and [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:lora:bspf_ressources#download|Basic Station Packet Forwarder]]</note> 


The following guides will walk you through the connection and the usage of Kerlink Gateways and sensor to AWS IoT Core for LoRaWAN.
  - {{ :wiki:lora:1-getting_started_with_kerlink_gateways_aws_iot_core_for_lorawan-v2.0.pdf |Getting started with Kerlink Gateways - AWS IoT Core for LoRaWAN (v2.0)}}
  - {{ :wiki:lora:2-getting_started_with_kerlink_wal-e_aws_iot_core_for_lorawan-v1.3.pdf |Getting started with Kerlink Wal-E - AWS IoT Core for LoRaWAN (v1.3)}}
  - {{ :wiki:lora:3-getting_started_with_kerlink_wal-e_amazon_web_services-v1.3.pdf |Getting started with Kerlink Wal-E - Amazon Web Services (v1.3)}}

===== Declare gateway on AWS =====

To register the Gateway with AWS IoT Core for LoRaWAN, follow these steps:
  * 	Go to the AWS IoT Core console.  
  * 	Choose LPWAN devices in the navigation panel on the left.

<note important>If you don’t see this service in the left panel, do a search in the top bar with the name of the service "wireless connectivity" and choose “AWS IoT Core for LoRaWAN” service, you may change the region to get it enabled in the left panel</note>

  * 	Choose Get started.  This step is needed to pre-populate the default profiles.
  * 	Under Add LoRaWAN gateways and wireless devices, choose Add gateway.
  * 	In the Add gateway section, fill in the GatewayEUI and Frequency band (RF Region) fields.
  * 	Enter a descriptive name in the Name – optional field.  We recommend that you use the GatewayEUI as the name.
  * 	Choose Add gateway
  * 	On the Configure your Gateway page, find the section titled Gateway certificate. 
  * 	Select Create certificate.
  * 	Once the Certificate created and associated with your gateway message is shown, select Download certificates to download the certificate (xxxxx.cert.pem) and private key (xxxxxx.private.key).  
  * 	Copy the CUPS endpoint to your clipboard and paste it in the command to enable basic station
  * 	Choose Submit to add the gateway.  



===== Install & configure gateway for AWS =====

1. Install [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:firmware:lastversion#download|Liveburner IPK 5.X]] and [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:lora:bspf_ressources#download|Basic Station Packet Forwarder]]

2. Basic Station only recognize certificates and keys with specific names, so you need to rename the files as follow:
  * 	Rename the *.cert.pem file as cups.crt
  * 	Rename the *.private.key file as cups.key

3. Upload the files in /user/basic_station/etc directory on the gateway

4. Activate Basic Station Packet Forwarder:
<code>klk_bs_config --enable --cups-uri "https://XXX.cups.lorawan.eu-west-1.amazonaws.com"</code>

===== More information about AWS =====

   * AWS: https://aws.amazon.com
   * AWS IoT Core: https://aws.amazon.com/iot/
   * AWS IoT Core for LoRaWAN: https://aws.amazon.com/fr/iot-core/lorawan/

===== AWS support =====

https://console.aws.amazon.com/support/home/