RGB LED Button Bricklet

Features

  • High quality 15mm x 15mm button

  • Adjustable RGB LED backlight

  • Replaceable/user-printable cap inlay

Description

The RGB LED Bricklet is equipped with an adjustable RGB backlit button. It can extend Bricks.

You can read the current state of the button (pressed/released) and adjust the color of the LED. The red, green and blue part of the LED can be controlled with 8 bit resolution each.

A white inlay is attached below the cap. This paper inlay can be replaced by a custom printed inlay (for example a power sign or an arrow or similar).

It is also possible to use events. This allows to react to button presses without polling.

Technical Specifications

Property

Value

Current Consumption (LEDs off)

31mW (6.2mA at 5V)

Current Consumption (LEDs on)

207mW (41.4mA at 5V)

LED Resolution

8 bit per channel

Inlay size

14 x 14mm

Button size

15 x 15mm

Cap size

17.4 x 17.4mm

Dimensions (W x D x H)

25 x 25 x 30mm (0.98 x 0.98 x 1.18")

Weight

7g

Resources

Button Inlay

The RGB LED Button Bricklet consists of four parts:

  • Bricklet with button and RGB LED,

  • White cap,

  • Inlay (optional, 14x14mm) and

  • Transparent cap.

RGB LED Button Bricklet disassembled

You can easily print your own inlays (size for perfect fit is 14x14mm). Put them between the white and the transparent cap.

For best results you can print the inlay on a transparent foil. A simple piece of white paper works too, but the LED brightness decreases a little bit.

Below you can find an example of three RGB LED Button Bricklets with different inlays with and without ambient light. The symbol inlays were printed by a laser printer on transparent foil.

RGB LED Button Bricklets with inlays RGB LED Button Bricklets with inlays in darkness

Test your RGB LED Button Bricklet

To test a RGB LED Button Bricklet you need to have Brick Daemon and Brick Viewer installed. Brick Daemon acts as a proxy between the USB interface of the Bricks and the API bindings. Brick Viewer connects to Brick Daemon. It helps to figure out basic information about the connected Bricks and Bricklets and allows to test them.

Connect the RGB LED Button Bricklet to a Brick with a Bricklet Cable.

If you connect the Brick to the PC over USB, you should see a new tab named "RGB LED Button Bricklet" in the Brick Viewer after a moment. Select this tab. You can now see button presses in the GUI and control the backlight RGB LED.

RGB LED Button Bricklet in Brick Viewer

After this test you can go on with writing your own application. See the Programming Interface section for the API of the RGB LED Button Bricklet and examples in different programming languages.

Case

A laser-cut case for the RGB LED Button Bricklet is available.

Case for RGB LED Button Bricklet

The assembly is easiest if you follow the following steps:

  • Screw 2x10mm spacers to bottom of Bricklet (use two diagonal wholes),

  • screw bottom plate to spacers,

  • screw 2x9mm and 1x10mm spacers to bottom plate,

  • build up side plates,

  • plug side plates into bottom plate and

  • screw top plate to top spacers.

Below you can see an exploded assembly drawing of the RGB LED Button Bricklet case:

Exploded assembly drawing for RGB LED Button Bricklet

Hint: There is a protective film on both sides of the plates, you have to remove it before assembly.

Programming Interface

See Programming Interface for a detailed description.

Language

API

Examples

Installation

C/C++

API

Examples

Installation

C/C++ for Microcontrollers

API

Examples

Installation

C#

API

Examples

Installation

Delphi/Lazarus

API

Examples

Installation

Go

API

Examples

Installation

Java

API

Examples

Installation

JavaScript

API

Examples

Installation

LabVIEW

API

Installation

Mathematica

API

Examples

Installation

MATLAB/Octave

API

Examples

Installation

MQTT

API

Examples

Installation

openHAB

API

Examples

Installation

Perl

API

Examples

Installation

PHP

API

Examples

Installation

Python

API

Examples

Installation

Ruby

API

Examples

Installation

Rust

API

Examples

Installation

Shell

API

Examples

Installation

Visual Basic .NET

API

Examples

Installation

TCP/IP

API

Modbus

API