[spi_led_strip] Support arbitrary color order and SPI LED strips not based on the APA102 protocol

content/components/light/spi_led_strip.md

@@ -10,8 +10,7 @@ params:
 The `spi_led_strip` light platform drives one or more SPI interfaced RGB LEDs. These LEDs are often used in strips, where
 each LED is individually addressable. This component requires an SPI interface to be configured.
 
-This component has been tested with APA102 LEDs and the P9813 LED driver. It should also work with HD107 and SK9822 type
-LEDs, or any others with a similar interface - SPI, 8 bits per colour and BGR ordering.
+This component supports the APA102 protocol, as well as a "raw" protocol that sends RGBW values defined via `channel_map`.
 
 {{< img src="apa102.jpg" alt="Image" width="75.0%" class="align-center" >}}
 
@@ -24,9 +23,18 @@ spi:
 light:
   - platform: spi_led_strip
     num_leds: 30
-    id: rgb_led
-    name: "RGB LED Strip"
+    protocol: APA102
+    channel_map: [B, G, R]
+    id: apa_rgb_led
+    name: "APA102 RGB LED Strip"
     data_rate: 1MHz
+  - platform: spi_led_strip
+    num_leds: 30
+    protocol: RAW
+    channel_map: [G, B, R, W]
+    id: raw_rgbw_led
+    name: "Raw RGBW LED Strip"
+    data_rate: 2MHz 
 ```
 
 ## Color Correction
@@ -37,12 +45,18 @@ perceived intensity of different colors will generally vary. This can be done by
 
 ## Configuration variables
 
+- **protocol** (**Required**): Set the protocol. One of `APA102`, `RAW`.
+- **channel_map** (**Required**, list): The RGB order of the strip. Must be a comma-seperated list with any of:
+  - R
+  - G
+  - B
+  - W  
 - **num_leds** (*Optional*, int): The number of LEDs attached. The default is 1.
 - **data_rate** (*Optional*): Set the data rate of the SPI interface to the display. One of `80MHz`, `40MHz`, `20MHz`, `10MHz`, `5MHz`, `2MHz`, `1MHz` (default), `200kHz`, `75kHz` or `1kHz`.
+
 - All other options from [Light](/components/light#config-light).
 
-You may also need to configure an `output` GPIO pin to control power to the LEDs, depending on your hardware. The
-APA102 and friends do not have a `CS` input, and are write-only so the SPI `miso` pin should not be specified.
+You may also need to configure an `output` GPIO pin to control power to the LEDs, depending on your hardware. Most SPI LED strips do not have a `CS` input, and are write-only so the SPI `miso` pin should not be specified.
 
 ## See Also