Skip to content

Helium Mapper Guide

Mustafa Tan edited this page Oct 10, 2021 · 1 revision

This module provides data that can be fed into the Helium Coverage Mapper.

Before uploading "helium-mapper.ino" sketch file to your device, check out following steps:

1) If you live in US, you might want to change:

  • Measurement System (default is Metric)
  • LoRaWAN Region (default is for Europe - EU868)

image

2) Then you should update device keys copying from Helium Console using following guide:

3) After you got your news keys for Helium Mapper and uploaded updated "helium-mapper.ino" to your device, add a Helium Mapper Decoder Function as follows using "decoder.js" file on Helium Console.

image

4) Then Add a new Custom Integration and select "HTTP" as follows:

image

Type "https://mappers.helium.com/api/v1/ingest/uplink" into "Endpoint URL" textbox, give a name to your integration and finally click on the "Add Integration" button as follows:

image

5) Finally connect your device, function and integration as follows on Flows menu.

image

Now your integration with Helium Mapper is complete. Please check out https://docs.helium.com/use-the-network/coverage-mapping for more info.

6) Also if you attach an OLED display to your module, you can display data as follows:

image

This sketch file is optimized for Adafruit_SSD1306 compatible 0.96 (128x64) Inch OLED Display Modules. So if you attach another Arduino compatible displays, you should install their libraries and modify the code accordingly.

Also check out the I2C pin order of the 0.96" Oled Display Modules before purchasing. Pin should be in VCC, GND, SCL and SDA order as follows. Should no start with GND.

image