REYAX RYLR993 and Helium Network User Guide
Document Date: 10-MAR-2022
1. What is LoRaWAN®?
The LoRaWAN® specification is a Low Power, Wide Area (LPWA) networking protocol designed to wirelessly connect battery-operated 'things' to the internet in regional, national, or global networks. It targets key Internet of Things (IoT) requirements such as bi-directional communication, end-to-end security, mobility, and localization services. For more details, please refer to https://lora-alliance.org/.
2. What is Helium Network
Helium Network is a globally distributed network of hotspots that creates public long-range wireless coverage for LoRaWAN® IoT devices. The Helium blockchain network is an open-source public blockchain that creates decentralized wireless networks. For more details, please refer to https://www.helium.com/.
To check for nearby hotspots, please refer to https://explorer.helium.com/.
3. How to apply Helium Network service
To use Helium Network service, you must purchase DC (DATA CREDITS) for data transmission. Please refer to the website link below for applying Helium Network service: https://docs.helium.com/use-the-network/console/quickstart.
After applying, you can create a Device in the console environment to get "Device EUI", "App EUI", and "App Key". These three data are the account ID and password used by the RYLR993 module to connect to the Helium Network. You can access https://console.helium.com/ to see this information. Typically, it will take a few hours for the sync after you create the Device.
Device Details Example:
- Name: RYLR993
- Device EUI: a97a3088-7c49-4b5f-9dfe-21cae6c0f151
- App EUI: 6081F9AF21685C5F
- App Key: 6081F96BCA11C017
- Activation Method: OTAA
- Profile: None
Data Transmission Summary:
- Packets Transferred (All Time): 47
- DC Used (All Time): 47
- Packets Transferred (Last 7 Days): 47
- DC Used (Last 7 Days): 47
- Packets Transferred (Last 30 Days): 47
- DC Used (Last 30 Days): 47
- Packets Transferred (Last 24 Hours): 47
- DC Used (Last 24 Hours): 47
4. Instruction of how to use RYLR993 and Helium Network for data transmission
The following describes the simple usage process. For advanced usage commands, please refer to the RYLR993 AT Command file.
4.1 Boot Information
The following strings will be occurred after you Boot or RESET:
BAND:US915 +READY
'Stands for the current frequency Band
4.2 Set Frequency Band
After sending "AT+BAND=0", RYLR993 will respond as below:
BAND:AS923 OK
4.3 Test the response of RYLR993
After sending "AT", RYLR993 will respond as below:
OK
4.4 Set DEUI
After sending "AT+DEUI=60:81:F9:AF:21:68:5C:5F", RYLR993 will respond as below:
OK
4.5 Set APPEUI
After sending "AT+APPEUI=60:81:F9:6B:CA:11:C0:17", RYLR993 will respond as below:
OK
4.6 Set NWKKEY
Because Helium Network is an APP itself, therefore the NWKKEY in RYLR993 is, after APPKEY send "AT+NWKKEY=FA:74:AF:C5:95:7A:B7:BF:52:E3:6F:AE:EA:C1:BA:D5:", RYLR993 will respond as below:
OK
4.7 Log in to Helium Network
After sending "AT+JOIN=1", RYLR993 will respond as below:
OK +EVT:JOINED +EVT:RX_1, DR 0, RSSI -19, SNR 8
'Successfully Login to Helium Network
'The quality of the signal status
4.8 Sending data to Helium Network
After sending "AT+SEND=1:1:31323334", RYLR993 will respond as below:
OK +EVT:SEND_CONFIRMED +EVT:RX_1, DR 2, RSSI -18, SNR 7
'Confirmation of sending data successfully
'The payload field are the data that has been uploaded successfully, and the format is BASE64
4.9 Receive the data transmitted from Helium Network to RYLR993
As the figure shown below, 12345678 in Text format can be transferred to RYLR993.
Due to Helium Network can only download the data when RYLR993 is uploading the data, therefore it is needed to send "AT+SEND=1:1:31323334:", and RYLR993 will respond as below:
OK +EVT:SEND_CONFIRMED +EVT:1:08:3132333435363738 +EVT:RX_1, DR 2, RSSI -28, SNR 7
'Confirmation of sending data successfully
5. Helium Network can be integrated with other services
Helium Network can also be integrated with other network protocols and services.
Prebuilt Integrations include:
- Helium Cargo (HTTP)
- myDevices (HTTP)
- Cayenne (HTTP)
- Ubidots (HTTP)
- Datacake (HTTP)
- Tagolo (HTTP)
- Google Sheets (HTTP)
- Microshare (HTTP)
- Akenza (HTTP)
Custom Integrations include:
- MQTT
- AWS IoT Core
- Azure IoT Hub
For more details, visit: https://console.helium.com/integrations