Getting started overview

Getting started with the Helium Network involves several key steps, primarily focused on establishing connectivity for either an IoT device using LoRaWAN or a 5G-enabled device. The network operates on a decentralized model, where coverage is provided by community-run hotspots, and data transmission is facilitated by Data Credits (DC).

The process generally includes:

  1. Account Setup: Creating a Helium Wallet to manage HNT and Data Credits.
  2. Device Acquisition: Obtaining a Helium-compatible IoT device or 5G device.
  3. Data Credit Acquisition: Burning HNT to acquire Data Credits, which are consumed when devices send data over the network.
  4. Device Onboarding: Registering and configuring your device with the Helium Network.
  5. First Data Transmission: Initiating communication from your device to verify connectivity.

This guide will walk through the initial steps required to get a device connected and send its first data packet.

Create an account and get keys

The foundation of interacting with the Helium Network is the Helium Wallet. This wallet is essential for managing your HNT (Helium Network Token) and Data Credits (DC), which are consumed when your devices send data. Helium's decentralized nature means there isn't a traditional API key in the same sense as a centralized service; instead, interaction is managed through your wallet and specific device configurations.

1. Download the Helium Wallet App

The primary method for managing your Helium assets and onboarding devices is through the official Helium Wallet app. This app is available for both iOS and Android devices.

  • Download: Search for "Helium Wallet" in the Apple App Store or Google Play Store.
  • Setup: Follow the in-app instructions to create a new wallet. This will involve generating a 12-word seed phrase. It is critical to secure this seed phrase, as it is the only way to recover your wallet if you lose access to your device. Without it, your funds and access to managing your devices will be permanently lost.

For more detailed instructions on setting up your wallet, consult the Helium Wallet App documentation.

2. Acquire Data Credits (DC)

Data Credits are the functional currency for sending data on the Helium Network. They are pegged to the US dollar at a fixed rate of $0.00001 per DC. To acquire Data Credits, you must burn HNT (Helium Network Token).

  • Acquire HNT: HNT can be purchased on various cryptocurrency exchanges. Examples include Binance, Crypto.com, and others. (Note: apispine does not endorse specific exchanges.)
  • Burn HNT for DC: Within your Helium Wallet app, there is a function to "burn" HNT to create Data Credits. This process converts your HNT into DCs at the prevailing exchange rate. For current pricing and detailed steps, refer to the Helium Data Credits documentation.

Ensure you have enough Data Credits to cover the anticipated data usage of your devices. The cost per data packet is minimal, but consistent usage can accumulate.

3. Onboard Your Device

Before your device can send data, it needs to be onboarded to the Helium Network. This process typically involves registering the device's unique identifier (e.g., Extended Unique Identifier, EUI) with the network and associating it with your wallet.

  • LoRaWAN Devices (Helium IOT): Most IoT devices on Helium use the LoRaWAN protocol. You will need device-specific information such as Device EUI, Application EUI, and Application Key. These are usually provided by the device manufacturer. The Helium Console (a web-based interface) is often used for onboarding LoRaWAN devices.
  • 5G Devices (Helium Mobile): For 5G devices, the onboarding process is integrated with the Helium Mobile service and often involves an eSIM or physical SIM card activation.

Detailed device onboarding instructions are available in the Helium device documentation, specific to the type of device you are using.

Your first request

For Helium, a "first request" typically means a device successfully transmitting its first data packet over the network, rather than an API call in the traditional sense. Once your device is onboarded and you have sufficient Data Credits, the next step is to configure your device to send data.

1. Configure Your Device

The configuration steps vary widely depending on your specific IoT device or 5G hardware. For LoRaWAN devices, this usually involves programming the device with the necessary network credentials (Device EUI, Application EUI, Application Key) obtained during the onboarding process.

  • LoRaWAN Example: Many LoRaWAN development boards (e.g., those from Adafruit, Espressif with LoRa modules) come with example code. You would typically modify this code to include your unique device credentials and a simple payload to send.
  • Payload Structure: LoRaWAN devices send small, often encrypted, data packets. A common "first request" is to send a simple "Hello World" message or sensor reading (e.g., temperature, humidity).

Consult your device's manufacturer documentation and the Helium Console documentation for specific programming and configuration guides.

2. Send a Test Packet

Once configured, power on your device. It should attempt to join the Helium Network and, upon successful join, send its programmed data payload.

  • Monitor in Helium Console: For LoRaWAN devices, you can monitor incoming data packets via the Helium Console. Look for your device under the "Devices" section and check its "Events" or "Data" tab. Successful transmission will show data packets being received.
  • Verify Data Credits: Observe your Data Credit balance in the Helium Wallet app. You should see a slight decrease as data is transmitted, indicating successful consumption.
{
  "port": 1,
  "payload": "SGVsbG8gV29ybGQ=", // Base64 encoded "Hello World"
  "hotspot": "112...",
  "rssi": -80,
  "snr": 10,
  "dc_cost": 1,
  "timestamp": 1678886400
}

