Software Overview  |  Sitemap  |  Downloads  |  Developers  |  Forums
Small_clear_logo_llc

Estimote Devices - Telemetry Beacon Devices

Estimote telemetry beacon devices are a family of Bluetooth beacons which broadcast location/proximity and environmental information. The ones shown below are cookie sized and have adhesive tape on the back - they can be stuck most anywhere.

Some Estimote Beacons
Estimote Beacons

When you buy an Estimote telemetry beacon, use the Estimote cellphone application to configure your beacons for maximum battery life. To do this, shut off Estimote location/proximity packets and enable only Estimote telemetry packets. Set the duration between packets for as many seconds as you can to lengthen the life of the battery. You may also be able to adjust the transmit power of the devices - lower power will conserve battery life, though it will also lower the range of the device.

Finding Your Estimote Device's Bluetooth ID

All Bluetooth devices have a unique ID, though not all devices have it written somewhere where you can see it. To find your Estimote's Bluetooth ID, use a Virtual Wiring Sniffer. When your Sniffer sees Bluetooth packets from unknown devices, it prints out their IDs.

To get started, set up a Sniffer Device. Follow the set up directions on the Sniffer page, and bring your Estimote Beacon within range of your Sniffer (if there aren't a lot of obstacles in the way, usually within 100 feet). If you go to your Virtual Wiring Log, you will see messages from your Sniffer like:

[2018-05-19 15:15:02.005]: Saw Bluetooth ID: 2F:48:41:91:E6:38, type: 0xFF, data: [0x00, 0x0E, 0x05, 0x85, 0x21, 0x23, 0xC3, 0xDB, 0x33, 0xF2, 0x94, 0x19, 0x6E, 0xDB], rssi: -69

[2018-05-19 19:50:49.840]: Saw Bluetooth ID: 33:93:76:EE:90:21, type: 0xFF, data: [0x00, 0xA5, 0x2C, 0x71, 0xF0, 0x18, 0xF1, 0x3D, 0x09, 0xE7, 0xBB, 0x7E, 0xD0, 0xA4, 0x10, 0x02, 0x0B, 0x00], rssi: -80

Each time your Sniffer encounters a Bluetooth ID it hasn't seen before, it prints a packet and its ID to the Log. Most likely, there will be other Bluetooth devices around, so you will see packets for those as well. To identify your Estimote device's packets, look for packets of the form:

[2018-05-19 21:45:03.654]: Saw Bluetooth ID: C3:15:10:FF:43:12, type: 0x03, data: [0x9A, 0xFE, 0x22, 0x2A, 0x64, 0x28, 0xCA, 0x32, 0x90, 0xC5, 0x3F, 0x00, 0x01, 0xFD, 0x42, 0x01, 0xD3, 0xF0, 0xFF, 0xFF, 0xFF, 0xFF], rssi: -62

Notice that the first 2 data bytes of data are 0x9A and 0xFE (that's an Estimote company ID). The third byte is 22, which identifies the packet as an Estimote telemetry packet. The Bluetooth ID for this Estimote packet is: C3:15:10:FF:43:12.

For each of your Estmote Devices, bring it near the Sniffer, look for a packet like the one above, and write down the Bluetooth ID. This is the ID you will use when creating your Estimote Devices.

Estimote Telemetry Beacon Device Description

All the Estimote Beacon Devices we support are Telemetry Beacon Devices. The Telemetry Beacon Device is described in detail below.

Telemetry Beacon Device (showing all sense terminals)

The Telemetry Beacon Device creates a Virtual Wiring Device which can monitor atmospheric pressure, light, temperature, and its battery. Atmospheric pressure is measured in hPa, light in Lux, and temperature in Fahrenheit and Celsius. Battery status is measured in percent, 100% being a fully charged battery and 0% being a dead battery. We've found that the Lux measurements vary quite a bit from one beacon to the next, so though they accurately measure none, some, or more light, the actual Lux values are not all that useful.

Not all Estimote beacons are the same. Some of the smaller devices only measure temperature, while others measure temperature and light, and still some others measure everything. In order to accommodate all the Estimote devices, the Telemetry Beacon Device Script is flexible, allowing you to create a Device which matches your Estimote device's capabilities.

Telemetry Beacon Devices are created by running the TelemetryBeacon Script. The parameters for the TelemetryBeacon Script are:

  • bluetooth_id : a quoted string with the Bluetooth ID of this device. Bluetooth IDs are unique IDs assigned to Bluetooth devices. To find your device's Bluetooth ID, bring your device within range of your Sniffer and read the Virtual Wiring Log. Bluetooth ID's are of the form: "D2:44:00:BC:D3:56"
  • measures_light : a true/false value which is set to true if the device measures light. Otherwise it is set to false.
  • measures_pressure : a true/false value which is set to true if the device measures atmospheric pressure. Otherwise it is set to false.
  • measures_temperature : a true/false value which is set to true if the device measures temperature. Otherwise it is set to false.

The following parameters are optional - leaving them alone generally works and is advisable.

  • scanner_name : a quoted string with the name of the scanner for the Sniffer this Device is using. If there is only one Sniffer in your system (typical), leave the string empty and the Device will use it by default.
  • offset_c : a numeric value which will be added to temperature readings (in Celsius). If your device measures temperature and its temperature values are incorrect, use offset_c to adjust them.

Running the TelemetryBeacon Script with the parameters listed below creates a Telemetry Beacon Device for a device with Bluetooth ID "D2:44:00:BC:D3:56" which measures temperature, and runs in a system with one Sniffer(scanner).

id: "tb"
bluetooth_id : "D2:44:00:BC:D3:56"
measures_light: false
measures_pressure: false
measures_temperature: true
offset_c : 2.3
scanner_name : ""

The Telemetry Beacon Device will have the ID "tb" and an offset of 2.3 Celsius (4.1 degrees Farhenheit) added to all its temperature measurements.

Running the TelemetryBeacon Script with the parameters listed below creates a Telemetry Beacon Device for a device with Bluetooth ID "D2:44:00:BC:D3:56" which measures light, pressure and temperature, and runs in a system with a Sniffer using a scanner named "vw_hcidump_comand".

id: "lptb"
bluetooth_id : "D2:44:00:BC:D3:56"
measures_light: true
measures_pressure: true
measures_temperature: true
offset_c : -3.0
scanner_name : "vw_hcidump_command"

The Telemetry Beacon Device will have the ID "lptb" and an offset of -3.0 Celsius (-5.4 degrees Farhenheit) added to all its temperature measurements.

Catalina Computing, LLC.

Copyright © Catalina Computing, LLC. (2013-2017)




Page last updated: Tue May 29 21:26:30 2018 (UTC)