Skip to content
Stand with Ukraine flag
Star
 
Pricing Try it now

ioButton Panic button

ioButton Panic button

ioButton Panic button

ioThings

Platform
ThingsBoard
Hardware Type
Other devices
Connectivity
LoRaWAN
Industry
Security, Smart Buildings
Use Case
Health Care
Try this device in ThingsBoard

Introduction

ioButton Panic button ioButton is a versatile solution, pre- configured for various emergency scenarios. When the panic button is activated, users receive immediate notification through the prominent LED ring, accompanied by haptic feedback from the vibration motor. With a standard battery life of over 10 years, virtually no maintenance is required. The ioButton can send 1,000,000 messages on SF-7 and 100,000 on SF-12! By default, the ioButton sends a heartbeat message every 4 hours.


Prerequisites

To continue with this guide we will need the following:

Device connection

Device configuration

To connect and send data we should configure the device and network server. At first we are going to configure the device, and save required information for network server configuration. To add a device to network server and get information from it, we will need the following device parameters:

  • Device EUI — device identifier
  • Application EUI — application identifier
  • Application Key — application key to identify device. We recommend to use a generated key, not from the example!

The parameters above are required for connection.

Depending on the network server, you may also need to provide join type (OTAA) and LoRaWAN version.

Prerequisites

  • Android app & account Install the ioTracker Configurator app from Google Play and log in with your ioTracker account.
  • Device compatibility Only with ioTracker accounts after February 1, 2022 are supported.
  • Bluetooth & permissions Enable Bluetooth and grant Location/“Nearby devices” permissions to the app.

1. Scanning & Connecting

  1. Open ioTracker Configurator and tap Refresh (or Scan) to discover devices.
  2. Select your ioTracker or ioButton from the list and tap Login; enter your credentials to establish Bluetooth.

2. LoRaWAN Menu

From the Main menu, tap Configuration to access LoRaWAN functions.

LoRaWAN menu screenshot

Change LoRaWAN Keys

  1. Click the edit/pencil icon next to DevEUI, AppEUI, and AppKey.
  2. Enter your new LoRaWAN DevEUI, AppEUI, and AppKey.
  3. Click Update.
  4. Reboot the device to activate the new keys.
Change LoRaWAN keys screenshot

Check LoRaWAN Status

  • Active Region: the frequency band in use.
  • LoRaWAN Version: the specification version.
  • Join Status: JOINED or NOT JOINED.
  • Last Uplink: timestamp, payload, message type, DataRate, channel, TxPower, TxToA, UpCntr.
  • Last Downlink: timestamp, payload, DataRate, RxSlot, port, RSSI, SNR, ACK flag, DownCntr.
LoRaWAN status overview screenshot

To configure the device we also need to add it to a network server, so select the network server your gateway is connected to:

Add a device on the Chirpstack

We need to add a device on the Chirpstack.

To add a device, you can follow next steps:

  1. Login to Chirpstack server.
  2. Go to the Device profiles page and click on Add device profile button.
  3. Fill the fields and click on Submit button.
  4. Go to the Applications page, click on your application and press Add device button.
  5. Fill parameters with values from the device configuration. Then choose previously created device profile and click on Submit button.
  6. Put your Application key to the field and click on Submit button to save the device.
Step 1: Download the JSON file

Download the JSON file with the uplink converter settings by clicking the button below.

Download uplink converter for ChirpStack integration.


Step 2: Import the Uplink converter into ThingsBoard

After downloading the file with the Uplink converter configuration, import it into ThingsBoard:

  1. Navigate to the “Data converters” page in the “Integration center” section.
  2. Click the ”+” icon in the top-right corner of the page and select “Import converter” from the drop-down menu.
  3. Drag and drop the downloaded JSON file (containing the uplink converter configuration) into the import window, then click “Import”.
  4. The uplink converter is now successfully imported.

Step 3: Replace the Uplink converter in the ChirpStack integration

Now, let’s update your ChirpStack integration to use the new uplink converter:

  1. Go to the “Integrations” page in the “Integration center” section.
  2. Click on your ChirpStack integration to open its details window.
  3. Enter edit mode by clicking the orange pencil button in the top-right corner.
  4. Replace the existing uplink converter with the imported one.
  5. Don’t forget to save your changes!

Check data on ThingsBoard

After the device is connected to the network server and ThingsBoard, you can check received and converted data on the platform for this device.

To do this, open Entities menu section and select Devices. Click on the device name to open the device details page. Go to the Latest telemetry tab to see the latest telemetry data received from the device.

LoRaWAN device data

Conclusion

Now you can easily connect your ioButton Panic button and start sending data to ThingsBoard.

To go further, explore the ThingsBoard documentation to learn more about key features, such as creating dashboards to visualize your telemetry, or setting up alarm rules to monitor device behavior in real time.

© 2026 The ThingsBoard Authors