1. Introduction
The QS-Zigbee-CP03 is an intelligent Zigbee curtain switch module designed to integrate traditional roller shutter and blinds motors into your smart home system. This module allows you to control your curtains remotely via a smartphone application, through voice commands, and with scheduled automation. It requires a Zigbee gateway for operation. A Wi-Fi variant, model QS-WIFI-CP03, is also available, offering similar functionality with direct Wi-Fi connectivity.

Figure 1: QS-Zigbee-CP03 Tuya Zigbee Curtain Module
2. Safety Information
- Ensure the power supply is disconnected before installation or maintenance to prevent electric shock.
- Installation should be performed by a qualified electrician or in accordance with local electrical codes.
- Do not exceed the maximum load rating of 3A.
- This device is designed for indoor use only.
- Keep the device away from water, moisture, and high temperatures.
- A neutral wire is required for the module's operation.
3. Package Contents
- 1 x QS-Zigbee-CP03 Curtain Switch Module
4. Specifications
| Parameter | Value |
|---|---|
| Model Number | QS-Zigbee-CP03 |
| Material | ABS+PC |
| Input Voltage | 100~240V AC, 50/60Hz |
| Max. Current | 3A |
| Wireless Protocol | Zigbee 3.0 |
| Frequency | 2.4GHz-2.484GHz IEEE 802.15.4 |
| Power | <20dBm |
| Battery Included | No |
| Package Size | 50 x 46 x 24 mm (2.0 x 1.8 x 0.9 in) |
| Package Weight | 45g (1.6 ounce) |
| Origin | Mainland China |
5. Setup and Installation
The QS-Zigbee-CP03 module is designed to be installed behind your existing traditional curtain switch. A Zigbee gateway (sold separately) is required for smart functionality.
5.1 Wiring Diagram
Before proceeding, ensure the main power supply to the circuit is turned OFF at the circuit breaker. This module requires a neutral wire for operation.

Figure 2: Detailed Wiring Diagram

Figure 3: Neutral Wire Connection
- Identify Wires: Locate the Live (L), Neutral (N), and motor control wires (typically L1 for open, L2 for close) from your existing curtain motor and switch.
- Connect Power: Connect the Live (L) wire from your power supply to the 'L' terminal on the module. Connect the Neutral (N) wire from your power supply to the 'N' terminal on the module.
- Connect Motor: Connect the motor's 'Open' wire to the 'L1' terminal on the module and the motor's 'Close' wire to the 'L2' terminal on the module.
- Connect Manual Switch (Optional): If you wish to retain manual control, connect the wires from your traditional curtain switch to the 'S1' and 'S2' terminals on the module.
- Secure Module: Carefully place the module into the wall box behind the traditional switch. Ensure all connections are secure and insulated.

Figure 4: Module Installed Behind Switch
5.2 Pairing with Tuya App and Zigbee Gateway
- Restore Power: Once wiring is complete and secure, restore power at the circuit breaker.
- Open Tuya App: Ensure you have the Tuya Smart or Smart Life app installed on your smartphone and a Zigbee gateway already set up and connected to the app.
- Enter Pairing Mode: The module should automatically enter pairing mode when first powered on. If not, press and hold the 'Reset' button on the module for 5-10 seconds until the indicator light flashes rapidly.
- Add Device: In the Tuya app, select your Zigbee gateway, then tap 'Add sub-device' or 'Add device'. The app will scan for new Zigbee devices.
- Confirm Pairing: Once the module is discovered, follow the in-app prompts to add and name the device.
5.3 Voice Assistant Integration
After successful pairing with the Tuya app, you can link your Tuya account to voice assistants like Amazon Alexa or Google Assistant for hands-free control. Refer to the respective voice assistant app's instructions for linking smart home devices.
6. Operating Instructions
6.1 App Control
Using the Tuya Smart or Smart Life app, you can:
- Open/Close Curtains: Tap the 'Open' or 'Close' buttons on the device interface in the app.
- Pause Curtains: Tap the 'Pause' button to stop the curtains at any desired position.
- Adjust Opening Height: Use the slider or percentage input in the app to set the curtain to a specific opening percentage.

Figure 5: App Control Interface
6.2 Voice Control
Once integrated with a voice assistant, use commands such as:
- "Alexa, open the living room curtains."
- "Hey Google, close the bedroom blinds."
- "Alexa, set the dining room curtains to 50%."
6.3 Timing and Scheduling
The Tuya app allows you to set schedules for automatic curtain operation:
- Create Schedules: In the app, navigate to the device settings and select 'Schedule' or 'Timer'.
- Set Time and Action: Configure specific times for curtains to open, close, or adjust to a certain percentage.
- Repeat: Set schedules to repeat daily or on specific days of the week.

Figure 6: Scheduling Example
6.4 Device Sharing and Group Function
- Device Sharing: Share control of the module with other family members through the Tuya app.
- Group Control: If you have multiple curtain modules, you can group them in the app to control them simultaneously with a single command.

Figure 7: Multi-room Application
7. User Tips
- Zigbee Gateway is Essential: Remember that the QS-Zigbee-CP03 module requires a Zigbee gateway to function as a smart device. Without it, it cannot connect to the Tuya app or voice assistants.
- Neutral Wire Check: Always confirm the presence of a neutral wire in your switch box before purchasing and installing, as it is mandatory for this module.
- Test Before Closing: After wiring, temporarily restore power and test the module's functionality (both manual and app control) before fully securing it and closing the wall box.
- Calibration: Some curtain motors may require calibration within the Tuya app after initial setup to ensure accurate open/close positions and percentage control.
8. Troubleshooting
- Module Not Responding: Check power supply to the module. Ensure the Zigbee gateway is online and within range. Try resetting the module by pressing the reset button for 5-10 seconds and re-pairing.
- Curtains Not Moving: Verify all wiring connections, especially to the motor (L1, L2). Ensure the motor itself is functioning correctly. Check for any obstructions in the curtain track.
- App Control Issues: Ensure your smartphone has an active internet connection. Confirm the Tuya app is updated to the latest version. Restart the app.
- Voice Control Not Working: Check if your Tuya account is correctly linked to your voice assistant (Alexa/Google Home). Ensure the device name in the Tuya app is recognized by the voice assistant.
- Inaccurate Open/Close Position: Perform calibration for the curtain motor within the Tuya app settings.
9. Maintenance
- The module requires minimal maintenance. Keep it free from dust and debris.
- Do not attempt to open or repair the module yourself, as this will void any warranty and may pose a safety risk.
- Regularly check for firmware updates through the Tuya app to ensure optimal performance and security.
10. Warranty and Support
For any issues or questions regarding the QS-Zigbee-CP03 module, please contact the seller or manufacturer's customer support. Provide your purchase details and a clear description of the problem for efficient assistance.