Skip to content
  • There are no suggestions because the search field is empty.

Connect ChirpStack to Humly Sensor Gateway

If you already run ChirpStack, you connect it to Humly Sensor Gateway (HSG) with an HTTP integration. You need a webhook token from HSG, an application in ChirpStack that holds the sensors, and the integration itself. The screenshots show ChirpStack v4.

In this article

Before you start

  • HSG is set up and paired. See Humly Sensor Gateway - First-time setup.
  • Your sensors already work in ChirpStack, with payload decoders that turn their data into readable values.
  • The ChirpStack server can reach the HSG server on port 3100.

Step 1: Create a webhook token in HSG

  1. In the HSG dashboard, go to Settings.
  2. Under LNS webhook tokens, click + Create LNS token.
  3. Name it after the ChirpStack server, for example chirpstack-primary. Click Create.
  4. Copy the Bearer token. HSG shows it only once.

The LNS token created dialog showing the token name and the bearer token

Step 2: Create an application

ChirpStack sends data per application. HSG receives every sensor in the application you connect. You can use an existing application, or create one for the sensors you want in Humly.

  1. Go to Applications and click Add application.
  2. Enter a name, for example Humly sensors, and an optional description.
  3. Click Submit.

The ChirpStack Add application form with the name Humly sensors

Step 3: Add your sensors to the application

  1. Open the application. On the Devices tab, click Add device.
  2. Enter a Name, the sensor's Device EUI, and choose its Device profile.
  3. Click Submit, then enter the sensor's keys as you normally do.
  4. Repeat for each sensor.

The ChirpStack Add device form with name, Device EUI and device profile filled in

The Devices tab then lists the sensors and when ChirpStack last heard from them.

The ChirpStack application Devices tab listing several LoRaWAN sensors

The name you enter in ChirpStack is what HSG shows first. You can give the sensor a new display name when you approve it in HSG.

Step 4: Turn on the HTTP integration

  1. In the application, open the Integrations tab.
  2. On the HTTP card, click +. If the card shows a pencil, an HTTP integration already exists. See the note below.

The ChirpStack Integrations tab with the HTTP card highlighted

  1. Set Payload encoding to JSON.
  2. In Event endpoint URL(s), enter http://<hsg-server>:3100/lora/uplink. Use https:// if HSG has a certificate.
  3. Click Add header. Enter Authorization as the key and Bearer <token> as the value, with the token from step 1.
  4. Click Submit.

The ChirpStack HTTP integration form with JSON encoding, the HSG webhook address and the Authorization header

Note

An application has one HTTP integration. If it already sends data to another system, add the HSG address to Event endpoint URL(s), separated by a comma. Check with the owner of the other system first, because both addresses receive the same headers.

Step 5: Approve the sensors in HSG

  1. Wait for each sensor's next uplink.
  2. In HSG, go to Sensors. The sensors appear as Pending, with the source ChirpStack.
  3. Click Confirm on each sensor you want in Humly, and give it a name.

The HSG Sensors page filtered on pending sensors, each with a Confirm button

If no sensor appears, see Connect LoRaWAN sensors for checks.

ChirpStack v3

The steps are the same, with different labels in step 4:

  1. Open the application and go to Integrations. Add the HTTP integration.
  2. Set Payload marshaler to JSON.
  3. Add the header Authorization with the value Bearer <token>.
  4. Enter http://<hsg-server>:3100/lora/uplink as the Uplink data URL. Leave the other event URLs empty.
  5. Save.

Humly Sensor Gateway guide

Get started

Install and set up

Connect sensors

Manage and troubleshoot