Skip to Content
Using Helium Console

Using Helium Console

This guide provides step-by-step instructions for adding a device in Helium Console and setting up an integration with Heliumtenna for notifications.

Note

Helium Console no longer accepts new sign-ups. If you are a new user, consider using a ChirpStack provider such as HeyIoT  or Meteo Scientific .

1. Add a Device

  1. Click “Devices” in the sidebar
  2. Click the ”+” icon with surrounding signals to add a new device

Add a Device

  1. Fill in the required fields:
    • Name
    • Device EUI
    • App EUI
    • App Key
  2. Click “Save Device”

Device Add Form

2. Add a Function

To decode raw byte values into human-readable data (e.g., temperature), add a decoder function:

  1. Click “Functions” in the sidebar
  2. Click the ”+” icon with surrounding brackets

Function Add Button

  1. Select the function type (typically “Custom JavaScript Function”)

Function Type Selection

  1. Enter the decoder function in the provided textbox. Manufacturers often provide these in their documentation, or you can find community-made decoders.

For a Dragino LGT-92, the JavaScript decoder is:

function Decoder(bytes, port) {
  var latitude = (bytes[0] << 24 | bytes[1] << 16 | bytes[2] << 8 | bytes[3]) / 1000000; // GPS latitude
  var longitude = (bytes[4] << 24 | bytes[5] << 16 | bytes[6] << 8 | bytes[7]) / 1000000; // GPS longitude
  var alarm = (bytes[8] & 0x40) ? "TRUE" : "FALSE"; // Alarm status
  var batV = (((bytes[8] & 0x3f) << 8) | bytes[9]) / 1000; // Battery, units: V
  var motion_mode;
  if ((bytes[10] & 0xC0) === 0x40) {
    motion_mode = "Move";
  } else if ((bytes[10] & 0xC0) === 0x80) {
    motion_mode = "Collide";
  } else if ((bytes[10] & 0xC0) === 0xC0) {
    motion_mode = "User";
  } else {
    motion_mode = "Disable";
  } // Mode of motion
  var led_updown = (bytes[10] & 0x20) ? "ON" : "OFF"; // LED status
  var firmware = 160 + (bytes[10] & 0x1f); // Firmware version
  var roll = (bytes[11] << 8 | bytes[12]) / 100; // Roll
  var pitch = (bytes[13] << 8 | bytes[14]) / 100; // Pitch
  var hdop = bytes[15] > 0 ? bytes[15] / 100 : bytes[15]; // HDOP
  var altitude = (bytes[16] << 8 | bytes[17]) / 100; // Altitude
 
  return {
    latitude: latitude,
    longitude: longitude,
    roll: roll,
    pitch: pitch,
    battery: batV,
    ALARM_status: alarm,
    MD: motion_mode,
    LON: led_updown,
    FW: firmware,
    HDOP: hdop,
    altitude: Math.floor(altitude),
    accuracy: 3
  };
}
Warning

Ensure the decoder matches your device’s firmware version, as older decoders may be incompatible.

  1. Enter the function name in Step 1 and the decoder code in Step 2
  2. Save the function

Function Add Form

3. Add Integration

To send data to Heliumtenna, add an HTTP integration:

Note

You must have already added a device in Heliumtenna to proceed. Alternatively, use your user API key from Settings .

  1. Click “Integrations” in the sidebar
  2. Click the ”+” icon within the cloud

Integration Add Button

  1. Select the “HTTP” integration

Integration Selection

  1. Fill in the endpoint details:
    • Request Type: POST
    • Endpoint URL: https://heliumtenna.com/api/device/data
    • HTTP Header:
      • Key: Authorization
      • Value: Device key (dk_123...) from the device details page or user API key (uk_123...) from Settings 
  2. Name the integration and save it

Integration Form

4. Connect Device with Function and Integration

To connect the device, decoder, and integration:

  1. Click “Flows” in the sidebar
  2. Expand “Nodes” by clicking the ”+”
  3. Drag your device, function (decoder), and HTTP integration onto the canvas
  4. Connect them as shown below

Flows Collapse Nodes Complete Flow

Next Steps

Network ArchitectureUsing ChirpStack Server