openHAB - LED Strip Bricklet 2.0¶

Simple¶

Download (ExampleSimple.rules)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

import java.util.Collections

val NUM_LEDS = 200
var counter = 0

rule "example"
when
    // System started has to be used as additional trigger to draw the first frame, the channel will only
    // trigger once the first frame has been sent.
    // Change XYZ to the UID of your LED Strip Bricklet 2.0
    System started or Channel "tinkerforge:brickletledstripv2:XYZ:BrickletLEDStripV2FrameStarted" triggered
then
    // Change XYZ to the UID of your LED Strip Bricklet 2.0
    val ledActions = getActions("tinkerforge", "tinkerforge:brickletledstripv2:XYZ")

    counter = counter + 1

    //Clear all LEDs when at the end of the strip.
    if (counter >= NUM_LEDS) {
         ledActions.brickletLEDStripV2SetLEDValues(0, Collections.nCopies(600, 0))
         counter = 0
    }

    // Draw pattern: black, red, green, blue, black
    // If the colors are exchanged, the channel mapping is misconfigured
    ledActions.brickletLEDStripV2SetLEDValues(counter * 3, newArrayList(0, 0, 0,
                                                                        255, 0, 0,
                                                                        0, 255, 0,
                                                                        0, 0, 255,
                                                                        0, 0, 0))
end

Basic Actions¶

brickletLEDStripV2SetLEDValues(int index, int[] value)¶

Parameters:	index – Type: int, Range: [0 to 6144] value – Type: int[], Length: variable, Range: [0 to 255]

Sets the RGB(W) values for the LEDs starting from index. You can set at most 2048 RGB values or 1536 RGBW values (6144 byte each).

To make the colors show correctly you need to configure the chip type (see the thing configuration) and a channel mapping (see the thing configuration) according to the connected LEDs.

If the channel mapping has 3 colors, you need to give the data in the sequence RGBRGBRGB... if the channel mapping has 4 colors you need to give data in the sequence RGBWRGBWRGBW...

The data is double buffered and the colors will be transfered to the LEDs when the next frame duration ends (see the thing configuration).

Generic approach:

• Set the frame duration to a value that represents the number of frames per second you want to achieve.
• Set all of the LED colors for one frame.
• Wait for the Frame Started channel.
• Set all of the LED colors for next frame.
• Wait for the Frame Started channel.
• And so on.

This approach ensures that you can change the LED colors with a fixed frame rate.

brickletLEDStripV2GetLEDValues(int index, int length)¶

Parameters:	index – Type: int, Range: [0 to 6144] length – Type: int, Range: [0 to 6144]
Return Map:	value – Type: int[], Length: variable, Range: [0 to 255]

Returns length RGB(W) values starting from the given index.

If the channel mapping has 3 colors, you will get the data in the sequence RGBRGBRGB... if the channel mapping has 4 colors you will get the data in the sequence RGBWRGBWRGBW... (assuming you start at an index divisible by 3 (RGB) or 4 (RGBW)).

brickletLEDStripV2GetFrameDuration()¶

Return Map:	duration – Type: int, Unit: 1 ms, Range: [0 to 216 - 1], Default: 100

Returns the frame duration as set by the thing configuration.

brickletLEDStripV2GetSupplyVoltage()¶

Return Map:	voltage – Type: int, Unit: 1 mV, Range: [0 to 216 - 1]

Returns the current supply voltage of the LEDs.

brickletLEDStripV2GetClockFrequency()¶

Return Map:	frequency – Type: long, Unit: 1 Hz, Range: [10000 to 2000000], Default: 1666666

Returns the currently used clock frequency as set by the thing configuration.

brickletLEDStripV2GetChipType()¶

Return Map:	chip – Type: int, Range: See constants, Default: 2801

Returns the currently used chip type as set by the thing configuration.

The following constants are available for this function:

For chip:

• val CHIP_TYPE_WS2801 = 2801
• val CHIP_TYPE_WS2811 = 2811
• val CHIP_TYPE_WS2812 = 2812
• val CHIP_TYPE_LPD8806 = 8806
• val CHIP_TYPE_APA102 = 102

brickletLEDStripV2GetChannelMapping()¶

Return Map:	mapping – Type: int, Range: See constants, Default: 36

Returns the currently used channel mapping as set by the thing configuration.

The following constants are available for this function:

For mapping:

