1. Introduction
This manual provides detailed instructions for the installation, operation, and maintenance of your Tuya Smart Curtain Modules (QS-WIFI-ECC02 and QS-Zigbee-CP03). These modules are designed to convert traditional curtain switches into intelligent, app-controlled devices, offering convenience through remote control, voice commands, and scheduled operations.

Figure 1: Overview of available Tuya Smart Curtain Module variants, including WiFi and Zigbee versions, a wireless gateway, and a remote control.
2. Models and Key Features
The Tuya Smart Curtain Modules come in two primary connectivity types:
- QS-WIFI-ECC02 (Mini Wi-Fi Curtain Module): Connects directly to your home Wi-Fi network (2.4GHz). No additional gateway is required for operation.
- QS-Zigbee-ECC02 / QS-Zigbee-CP03 (Mini Zigbee Curtain Module): Requires a Zigbee gateway (sold separately) to connect to your smart home network. The CP03 model specifically notes a "With Neutral" requirement for installation.
Both models offer the following intelligent features:
- APP Remote Control: Control your curtains from anywhere using the Tuya APP on your smartphone.
- Hands-free Voice Control: Compatible with Amazon Alexa and Google Home for convenient voice commands.
- Timing Function: Set schedules for automatic opening and closing of curtains, including countdown and calendar functions.
- Family Sharing Function: Share control of the device with multiple family members through the app.
- Compact Design: Made from PC material, designed for quick and easy installation within a junction box.
- Optional RF Remote Control: Some packages may include an RF remote control for local operation.

Figure 2: Voice control compatibility with Amazon Alexa and Google Home.

Figure 3: Example of setting a timing function for curtain operation.

Figure 4: Illustrates sharing device control among family members.
3. Technical Specifications
| Feature | QS-WIFI-ECC02 | QS-Zigbee-ECC02 / CP03 |
|---|---|---|
| Model Number | Mini Wi-Fi Curtain Module | Mini Zigbee Curtain Module |
| Input Voltage | 100-250VAC, 50/60Hz | 100-250VAC, 50/60Hz |
| Max Current | 5A | 3A |
| Wireless Protocol | Wi-Fi 2.4GHz (802.11 b/g/n) | Zigbee 3.0 (IEEE 802.15.4) |
| Power | <20dBm | <20dBm |
| Operation Temperature | -10℃ to +40℃ | -10℃ to +40℃ |
| Operation Range | ≤ 200m | ≤ 200m |
| IP Rating | IP20 | IP20 |
| Dimensions (Module) | 44 x 41 x 25 mm (1.73 x 1.61 x 0.98 in) | 50 x 46 x 24 mm (2.0 x 1.8 x 0.9 in) |
| Material | ABS+PC | ABS+PC |
| Certification | CE, RoHS | CE, RoHS |
| Battery Included | Yes (for remote, if included) | Yes (for remote, if included) |
Remote Controller (Optional):
- Power Source: 1 x A23 alkaline battery, 12V, 23A (included)
- 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)

Figure 5: Detailed dimensions and specifications for the Mini Wi-Fi Curtain Module and optional remote control.
4. Package Contents
The package contents may vary depending on the specific option purchased. Typically, a package includes:
- Smart Curtain Module (QS-WIFI-ECC02 or QS-Zigbee-CP03)
- User Manual (this document)
- Optional: RF Remote Controller (with A23 battery)
- Optional: RF Module
- Optional: Zigbee Gateway (if purchased separately or as part of a kit)
5. Safety Information
- Always turn off the power supply at the circuit breaker before performing any electrical installation or maintenance.
- Installation should be performed by a qualified electrician or a person with sufficient knowledge of electrical systems.
- Ensure the module's input voltage and current ratings match your electrical system.
- Do not expose the device to moisture or extreme temperatures.
- Keep the device out of reach of children.
- Follow all local electrical codes and regulations during installation.
6. Installation and Setup
6.1 Wiring Instructions
- Turn off the power supply at the main circuit breaker before starting any electrical work.
- Connect wires according to the appropriate wiring diagram below for your module type (Wi-Fi or Zigbee). Ensure all connections are secure.
- Insert the module into the junction box behind your traditional curtain switch.
- Turn on the power supply at the circuit breaker.
- Proceed to the app configuration instructions.
Note: For optimal configuration, keep your smartphone close to the switch module during the setup process.
6.2 Wiring Diagrams for Curtain/Roller Shutter/Blind

