YSRSAI WZ-SPI

Contents

Tuya Zigbee SPI LED Controller User Manual

Model: WZ-SPI

Brand: YSRSAI

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

WZ-SPI Zigbee RGB/RGBW SPI LED Controller with R9 and RTS remotes, Tuya app, and voice control integration.

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

System wiring diagram showing the WZ-SPI controller connected to a Tuya Zigbee gateway, WiFi router, mobile phone, and RGB pixel LED strips.

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

Detailed wiring diagrams for WZ-SPI controller with SPI spotlights (TM1803), one SPI pixel strip (WS2801), and SPI digital light tube (TM1809).

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

  1. 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.
  2. Open the Tuya Smart APP on your mobile device and search for the WZ-SPI device.
  3. Once the network connection is successful, the 'RUN' LED indicator on the controller will stop flashing.
Image showing the WZ-SPI controller, a smartphone with the Tuya app, and Amazon Alexa and Google Assistant devices, illustrating multiple control methods.

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

Tuya app interface showing 44 predefined and 10+ custom dynamic scenarios for LED lighting.

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

Tuya app showing cloud control for long-distance light management and timer/schedule functions.

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

Image of the R9 (1-zone) ultrathin RGB/RGBW remote controller and its back holder.

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

ParameterValue
Input VoltageDC5V-24V
Input Current8A
Input SignalZigBee + RF 2.4G
Output SignalSPI(TTL) x 2
Scenario Mode44 default and 10+ customizations
Max. Pixel Dots1000
EMC StandardETSI 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
CertificationCE, EMC, RED, UL
Operation Temperature-30°C to +55°C
Max. Case TemperatureTc +65°C
IP RatingIP20
Size114 x 43 x 27 mm
Gross Weight0.066kg
Warranty1 Year
FeaturesTuya 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 TypeCompatible Chip
TM1803TM1804, TM1812, UCS1903, UCS1909, UCS1912, SK6813, UCS2903, UCS2909, UCS2912, WS2811, WS2812, WS2813, WS2815, SM16703P
TM1809TM1804, TM1812, UCS1903, UCS1909, UCS1912, SK6813, UCS2903, UCS2909, UCS2912, WS2811, WS2812, WS2813, WS2815, SM16703P
TM1829
TLS3001TLS3002
GW6205
MB16120
TM1814B(RGBW)
SK6812(RGBW)WS2813(RGBW), WS2814(RGBW)
UCS8904B(RGBW)
LPD6803LPD1101, D705, UCS6909, UCS6912
LPD8803LPD8806
WS2801WS2803
P9813
SK9822
TM1914A
GS8206GS8208
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)

© 2024 YSRSAI. All rights reserved.

Documents and downloads

Ask a question about this manual

Ask about setup, troubleshooting, compatibility, parts, safety, or missing instructions. Manuals+ will review the question and use this page’s manual context to help answer it.

After a successful submission, we securely hash the supplied account or form email before sending it to Microsoft Advertising for conversion attribution. Privacy details.