• val CHANNEL_MAPPING_RGB = 6
• val CHANNEL_MAPPING_RBG = 9
• val CHANNEL_MAPPING_BRG = 33
• val CHANNEL_MAPPING_BGR = 36
• val CHANNEL_MAPPING_GRB = 18
• val CHANNEL_MAPPING_GBR = 24
• val CHANNEL_MAPPING_RGBW = 27
• val CHANNEL_MAPPING_RGWB = 30
• val CHANNEL_MAPPING_RBGW = 39
• val CHANNEL_MAPPING_RBWG = 45
• val CHANNEL_MAPPING_RWGB = 54
• val CHANNEL_MAPPING_RWBG = 57
• val CHANNEL_MAPPING_GRWB = 78
• val CHANNEL_MAPPING_GRBW = 75
• val CHANNEL_MAPPING_GBWR = 108
• val CHANNEL_MAPPING_GBRW = 99
• val CHANNEL_MAPPING_GWBR = 120
• val CHANNEL_MAPPING_GWRB = 114
• val CHANNEL_MAPPING_BRGW = 135
• val CHANNEL_MAPPING_BRWG = 141
• val CHANNEL_MAPPING_BGRW = 147
• val CHANNEL_MAPPING_BGWR = 156
• val CHANNEL_MAPPING_BWRG = 177
• val CHANNEL_MAPPING_BWGR = 180
• val CHANNEL_MAPPING_WRBG = 201
• val CHANNEL_MAPPING_WRGB = 198
• val CHANNEL_MAPPING_WGBR = 216
• val CHANNEL_MAPPING_WGRB = 210
• val CHANNEL_MAPPING_WBGR = 228
• val CHANNEL_MAPPING_WBRG = 225

Advanced Actions¶

brickletLEDStripV2GetChipTemperature()¶

Return Map:	temperature – Type: int, Unit: 1 °C, Range: [-215 to 215 - 1]

Returns the temperature as measured inside the microcontroller. The value returned is not the ambient temperature!

The temperature is only proportional to the real temperature and it has bad accuracy. Practically it is only useful as an indicator for temperature changes.

brickletLEDStripV2GetStatusLEDConfig()¶

Return Map:	config – Type: int, Range: See constants, Default: 3

Returns the configuration as set by the thing configuration

The following constants are available for this function:

For config:

• val STATUS_LED_CONFIG_OFF = 0
• val STATUS_LED_CONFIG_ON = 1
• val STATUS_LED_CONFIG_SHOW_HEARTBEAT = 2
• val STATUS_LED_CONFIG_SHOW_STATUS = 3

brickletLEDStripV2GetSPITFPErrorCount()¶

Return Map:	errorCountAckChecksum – Type: long, Range: [0 to 232 - 1] errorCountMessageChecksum – Type: long, Range: [0 to 232 - 1] errorCountFrame – Type: long, Range: [0 to 232 - 1] errorCountOverflow – Type: long, Range: [0 to 232 - 1]

Returns the error count for the communication between Brick and Bricklet.

The errors are divided into

• ACK checksum errors,
• message checksum errors,
• framing errors and
• overflow errors.

The errors counts are for errors that occur on the Bricklet side. All Bricks have a similar function that returns the errors on the Brick side.

brickletLEDStripV2Reset()¶

Calling this function will reset the Bricklet. All configurations will be lost.

After a reset you have to create new device objects, calling functions on the existing ones will result in undefined behavior!

brickletLEDStripV2GetIdentity()¶

Return Map:

uid – Type: String, Length: up to 8 connectedUid – Type: String, Length: up to 8 position – Type: char, Range: ['a' to 'h', 'z'] hardwareVersion – Type: short[], Length: 3 0: major – Type: short, Range: [0 to 255] 1: minor – Type: short, Range: [0 to 255] 2: revision – Type: short, Range: [0 to 255] firmwareVersion – Type: short[], Length: 3 0: major – Type: short, Range: [0 to 255] 1: minor – Type: short, Range: [0 to 255] 2: revision – Type: short, Range: [0 to 255] deviceIdentifier – Type: int, Range: [0 to 216 - 1]

Returns the UID, the UID where the Bricklet is connected to, the position, the hardware and firmware version as well as the device identifier.

The position can be 'a', 'b', 'c', 'd', 'e', 'f', 'g' or 'h' (Bricklet Port). A Bricklet connected to an Isolator Bricklet is always at position 'z'.

The device identifier numbers can be found here. 

Internal Actions¶

brickletLEDStripV2ReadUID()¶

Return Map:	uid – Type: long, Range: [0 to 232 - 1]

Returns the current UID as an integer. Encode as Base58 to get the usual string version.