Skip to main content

Getting Started with the ThingsIX Mapper


The ThingsIX Mapper has a USB-C connection that can be used for both powering the mapper and charging the mapper. Use a charger that can supply 2 Amps or more for a reliable charging and operating experience.

It's ok to leave the mapper connected while mapping.

LED and Button

The ThingsIX Mapper has a multi-color LED that shows it's status. Depending on the state it's in, multiple patterns are visible:

OffOffThe battery of the mapper is empty and the mapper is not connected to a power supply
Green BlinkingGetting GNSS Fix and ValidationThe mapper is trying to get a GNSS (GPS, Galileo) location fix and is validating the signals from the GNSS satellites
Blue Blinking (combined with other states)Bluetooth OnThe bluetooth interface of the mapper is on, and the mapper can be discovered and connected to over Bluetooth LE.
Green SolidReady to mapThe mapper is ready to map and will automatically transmit mapping packets
White SolidFound GatewayThe mapper has interacted with a gateway in last second.
Red BlinkingInitializing or errorThe mapper is just powered on or has an fatal error. This state should disappear after powering on after a few seconds, if not there's a fatal error.
White Breathing/Sleep and not charging/poweredThe mapper is sleeping and is not charging the battery
Green BreathingSleep and chargedThe mapper is sleeping and is fully charged
Red BreathingSleep and chargingThe mapper is sleeping and is charging

Using the button next to the USB-C connector, the state of the mapper can be changed:

  • Short press (less than 10 seconds pressed): Enable/disable Bluetooth
  • Long press (between 10 and 60 seconds pressed): Enable/disable sleep
  • Very long press (longer than 60 seconds): Reboot mapper

Onboarding Mapper

Using the Bluetooth interface the Mapper can be connected to your Polygon account. First make sure that your computer you are using has Bluetooth LE 4.2 or higher support as it's needed to connect to the ThingsIX Mapper.

To do so, go to the ThingsIX web app at:

Next follow the instructions to connect your wallet to the app: Connecting a Wallet and make sure you have some MATIC.

Once your wallet is ready, shortly press the button on the Mapper itself to turn on bluetooth. Verify that the LED is blinking blue to indicate that Bluetooth is turned on.

Now go to the Mapper section of the ThingsIX web app and click the Connect with Bluetooth button:

connect with bluetooth button

Now click the Onboard a Mapper button:

onboard a mapper button

You will now be asked by your browser to select and connect to a bluetooth device. Find the device called ThingsIX Mapper and click Pair or Connect (depending on browser). You should now see a window confirming that the ThingsIX Mapper was detected:

device detected modal

Now click Confirm and switch to your wallet and follow the instructions to sign the transaction using your wallet.

The ThingsIX App will now show the confirmation process of the registration transaction. After 128 blocks the Mapper is ready to use!

Free Gateway Onboard

The initial batches of ThingsIX Mappers come with a free gateway onboard. You can use this free gateway onboard on the same account as the ThingsIX Mapper was connected to. To do so, follow the instructions of your gateway, or on Onboarding Gateway to onboard your gateway. Use the option to push the gateway onboard. You will see a slightly different gateway onboarding screen where you can only select 1 gateway to be onboarded for free.

Mapping using the ThingsIX Mapper

The ThingsIX Mapper is used to measure the signal strength that Gateways connected to ThingsIX are providing at a location. Such measurement executed at a certain location is called a "Mapping Record". If no Gateway is within reach, no Mapping Record will be created. The gateway providing the strongest signal (confirming to certain validation checks) is determined to provide the best coverage at that location.

You can view recent Mapping Records on the mapper detail page under Recent activity: recent mapper activity.

Please note that due to privacy reasons the Mapping Records are delayed by 1 hour. In other words you won't see the mapping records that happened in the last hour. In a future update we will provide a way to view recent records behind authentication.

If you click on one of the Mapping Records you can see the details. For more information about mapping validation rules see: TODO