sascha_hemi/pycom-documentation
1
0
Fork 0
mirror of https://github.com/sascha-hemi/pycom-documentation.git synced 2026-03-21 03:04:13 +01:00
Code Issues Packages Projects Releases Wiki Activity

added Helium to LoRaWAN services

Browse Source
This commit is contained in:
gijsio
2021-06-21 15:31:26 +02:00
committed by peter-pycom
parent a99849e3d6
commit d831390925
3 changed files with 38 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
config.toml
View File

@@ -137,6 +137,13 @@ theme = "doc-theme"
parent = "gettingstarted@registration@lora"
weight = 30
[[menu.main]]
name= "Helium"
url = "/gettingstarted/registration/lora/helium/"
identifier = "gettingstarted@registration@lora@helium"
parent = "gettingstarted@registration@lora"
weight = 40
# *** Tutorials & Examples
[[menu.main]]
name = "Tutorials & Examples"

16
content/gettingstarted/registration/lora/_index.md
View File

@@ -11,25 +11,13 @@ When using raw LoRa, you do not have to register your module in any way. The mod
In order to connect your LoRa capable Pycom module to a LoRaWAN network you will have to register your device with the desired network. We are unable to provide instructions for all LoRaWAN networks but below you will find some generic instructions, along with links to any specific guides we are aware of.
### Generic instructions
Firstly you will need to get your modules `Device EUI`, this can be achieved using the following code:
```python
from network import LoRa
import ubinascii
lora = LoRa(mode=LoRa.LORAWAN)
print(ubinascii.hexlify(lora.mac()).upper().decode('utf-8'))
```
The output will be a hex string like: `70B3D5499585FCA1`. Once you have this you will need to provide it to your LoRaWAN network which will then provide you with the details need to connect via Over-the-Air Activation (OTAA) or Activation by Personalisation (ABP)
#### OTAA
### OTAA
If you wish to connect via OTAA (which is the recommended method) the network will provide you with an `Application EUI` and `Application Key`. The former identifies what application your device is connecting to, the latter is a shared secret key unique to your device to generate the session keys that prove its identity to the network. Once you have these you can use the [LoRaWAN OTAA example](/tutorials/networks/lora/lorawan-otaa) code to connect to the network.
#### ABP
### ABP
With ABP the encryption keys enabling communication with the network are preconfigured in the device. The network will need to provide you with a `Device Address`, `Network Session Key` and `Application Session Key`. Once you have these you can use the [LoRaWAN ABP example](/tutorials/networks/lora/lorawan-abp) code to connect to the network.

29
content/gettingstarted/registration/lora/helium.md Normal file
View File

@@ -0,0 +1,29 @@
---
Title: "Helium"
---
Helium is a LoRaWAN service that allows you to send and receive LoRa packets from your nodes. The network allows for cost-effective wireless infrastructure using the new HNT blockchain as an incentive for the creation of public gateways.
> At the moment, it is not possible to mine HNT on the Pygate or nano-gateway.
* [Create an account](#create-an-account)
* [Add a device](#add-a-device)
* [Registering a gateway](#registering-a-gateway)
## Create an account
Go to [console.helium.com](https://console.helium.com]) to create an account and verify your email-address. Once your account is registered, you can select to [add a device](#registering-a-devi)
![](/gitbook/assets/lorawan/helium/helium.png)
## Add a device
To add a device, click `Devices` in the left hand menu bar and `Add device` on the following page. The following screen will pop up:
![](/gitbook/assets/lorawan/helium/device.png)
Give your device a human-readable name. All other credentials should be filled in already. After successful creation, the device will be shown. You can use the credentials in the [LoRaWAN OTAA](/tutorials/networks/lora/lorawan-otaa/) example.
## Register a gateway
For more information about registering a gateway, we'd like to forward you to the [Helium Docs](https://docs.helium.com/use-the-network/build-a-packet-forwarder#packet-forwarder-architecture). Note that the Pygate uses a Semtech UDP forwarding architecture, and you will need to configure your own miner.