Beacony Parameter 3.9 - ozrobotics.com

1

Beacony Parameter 3.9.4

Document release: 04/01/2021

APP suggested (Android and IOS) LIGHTBLUE® EXPLORER — Bluetooth Low Energy

https://play.google.com/store/apps/details?id=com.punchthrough.lightblueexplorer

https://itunes.apple.com/us/app/lightblue-explorer-bluetooth-low-energy/id557428110?mt=8

NRF Connect for Mobile

https://play.google.com/store/apps/details?id=no.nordicsemi.android.mcp&hl=it

https://itunes.apple.com/it/app/nrf-connect/id1054362403?mt=8

TO POWER ON/OFF BEACON

Push button for 3sec. to Power ON. Blue LED blink.

For Power OFF follow service 0xFFBA / 0xFFBB at page 6 of this document

TO CONNECT AND TO CHANGE PARAMETERS

1) Open the APP and select beacon you need make connection.

2) Put values as below:

In service 0xFF8B (Pair Notify) – Push Notification button (N) and write value FF (HEX value)

In service 0xFF8A (Pair) – write value 38 38 38 38 38 38 (HEX value)

NOTE: these operations need to be made in less than 60sec. or beacon disconnects automatically.

TO RESET TO FACTORY PARAMETERS

1) Connect Beacon as above described.

2) Push button for three consecutive times. Blue and red LED blink at the same time. All parameters will be reset to default factory values.

OTA SERVICE (TO CHANGE FIRMWARE ON THE AIR)

1) In service FF82, into FFAA characteristic, insert value 0x01 and follow instruction in document:

Change_Firmware_instructions_1.1

https://play.google.com/store/apps/details?id=com.punchthrough.lightblueexplorer

https://itunes.apple.com/us/app/lightblue-explorer-bluetooth-low-energy/id557428110?mt=8

https://play.google.com/store/apps/details?id=no.nordicsemi.android.mcp&hl=it

https://itunes.apple.com/it/app/nrf-connect/id1054362403?mt=8

2

STANDARD PARAMETERS

0XFF81: iBeacon UUID

Service Executable

operation

data

format

function range remark

0xFF80 Read/write 16 BYTE Amend

UUID

16bytes

of data

default

0x476c6f62616c2d546167000000000000

0xFF82: iBeacon major

Service Executable

operation

data

format


0xFF80 Read/write Little End Amend major 2bytes of data Default: 0x0000 (already in

little endian).

0xFF83: iBeacon minor

Service Executable

operation

data

format


0xFF80 Read/write Little End Amend minor 2 bytes of data Default: 0x0000 (already in

little endian).

0xFF84: Broadcast Interval Service Executable

operation

data

format


0xFF80 Read/write UINT 16

4 byte

Little

Endian

Amend

Broadca

st

Interval

160 (100ms) to

16000 (10s)

Values in

decimal

For values over

10s, the packets

sent every

interval will be

3. (Broadcast

values higher

than 10s don’t

work with all

GSensor.)

Default: 0x4006 (LSB first)

default broadcast time: 1s.

Unit: 0.625ms.

Example to calculate 1s. in decimal range:

1.000ms./0,625ms. = 1600 decimal value

1600 decimal -> 0x00000640 HEX ->

0x40060000 (LSB first)

Example to calculate 100ms. in decimal range:

100ms./0,625ms. = 160 decimal value

160 decimal -> 0x000000A0 HEX ->

0xA0000000 (LSB first)

Value to write must be hexadecimal value LSB

first notation

3

0xFF85: Connectable

Service Executable

operation

data

format

function range Remark

0xFF80 Read/write 1 byte Amend

contact

No-YES Default: NO(0x00), if set to yes(0x01), then the

phone can not contact with the device.

Remove and insert the battery to connect again.

0xFF86: Measure and TX power

Service Executable

operation

data

format


0xFF80 Read/write UINT8

1 byte

Measured

power

Default: -51dBm(0xCD) ONLY VALUE

UINT8

1 byte

transmitting

power

0~3 Default: 0x02 (TX Power set to 2->0dBm)

To Set:

0->-23dBm 0x00 (short reading distance)

1->-6dBm 0x01

2->0dBm 0x02 (long reading distance)

3->4dBm 0x03

0xFF88: Device Name Service Executable

