Connecting to Telematics Guru over Helium

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:

Basic YWJjZGVmMTIzNDU2Nzg5MDpmZWRjYmEwOTg3NjU0MzIxYWJjZGVmMTIzNDU2Nzg5MA==


RegionDevice URL
APAC01http://device-apac01.telematics.guru:8083/helium/oyster
APAC02http://device-apac02.telematics.guru:8083/helium/oyster
APAC03http://device-apac03.telematics.guru:8083/helium/oyster
APAC04
http://device-apac04.telematics.guru:8083/helium/oyster
EMEA01http://device-emea01.telematics.guru:8083/helium/oyster
EMEA02http://device-emea02.telematics.guru:8083/helium/oyster
EMEA03http://device-emea03.telematics.guru:8083/helium/oyster
EMEA04http://device-emea04.telematics.guru:8083/helium/oyster
AMER01http://device-amer01.telematics.guru:8083/helium/oyster
AMER02http://device-amer02.telematics.guru:8083/helium/oyster



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.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.