1. Setup your Yabby Edge LoRaWAN devices using the LoRaWAN Provisioning Tool
The LoRaWAN provisioning tool can be downloaded here.
Note: It is important to configure the Region and Scanning parameters.
2.Setup the API Credentials on OEM
Navigate to the Mange dropdown on OEM and click on 'API Credentials'. Generate the API Key and click on 'copy'.
3. Sign up for a Helium Console account
Browse to Helium Console front page, and click 'Sign Up'. Follow the prompts, and complete the email verification step.
4. Open the Helium Console
The console is where you register your devices, create an HTTP integration, set up a label and set up forwarding to your desired endpoint. It is accessed at Helium Console.
5. Add your device to the Helium Console
Browse to the Devices screen in the console, and click '+ Add Device' in the top right corner. The fields, Dev EUI, App EUI, App Key, will be auto generated but you will need to enter in the credentials provided with the Digital Matter device. The device name does not need to be unique, each device will be given a unique identifier by Helium Console.
6. Add your integration in Helium
Browse to the Integrations screen in the console, and click 'HTTP' under the Add a Custom Integration section. The fields Endpoint, Header, and Value will need to be filled out.
Header will need to be input as Authorization
The value will be Bearer and then the API Key generated in Step 2 above.
7. Add a Label
Labels are used in Helium Console to organize devices, assign integrations, and provide scalability and flexibility to managing your projects. Labels need to be created before attaching them to devices and integrations.
Browse to the Labels screen in the console, and click '+ Add Label' in the top right corner. The label can be named to your preference in enter a label name step. In the attach an integration step you will need to attach the label to the integration that was created. Once that is done select Create Label and Manage Select the label name and in the top right corner click 'Add this Label to a Device' Select all devices that you would like to add to the label and click 'Add Label to Device'
8. Add application server security details to OEM
1. Navigate to Manage dropdown on OEM and click on 'LoRa Network Credentials'
2. Click "New" to create a new entry
3. Select the relevant Vendor/Client
4. Enter a name for the network credential entry
5. Select "Helium" from the LoRa Network Code dropdown
6. Enter the Integration ID and Downlink Key. Details are found in the integration details that were created in Step 6.
7. Enter the base URL https://console.helium.com/api/v1/down
9. Create a Forwarder on OEM
This step is only relevant if you need to forward data to your own platform.
A Forwarder is an HTTP connector which allows the Location Engine to forward the "solved" device data to an end platform. Browse to Forwarders on OEM and click 'New'.
10. Set the Location Engine Lookups and Forwarder
Browse to LoRa Devices on OEM and select your devices.
a. Click on 'Device Operation' and 'Set Network Credentials'. Select the entry you created in Step 8
b. Click on 'Device Operation' and 'Set Location Engine Lookup Settings'. Select Default Profile. This profile will cover 99% of use cases. Test on this profile initially, if you have have specific requirements, speak to your support team to have the profile adjusted if this is required.
c. Click on 'Device Operation' and 'Set Forwarder'. Select the TG forwarder for your region or the entry you created in Step 9.