operation

data

format


0xFF80 Read/write 19 BYTE

Big

Endian

Friendly

Name

10 BYTE

(9 byte

reserved)

This is friendly name and is generally unique.

Can be changed and customized on request.

Default: 0x476c6f62616c20546167

(Global Tag in ASCII).

0xFF89: Disconnect

Service Executable

operation

data

format


0xFF80 write 1 byte Connect/discon

nect quickly

NO~YES Default: NO(0x00)

NO (0x00)-> Continuous connection

YES (0x01)-> disconnect

N.B When disconnected the value remains

01,even if we will connect to it again

4

0xFF8A: Pair

Service Executable

operation

data

format

For example remark

0xFF80 write UNIT 12

12 byte

“888888”(ASCII)

38 38 38 38 38 38 (HEX)

Submit current password 888888

888888654321 (ASCII) Change the old password 888888 to new

password 654321, old password must be

correct

0xFF8B: Pair Notify

Service Executable

operation

data

format

function Value Remark

0xFF80 Read/write 1 BYTE Set access FF (HEX) Requested in connection operations.

0XFF80 Notify 1 BYTE Notification Pw 04 (HEX) After writing FF, This service will notify

To insert the password, by sending the

HEX value 04

0xFFF1: Eddystone UID

Service Executable

operation

data format function range Remark

0XFF80 Read/ Write 16 Byte

Big Endian

mark 16 BYTE Default:0X476c6f62616c2d546167000

000000000 (Same as ibeacon UUID)

0xFFF2: Eddystone URL

Service Executable

operation

data

format


0xFF80 Read/ Write 18 Byte

Big

Endian

URL 18 BYTE

1 Byte URL

Length

1 Byte prefix,17

Bytes URI (if the

suffix is

recognized by

Eddystone, for

example .com,

it occupies only

1 Byte

Default:0c00676c6f62616c2d746

16707 (http://www.global-tag.com).

The URL is composed by

prefix+URI+suffix.

(The prefix and the suffix are

Eddystone URL Standards).

http://www.global-tag.com/

5

0xFFFF: Adv mode

Service Executable

operation

data

format


0xFF80 Read/ Write 1 Byte Ibeacon/ or

Eddystone

1 BYTE

Default: 0x00 ibeacon

0x01 eddystone UID 0x02URL 0X04TLM

6

SPECIAL PARAMETERS

POWER OFF MANAGEMENT:

It is possibile to “Lock” the power OFF function via service (FF:BA), to avoid unintentional clicks

that turn OFF the Beacony.

If the service is set on 0x00 –> ON, push button for 3sec. to switch OFF. Red LED blink.

If the service is set on 0x01 –> OFF, button is disabled and there are only 2 ways to power OFF the

Beacony:

1) By removing the battery

2) By writing 0xFF in the service FF:BB, the Beacony will automatically turn itself OFF

0xFFBA: Button ON/OFF (POWER OFF Management)

Service Executable

operation

data

format


0xFF80 Read/Write 1Byte OFF service

switch

DEFAULT: 0x00 ON 0X01 OFF

0xFFBB: Power Down

Service Executable

operation

data

format


0Xff80 Write 1Byte Auto OFF 0XFF Turn OFF Beacony

Note: Please note is needed to always make connection before change each one parameters.

7

ALARM:

The Alarm is a feature that allows the sending of Advertising Packets with a Broadcast Interval of

100ms, in the iBeacon format.

There are two types of Alarms:

1) Normal Alarm Triggered by double clicking the physical button on the Beacony.

It will send a series of iBeacon Packets at 100ms with the hexadecimal value of “ALARM”

written in it’s UUID, for a custom time interval (settable by service). Once the interval is

finished, the Beacony will return to it’s previous state.

2) RED Alarm Triggered by double clicking the physical button while the Normal Alarm is

executing.

It will send a series of iBeacon Packets at 100ms with the hexadecimal value of “RED

ALARM” written in it’s UUID, until the user switchs OFF the Alarm service or remove the

battery/turns OFF the Beacony.

If the Normal Alarm is triggered while the accelerometer is ON in Trigger/Real Time Mode, the

sensor will be turned OFF until the Alarm Interval is finished (Normal Alarm).

If the RED Alarm is triggered while the accelerometer is ON in Trigger/Real Time Mode,the sensor

