1. Product Overview
The QS-Zigbee/Wifi-CP03 series curtain switch module is designed to convert traditional curtain switches into intelligent smart home devices. These modules allow for remote control, voice control, and scheduled operation of roller shutters, blinds, and motors. Available in both Zigbee and WiFi versions, they integrate seamlessly with popular smart home platforms like Tuya, Amazon Alexa, and Google Home.
Product Variants
- QS-Zigbee-CP03 / QS-Zigbee-ECC02: Requires a Zigbee gateway for smart functionality.
- QS-WIFI-CP03 / QS-WIFI-ECC02: Connects directly to your 2.4GHz WiFi network, no additional gateway needed.


2. Safety Information
Please read and understand all safety instructions before installation and use. Failure to follow these instructions may result in electric shock, fire, or other hazards.
- Always turn off the power supply at the circuit breaker before performing any electrical work.
- Installation should be performed by a qualified electrician or a person with a thorough understanding of electrical wiring.
- Ensure the module is installed in a junction box or suitable enclosure to prevent accidental contact.
- Do not exceed the maximum current rating of the module (3A for Zigbee, 5A for WiFi ECC02).
- Keep the device away from water and high humidity environments.
3. Setup and Installation
Wiring Instructions and Diagrams
Follow these steps carefully for proper installation:
- Turn off the power supply: Before carrying out any electrical installation work, ensure the main power supply to the circuit is turned off at the breaker.
- Connect wires: Connect the wires according to the appropriate wiring diagram for your module type (WiFi or Zigbee) and motor.
- Insert the module: Carefully insert the module into the junction box.
- Turn on power and configure: Restore power and proceed with the switch module configuration instructions using the Tuya App.

The diagram shows connections for an Electrical Shutter. The module has terminals for N (Neutral), L (Live), and motor connections (Up, Stop, Down). Ensure correct polarity and secure connections. The left diagram is for QS-WIFI-ECC02 and the right for QS-Zigbee-ECC02. Both show similar wiring principles for connecting to an electrical shutter and a manual switch.
App Pairing and Network Connection
- Download the Tuya App: Search for "Tuya Smart" in your mobile app store (iOS or Android) and download it.
- Register/Log in: Create an account or log in to your existing Tuya Smart account.
- Add Device: Open the Tuya Smart App, tap '+' to add a new device.
- Select Device Type: Choose "Curtain Switch" or "Curtain Module" from the device list.
- Enter Network Details:
- For WiFi Modules (QS-WIFI-CP03/ECC02): Ensure your phone is connected to a 2.4GHz WiFi network. Enter your WiFi password when prompted.
- For Zigbee Modules (QS-Zigbee-CP03/ECC02): Ensure your Zigbee gateway is already set up and connected to the Tuya App. The app will guide you to connect the module through the gateway.
- Reset Module: Press and hold the "Reset" button on the module until the indicator light blinks rapidly (usually 5-10 seconds). This puts the module into pairing mode.
- Complete Pairing: Follow the on-screen instructions in the Tuya App to complete the pairing process. The app will confirm once the device is successfully added.


4. Operating Instructions
App Control
Once paired, you can control your curtains directly from the Tuya Smart App:
- Open/Close: Tap the respective buttons to fully open or close the curtains.
- Pause: Stop the curtains at any desired position.
- Adjust Height: Some modules and curtain types allow for precise adjustment of opening percentage within the app.

Voice Control
Integrate with Amazon Alexa or Google Home for hands-free control:
- Link Accounts: In the Alexa or Google Home app, link your Tuya Smart account.
- Discover Devices: Ask Alexa/Google to discover new devices.
- Voice Commands: Use commands like:
- "Alexa/Hey Google, open the living room curtains."
- "Alexa/Hey Google, close the bedroom blinds."
- "Alexa/Hey Google, pause the kitchen shutter."
Timing and Scheduling
Set up automated routines for your curtains:
- Access Timer/Schedule: In the Tuya Smart App, navigate to the device settings and find the "Timer" or "Schedule" option.
- Create Schedules: Set specific times for your curtains to open, close, or pause. You can also set repeat days (e.g., every weekday).
- Countdown Function: Use the countdown feature for temporary actions, such as closing curtains after a set duration.

Family Sharing and Group Function
- Family Sharing: Share control of your curtain module with other family members through the Tuya Smart App. They will need their own Tuya accounts.
- Group Function: Create groups of multiple curtain modules or other smart devices to control them simultaneously with a single command.

RF Remote Control (Optional)
If your module supports RF control and you have an RF remote, you can use it for direct control:
- Pairing: Follow the specific pairing instructions for your RF remote and module.
- Functions: Typically includes buttons for Up, Down, Pause, and an RF pairing button.

