For makers and academics
LoRa4Makers is an easy entry door to the Proximus LoRaWAN network. Makers and academic users can now conveniently develop their LoRaWAN prototypes and connect these to our network at no charge. Access to the network is offered for a limited period of 4 months, enough time to validate the development of your prototypes.
LoRa4Makers supports the configuration of up to 5 ABP devices (Activation By Personalization). Each configured device will be allowed 288 uplink messages per day.
When working with AllThingsTalk LoRa Rapid Development Kits, LoRa4Makers provides the ability to decode standard payloads. Any other generic LoRa device's payload will not be decoded, however the CloudEngine can be used for that purpose.
Commercial use of Proximus LoRaWAN
We recommend you make use of the Proximus MyThings solution for any planned production use, or if any of the following features are important to you:
- Broad range of payload decoders for professional devices
- Support for ABP and OTAA devices
- Support for downlink messages
Please note that the Proximus MyThings APIs on this platform require that you have an existing and active MyThings contract with Proximus. Customers looking to subscribe to MyThings can send their enquiry to email@example.com.
Activating your device
Even if your device is sending messages to the Proximus LoRa network, they will not flow into the EnCo platform until the device is activated here. To activate it:
- Sign in using your EnCo account
- Make sure you are already subscribed to LoRa4Makers
- Create a Lora device in LoRa4Makers microsite.
The following types of LoRa devices are supported:
- Generic LoRa devices: any generic ABP LoRa-capable device, which can be activated on the Proximus LoRa network, except for AllThingsTalk devices.
- AllThingsTalk Rapid Development Kits created by AllThingsTalk, for which LoRa4Makers will decode the payload, as long as these are sent from the ATT kits as "CONTAINERS" (#define CONTAINERS in your project file)
The general device activation flow is as follows:
- Subscribe to the LoRa4Makers asset on the Proximus API Solutions marketplace (EnCo) if you haven't already
- Open the LoRa4Makers microsite
- Click on
+button to create a new device
- Provide a unique device ID (name) and device Unique Identifier.
- Associate at least one tag to the device. Press enter or tab after typing a tag name.
- Choose the device type
- Click Add
A confirmation windows will appear with all data you may need to configure your hardware device, namely:
- Device address
- Application Session Key
- Network Session Key
Modifying and deleting devices
The LoRa4Makers microsite further allows you to:
- View your device data - in case you need to copy again the address and keys
- Edit your device - to change its name or associated tags
- Delete your device
Retrieving device data
Once your device has been created and your hardware properly configured, you are ready to start receiving your messages. The LoRa4Makers microsite will show a count of messages received during the day for each created device.
All messages are forwarded to the CloudEngine. Make sure you are subscribed to CloudEngine in our marketplace. The free plan lets you reach 1500 free executions per day, enough to process 288 messages coming from 5 devices.
CloudEngine inbound endpoint
Your device data is available in CloudEngine via the new
LoRa4Makers inbound endpoint.
After adding the LoRa4Makers inbound endpoint to your CloudEngine script or flow, you can define filters on incoming data by clicking on this endpoint and adding tags. The following filters are supported:
- DevEUI : filtering on specific device mac addresses (wildcards are not supported)
- device ID : filtering based on the name of your device (wildcards are not supported)
- device tags : based on the tags you associated to your device when creating it
The message data is accessible in your CloudEngine flow or script in a data array:
Common data fields
|DevEUI||device unique identifier|
|Time||The timestamp indicating the moment of the reading|
|DeviceName||The alias name of the device|
|DeviceAddress||This is a unique identifier for the device provided by Proximus|
|FPort||The application port (* or 1-255)|
|FCntUp||LoRa received packet counter value for uplink|
|FCntDn||LoRa received packet counter value for downlink|
|LrrRSSI||LoRa base station Received Signal Strength|
|LrrSNR||LoRa base station Signal to Noise Ratio|
|SpFact||LoRa spreading factor|
|SubBand||LoRa subband used|
|Channel||LoRa channel used|
|DvLrrCnt||Amount of lrr's|
|LrrId||Identifier of the LoRa base station|
|Tags||JSON array as a string, containing the device-specific tags|
Generic device data fields
For generic LoRa devices created with LoRa4Makers, the following data field will always be added to the common data fields:
|PAYLOAD||the binary representation of the message|
Exemple of a data array for a generic LoRa device:
[LrrSNR=9.0, Lrrid=004A059B, SpFact=9, SubBand=G3, FPort=1, Channel=LC6, PAYLOAD=1010/9002,20/153,0, FCntUp=809, Time=1571840484578, DevEUI=000012340020CC61, LrrRSSI=-67.0, DeviceAddress=06060606, FCntDn=101, DevLrrCnt=2, Tags=["VERSASENSE"], DeviceName=VERSA-3C61]
AllThingsTalk LoRa RDK fields
For AllThingsTalk LoRa RDK devices created with LoRa4Makers, any of the following field will be added to the common data fields depending on the scenario you have implemented on your board.
|xmotion, ymotion, z_motion|
|latitude, longitude, altitude, time|
Exemple of a data array for a generic LoRa device:
[LrrSNR=5.0, Lrrid=004A022E, SpFact=7, SubBand=G1, FPort=1, Channel=LC2, FCntUp=3, z_motion=0.0, Time=1571818673131, DevEUI=000012340020CC61, LrrRSSI=-94.0, y_motion=1.0, x_motion=-19.0, DeviceAddress=06060606, stream_id=8, FCntDn=2, DevLrrCnt=2, Tags=["ATT","DEMO"], DeviceName=ATTPORT2]
Decoding messages from generic devices
Decoding your raw binary message is best done using CloudEngine in script mode. Refer to the CloudEngine documentation to learn more about scripting mode.
Sample CloudEngine scripts can be found in our GitHub.
AllThingsTalk LoRaWAN RDK tutorial
If you have acquired an AllThingsTalk LoRaWAN RDK, we created a step by step tutorial to onboard this device on the Proximus LoRaWAN network using LoRa4Makers and using CloudEngine to retrieve your messages. The new tutorial can be accessed here.