will be turned OFF until the user switchs OFF the Alarm service or turns OFF/removes the battery ,

then the accelerometer will automatically turn ON

0xFF60: Alarm ON/OFF

Service Executable

operation

data

format


0xFF80 Read/Write 1Byte Switch ON/OFF

Alarm DEFAULT: 0x00 OFF

0x01 ON

8

0xFF61: Alarm Adv number

Service Executable

operation

data

format


0xFF80 Read/Write 1Byte Set adv alarm

interval

0x01 1.seconds advertising at 100ms

Broadcast Interval

0x0a 10 seconds advertising at 100ms

Broadcast Interval

LED:

The LED is a feature that allows a visual response to certain actions.

It’s possible to set the blink interval of the led by services

It’s also possible to set a value allowing the LED to be fixed (not blinking). In this state the LED can

be turned OFF (only the physical LED, the service will still be ON) by sending the alarm (Pick To

Light).

0xFF95: Led Blink Time Switch

Service Executable

operation

data

format


0xFF80 Read/write 1 Byte LED ON/OFF Default: 0x00

OFF: 0x00

ON: 0xFF

0xFF96: Led Blink Time Interval

Service Executable

operation

data

format


0xFF80 Read/Write 1Byte LED Blink

second

0~255sec. 0x01 blink each. 1sec.

0x02 blink each. 2sec.

0x03 blink each. 3sec.

0x04 ……….

9

TIMING:

The Timing Mode allows the user to turn ON/OFF the Beacony at a specified time (hour:minute).

Since the Beacony hasn’t an internal time, it’s necessary to set the current time by service.

It’s also possible to choose only one of the 2 features (turn OFF only and then manually turn ON,

or viceversa).

0xFF87: Timing

Service Executable

operation data

format


0xFF80 Read/write UINT8 Set hour 0~23 Default: 0

UNIT8 Set min 0~59 Default: 0

UNIT8 Set second 0~59 Default: 0

HEX Contact time open NO(Ox00)~YES(0x01) Default: 0x00

UINT8 Set timing open(hour) 0~23 Default: 0

UINT8 Set timing open(min) 0~59 Default: 0

HEX Contact timing OFF NO(0x00)~YES(0X01) Default: 0x00

UINT8 Timing OFF(hour) 0~23 Default: 0

UINT8 Timing OFF(min) 0~59 Default: 0

10

SENSORS MANAGEMENT PARAMETERS

ACCELEROMETER SENSOR:

The Beacony has integrated an accelerometer sensor that displays the coordinates of the three

axis (X,Y,Z).

To switch ON/OFF accelerometer:

N.B -> When the battery is removed from the Beacony, the sensor will turn OFF.

0xFF93: Accelerometer ON/OFF

Service Executable

operation

data

format


0xFF80 Read/ Write 3 Byte

Big

Endian

Sensor ON/OFF 3 BYTE Default: 0x000000

OFF: 0x000000

ON: 0XffGGMM

GG → byte that set the accelerometer sampling (1 Hz, 10Hz, 25Hz, 50Hz, 100Hz), HEX values

MM → byte that set the MCU sampling (OFF, 1Hz, 10Hz, 25Hz, 50Hz, 100Hz), HEX Values

NOTE: The accelerometer sampling is the frequency of the Gsensor to wake itself to read the coordinates, the MCU

sampling is the frequency of the MCU to read the coordinates of the Gsensor. Higher the value of the MCU

sampling, higher the frequency of the Beacony to read the coordinates, but higher also the battery consume.

There are 4 operating modes of accelerometer:

1) Connection Mode The accelerometer values can be read ONLY via service (FF:94)

2) Advertising Mode The accelerometer values can be read in Scan Response.

3) Trigger Mode This mode allows the user to choose a sensitivity for the accelerometer:

a. Slight Mode

b. Moving Mode

c. Critical Mode

It also allows the user to choose an interval (in seconds) in which the Beacony will send

Advertising Packets when it senses an acceleration based on the sensitivity chosen.

It also can be used with Watchdog function (see below for details of service FF:E3) allowing

to receive advertising packets if beacon is not in moving (stationary).

11

4) Real Time Mode This mode allows the user to choose a sensitivity for the

accelerometer:

a. Slight Mode

b. Moving Mode

