TiBe is a bluetooth low energy device developed by Ticatag which might help you to implement different use cases like proxmity scenario, smart button, smart keyfob, …​

Introduction

This is the documentation for the Ticatag’s beacon aka TiBe.
The Ticatag team strongly believes in opened ecosystems so we are proud to give you access to this documentation that will help you to integrate TiBe with your app.
Do not hesitate to give us feedbacks or to contact us.

SDK

Please find the Ticatag’s SDK on GitHub :

Advertising mode

iBeacon technology

Ticatag chose to use iBeacon protocol specified by Apple as the technology for its Bluetooth Low Energy (BLE) devices TiBe. Ticatag tries to adhere as closely as possible to the iBeacon standard.

TiBe advertising frames

In advertising mode, TiBe transmits iBeacon frames on a regular basis (constant interval) that might vary from few hundreds milliseconds to one second depending on the hardware version of TiBe that you have.

An example of the frame look like this :

Proximity UUID : 801DDF60-A557-43B5-BBA1-D4ABEFC13045
Major : 40681
Minor : 61638

Depending on the TiBe version and the action performed on the beacon, TiBe will advertise with a Proximity UUID slightly different. Minor and Major are invariant and remain unchanged.

TiBe Connect

Action

Advertising frame

No action

801DDF60-A557-43B5-BBA1-D4ABEFC13045

Button clicked

801DDF60-A557-43B5-BBA1-D4ABEFC13046

Button double clicked

801DDF60-A557-43B5-BBA1-D4ABEFC13056

Button held

801DDF60-A557-43B5-BBA1-D4ABEFC13066

TiBe1 & TiBe 2

Action

Advertising frame

No action

801DDF60-A557-43B5-BBA1-D4ABEFC13045

Button clicked

Table of Contents

Round robin value among these :

  • 801DDF60-A557-43B5-BBA1-D4ABEFC13046

  • 801DDF60-A557-43B5-BBA1-D4ABEFC13047

  • 801DDF60-A557-43B5-BBA1-D4ABEFC13048

Connected mode

Please, find below the list of the main bluetooth services and their description.

Device information

Device information service
UUID: 0x180A

Manufacturer Name String
UUID: 0x2A29
Value: Ticatag

Hardware revision String
UUID: 0x2A27
Value: 3.0

Firmware revision String
UUID: 0x2A29
Value: 2.0.9
Hardware version TiBe version

1.0

TiBe 1

1.0.1

TiBe 2

3.0

TiBe Connect

TiBe information

Please, find below how to retrieve the TiBe information : minor, major, proximity UUID, …​

Ticatag device information service
UUID: f000ff11-0451-4000-b000-000000000000

Minor
UUID: f000ff11-0451-4000-b000-000000000000
Value: (0x)F0-C4

Major
UUID: f000ff22-0451-4000-b000-000000000000
Value: (0x)9E-EE

Proximity UUID
UUID: f000ff33-0451-4000-b000-000000000000
Value: (0x) 80-1D-DF-60-A5-57-43-B5-BB-A1-D4-AB-EF-C1-30-45

Advertising period
UUID: f000ff87-0451-4000-b000-000000000000
Value: (0x) 09-60

Accelerometer
UUID: f000ff97-0451-4000-b000-000000000000
Value: (0x) 00

All the information above are explained in the table below.

Info Value Comment

Minor

61636

Decimal value of hex value F0C4

Major

40686

Decimal value of hex value 9EEE

Proximity UUID

801DDF60-A557-43B5-BBA1-D4ABEFC13045

Ticatag’s proximity UUID

Advertising period

2400

Unit : millisecond; decimal value of hex value 0960

Accelerometer

00

00 : accelerometer OFF; 01 : accelerometer ON

Battery level

The battery level is expressed in percent.

Battery level service
UUID: 0x180F

Battery Level
UUID: 0x2A19
Value: 79%

Button press

A button press can be catched by monitoring the corresponding characteristic.

Service
UUID: 0000ffe0-0000-1000-8000-00805f9b34fb
Characteristic
UUID: 0000ffe0-0000-1000-8000-00805f9b34fb
Value: 0x01
Value Action

0x01

Click

0x02

Double click

0x03

Hold

Ring command

To make your beacon ring, you must write the value 0x01 to the alert level characteristic in the alert service.

Immediate Alert service
UUID: 0x1802
Alert Level characteristic
UUID: 0x2A06
Value: 0x01

Tx Power

The TX power setting specifies the strength of the signal that the beacon produces during the times it is transmitting. The setting can be changed to an other value that best fits your needs.

Tx Power
UUID: 0x1804
Tx Power Level characteristic
UUID: 0x2A07
Value: 7dBm

Temperature

TiBe includes a temperature sensor. The value below is expressed in hexadecimal : 00-19 corresponds to 25° celcius.

Service
UUID: 0000fff0-0000-1000-8000-00805f9b34fb
Characteristic
UUID: 0000fff2-0000-1000-8000-00805f9b34fb
Value: (0x)00-19