From c5ab2807256cfaa96487e198984e357b87fa31ed Mon Sep 17 00:00:00 2001
From: Roman Priesol <roman@priesol.net>
Date: Tue, 29 Sep 2026 23:22:17 +0200
Subject: [PATCH] air-office-r: document hardware, disable the LEDs until the
 stick is fixed

The TZT 8-bit WS2812 stick lights up random colours after the first LED.
---
 mcu-air-office-r.yaml | 120 +++++++++++++++++++++---------------------
 1 file changed, 61 insertions(+), 59 deletions(-)

diff --git a/mcu-air-office-r.yaml b/mcu-air-office-r.yaml
index bd56bdc..1d6c049 100644
--- a/mcu-air-office-r.yaml
+++ b/mcu-air-office-r.yaml
@@ -1,4 +1,12 @@
 ---
+# Hardware: IKEA VINDRIKTNING (modded) + M5Stack M5Stamp Pico
+# Pinout:
+#   GPIO21  PM1006 UART                -> particle_uart (uart tx_pin)
+#   GPIO22  PM1006 UART                -> particle_uart (uart rx_pin)
+#   GPIO25  TZT 8-bit WS2812 5050 stick (8 LEDs, 7 visible outside; LEDs 1-7 broken), disabled
+#   GPIO27  Onboard RGB LED (1x WS2812, inside), unused
+#   GPIO32  Grove SDA                  -> i2c (i2c sda)
+#   GPIO33  Grove SCL                  -> i2c (i2c scl)
 substitutions:
   device: air-office-r
   name: Office R Air
@@ -45,65 +53,59 @@ uart:
 #       number: 39
 #       inverted: true
 
-light:
-  - platform: esp32_rmt_led_strip
-    # name: LED
-    id: neo
-    channel_colors: GRB
-    pin: 27
-    num_leds: 1
-    chipset: ws2812
-    restore_mode: ALWAYS_OFF
-  - platform: esp32_rmt_led_strip
-    name: NEO
-    id: neo_strip
-    channel_colors: GRB
-    pin: 25
-    num_leds: 7
-    chipset: ws2812
-    restore_mode: ALWAYS_OFF
-    effects:
-      - random:
-      - random:
-          name: "My Slow Random Effect"
-          transition_length: 30s
-          update_interval: 30s
-      - random:
-          name: "My Fast Random Effect"
-          transition_length: 4s
-          update_interval: 5s
-      - strobe:
-      - strobe:
-          name: Strobe Effect With Custom Values
-          colors:
-            - state: True
-              brightness: 100%
-              red: 100%
-              green: 90%
-              blue: 0%
-              duration: 500ms
-            - state: False
-              duration: 250ms
-            - state: True
-              brightness: 100%
-              red: 0%
-              green: 100%
-              blue: 0%
-              duration: 500ms
-      - flicker:
-      - flicker:
-          name: Flicker Effect With Custom Values
-          alpha: 95%
-          intensity: 1.5%
-      - addressable_rainbow:
-      - addressable_rainbow:
-          name: Rainbow Effect With Custom Values
-          speed: 10
-          width: 50
-      - addressable_scan:
-      - addressable_scan:
-          name: Scan Effect With Custom Values
-          move_interval: 100ms
+# LEDs disabled until the stick is fixed (LEDs after the first one light up randomly)
+# light:
+#   # only the first LED of the stick: the rest get garbage (broken DOUT after LED 0)
+#   - platform: esp32_rmt_led_strip
+#     name: NEO
+#     id: neo
+#     channel_colors: GRB
+#     pin: 25
+#     num_leds: 1
+#     chipset: ws2812
+#     restore_mode: ALWAYS_OFF
+#     effects:
+#       - random:
+#       - random:
+#           name: "My Slow Random Effect"
+#           transition_length: 30s
+#           update_interval: 30s
+#       - random:
+#           name: "My Fast Random Effect"
+#           transition_length: 4s
+#           update_interval: 5s
+#       - strobe:
+#       - strobe:
+#           name: Strobe Effect With Custom Values
+#           colors:
+#             - state: True
+#               brightness: 100%
+#               red: 100%
+#               green: 90%
+#               blue: 0%
+#               duration: 500ms
+#             - state: False
+#               duration: 250ms
+#             - state: True
+#               brightness: 100%
+#               red: 0%
+#               green: 100%
+#               blue: 0%
+#               duration: 500ms
+#       - flicker:
+#       - flicker:
+#           name: Flicker Effect With Custom Values
+#           alpha: 95%
+#           intensity: 1.5%
+#       - addressable_rainbow:
+#       - addressable_rainbow:
+#           name: Rainbow Effect With Custom Values
+#           speed: 10
+#           width: 50
+#       - addressable_scan:
+#       - addressable_scan:
+#           name: Scan Effect With Custom Values
+#           move_interval: 100ms
 
 sensor:
   # https://blissair.com/what-is-pm-2-5.htm