c. Critical Mode

The Beacony will send Advertising Packets when it senses an acceleration based on the

sensitivity chosen, without a custom interval, but only when it senses it. When the Beacony

stops, no packets will be sent.

It also can be used with Watchdog function (see below for details of service FF:E3) allowing

to receive advertising packets if beacon is not in moving (stationary).

See below services and parameters for each. Operating modes:

CONNECTION MODE

0xFFE1: Moving mode service

Service Executable

operation

data

format


0xFF80 Read/Write 1Byte Set moving

mode

1 Byte 0x00 Connection Mode (DEFAULT)

0xFF94: Accelerometer control in connected mode

Service Executable

operation

data

format


0xFF80 Notify 6 Byte

Big

Endian

accelerometer 6 BYTE BIG ENDIAN

XYZ each direction 2 Byte

0x000100010100

={x=1,y=1,z=256}

ADVERTISING MODE


Service Executable

operation

data

format



mode

1 Byte 0x01 Advertising Mode

12

TRIGGER MODE


Service Executable

operation

data

format



mode

1 Byte 0x03 -> Slight Mode

0x04 -> Moving Mode

0xff -> Critical Mode

0xFFE2: Moving advertising time service

Service Executable

operation

data

format


0xFF80 Read/Write 2Byte

Little-

Endian

Set adv. time

while moving

From 0s to

100s (only

even

values)

2s. -> 5dec. -> 0x5 HEX

10s. -> 25dec. -> 0x19 HEX

60s. -> 150dec. -> 0x96 HEX

100s. -> 255dec.-> 0xFF HEX

0xFFE3: Watchdog (Keepalive)

Another useful feature is the Watchdog Mode, which allows our Beacony to send a special packet with a settable time interval (in seconds) when, the Beacony is stationary, to remind the user that the Beacony is still working.

The packet sent by the Watchdog Mode will be an iBeacon packet with the Hexadecimal value of "WATCHDOG" written in the UUID.

Service Executable

operation

data

format


0XFF80 Read/Write 1Byte

LSB

Set

Watchdog

Interval

1s…65535s

If Broadcast Interval

< 1s 1/broadcats

interval packets sent

ecah Watchdog

0x0000 Watchdog OFF

0x0100 Watchdog 1sec.


0x0a00 Watchdog 10 sec.

13

REAL TIME MODE


Service Executable

operation

data

format



mode

1 Byte 0X03 -> Slight Mode

0x04 -> Moving Mode

0xff -> Critical Mode

0xFFE2: Moving advertising time service

Service Executable

operation

data

format



Little-

Endian

Set adv. time

while moving

0s. and

2s. to 100s.

Default: 0x00

Advertising sent while moving

beacon, immediately stopped when

stationary.

0xFFE3: Watchdog (Keepalive)

Another useful feature is the Watchdog Mode, which allows our Beacony to send a special packet with a settable time interval (in seconds) when, in trigger and real-time modes, the Beacony is stationary, to remind the user that the Beacony is still working.

The packet sent by the Watchdog Mode will be an iBeacon packet with the Hexadecimal value of "WATCHDOG" written in the UUID.

Service Executable

operation

data

format


0XFF80 Read/Write 1Byte

LSB

Set

Watchdog

Interval

1s…65535s

If Broadcast Interval

< 1s 1/broadcats

interval packets sent

ecah Watchdog

0x0000 Watchdog OFF



0x0a00 Watchdog 10 sec.

14

TEMPERATURE & HUMIDITY SENSOR:

The Beacony has an integrated Temperature & Humidity sensor that samples every 10s.

The temperature value can be seen in both Eddystone TLM packet and Scan Response.

The humidity can be only seen in the Scan Response.

These values can be also read via service (FF:92) by connecting to the Beacony, after switching ON the sensor service

(FF:91).

The operating range of the temperature goes from -40°C to +125°C, with an accuracy tolerance of ±0.3 °C.

The accuracy range of the humidity sensori is ±3RH in normal conditions, ±4.5RH at extreme conditions (degradable).

Yet the ranges in which the battery of the Beacony can operate are -30 and +60.

0xFF91: Temperature and humidity ON/OFF button

Service Executable

operation

data

format


0xFF80 Read/write 1 Byte Sensor ON/OFF 1 BYTE Default: 0x00