5. Maintenance
To ensure the longevity and optimal performance of your curtain switch module, follow these simple maintenance guidelines:
- Cleaning: Use a soft, dry cloth to clean the module. Do not use abrasive cleaners, solvents, or harsh chemicals, as these can damage the device.
- Environment: Ensure the module is installed in a dry environment, away from direct sunlight, extreme temperatures, and high humidity.
- Firmware Updates: Periodically check the Tuya Smart App for any available firmware updates for your module. Updates can improve performance and add new features.
- Power Cycle: If the module becomes unresponsive, try turning off the power at the circuit breaker for a few minutes, then restore power.
6. Troubleshooting
If you encounter issues with your curtain switch module, refer to the following common problems and solutions:
Device Not Connecting to App/Network
- Check Power: Ensure the module is receiving power and the indicator light is on.
- Reset Module: Press and hold the reset button on the module until the indicator light blinks rapidly to enter pairing mode. Try pairing again.
- Network Type: Verify you are using the correct network type (2.4GHz WiFi for WiFi modules, Zigbee gateway for Zigbee modules).
- WiFi Signal: Ensure your WiFi router is within range and providing a strong 2.4GHz signal.
- Zigbee Gateway: For Zigbee modules, confirm your Zigbee gateway is online and properly connected to the Tuya App.
- Router Settings: Some routers may require disabling AP isolation or enabling UPnP for smart devices. Consult your router's manual.
Curtain Not Responding to Commands
- Wiring Check: Double-check all wiring connections to the motor and power supply as per the installation diagram. Ensure wires are securely fastened.
- App Status: Verify the device status in the Tuya App. If it shows offline, troubleshoot network connection first.
- Motor Functionality: Test the curtain motor manually to ensure it is working correctly.
- Calibration: Some curtain systems may require calibration after installation. Refer to your curtain motor's manual or the Tuya App for calibration options.
Voice Control Not Working
- Account Linking: Confirm that your Tuya Smart account is correctly linked to your Amazon Alexa or Google Home account.
- Device Discovery: Ask Alexa/Google to discover devices again.
- Device Naming: Ensure the device name in the Tuya App is simple and easily recognizable by voice assistants.
- Internet Connection: Verify that your smart speaker/hub and the curtain module have active internet connections.
User Tips
- Stable Network: A stable 2.4GHz Wi-Fi network is crucial for reliable performance of WiFi modules and Zigbee gateways.
- "Gang" Terminology: In smart switches, "gang" refers to the number of independent circuits or devices a single unit can control. For example, a "2 Gang" module can control two separate curtain motors or two sets of blinds independently.
- App Routines: Explore the automation features in the Tuya Smart App to create custom routines based on time, weather, or other smart devices.
7. Specifications
| Feature | QS-Zigbee-CP03 / ECC02 | QS-WIFI-CP03 / ECC02 |
|---|---|---|
| Model | QS-Zigbee-CP03 / QS-Zigbee-ECC02 | QS-WIFI-CP03 / QS-WIFI-ECC02 |
| Input Voltage | 100-240V AC, 50/60Hz | |
| Max. Current | 3A | 3A (CP03), 5A (ECC02) |
| Wireless Protocol | Zigbee 3.0 (IEEE 802.15.4) | WiFi 2.4GHz (802.11 b/g/n) |
| Frequency | 2.4GHz-2.484GHz | 2.4GHz-2.4835GHz |
| Power | <20dBm | |
| Operation Temperature | -10℃ to +40℃ | |
| Operation Ranges | ≤200m | |
| IP Rating | IP20 | |
| Material | ABS+PC | |
| Module Dimensions | 44 x 41 x 25 mm (1.73 x 1.61 x 0.98 in) | |
| Module Weight | Approx. 33g (1.16 oz) | |
| Battery Included | Yes (for RF remote, if applicable) | |
RF Remote Control (Optional)
| Feature | Specification |
|---|---|
| Battery Type | A23 alkaline battery, 12V, 23A |
| Remote Dimensions | 94 x 44 x 19 mm (3.70 x 1.73 x 0.75 in) |
| RF Module Dimensions | 27 x 24 x 11 mm (1.06 x 0.94 x 0.43 in) |
| Remote Weight | Approx. 39g (1.38 oz) |

8. Warranty and Support
For warranty information, please refer to the terms and conditions provided by your retailer or the seller at the time of purchase. Keep your proof of purchase for any warranty claims.
For technical support, troubleshooting assistance, or further inquiries, please contact the seller or refer to the support section within the Tuya Smart App.