Skip to Content
Using ChirpStack Server

Using ChirpStack Server

This guide provides step-by-step instructions for adding a device in a ChirpStack server and integrating it with Heliumtenna for notifications.

Note

This guide uses the ChirpStack server provided by HeyIoT . Note that other ChirpStack servers may have slight differences.

1. Add a Device Profile

  1. Click “Device Profiles” in the sidebar
  2. Click “Add Device Profile”

Device Profile List

1.1 Set Up General Device Profile Information

In the “General” tab, fill in the fields:

  • Name: A unique name for the device profile
  • Region: The LoRaWAN region (e.g., EU868, US915)
  • LoRaWAN Version: The LoRaWAN protocol version
  • Parameter Revision: Keep the default unless specified by the manufacturer
  • ADR Algorithm: Keep the default unless specified Alternatively, select a device profile template via “Select device-profile template” and choose a manufacturer-provided or generic template

Device Profile Add General Tab

1.2 Set Up Decoder

In the “Codec” tab:

  1. Select “JavaScript functions” as the Payload codec
  2. Paste the decodeUplink function in the textbox (leave encodeDownlink empty unless required)

Device Profile Codec Tab

Warning

Ensure the JavaScript function is compatible with ChirpStack, using the decodeUplink(input) signature. Helium Console decoders are not compatible and must be rewritten. You can use AI tools like Grok  to convert decoders to the correct format.

  1. Save the device profile

2. Configure Application

2.1 Add Application

  1. Click “Applications” in the sidebar
  2. Click “Add application”

Application List

  1. Enter a name and optional description

Application Add Form

2.2 Add New Device to Application

  1. Click “Add device” within the application

Application Add Device Button

  1. Fill in the fields:
    • Name: A descriptive name (e.g., “Tracking Sensor”, “Motion Sensor”)
    • Device EUI: The Device EUI (DevEUI) from your sensor’s documentation or label
    • Join EUI: The Join EUI (App EUI) from your sensor’s documentation or label
      • Select MSB or LSB to match the Join EUI format
    • Device Profile: Select the device profile created in Step 1

Application Device Form

  1. Save the device
  2. In the “OTAA” tab, enter the Application Key (provided with your sensor)

Application App Key Form

  1. Save the application key

To send data to Heliumtenna:

  1. Click your application name
  2. Go to the “Integrations” tab

Application Integrations Tab

  1. Select “HTTP” from the card list and click the ”+” icon

Application HTTP Card

Note

You must have already added a device in Heliumtenna to proceed.

  1. Fill in the fields:
    • Payload encoding: JSON
    • Event endpoint URL(s): 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 

Application HTTP Form

  1. Save the HTTP integration

Next Steps

Using Helium Console