OFF: 0x00

ON: 0xFF

If Sensor turned off, in scan

response will be displayed the

last value the sensor have read

0xFF92: Temperature and humidity read

Service Executable

operation

data

format

function range

0xFF80 Read 3 Byte

Temperature and humidity 1 BYTE Temperature

1 BYTE humidity

1 BYTE Temperature decimal

Ex. 0x143005 -> Temperature= 14 hex ->

20 dec(20°C) Humidity=30 hex -> 48 dec

(48%) Decimal Temperature=05 hex ->

0.5°C

15

VIBRATION SENSOR:

The Beacony also has an integrated vibration sensor, that can be set according to the type of work you want to do.

0XFF9A: Vibration Sensor Interval

Service Executable

operation

data

format



LSB

Set

Watchdog

Interval

From 0 to 10 0x00 -> Continuous

0x01 -> Each second

………

0x0a -> Each 10 seconds

0XFF99: Vibration Sensor Switch

Service Executable

operation

data

format



LSB

Set

Watchdog

Interval

ON/OFF 0x00 -> OFF

0Xff -> ON

16

BUZZER SENSOR:

The Beacony also has an integrated buzzer sensor, that can be set according to the type of work you want to do.

If the buzzer is in Continuous Mode, it can be turned OFF by triggering the alarm, if set (by double clicking the physical

button on the Beacony).

0XFF98: Buzzer Sensor Interval

Service Executable

operation

data

format



LSB

Set

Watchdog

Interval

From 0 to 10 0x00 -> Continuous

0x01 -> Each second

………

0x0a -> Each 10 seconds

0XFF97: Buzzer Sensor Switch

Service Executable

operation

data

format



LSB

Set

Watchdog

Interval

ON/OFF 0x00 -> OFF

0Xff -> ON

17

SOCIAL DISTANCING AND CONTACT TRACING FUNCTION

With these services, beacon can listen other and detect another beacons in the proximity area (from 1mt to 3meters).

When it occurs, the beacon can:

1) Emit light signals (blinking LED)

2) Start to vibe (if present on the board) 3) Activate the buzzer mode (if present on the board)

4) Send a special “Contact” advertising packet in broadcasting

5) Store into beacon memory, the Mac Address of the beacons detected in the proximity area.

0xFFCA: Contact tracing (and social distancing) ON/OFF

Service Executable

operation

data

format

function remark

0xFF81 Read/write 1 Byte Whether to

enable the scan

function

Default: 0x00

OFF: 0x00

ON: 0x01

If Sensor turned ON, beacon start to ‘listen’ other

beacon follow FFCB parameters

0xFFCB: Contact tracing Gateway Timing

Service Executable

operation

data

format

function range

0xFF81 Read/write 4 Byte

Interval scanning Byte1-2 – Listen OFF cycle (in sec.)

from 1s to 1000 mins.

Default: 001E

Byte2 – Listen ON, Scan duration (in sec.)

from 01 to 10)

Default: 01

Byte3 – Listen ON, Scan duration (in decimal) from

01 to 09)

Default: 02

18

0xFFCC: Contact tracing RSSI Filter

Service Executable

operation

data

format


0xFF81 Read/write 1 Byte Listen filter RSSI 10 to -90dB Default: 0xBD (-67dB)

hexadecimal 2-complement

Ex. 0xB0 is -80dB.

To calculate: start to 80dec.

Covert into binary, make

complement and added + 1.

Result make in hexadec.

0xFFCD: Contact tracing LED blink parameter

Service Executable

operation

data

format



LED blink mode Byte1 – 00 to 10

Byte2 – 01 to 255

Byte1: Default 0x00 Switch OFF

0x01, blink each one sec.

0x02, blink each. two sec.

Byte2:

0x01 LED Blink one time

0x02 LED Blink two times

…

0xFFCE: Contact tracing Buzzer parameter

Service Executable

operation

data

format



Buzzer mode Byte1 – 00 to 10

Byte2 – 01 to 255


0x01, buzz each one sec.

0x02, buzz each. two sec.

Byte2:

0x01 Buzz one time

0x02 Buzz two times

…

19

0xFFCF: Contact tracing Vibration parameter

Service Executable

operation

data

format



Vibe mode Byte1 – 00 to 10

Byte2 – 01 to 255


