Bluetooth Low Energy controlled LED - Farsens · Bluetooth Low Energy controlled LED Check for...
Transcript of Bluetooth Low Energy controlled LED - Farsens · Bluetooth Low Energy controlled LED Check for...
WWW.FARSENS.COM
BLE-LED
Datasheet
Bluetooth Low Energy controlled LEDCheck for samples: BLE-LED
FEATURES
• Bluetooth Low Energy (BLE) interface
– 2400-2480MHz operation
– Bluetooth 4.1 single-mode
– Typical read range: 10m
• Industrial working temperature range: -40 ◦Cto +85 ◦C
• Color scale
– 4 RGB LED-s
– More than 16 million colors
– 256 intensity levels
• Customizable LED modes
– Continuous light
– Continuous blink
– Determined blink number
• Friendly User Interface
– Button/LED manual interface
– Reset function
– Demo Android application
∗ Allows checking different blink andconnection configurations
∗ Supports Android 4.3 onwards
– Demo Windows application
∗ Allows checking different blink andconnection configurations
∗ Supports Windows 8 onwards
• Long battery life time
– CR-2032 button cell lithium battery
– Battery monitoring with alerts in theAndroid application and BLE LED board
DESCRIPTIONBLE-LED is a Bluetooth Low Enery controlled LEDsystem. Built in a compact PCB format, the tagincludes a BLE interface, an advertisement RGB LED,and four RGB LEDs which can represent more than16 million of colours with 256 intensity levels.
The user can remotelly control the colour of theRGB LEDs, ligth’s intensity and blinking or continuousworking modes. The device will notify the batterystatus in the board with the advertising LED and alsoin the mobile application.
This tag can be controlled with devices supportingBluetooth 4.0 or higher, and the API of the devicemust support the Bluetooth low energy API. Windows,IOS and Android (at least 4.3) devices can be usedto communicate with this tag at distances over tenmeters.
Copyright c©, Farsens 1
BLE-LED
Datasheet - DS-BLE-LED-V02 - JULY 2016 WWW.FARSENS.COM
BASIC USER INTERFACEBLE-LED includes a Bluetooth Low Energy module, a tactile push button, an advertising RGB LED and 4 RGBLEDs. The tactile push button allows switching the device on, while the advertising LED shows the system statusfollowing a color codification.
The BLE LED service includes six characteristics: color, on/off, number of blinks, blink on and off times, devicestatus notification and battery level notifications. These characteristics and their proterties are going to beanalized in this document.
LED
PUSHBUT.
LED LED
LED LED
BLE
Figure 1: Manual user interface of BLE-LED
CHECK STATUS
The advertising RGB LED provides information about the status of the BLE LED board. The LED will showmessages with the following color codification:
COLOR SIGNAL DESCRIPTION
Red Blink Low battery
Green Blink BLE advertising mode
2 Copyright c©, Farsens
WWW.FARSENS.COM
BLE-LED
Datasheet - DS-BLE-LED-V02 - JULY 2016
ABSOLUTE MAXIMUM RATINGS
SYMBOL PARAMETER MIN MAX UNIT
VDD Supply voltage -0.5 5.0 V
Tstorage Storage temperature -40 125 ◦C
ESD RATINGS
SYMBOL PARAMETER MIN MAX UNIT
ESDHBM Static discharge HBM 4000 V
ESDMM Static discharge MM 200 V
RECOMMENDED OPERATING CONDITIONS
SYMBOL PARAMETER MIN TYP MAX UNIT
RF
PRF RF output power -18 3 dBm
POWER SUPPLY
VDD Supply voltage 1.8 3.0 3.6 V
TEMPERATURE
Toperation Operation temperature -40 85 C
ELECTRICAL CHARACTERISTICS
SYMBOL PARAMETER MIN TYP MAX UNIT
RF
RFSENS
RF sensitivity -87 dBm
Theoretical range in open air 25 m
Actual range in typical environment 10 m
POWER SUPPLY
IDD Supply current
Idle 1.83 µA
Advertising 400 µA
Alerts & Connected 324 µA
Alerts & LED on 5 30 60 mA
BATLIFE Expected battery life 1 month
BLE LED battery life values were calculated for a typlical blink of 1 second with a half maximum intensity and a50% duty cycle asumming a continuous BLE connection.
Copyright c©, Farsens 3
BLE-LED
Datasheet - DS-BLE-LED-V02 - JULY 2016 WWW.FARSENS.COM
LED CHARACTERISTICS
PARAMETER MIN TYP MAX UNIT
Light intensity 1.7 lux
RedDominant wavelength 619 624 nm
Luminous intensity 355 900 mcd
GreenDominant wavelength 520 540 nm
Luminous intensity 560 1800 mcd
BlueDominant wavelength 460 480 nm
Luminous intensity 180 505 mcd
4 Copyright c©, Farsens
WWW.FARSENS.COM
BLE-LED
Datasheet - DS-BLE-LED-V02 - JULY 2016
SERVICE DESCRIPTION
BLE-LED has two main services to configure and interact with the device. The LED service includes thecharacteristic related to the functionality while general characteristic service contains the handles for the connectionparameters’ configuration. Each services’ and characteristics’ UUID and details are shown in the following servicetree.
LED (s) 0000C000-0000-1000-8000-00805F9B34FB
Color (c) 0000C001-0000-1000-8000-00805F9B34FB
Characteristic User Description 00002901-0000-1000-8000-00805F9B34FB
OnOff (c) 0000C002-0000-1000-8000-00805F9B34FB
Characteristic User Description 00002901-0000-1000-8000-00805F9B34FB
nBlinks (c) 0000C003-0000-1000-8000-00805F9B34FB
Characteristic User Description 00002901-0000-1000-8000-00805F9B34FB
tUpDown (c) 0000C004-0000-1000-8000-00805F9B34FB
Characteristic User Description 00002901-0000-1000-8000-00805F9B34FB
StatusNot (c) 0000C005-0000-1000-8000-00805F9B34FB
Client Characteristic Configuration 00002902-0000-1000-8000-00805F9B34FB
Characteristic User Description 00002901-0000-1000-8000-00805F9B34FB
GenCharact. (s) 0000C100-0000-1000-8000-00805F9B34FB
BatteryLevel (c) 0000C101-0000-1000-8000-00805F9B34FB
Client Characteristic Configuration 00002902-0000-1000-8000-00805F9B34FB
Characteristic User Description 00002901-0000-1000-8000-00805F9B34FB
TX Power (c) 0000C102-0000-1000-8000-00805F9B34FB
Characteristic User Description 00002901-0000-1000-8000-00805F9B34FB
Advertising Mode (c) 0000C103-0000-1000-8000-00805F9B34FB
Characteristic User Description 00002901-0000-1000-8000-00805F9B34FB
Advertising Parameters (c) 0000C104-0000-1000-8000-00805F9B34FB
Characteristic User Description 00002901-0000-1000-8000-00805F9B34FB
Reboot (c) 0000C105-0000-1000-8000-00805F9B34FB
Characteristic User Description 00002901-0000-1000-8000-00805F9B34FB
Save Configuration (c) 0000C106-0000-1000-8000-00805F9B34FB
Characteristic User Description 00002901-0000-1000-8000-00805F9B34FB
Copyright c©, Farsens 5
BLE-LED
Datasheet - DS-BLE-LED-V02 - JULY 2016 WWW.FARSENS.COM
Advertising LED (c) 0000C107-0000-1000-8000-00805F9B34FB
Characteristic User Description 00002901-0000-1000-8000-00805F9B34FB
Battery LED (c) 0000C108-0000-1000-8000-00805F9B34FB
Characteristic User Description 00002901-0000-1000-8000-00805F9B34FB
(s) = service, (c) = characteristic.
LED SERVICE
The LED service of the BLE-LED device consists of six characteristics that set the performance of the device:Color, Onoff, nBlinks, tUpDown, StatusNot and BatteryLevel.
The Color characteristic is a read and write type characteristic used to select the color and the intensity of thelight generated using the four RGB LEDs. It is a Read/Write characteristic and its configuration is shown in thenext figure:
Byte 3
I B G R
Byte 2 Byte 1 Byte 0rawdata
content
• R: Red value of the final color code.
• G: Green value of the final color code.
• B: Blue value of the final color code.
• I: Intensity of the color obtained from R, G and B values.
The OnOff characteristic is a read and write type characteristic to switch on or off the four RGB LEDs. To switchLEDs on a 0xFF byte needs to be set in this characteristic while setting this characteristic to 0x00 switches themoff.
Byte 0
On/Off
rawdata
content
The third one is the nBlinks characteristic, which is a read and write type characteristic used to set the numberof blinks that are desired. If a continuous blinking or continuous light is wanted, this characteristic needs to beset to 0x00.
6 Copyright c©, Farsens
WWW.FARSENS.COM
BLE-LED
Datasheet - DS-BLE-LED-V02 - JULY 2016
Byte 0
nBlinks
rawdata
content
The tUpDown characteristic, read and write type characteristic, sets the time the LEDs are on and off. In casethe performance mode is set to blinking mode, this characteristic sets the times of the blinking. If a continuouslight is desired, the value of the tDown needs to be set to 0x00.
Byte 3
tDownH tDownL tUpH tUpL
Byte 2 Byte 1 Byte 0rawdata
content
• tDownH: MSB of the time where LEDs are off in miliseconds.
• tDownL: LSB of the time where LEDs are off in miliseconds.
• tUpH: MSB of the time where LEDs are on in miliseconds.
• tUpL: LSB of the time where LEDs are on in miliseconds.
StatusNot characteristic is a read and notify characteristic that shows changes on the OnOff characteristic. Incase of nBlinks value is different to 0x00, this characteristic is used to notify that the blink cycle is finished.
Byte 0
Status
rawdata
content
GENERAL CHARACTERISTICS SERVICE
The second Bluetooth service of the BLE-LED is the GeneralCharacteristic, which sets the connection parametersand some extra features to the device such as the battery level or the possibility to save configuration or rebootthe device.
The main connection parameters are the TX Power level, advertising period and advertising timeout, describedin the next figure:
Copyright c©, Farsens 7
BLE-LED
Datasheet - DS-BLE-LED-V02 - JULY 2016 WWW.FARSENS.COM
Time
TX
Po
we
r
Adv.
Period
Adv. Timeout
TX Power level sets the communication power level between the BLE-LED and the receiver. This parametersupports the following values: -18 dBm, -12 dBm, -6 dBm, -3 dBm, -2 dBm, -1 dBm, 0 dBm and 3 dBm. It is aread and write type characteristic wich is transmitted as an int16 type variable as shown in the following figure:
Byte 1
TXH TXL
Byte 0rawdata
content
This device has two advertising modes, the one where the device is always switched on and visible and a secondone where the device is switched off, and it is waked up to the advertising mode using a physical button placedon the BLE-LED .
• Button mode: The device is switched of if there is no active connection with any device. To set it intoadvertisement mode the button placed on the board must be pressed, and then, the device enters theadvertising mode sending advertising messages with a period and timeout set in the Advertising Parameterscharacteristic. Once the advertising time elapsed, the system is switched off until the button is pressedagain. When the BLE-LED is disconnected from a receiver, the device enters the advertising mode againwith the parameters specified in the Advertising Parameters characteristic.
• Visible mode: The device is never switched off, it can be connected to a device or in the advertising modewaiting for a connection. Working in this mode, the advertisement follows the period set in the AdvertisingParamters characteristic but there is no timeout, because it is continuously sending messages.
The selection of the advertising mode is carried out with the Advertising Mode read and write characteristic.When a 0x00 is written in this handle, the advertisement mode is set to button mode while setting this handle to0x01 visible mode is selected.
8 Copyright c©, Farsens
WWW.FARSENS.COM
BLE-LED
Datasheet - DS-BLE-LED-V02 - JULY 2016
Byte 0
AdvMode
rawdata
content
Advertising Parameters is a read and write characteristic to set the advertising period and timetout. It is a 4byte variable, which is divided into to int16 variables: advertisement period and advertisement timeout.
Byte 3
TimeoutH TimeoutL PeriodH PeriodL
Byte 2 Byte 1 Byte 0rawdata
content
BatteryLevel characteristic is a read and notify type characteristic that provides the battery voltage in a float typevariable. As explained for Rvalue characteristic, notify working mode is enabled setting the Client CharacteristicConfiguration to 0x01. To disable the notifications the 0x00 value must be written in the Client CharacteristicConfiguration.
Byte 3
BattXH BattH BattL BattXL
Byte 2 Byte 1 Byte 0rawdata
content
Reboot is a write only characteristic which offers the posibility to remotely reboot the device by setting the handleto 0x01. This action will reset the device with the parameters saved on the memory.
Byte 0
Reboot
rawdata
content
Copyright c©, Farsens 9
BLE-LED
Datasheet - DS-BLE-LED-V02 - JULY 2016 WWW.FARSENS.COM
Save Configuration is a write only characteristic to save all the configuration data into the non volatile memory ofthe device. Thus, configuration is not lost when the device is switched off or battery is replaced. Memory writtingprocess is enabled by setting this handle to 0x01.
Byte 0
Save
rawdata
content
Advertisement LED is a read and write characteristic that offers the posibility to enable or disable LED notificationswhen the device is in advertisement mode. To enable the notifications, 0x01 value must be written in this handle,while writting 0x00, notifications are disabled.
Byte 0
AdvLED
rawdata
content
Finally, Battery LED is a read and write characteristic to switch on or off low battery LED notifications. As in caseof Advertising LED characteristic, 0x01 value must be written to enable notifications and 0x00 to disable them.When notifications are enabled and battery level is low, the LED blinks in red every 10 seconds to notify the lowbattery status.
Byte 0
BattLED
rawdata
content
10 Copyright c©, Farsens
WWW.FARSENS.COM
BLE-LED
Datasheet - DS-BLE-LED-V02 - JULY 2016
DEMO SOFTWAREIn order to receive data from the BLE-LED device, a custom software is required. This software is availablefor Android and Windows, which can be downloaded from Google Play and Windows Store respectively. Theapplication is called Bluetooth LED and it can be downloaded from the following links or QR code:
Copyright c©, Farsens 11
BLE-LED
Datasheet - DS-BLE-LED-V02 - JULY 2016 WWW.FARSENS.COM
REFERENCESThe next table shows the available references of the BLE-LED.
Ref. Name Description
38902 BLE-LED Bluetooth Low Energy with 4 RGB LEDs, PCB format
38902 BLE-LED Bluetooth Low Energy with 4 RGB LEDs, PCB format
For custom references with other antennas and housings, please contact us at [email protected].
12 Copyright c©, Farsens
WWW.FARSENS.COM
BLE-LED
Datasheet - DS-BLE-LED-V02 - JULY 2016
PACKAGING
PACKAGE DESCRIPTION
Maximum height: 8 mm.
Notes: 1. All linear dimensions are in millimeters.2. This drawing is subject to change without notice.
Copyright c©, Farsens 13