Helium Mapper & Helium Mapper Kit

i did buy two kits
1- Helium Developer Kit | Support Helium Regions EU868, AU915, US915, AS923
2- Helium Mapper Kit | Helium Mapper Kit 1 / US915

after an intensive search, I still don’t know how to figure it out flash those boards or make the helium mapper.
i did follow the instructions to add the mapper to the console and I did, . actually, I added all three boards. since the developer kit includes 2 boards of RAK-5005-0 V1.
on youtube there is none, nobody documented or did a video on how to create one for the mapper.
so I need the community’s help here. to make one.

Please I would appreciate your input on this matter!

Welcome to the forum @XBlackLight

For the Helium Mapper you can find a tutorial here Make a Helium Mapper with the WisBlock

For WisBlock solutions we have guides in our Knowledge Hub and we have many examples in our [Github repo] (WisBlock/examples at master · RAKWireless/WisBlock · GitHub)

There is as well a Quick Start Guide in our Documentation Center.

Even most guides and tutorials focus on LoRaWan servers like TTN or Chirpstack, they work the same with the Helium Console (which is just another LoRaWan server)

Hello Bernd, im so lucky that you are the one who did answer me :wink:
I actually did follow your bootloader instruction for windows and it did work. i actually did that for all three boards.
but the link you sent me yes it shows the instructions to use only VS/ PlatformIO which I’m not that expert or even close to having the min knowledge.
but where I can put the 3 Device EUI msb , App EUI msb & App Key msb.
i seen something using arduino.exe and changing the values on that programming tool to the actual ones we take from console.helium.com

for example.
this example giving me page error. here what I think I’m missing, I need the code.
Download the example from https://github.com/RAKWireless/WisBlock/tree/master/examples/communications/LoRa/LoRaWAN/LoRaWAN_OTAA/ . The example will communicate with server in EU868, join type in OTAA. And send “hello” to server period.

The way Helium Mapper code is written is quite different from the examples in the WisBlock repo.
The concept is that the DevEUI, AppEUI and AppKey are not inside the code. Instead you use a terminal program or a BLE app on a phone to setup these credentials. That way you can use the same compiled code on many devices.

If you want to compile the Helium Mapper code in Arduino instead of PlatformIO, that is not a big problem.

  1. Create a folder named Helium-Mapper
  2. Copy the files from the src folder into the Helium Mapper folder.
  3. Rename the file app.cpp to Helium-Mapper.ino

Then you can open Helium-Mapper from Arduino IDE.
You will need to install some libraries to be able to compile it:

  • SX126x-Arduino
  • TinyGPSPlus
  • SparkFun u-blox GNSS Arduino Library
  • SparkFun LIS3DH Arduino Library
  • WisBlock-API

All of them are available in the Arduino IDE library manager.

But still, there is no place to setup the credentials inside the code, that’s not how the code works.

Hello Bernd,
i didnt have the chance to continue finishing up the mapper project due to welcoming a new baby to the family!
thankg God she arrived and I’m back to business!
can you please explain to me how to use a terminal program or a BLE app on iPhone!
app store lack of those goodies like google store!. if there is no other way, i will buy an android tablet not a big deal!.

also one question about the RAK5005 v.1 board. is there a way we can flash it, i cant see it anymore on Bluetooth devices. even i reset it?

Hi David,

You can flash the RAK4631 on the RAK5005-O only from Arduino IDE or PlatformIO over USB.

The steps are the same as I explained above.

Hey BeeGee, we’ve got some community members trying to proceed with this code and are receiving compile errors.

request for member 'reset' in 'g_task_wakeup_timer', which is of non-class type 'TimerHandle_t {aka void*}'

expression must have class type but it has type "TimerHandle_t"

Is there any correction that should be made to the code before building? Thanks for your help!

Welcome to the forum @ilovespectra

Sorry for that, I updated WisBlock-API library which is used in the Helium Mapper code, but the Helium Mapper code is not updated (not my sources).

Make sure in PlatformIO it forces to use the older WisBlock-API release:

lib_deps = 
	sparkfun/SparkFun u-blox GNSS Arduino [email protected]^2.0.9
	sparkfun/SparkFun LIS3DH Arduino Library
	beegee-tokyo/[email protected]

==> beegee-tokyo/[email protected] is the important line.

Then it should compile.

I have a GNSS tracker code that can be switched between different formats, but I didn’t share it yet on Github.
It supports CayenneLPP, extended precision LPP, Helium Mapper format and LoRaWAN Field Tester packet formats.

Maybe time to release it to the open source.


It should be **beegee-tokyo/[email protected]** without the apostroph

ah i see now, thanks so much for the help Bernd!

in app.cpp, replace