import { _ as _export_sfc, c as createElementBlock, o as openBlock, a8 as createStaticVNode } from "./chunks/framework.DyMmIvSC.js"; const __pageData = JSON.parse('{"title":"APA102 Driver","description":"","frontmatter":{},"headers":[],"relativePath":"drivers/apa102.md","filePath":"drivers/apa102.md"}'); const _sfc_main = { name: "drivers/apa102.md" }; const _hoisted_1 = /* @__PURE__ */ createStaticVNode('

APA102 Driver ​

This driver provides support for APA102 addressable RGB LEDs. They are similar to the WS2812 LEDs, but have increased data and refresh rates.

Usage ​

In most cases, the APA102 driver code is automatically included if you are using either the RGBLight or RGB Matrix feature with the apa102 driver set, and you would use those APIs instead.

However, if you need to use the driver standalone, add the following to your rules.mk:

make
APA102_DRIVER_REQUIRED = yes

You can then call the APA102 API by including apa102.h in your code.

Basic Configuration ​

Add the following to your config.h:

DefineDefaultDescription
APA102_DI_PINNot definedThe GPIO pin connected to the DI pin of the first LED in the chain
APA102_CI_PINNot definedThe GPIO pin connected to the CI pin of the first LED in the chain
APA102_DEFAULT_BRIGHTNESS31The default global brightness level of the LEDs, from 0 to 31

API ​

void apa102_init(void) ​

Initialize the LED driver. This function should be called first.

void apa102_set_color(uint16_t index, uint8_t red, uint8_t green, uint8_t blue) ​

Set the color of a single LED. This function does not immediately update the LEDs; call apa102_flush() after you are finished.

Arguments ​

void apa102_set_color_all(uint8_t red, uint8_t green, uint8_t blue) ​

Set the color of all LEDs.

Arguments ​

void apa102_flush(void) ​

Flush the PWM values to the LED chain.

void apa102_set_brightness(uint8_t brightness) ​

Set the global brightness.

Arguments ​

', 31); const _hoisted_32 = [ _hoisted_1 ]; function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) { return openBlock(), createElementBlock("div", null, _hoisted_32); } const apa102 = /* @__PURE__ */ _export_sfc(_sfc_main, [["render", _sfc_render]]); export { __pageData, apa102 as default };