Geofencing Quickstart

What You’ll Need


This procedure requires some basic knowledge pertaining to Avimesa’s IIoT Solution and its management via Avimesa.Live:

  • An Avimesa-enabled Device - This is what Avimesa’s IIoT Solution (and arguably all others) are built around. An Avimesa-enabled Device is two things at once: it’s a physical computer system with valid authentication credentials to and communication software for Avimesa Messages and also an identity in Avimesa’s cloud (to you, the user, Avimesa Messages and Avimesa.Live).

  • Avimesa.Live - A web application for control of and visualization of Avimesa’s IIoT Solution

Live Setup - Part 1

First, we’ll want to make note of one of our unused device’s Device ID and Authentication Key and configure it as a gateway device. We can do both of these things from the same place: navigate to the Devices section in your Avimesa.Live account, click on the cog next to an unused device in your account, and, finally, select Edit.

Next, we’ll want to make note our device’s credentials, it’s Device ID and Authentication Key, switch its Device Type to Avimesa Raspberry Pi Gateway, and click Edit Device to update our device’s Device Type.

Here we can see that we can also configure this device’s Device Name, Device Location, and Sleep Interval. The Sleep Interval is an OTA configurable parameter that specifies how often this device should attempt to communicate with the Avimesa cloud.

Gateway Setup

STOP! You’ll want to complete your gateway device’s setup here now. And if you haven’t done any gateway setup, you’ll want to start here instead.

Beacon Setup

This portion of the setup is mostly up in the air. You’ll want to follow whatever setup procedure your beacon recommends; the setup procedure usually involves downloading a phone application. The two important things to do in this procedure are (1) to configure your beacon as an iBeacon and (2) to generate (and make note of) a 32 character hexadecimal UUID and us it as the beacon’s iBeacon UUID.

Live Setup - Part 2

Navigate to the Beacons section of Live.

Select Add Geofence and: give your Geofence a name, program it to locate beacons advertising with the iBeacon UUID we generated during the beacon portion of this setup, and then click Add.

Next, we’ll want to add the device we previously configured to our Geofence. This can be done by selected the cog and then selecting Edit Geofence. Once here, we can add our gateway devices to our Geofence.


Depending on the Sleep Interval we configured our device with, our beacon should be detected by our gateway device and then automatically added to our Live account (There are two detected beacons below…).

You can also select your Geofence and then select the device we added to see what it’s detecting. If your beacon is close enough to our gateway, it should be detected momentarily.

Finally, we can alert for our beacon to receive text and email alerts whenever our beacon leaves and returns to our Geofence!

The next steps are up to you: you can expand your existing Geofence with more gateway devices, track more assets by adding more beacons to your Live account, and create multiple Geofences using the same iBeacon UUID to track multiple areas of interest.