Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

badge.bling

Declared in BadgeOS/modules/sg2k/bling.nix.

badge.bling.enable

Whether to enable the badge WS2812 LED ring.

Type: boolean

Default:

config.hardware.sg2k.ledRing.enable

Example:

true

Declared by:

badge.bling.backend

The evaluator for evalPattern: “fix” (embedded) or “nix” (the Nix C API, aarch64 only; elsewhere it falls back to fix).

Type: one of “fix”, “nix”

Default:

"fix"

Declared by:

badge.bling.bits

SPI bits sent for each WS2812 bit: 8 (0 -> 10000000, 1 -> 11111100), 4 (1000, 1110) or 3 (100, 110; flips bits at random on this badge’s LEDs).

Type: one of 3, 4, 8

Default:

8

Declared by:

badge.bling.blob

A baked “BLED” RGB-frame blob to play on the ring (see nix-badge-bling-content’s leds.nix). With neither this nor evalPattern, the ring shows a dim blue fill.

Type: null or absolute path

Default:

null

Declared by:

badge.bling.brightness

Global brightness, applied by scaling the colour channels.

Type: integer between 0 and 255 (both inclusive)

Default:

64

Declared by:

badge.bling.count

Number of WS2812 LEDs on the ring.

Type: positive integer, meaning >0

Declared by:

badge.bling.csHigh

Ask spidev for SPI_CS_HIGH. Keep this true: the LED ring only takes data while chip select is high (LED_DIN = CS AND SDO). The device tree’s GPIO chip select already sets that polarity, so this option is only for overriding it.

Type: boolean

Default:

true

Declared by:

badge.bling.device

spidev node for the SPI3 controller.

Type: string

Default:

"/dev/spidev3.0"

Declared by:

badge.bling.evalPattern

A pure-Nix LED pattern, scope: { bitmap = [ 0xRRGGBB ... ]; nextMs; }, evaluated every frame. Takes precedence over blob.

Type: null or absolute path

Default:

null

Declared by:

badge.bling.fps

Animation frames per second.

Type: integer between 1 and 200 (both inclusive)

Default:

30

Declared by:

badge.bling.speedHz

SPI clock in Hz; with bits it sets the LED bit time. The driver rounds it to an even divisor of ssi_clk, and the service logs the timing it got. The badge’s XL-1615/XL-2020 LEDs want a T1H of 0.9 to 1.0 us.

Type: positive integer, meaning >0

Default:

6400000

Declared by: