1. Introduction
The WZ-SPI is a versatile Zigbee RGB/RGBW SPI LED Controller designed for addressable LED strips. It offers multiple control methods including the Tuya Smart APP, RF remote control (R9/RTS options), and voice control via Amazon Alexa and Google Assistant. This controller supports a wide range of LED chip types and dynamic lighting effects, making it ideal for various lighting scenarios.
2. Product Overview

Figure 1: WZ-SPI Zigbee RGB/RGBW SPI LED Controller. The controller (left) is shown with R9 and RTS remote controls, a smartphone displaying the Tuya app interface, and icons for Amazon Alexa and Google Assistant, indicating voice control compatibility. A Tuya Zigbee Gateway is required for operation.
Key Features:
- Multi-pixel RGB/RGBW LED strip controller with SPI signal output.
- Tuya Smart APP cloud control for remote management.
- Voice control support for Amazon Alexa and Google Assistant.
- Compatible with RGB or RGBW LED strips supporting 49 different chip types, with configurable R/G/B/W color sequence via the APP.
- Supports painted segment color mixing, full color filling, color pencil segment painting, and eraser segment light off.
- Offers rich dynamic effects, including 44 default and 10+ custom dynamic scenarios with 16 variations.
- Features 3 APP music rhythms for synchronized lighting.
- Optional RF 2.4G RGB remote control compatibility (e.g., R9, RTS).
3. Installation and Wiring
3.1. System Wiring Diagram

Figure 2: Overall system wiring diagram. This diagram illustrates the mobile phone, WiFi router, Tuya Zigbee gateway, RF remote, and two WZ-SPI controllers connected to RGB pixel LED strips. Important: This controller MUST be used with a Tuya Zigbee gateway.
3.2. Detailed Wiring Configurations

Figure 3: Specific wiring configurations. This image provides diagrams for: 1. WZ-SPI connected to SPI spotlights (TM1803) with a 5-24VDC power supply. 2. WZ-SPI connected to one SPI pixel strip (WS2801) with a 5-24VDC power supply. 3. WZ-SPI connected to SPI digital light tube (TM1809) with a 5-24VDC power supply. 4. WZ-SPI connected to multiple SPI pixel strips (LED strip load over 8A), showing separate power supplies for the controller and the LED strips.
3.3. Wire Preparation
- Use solid or stranded wiring with a cross-sectional area of 0.5 to 1.5 mm².
- A conventional 1mm² wire can withstand up to 10A output current.
- Ensure all terminals are tightened securely during installation. Loose terminals can lead to high contact resistance and overheating, especially under full load.
3.4. Installation Precautions
- For single-wire control SPI LED strips, the DATA and CLK signal line outputs of the controller are identical. One controller can connect up to 4 LED strips.
- If the LED strip load exceeds 8A, the LED strip requires a separate power supply. In this setup, only the DATA/CLK and GND lines should be connected between the controller and the LED strip, ensuring they share a common ground.
- The output power of the constant voltage power supply must be at least 1.2 times that of the output load (LED strip) to prevent flickering or shaking.
- The voltage of the power supply must match the voltage of the LED strip to ensure proper illumination.
- The signal line (DATA/CLK) length should not exceed 10 meters. For lengths greater than 10 meters, an SPI signal amplifier (with common ground) is required to prevent signal interference.
- Maintain a distance of at least 15cm between the SPI signal lines (DATA, CLK) and strong power lines (100-240VAC) to avoid magnetic field interference.
- Each signal output port (DATA/CLK) can only be connected to one set of light strips.
- If the light strip remains on without control, it may indicate an open signal line (DATA/CLK) or a damaged chip. It is recommended to replace the signal line or the light strip.
4. Tuya Smart APP Operation
4.1. Network Connection
- To enter configuration mode, press and hold the 'Match' key on the controller for 5 seconds, or quickly press it twice. The LED indicator will flash rapidly.
- Open the Tuya Smart APP on your mobile device and search for the WZ-SPI device.
- Once the network connection is successful, the 'RUN' LED indicator on the controller will stop flashing.

Figure 4: Multiple ways to control your LED light. This image highlights the various control methods: Third-party voice control (Amazon Alexa, Google Assistant), Tuya APP control, and Series RF Remote (purchased separately).
4.2. APP Interface Functions
Color Control
- Colour: Touch the color rectangle to adjust color and saturation. Use the brightness slide to adjust brightness.
- White: Touch the color rectangle to adjust color temperature. Use the brightness slide to adjust brightness.
- Color Card: Touch the color card array to select multiple colors. Use the brightness slide to adjust brightness.
- Combination: Select a proportional distribution of multi-color circles to evenly distribute colors on the LED strip.
- Color Fill: Change the color of the full segment of the LED strip.
- Color Pen: Change the color of a single segment of the LED strip.
- Eraser: Erase the color of a single segment of the LED strip (effectively turning off that segment).
- Color Transition: When multiple colors are present, set to turn on or off the color segment gradient transition.
Scene Interface

Figure 5: Multiple Scenes Optional. The Tuya app offers 44 predefined scenarios and allows for 10+ custom dynamic scenarios, providing extensive lighting customization options.
- Access 44 predefined scenarios and 10+ custom dynamic scenarios.
- Custom scenarios offer 16 types of variations (e.g., fade, jump, breath, flash, flow, rainbow, shooting star, pile-up, floating down, chasing light, floating, flashing, bouncing, shuttle, chaotic flashing, open and close).
- Control 1-8 colors, full or segment control, forward or reverse motion direction, and adjustable brightness and speed.
Music Rhythm Interface
- Select from 6 local music modes (rock, jazz, classical, rolling, energy, spectrum) and 3 APP modes (music rhythm, game, romance).
- Adjust the sensitivity of the received sound.
- The light will follow the rhythm according to the music collected by the phone microphone.
- Note: The controller only supports App mode for music rhythm functions.
Timer and Schedule Function

Figure 6: Cloud Data supports long distance control. Timer and schedule function. The Tuya app supports cloud data for long-distance control, allowing users to manage their lights from anywhere. It also features timer and schedule functions for automated on/off actions.
- Countdown: Customize a countdown time (max. 24 hours) to perform an on/off action.
- Timer: Customize multiple times to perform on/off light actions.
4.3. Notes on APP Control
- In the APP, a light strip is fixed with 20 segments. The strip length (total number of pixel points) divided by 20 segments equals the number of pixel points per segment.
- The maximum length of the light strip is 1000 pixels. For example, a 5-meter light strip with 60 pixels per meter can be set to 300 pixels, which will be divided into 20 segments, each having 15 pixels.
- If the light strip length is less than or equal to 20 pixels (e.g., 10-20), each pixel sequentially corresponds to each segment from the beginning.
- If the light strip length is not an integer multiple of 20, the remainder of the strip will display the color of the last segment. It is recommended to set the length longer and increase the value to a multiple of 20.
- If the set light strip length is less than the actual length, the latter part of the light strip cannot be controlled.
- If the selected dynamic mode cycle running interval is too long, reset the correct pixel length.
- If the static or dynamic mode color display is inconsistent with the APP interface, re-select the light strip color sequence.
5. Remote Control Pairing
5.1. Match R9 Remote Control

Figure 7: R9 (1-zone) Ultrathin RGB/RGBW Remote Controller. The R9 remote control features a multi-button layout for color and mode selection, with a power button and numbered presets. Its dimensions are 107*58.5*9mm, and the back holder is 63*68mm.
- Match: Short press the 'Match' key on the controller, then immediately press the on/off key of the remote. The LED indicator will flash a few times, indicating a successful match.
- Delete: Press and hold the 'Match' key on the controller for 10 seconds. The LED indicator will flash a few times, indicating that all matched remotes have been deleted.
6. Specifications
6.1. Technical Parameters
| Parameter | Value |
|---|---|
| Input Voltage | DC5V-24V |
| Input Current | 8A |
| Input Signal | ZigBee + RF 2.4G |
| Output Signal | SPI(TTL) x 2 |
| Scenario Mode | 44 default and 10+ customizations |
| Max. Pixel Dots | 1000 |
| EMC Standard | ETSI EN 301 489-1 V2.2.3, ETSI EN 301 489-17 V3.2.4 |
| Radio Equipment (RED) | ETSI EN 300 328 V2.2.2 |
| Certification | CE, EMC, RED, UL |
| Operation Temperature | -30°C to +55°C |
| Max. Case Temperature | Tc +65°C |
| IP Rating | IP20 |
| Size | 114 x 43 x 27 mm |
| Gross Weight | 0.066kg |
| Warranty | 1 Year |
| Features | Tuya Zigbee Version, SPI RGB/RGBW, R9 RF remote control, Support 49 kinds chip, 10+ custom dynamic scenarios, APP control, Voice control for Google assistant/Amazon Alexa |
6.2. Compatible Chip Types
| Chip Type | Compatible Chip |
|---|---|
| TM1803 | TM1804, TM1812, UCS1903, UCS1909, UCS1912, SK6813, UCS2903, UCS2909, UCS2912, WS2811, WS2812, WS2813, WS2815, SM16703P |
| TM1809 | TM1804, TM1812, UCS1903, UCS1909, UCS1912, SK6813, UCS2903, UCS2909, UCS2912, WS2811, WS2812, WS2813, WS2815, SM16703P |
| TM1829 | |
| TLS3001 | TLS3002 |
| GW6205 | |
| MB16120 | |
| TM1814B(RGBW) | |
| SK6812(RGBW) | WS2813(RGBW), WS2814(RGBW) |
| UCS8904B(RGBW) | |
| LPD6803 | LPD1101, D705, UCS6909, UCS6912 |
| LPD8803 | LPD8806 |
| WS2801 | WS2803 |
| P9813 | |
| SK9822 | |
| TM1914A | |
| GS8206 | GS8208 |
| UCS2904 | |
| SM16804 | |
| SM16825 | |
| SM16714(RGBW) | |
| UCS5603 | |
| UCS2603 | |
| SM16714D | |
| UCS7604(RGBW) | |
| UCS7804(RGBW) |
7. Troubleshooting
Common Issues and Solutions
- Light strip is always on without control:
Possible cause: The signal line (DATA/CLK) is open, or the chip of the light strip is damaged.
Solution: Replace the signal line or the light strip. - Lights flicker or shake:
Possible cause: The output power of the constant voltage power supply is insufficient (less than 1.2 times the load).
Solution: Ensure the power supply output is at least 1.2 times the load of the LED strip. - Light strip not lit or dimly lit:
Possible cause: The power supply voltage does not match the light strip voltage.
Solution: Ensure the power supply voltage is the same as the light strip's required voltage. - Signal interference:
Possible cause: The signal line is too long (over 10m) without an amplifier, or signal lines are too close to strong power lines.
Solution: Use an SPI signal amplifier for signal lines exceeding 10m. Maintain a separation of at least 15cm from strong power (100-240VAC) lines.
8. User Tips
- Always use a Tuya Zigbee Gateway for full functionality, including remote control and voice commands, as this controller is specifically designed for the Tuya ecosystem. It is not directly compatible with Philips Hue without specific third-party integrations.
- For installations involving multiple LED strips, ensure proper power distribution. If signal lines are long (over 10m), consider using an SPI signal amplifier to maintain signal integrity.
- Verify the chip type of your LED strip and configure it accurately within the Tuya APP for optimal performance and correct lighting effects.
- The controller can connect to up to 4 LED strips, but each DATA/CLK output port is designed for one set of light strips. Plan your wiring accordingly for simultaneous control.
9. Warranty and Support
9.1. Warranty Information
This product comes with a 1-year warranty from the date of purchase, covering manufacturing defects and malfunctions under normal use.
9.2. Additional Resources
For a comprehensive guide, detailed diagrams, and further technical information, please refer to the official user manual PDF: User manual (PDF)