Figure 6: Wiring diagrams for both Wi-Fi (left) and Zigbee (right) curtain modules. Ensure to connect Live (L), Neutral (N), Motor Up (↑), Motor Down (↓), and Common Motor (M) wires correctly. The Zigbee module (QS-Zigbee-CP03) requires a neutral wire.
6.3 App Connection (Tuya Smart App)
- Download the "Tuya Smart" or "Smart Life" app from your smartphone's app store (iOS or Android).
- Register or log in to your account.
- For Wi-Fi modules (QS-WIFI-ECC02):
- Ensure your phone is connected to a 2.4GHz Wi-Fi network.
- Open the app, tap '+' to add a device, and select the curtain switch/module category.
- Follow the in-app instructions to put the module into pairing mode (usually by pressing the reset button or power cycling).
- Confirm the indicator light on the module is blinking as described in the app.
- Enter your Wi-Fi network password and complete the pairing process.
- For Zigbee modules (QS-Zigbee-ECC02 / CP03):
- Ensure your Zigbee gateway is already set up and connected to the Tuya app.
- Open the app, tap your Zigbee gateway, then tap 'Add sub-device'.
- Follow the in-app instructions to put the module into pairing mode.
- The gateway will discover and add the Zigbee module.

Figure 7: Illustrates the connection of Wi-Fi modules to a router and Zigbee modules to a gateway, both controlled via the app.
7. Operating Instructions
7.1 Manual Control
You can still operate your curtains using the traditional wall switch connected to the module. The module will synchronize its status with the app.
7.2 App Control
Once connected to the Tuya app, you can:
- Open/Close: Tap the 'Open' or 'Close' buttons in the app interface.
- Pause: Tap 'Pause' to stop the curtain at any desired position.
- Adjust Opening Height: For some curtain types, you can set a specific opening percentage.

Figure 8: Remote control of curtains via the Tuya app.
7.3 Voice Control
Integrate your module with Amazon Alexa or Google Home for voice commands:
- Link your Tuya Smart account to Alexa or Google Home app.
- Discover devices.
- Use commands like:
- "Alexa, open the living room curtains."
- "Hey Google, close the bedroom blinds."
- "Alexa, set the kitchen roller shutter to 50%. "
7.4 Timing and Schedules
Use the app's timing function to automate curtain movements:
- In the Tuya app, select your curtain module.
- Navigate to the 'Schedule' or 'Timer' section.
- Set specific times for opening, closing, or pausing your curtains. You can also configure countdown timers.

Figure 9: Example of setting a timer schedule within the Tuya app.
7.5 Family Sharing
To share control of your smart curtain module with family members:
- In the Tuya app, go to the device settings.
- Select 'Share Device' or 'Family Management'.
- Invite family members by their Tuya account or phone number. They will need to accept the invitation to gain control.
8. Maintenance
- Keep the module clean and free from dust. Use a dry, soft cloth for cleaning.
- Do not use harsh chemicals or abrasive cleaners.
- Ensure the module is not exposed to direct sunlight or excessive heat, which can affect its lifespan.
- Periodically check wiring connections for any signs of loosening or damage.
- For optional RF remote controls, replace the A23 battery when performance degrades.
9. Troubleshooting
| Problem | Possible Cause | Solution |
|---|---|---|
| Module not responding to app/voice commands. | No power, Wi-Fi/Zigbee disconnected, incorrect wiring, app issue. | Check power supply. Verify Wi-Fi (2.4GHz) or Zigbee gateway connection. Recheck wiring. Restart app/router/gateway. Re-pair device if necessary. |
| Curtains not moving or moving incorrectly. | Incorrect wiring (motor wires), motor fault, module fault. | Double-check motor wiring (Up, Down, Common). Ensure motor is functional. Contact support if module is suspected faulty. |
| Module indicator light not on. | No power, module fault. | Verify power supply to the module. If power is present and light is off, the module may be faulty. |
| Cannot pair with app. | Incorrect pairing mode, wrong network (5GHz Wi-Fi), weak signal, incorrect password. | Ensure module is in pairing mode (blinking indicator). Connect phone to 2.4GHz Wi-Fi. Move closer to router/gateway. Re-enter Wi-Fi password carefully. |
10. User Tips
- Choosing the Right Module: If you already have a Zigbee gateway (e.g., from SmartThings, Hubitat, or another Tuya Zigbee hub), the QS-Zigbee-CP03/ECC02 is a good choice for better network stability and lower power consumption. If you prefer a simpler setup without an additional hub, the QS-WIFI-ECC02 connects directly to your existing 2.4GHz Wi-Fi.
- Neutral Wire: Be aware that the QS-Zigbee-CP03 model explicitly states "Note: With Neutral" for wiring. Always ensure your switch box has a neutral wire available for proper installation of such modules.
- Signal Strength: For reliable operation, ensure your Wi-Fi router or Zigbee gateway is within a reasonable range of the curtain module. Walls and other obstructions can reduce signal strength.
- Testing Before Final Installation: It's recommended to test the module's functionality with the app and manual switch before fully securing it within the junction box.
11. Warranty and Support
For warranty information, technical support, or service inquiries, please refer to the seller's policy or contact the retailer where the product was purchased. Keep your proof of purchase for any warranty claims.