0x01, vibe each one sec.

0x02, vibe each. two sec.

Byte2:

0x01 vibe one time

0x02 vibe two times

…

0xFFDA: Contact tracing Mac Address store function

Service Executable

operation

data

format

function remark

0xFF81

Read/write 1 Byte

Whether to enable mac address saving Default: 0x00

OFF: 0x00

ON: 0x01

If service turned ON, beacon

start to ‘store’ Mac Address of

beacon listen nearly

…

0xFFDB: Contact tracing Advertising ‘alarm’

Service Executable

operation

data

format



Send advertising

packet with UUID

‘CONTACT’hexadecimal

value to warn

That beacon is in

contact with another

beacon

From 01 to FF Default: 0x05

Sent 5 advertising packet follow

FFB4 broadcast interval

20

0xFFDC: Contact tracing filter beacon with ‘Device Name (0xFF88)’

Service Executable

operation

data

format

function remark


Scan the white list of

device names

Default: 476c6f62616c20546167

‘Global Tag’ in ASCII

0xFFDD: Contact tracing alarm tick count

Service Executable

operation

data

format



Number of consecutive

scans triggered by an

alarm

From 1 to 10 Default: 0x01

0xFFDE: Contact tracing Mac Address storage

Service Executable

operation

data

format

function Command ack

0xFF81 Write/Notify 20 Byte

Get mac address

Related operations

by issuing commands

0x01: Get the number of

saved devices

0x02: get saved mac

address

0x03: Clear memory

Default: 0x01

Note: Can be storage more than 500 Mac Address into memory

0xFFDF: Contact Tracing Family filter (whitelist operation)

Service Executable

operation

data

format

function Command ack

0xFF81 Write/Notify 20 Byte

Whitelist actions by

Issuing commands

0x01:Add whitelist

0x02:Remove whitelist

0x03: View whitelist

Success: 0x01

Failure：0x00

Note: can be added into Whitelist max 20 Mac Address

21

Whitelist commands:

0x01 Add Mac Addresses to Whitelist

Example: 0x01NNNNMMMMMMMMMMMM (ADD 1 MAC ADDRESS TO WHITELIST)

01 Command add to Whitelist

NNNN Number of Mac Address to add (Big Endian)

MMMMMMMMMMMM Mac Address to add (if there are more than one to add, they need

to be written sequencially)

0x02 Delete Mac Addresses from Whitelist

Example: 0x02NNNNMMMMMMMMMMMM (REMOVE 1 MAC ADDRESS FROM WHITELIST)

02 Command remove from Whitelist

NNNN Number of Mac Address to remove (Big Endian)

MMMMMMMMMMMM Mac Address to remove (if there are more than one to remove,

they need to be written sequencially)

0x03 View WhiteList

Example 0x03 (it will return all Mac Addresses in the WhiteList)

22

DATALOGGER PARAMETERS

The datalogger function allows the user to set MIN and MAX tresholds,which are usefull to

manage the temperature of the beacon, and so of the enviorement in which the Beacon is

placed.

If these tresholds are exceeded, the Beacon can store in it’s internal memory the temperature

that exceeded, as well as the timestamp (day,hour,minute).

IMPORTANT: THE TEMPERATURE/HUMIDITY SENSOR UPDATES EVERY 10 SECONDS.

Datalogger characteristics Primary Service: FF:83

0xFF84: Temperature record enable switch

Service Executable

operation

data

format

Function remark

0xFF83

Read/write 1 Byte

Enable whether to record

temperature history value

Default: 0x00

OFF: 0x00

ON: 0x01


start to ‘store’ temperature

values, if the tresholds are

exceeded.

0xFF85: Humidity record enable switch

Service Executable

operation

data

format

Function remark

0xFF83

Read/write 1 Byte

Enable whether to record

humidity history value

Default: 0x00

OFF: 0x00

ON: 0x01


start to ‘store’ humidity values,

if the tresholds are exceeded.

23

0xFF86: Recording interval time setting

Service Executable

operation

data

format

function remark

0xFF83

Read/write 4 Byte

Set recording temperature

and humidity interval

EXAMPLE: 0x00 0x0A 0x00 0x0A Temperature is recorded every 10 seconds Humidity is recorded every 10

seconds

0xFF87: Calibration time setting

Service Executable

