Bluetooth Low Energy controlled LED - Farsens · Bluetooth Low Energy controlled LED Check for...

13
WWW.FARSENS.COM BLE-LED Datasheet Bluetooth Low Energy controlled LED Check 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 C to +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 and connection configurations * Supports Android 4.3 onwards – Demo Windows application * Allows checking different blink and connection configurations * Supports Windows 8 onwards Long battery life time – CR-2032 button cell lithium battery – Battery monitoring with alerts in the Android application and BLE LED board DESCRIPTION BLE-LED is a Bluetooth Low Enery controlled LED system. Built in a compact PCB format, the tag includes a BLE interface, an advertisement RGB LED, and four RGB LEDs which can represent more than 16 million of colours with 256 intensity levels. The user can remotelly control the colour of the RGB LEDs, ligth’s intensity and blinking or continuous working modes. The device will notify the battery status in the board with the advertising LED and also in the mobile application. This tag can be controlled with devices supporting Bluetooth 4.0 or higher, and the API of the device must support the Bluetooth low energy API. Windows, IOS and Android (at least 4.3) devices can be used to communicate with this tag at distances over ten meters. Copyright c , Farsens 1

Transcript of Bluetooth Low Energy controlled LED - Farsens · Bluetooth Low Energy controlled LED Check for...

Page 1: Bluetooth Low Energy controlled LED - Farsens · Bluetooth Low Energy controlled LED Check for samples:BLE-LED ... –4 RGB LED-s ... If a continuous blinking or continuous light

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

Page 2: Bluetooth Low Energy controlled LED - Farsens · Bluetooth Low Energy controlled LED Check for samples:BLE-LED ... –4 RGB LED-s ... If a continuous blinking or continuous light

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

Page 3: Bluetooth Low Energy controlled LED - Farsens · Bluetooth Low Energy controlled LED Check for samples:BLE-LED ... –4 RGB LED-s ... If a continuous blinking or continuous light

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

Page 4: Bluetooth Low Energy controlled LED - Farsens · Bluetooth Low Energy controlled LED Check for samples:BLE-LED ... –4 RGB LED-s ... If a continuous blinking or continuous light

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

Page 5: Bluetooth Low Energy controlled LED - Farsens · Bluetooth Low Energy controlled LED Check for samples:BLE-LED ... –4 RGB LED-s ... If a continuous blinking or continuous light

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

Page 6: Bluetooth Low Energy controlled LED - Farsens · Bluetooth Low Energy controlled LED Check for samples:BLE-LED ... –4 RGB LED-s ... If a continuous blinking or continuous light

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

Page 7: Bluetooth Low Energy controlled LED - Farsens · Bluetooth Low Energy controlled LED Check for samples:BLE-LED ... –4 RGB LED-s ... If a continuous blinking or continuous light

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

Page 8: Bluetooth Low Energy controlled LED - Farsens · Bluetooth Low Energy controlled LED Check for samples:BLE-LED ... –4 RGB LED-s ... If a continuous blinking or continuous light

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

Page 9: Bluetooth Low Energy controlled LED - Farsens · Bluetooth Low Energy controlled LED Check for samples:BLE-LED ... –4 RGB LED-s ... If a continuous blinking or continuous light

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

Page 10: Bluetooth Low Energy controlled LED - Farsens · Bluetooth Low Energy controlled LED Check for samples:BLE-LED ... –4 RGB LED-s ... If a continuous blinking or continuous light

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

Page 11: Bluetooth Low Energy controlled LED - Farsens · Bluetooth Low Energy controlled LED Check for samples:BLE-LED ... –4 RGB LED-s ... If a continuous blinking or continuous light

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

Page 12: Bluetooth Low Energy controlled LED - Farsens · Bluetooth Low Energy controlled LED Check for samples:BLE-LED ... –4 RGB LED-s ... If a continuous blinking or continuous light

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

Page 13: Bluetooth Low Energy controlled LED - Farsens · Bluetooth Low Energy controlled LED Check for samples:BLE-LED ... –4 RGB LED-s ... If a continuous blinking or continuous light

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