The Helium Network is the largest, public LPWAN in the United States, and enables long range, low power, bi-directional communication for any LoRaWAN compatible device. The Helium Network is open and permissionless, and requires no up-front payments, contracts or commitments to use. Devices pay Helium Hotspot owners and other Helium Network Operators on a per-packet basis for delivering their sensors packets to the application end point.
1. 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.
2. 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 Telematics Guru. It is accessed at Helium Console.
3. Add your Device
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.
4. Add an Integration
Browse to the Integrations screen in the console, and click 'HTTP' under the Add a Custom Integration section. The fields Enpoint, Header, and Value will need to be filled out. Based on which regional server your partner account is hosted you will need to use the related URL shown in the table below in the endpoint section. The HTTP header will be Authorization.
The Authorization Field noted as Value should be set using a special username and password obtained from Telematics Guru. TG support will provide these details. The username and password should be combined in the format username:password, and then base64 encoded. For example: abcdef1234567890:fedcba0987654321abcdef1234567890 (username:password) base64 encodes to YWJjZGVmMTIzNDU2Nzg5MDpmZWRjYmEwOTg3NjU0MzIxYWJjZGVmMTIzNDU2Nzg5MA== and should be used in the value section as:
For downlinks to work through TG, each device type will need to have its own authentication details. Please confirm with Digital Matter support each device type that you are using so that all authorization details can be generated.
Once that information is provided by Digital Matter, you will need to give the Helium Integration ID and Helium Downlink Key for each integration you have set up.
Based on which regional server your partner account is hosted you will need to use the related URL for the endpoint. The end of the URL dictates which device type. You will need to input oyster, yabby, g62 or guppy depending on device type.
5. 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 step 1. In step 2 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'
6. Create an asset on Telematics Guru
Log in to your Telematics Guru account, navigate to the Assets page, and click Create New Asset:
Now choose a name, select the correct Device Type, enter the DevEUI in the Device Serial field, and click Save:
If all of the previous steps have been followed correctly, new data points should start populating the Telemetry and IO Telemetry pages as soon as the Oyster gets its first GPS fix. The Oyster's location should also start updating on the live tracking page.