Embrava Implementation¶
Blynclight series with audio capabilities
This module contains the low-level implementation details for Embrava devices, including enumerations, bit fields, and state management classes.
Available Components¶
Embrava device implementation details.
Attributes¶
module-attribute
¶
BLYNCUSB_COLOR_TO_RGB = {
WHITE: (255, 255, 255),
CYAN: (0, 255, 255),
MAGENTA: (255, 0, 255),
BLUE: (0, 0, 255),
YELLOW: (255, 255, 0),
GREEN: (0, 255, 0),
RED: (255, 0, 0),
OFF: (0, 0, 0),
}
module-attribute
¶
BLYNCUSB_TO_TENX20 = {
RED: RED,
GREEN: GREEN,
BLUE: BLUE,
YELLOW: YELLOW,
MAGENTA: MAGENTA,
WHITE: WHITE,
CYAN: CYAN,
OFF: OFF,
}
module-attribute
¶
FlashSpeed = BlynclightFlashSpeed
Classes¶
Bases: IntEnum
Flash speed enumeration for Embrava Blynclight devices.
Defines the available flash speeds for the LED indicator. These values control how quickly the device cycles when in flash mode.
Attributes¶
class-attribute
instance-attribute
¶
class-attribute
instance-attribute
¶
class-attribute
instance-attribute
¶
Bases: Word
Complete device state for Embrava Blynclight commands.
The State class manages the full command structure sent to Embrava devices. It controls both LED behavior (color, brightness, flashing) and audio functionality (ringtones, volume, playback control). The state is serialized to bytes for transmission to the hardware.
Attributes¶
instance-attribute
¶
instance-attribute
¶
instance-attribute
¶
property
¶
Return the integer value of the word.
property
¶
Return the range of bit offsets for this word.
property
¶
Return a string hexadecimal representation of the word.
property
¶
Return a string binary representation of the word.
class-attribute
instance-attribute
¶
red = RedField()
class-attribute
instance-attribute
¶
blue = BlueField()
class-attribute
instance-attribute
¶
green = GreenField()
class-attribute
instance-attribute
¶
off = OffBit()
class-attribute
instance-attribute
¶
dim = DimBit()
class-attribute
instance-attribute
¶
flash = FlashBit()
class-attribute
instance-attribute
¶
speed = SpeedField()
class-attribute
instance-attribute
¶
repeat = RepeatBit()
class-attribute
instance-attribute
¶
play = PlayBit()
class-attribute
instance-attribute
¶
music = MusicField()
class-attribute
instance-attribute
¶
volume = VolumeField()
class-attribute
instance-attribute
¶
mute = MuteBit()
Functions¶
Clear all bits in the word.
Reset the state to default values.
Sets the device to off state with no audio playback and default flash speed settings.
Bases: IntEnum
Predefined color values for early Blynclight devices.
The blynux protocol uses a 4-bit color mask in the high nibble of byte 7. These values are the mask before shifting.
Attributes¶
class-attribute
instance-attribute
¶
class-attribute
instance-attribute
¶
class-attribute
instance-attribute
¶
class-attribute
instance-attribute
¶
class-attribute
instance-attribute
¶
class-attribute
instance-attribute
¶
class-attribute
instance-attribute
¶
class-attribute
instance-attribute
¶
Bases: IntEnum
Color codes for TENX20 chipset (PID 0x1E00).
Single-byte color codes used in the TENX20 protocol.
Attributes¶
class-attribute
instance-attribute
¶
class-attribute
instance-attribute
¶
class-attribute
instance-attribute
¶
class-attribute
instance-attribute
¶
class-attribute
instance-attribute
¶
class-attribute
instance-attribute
¶
class-attribute
instance-attribute
¶
class-attribute
instance-attribute
¶
Functions¶
Map an RGB color to the nearest predefined BlyncusbColor enum.
Convenience wrapper around snap_color for protocol code that needs the enum value directly.
:param red: Red component (0-255) :param green: Green component (0-255) :param blue: Blue component (0-255) :return: The closest BlyncusbColor match
Map an RGB color to the nearest predefined Blyncusb palette color.
Since these devices only support 7 colors plus OFF, this finds the best match based on which channels are dominant and returns the canonical RGB for that palette entry.
:param red: Red component (0-255) :param green: Green component (0-255) :param blue: Blue component (0-255) :return: The canonical RGB tuple for the nearest palette color