The example JSON above illustrates what a data packet might look like when received and decoded in the Helium Console, specifically showing a base64 encoded "Hello World" payload. If you see similar output, your first request was successful.

Common next steps

After successfully sending your first data packet, you can explore more advanced features and integrations with the Helium Network:

  1. Integrate with Cloud Services: Connect your Helium device data to cloud platforms like AWS IoT, Google Cloud IoT, or Microsoft Azure IoT. The Helium Console offers built-in integrations to streamline this process. For example, AWS's IoT Core can receive data directly from Helium.
  2. Develop Custom Decoders: For LoRaWAN devices, implement custom payload decoders in the Helium Console to transform raw binary data into human-readable JSON formats. This is crucial for interpreting sensor data.
  3. Explore Helium Mobile: If you're interested in 5G, investigate Helium Mobile plans and compatible devices to experience decentralized cellular service.
  4. Participate in Network Coverage: Consider deploying a Helium Hotspot (for LoRaWAN) or a FreedomFi Gateway (for 5G) to provide network coverage and earn HNT rewards, contributing to the decentralized infrastructure.
  5. Utilize APIs and SDKs: For more programmatic control, explore Helium's blockchain API to interact with network data, wallet information, and more. While less common for initial device interaction, it's vital for building custom applications.
  6. Explore the Solana Migration: Be aware that the Helium Network has migrated to the Solana blockchain. Understanding this migration is important for managing HNT and network operations. Further details can be found in the Solana Migration overview.

Troubleshooting the first call

Troubleshooting device connectivity on a decentralized network like Helium can involve several layers. Here are common issues and their resolutions:

1. Device Not Joining the Network

  • Incorrect Credentials: Double-check the Device EUI, Application EUI, and Application Key programmed into your LoRaWAN device against what's registered in the Helium Console. A single incorrect character will prevent joining.
  • Out of Range: Ensure your device is within range of an active Helium Hotspot. The Helium Explorer (explorer.helium.com) can help visualize coverage. If no hotspots are nearby, your device won't connect.
  • Antenna Issues: Verify that your device's antenna is correctly attached and suitable for the frequency band (e.g., 915 MHz for US, 868 MHz for EU).
  • Device Activation Mode: Ensure your LoRaWAN device is configured for Over-the-Air Activation (OTAA) or Activation by Personalization (ABP) as intended, and that the console settings match. Most new devices use OTAA.

2. Data Credits Not Decreasing / Data Not Arriving

  • Insufficient Data Credits: Check your Helium Wallet to confirm you have enough Data Credits. If your balance is zero, your device's data will be dropped by the network.
  • Hotspot Activity: While your device might be in range, the serving hotspot might be experiencing issues (e.g., offline, relayed). Check the hotspot's status on the Helium Explorer.
  • Decoder Issues (LoRaWAN): If data arrives but isn't visible or is unreadable in the Helium Console, your payload decoder might be incorrect or missing. Ensure your function processes the raw binary data correctly.
  • Integration Errors: If you're sending data to an external integration (e.g., AWS IoT), check the integration's logs for errors and ensure correct API keys or credentials are set up in the Helium Console.

3. General Network Latency or Delays

  • Decentralized Nature: The Helium Network, being decentralized, can sometimes exhibit varying latency compared to centralized services. This is generally expected for LoRaWAN's low-power, long-range nature.
  • Hotspot Congestion: In areas with many active devices and limited hotspots, there might be occasional delays in data transmission.

For persistent issues, refer to the comprehensive Helium documentation and community forums, which often contain solutions to specific device-related problems. For understanding LoRaWAN fundamentals, the LoRa Alliance website provides foundational information on the technology.

Quick Reference for Getting Started

Step What to Do Where
1. Get Wallet Download & set up Helium Wallet app, secure seed phrase. Helium Wallet App docs
2. Acquire HNT Purchase HNT on a crypto exchange. Your preferred crypto exchange
3. Get Data Credits Burn HNT for Data Credits (DC) in the Wallet app. Helium Data Credits guide
4. Onboard Device Register device EUI/keys in Helium Console (LoRaWAN) or activate SIM (5G). Helium Console / Device manufacturer docs
5. Configure Device Program your device with network credentials and payload logic. Device manufacturer docs / Helium device guides
6. Send First Packet Power on device, monitor for data reception in Console. Helium Console