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
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
function range remark
0xFF80 Read/write Little End Amend major 2bytes of data Default: 0x0000 (already in
little endian).
0xFF83: iBeacon minor
Service Executable
operation
data
format
function range remark
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
function range remark
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
function range Remark
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
function range Remark
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
function range remark
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
function range Remark
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).
5
0xFFFF: Adv mode
Service Executable
operation
data
format
function range remark
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
function range remark
0xFF80 Read/Write 1Byte OFF service
switch
DEFAULT: 0x00 ON 0X01 OFF
0xFFBB: Power Down
Service Executable
operation
data
format
function range remark
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
function range remark
0xFF80 Read/Write 1Byte Switch ON/OFF
Alarm DEFAULT: 0x00 OFF
0x01 ON
8
0xFF61: Alarm Adv number
Service Executable
operation
data
format
function range remark
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
function range remark
0xFF80 Read/write 1 Byte LED ON/OFF Default: 0x00
OFF: 0x00
ON: 0xFF
0xFF96: Led Blink Time Interval
Service Executable
operation
data
format
function range remark
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
function range remark
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
function range remark
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
function range remark
0xFF80 Read/Write 1Byte Set moving
mode
1 Byte 0x00 Connection Mode (DEFAULT)
0xFF94: Accelerometer control in connected mode
Service Executable
operation
data
format
function range remark
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
0xFFE1: Moving mode service
Service Executable
operation
data
format
function range remark
0xFF80 Read/Write 1Byte Set moving
mode
1 Byte 0x01 Advertising Mode
12
TRIGGER MODE
0xFFE1: Moving mode service
Service Executable
operation
data
format
function range remark
0xFF80 Read/Write 1Byte Set moving
mode
1 Byte 0x03 -> Slight Mode
0x04 -> Moving Mode
0xff -> Critical Mode
0xFFE2: Moving advertising time service
Service Executable
operation
data
format
function range remark
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
function range remark
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.
0x0200 Watchdog 2sec.
0x0a00 Watchdog 10 sec.
13
REAL TIME MODE
0xFFE1: Moving mode service
Service Executable
operation
data
format
function range remark
0xFF80 Read/Write 1Byte Set moving
mode
1 Byte 0X03 -> Slight Mode
0x04 -> Moving Mode
0xff -> Critical Mode
0xFFE2: Moving advertising time service
Service Executable
operation
data
format
function range remark
0xFF80 Read/Write 2Byte
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
function range remark
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.
0x0200 Watchdog 2sec.
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
function range remark
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
function range remark
0xFF80 Read/Write 1Byte
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
function range remark
0xFF80 Read/Write 1Byte
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
function range remark
0xFF80 Read/Write 1Byte
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
function range remark
0xFF80 Read/Write 1Byte
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
function range remark
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
function range remark
0xFF81 Read/write 2 Byte
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
function range remark
0xFF81 Read/write 2 Byte
Buzzer mode Byte1 – 00 to 10
Byte2 – 01 to 255
Byte1: Default 0x00 Switch OFF
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
function range remark
0xFF81 Read/write 2 Byte
Vibe mode Byte1 – 00 to 10
Byte2 – 01 to 255
Byte1: Default 0x00 Switch OFF
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
function range remark
0xFF81 Read/write 1 Byte
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
0xFF81 Read/write 19 Byte
Scan the white list of
device names
Default: 476c6f62616c20546167
‘Global Tag’ in ASCII
0xFFDD: Contact tracing alarm tick count
Service Executable
operation
data
format
function range remark
0xFF81 Read/write 19 Byte
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
If service turned ON, beacon
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
If service turned ON, beacon
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