operation

data

format

function remark

0xFF83

Read/write 6 Byte

Calibration time EXAMPLE:

0x14(Year) 0x0b(Month) 0x12(Day) 0x09(Hour) 0x0a(Minute) 0x00(Second) 2020/11/18 9:10:00

0xFF88: Temperature threshold setting

Service Executable

operation

data

format

function remark

0xFF83

Read/write 4 Byte

LSB

Temperature treshold setting EXAMPLE:

0x01 0x00 0x26 0x00 Minimum temperature threshold: 1° Maximum temperature

threshold: 38°

24

0xFF89: Humidity threshold setting

Service Executable

operation

data

format

function remark

0xFF83

Read/write 4 Byte

Humidity treshold setting EXAMPLE:

0x20 0x50 Lowest humidity threshold: 32% Maximum humidity threshold: 80%

0xFF90: History data read

Service Executable

operation

data

format

function remark

0xFF83

Write/notify 1 Byte

History data read 0x01: Get the historical number of temperature 0x02: read temperature 0x03: Get the historical number of humidity 0x04: Read humidity

0x05: Clear Temperature storage

0x06: Clear Humidity storage

Write: 0x01 --> FF:90 Ack:

Write: 0x02 --> FF:90 Ack: 0xFF Indicates that the answer is complete

CMD VALUES

0x01 BIG-Endian

CMD Number DATE Temperature

0x02 How many valid data are in the frame data

[year][mon][date][hour][min][sec]

[Temperature integer part][Temperature decimal part]

25

Write: 0x03 --> FF:90 Ack:

Write: 0x04 --> FF:90 Ack: 0xFF Indicates that the answer is complete

Write: 0x05 --> FF:90 (CLEAR TEMPERATURE STORAGE) Write: 0x06 --> FF:90 (CLEAR HUMIDITY STORAGE)

CMD VALUES

0x03 BIG-Endian

CMD Number DATE Humidity

0x04 How many valid data are in the frame data

[year][mon][date][hour][min][sec]

[Humidity Percentual]

26

SCAN RESPONSE FORMAT (Hexadecimal values)

The Scan Response is an addictional packet sent by the Beacony if the Master makes a request for

it.

When the Master receives an Advertising Packet from a Beacon, it can tell the Beacon to send

another packet (can be custom) for more addictional data.

This act is called Scan Active.

Here below is described our custom Scan Response:

SCAN RESPONSE EXAMPLE: (STANDARD BEACONY)

0303bbaa0d16bbaa64192305ff00fc90c1600b09476c6f62616c20546167

03,0d,0b Data Packet Lengths.

64 Battery Service (Percentual,HEX Value)

192305 Temperature and Humidity:

1° - 2° Byte -> Temperature Integer Value

3° - 4° Byte -> Humidity Percentual Value

5° - 6° Byte -> Temperature Decimal Value

476c6f62616c20546167 Friendly Name (0xFF88)

ff00fc90c160 Accelerometer:

1° - 2° Byte -> Coordinate X HEX Value

3° - 4° Byte -> Coordinate Y HEX Value

5° - 6° Byte -> Coordinate Z HEX Value

bbaa Reserved

03,16 Type of Services (use type reserved).

09 Friendly name not complete (less than 19Byte). 08 complete

27

SCAN RESPONSE EXAMPLE: (CONTACT TRACING / SOCIAL DISTANCING BEACONY)

0303bbaa0d16bbaa0e0c192305ff00fc90c1600b09476c6f62616c20546167

03,0d,0b Data Packet Lengths.

0e0c Battery Voltage (Same as the TLM one displayed,HEX Value)

192305 Temperature and Humidity:

1° - 2° Byte -> Temperature Integer Value

3° - 4° Byte -> Humidity Percentual Value

5° - 6° Byte -> Temperature Decimal Value

476c6f62616c20546167 Friendly Name (0xFF88)

ff00fc90c160 Accelerometer:

1° - 2° Byte -> Coordinate X HEX Value

3° - 4° Byte -> Coordinate Y HEX Value

5° - 6° Byte -> Coordinate Z HEX Value

bbaa Reserved

03,16 Type of Services (use type reserved).

09 Friendly name not complete (less than 19Byte). 08 complete

Documents

Beacony Parameter 3.9 - ozrobotics.com