LED stream module

Use the LED stream module to receive the LED effect sequence and display it using LEDs. The LED effect sequence is generated on the host computer and sent through the Configuration channel.

Module events

Source Module	Input Event	This Module	Output Event	Sink Module
Source modules for config_event	config_event	led_stream
LED state module	led_event
LED stream module
LEDs module	led_ready_event
Source modules for module_state_event	module_state_event
			config_event	Sink modules for config_event
			led_event	LED stream module
				LEDs module
			module_state_event	Sink modules for module_state_event

Note

See the Overview: Firmware architecture for more information about the event-based communication in the nRF Desktop application and about how to read this table.

Configuration

The module receives LED effects through the Configuration channel and displays them using the CAF: LEDs module. For this reason, make sure that CONFIG_CAF_LEDS and CONFIG_DESKTOP_CONFIG_CHANNEL_ENABLE are both set.

To enable the module, use the CONFIG_DESKTOP_LED_STREAM_ENABLE Kconfig option.

You can also define the stream LED event queue size (CONFIG_DESKTOP_LED_STREAM_QUEUE_SIZE). The queue is used by the module as data buffer for the data received from the host computer.

Configuration channel

Note

All the described Configuration channel options are used by the HID configurator for nRF Desktop during the led_stream operation. You can trigger displaying the LED stream effects using the led_stream command in CLI.

The module is a Configuration channel listener and provides the following options:

• set_led_effect

  The HID configurator for nRF Desktop performs the set operation on this option to send the LED effect step that will be displayed by the CAF: LEDs module. The selected LED is identified using the LED ID provided in the data received from the host. The module queues the received LED effect steps and forwards them to CAF: LEDs module one after another. See the CAF: LEDs module documentation for more detailed information about the LED effect and LED effect step.

• get_leds_state

  The HID configurator for nRF Desktop performs the fetch operation on this option to get the number of available free places in the queue of LED effect steps for every LED. This information can be used, for example, to synchronize the displayed LED effects with music.

  Fetching this option also provides information whether the CAF: LEDs module is ready. If the device is suspended by Power manager module, the LEDs are turned off and the effects cannot be displayed. You then must wake up the device before displaying the LED stream.

Implementation details

The module receives LED effects as config_event. The effects are sent to CAF: LEDs module as led_event. Displaying the sequence begins when the first LED effect is received by the LED stream module.

Every received LED effect has a predefined duration. The LEDs module submits led_ready_event when it finishes displaying a LED effect. On this event, the LED stream module sends the next effect from the queue.

When the sequence is active, the host computer keeps sending new effects that are queued by the LED stream module. The sequence ends when there are no more effects available in the queue.

LED state interaction

The LED state module uses LEDs to display both the state of the system and the state of the connected Bluetooth peer. The LED stream module takes control over the selected LED only when the sequence is displayed. After the sequence ends, the LED effect selected by the LED state module is restored.