[APP][Pro] Universal TUYA Zigbee - Local-First Control

Community-maintained Universal Zigbee app with unified hybrid drivers and 18,000+ manufacturer IDs.

🏠 100% Local Control - No Cloud Required
🔋 Intelligent Auto-Detection - Power Source & Battery Type
⚡ Advanced Energy Management - Flow Cards Included
🛠️ SDK3 Compliant - Latest Homey Standards

📊 Statistics

• Total Drivers: 173
• SDK Version: 3
• Homey Compatibility: >=12.2.0
• Last Updated: 2025-11-03
• Phase 2 Status: ✅ Complete
• Intelligent Protocol Router: ✅ Integrated

Drivers by Category

• Other: 57 drivers
• Switches: 45 drivers
• Sensors: 21 drivers
• Buttons: 18 drivers
• Power: 17 drivers
• Lighting: 7 drivers
• Climate: 6 drivers

🚀 Latest Updates - v4.10.0 (Phase 2 Complete)

✨ New Features

• IntelligentProtocolRouter: Auto-detects Tuya DP vs native Zigbee protocol
• BSEED Multi-Gang Fix: Resolves issue where all gangs activate together
• TS0601 Full Support: 3 device types with complete DP mapping
• HOBEIAN Manufacturer: ZG-204ZV Multisensor integration
• Device Finder Enhanced: Functional search and filters

🔧 Technical Improvements

• Integrated protocol routing in BaseHybridDevice
• BseedDetector for automatic BSEED device detection
• TuyaDataPointEngine for TS0601 devices
• All 7 network devices updated and optimized
• 97% validation success rate

📦 Installation

From Homey App Store

1. Open Homey app
2. Go to "More" → "Apps"
3. Search for "Universal Tuya Zigbee"
4. Click "Install"

Manual Installation (Development)

git clone https://github.com/dlnraja/com.tuya.zigbee.git
cd com.tuya.zigbee
npm install
homey app run

🔧 Development

Prerequisites

• Node.js 18+
• Homey CLI: npm install -g homey

Build & Validate

# Build app
homey app build

# Validate (publish level)
homey app validate --level publish

# Run locally
homey app run

Scripts Available

# Deep coherence check
node scripts/validation/DEEP_COHERENCE_CHECKER.js

# Auto-fix issues
node scripts/validation/DEEP_COHERENCE_FIXER.js

# Update README (automatic)
node scripts/automation/AUTO_README_UPDATER.js

# Safe push & publish
node scripts/deployment/SAFE_PUSH_AND_PUBLISH.js

📁 Project Structure

tuya_repair/
├── drivers/           # 163 Zigbee device drivers
├── lib/              # Shared libraries
├── scripts/          # Automation & validation scripts
│   ├── automation/   # Auto-update & organization
│   ├── validation/   # Coherence checking & fixing
│   └── deployment/   # Safe push & publish
├── diagnostics/      # Issue tracking & reports
├── flow/             # Flow cards (triggers, actions, conditions)
├── locales/          # Translations (en, fr, de, nl)
└── app.json          # App manifest

🤝 Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Run validation: homey app validate
4. Submit a pull request

📝 License

GPL-3.0 - See LICENSE file

🔗 Links

🏠 Homey Platform

• Test App (Homey): https://homey.app/a/com.dlnraja.tuya.zigbee/test/
• Homey App Store: https://homey.app/a/com.dlnraja.tuya.zigbee/
• Community Forum: https://community.homey.app/

🔍 Device Database & Tools

• Device Database: https://dlnraja.github.io/com.tuya.zigbee/
• Smart Device Finder: https://dlnraja.github.io/com.tuya.zigbee/device-finder.html
• Device Matrix: https://dlnraja.github.io/com.tuya.zigbee/matrix.html

💻 Development

• GitHub Repository: https://github.com/dlnraja/com.tuya.zigbee
• GitHub Actions: https://github.com/dlnraja/com.tuya.zigbee/actions
• Issues & Support: https://github.com/dlnraja/com.tuya.zigbee/issues

📞 Support

For issues and questions:

• Check existing issues: GitHub Issues
• Homey Community Forum: Universal TUYA Zigbee
• Diagnostic reports: Submit via Homey app settings

---

This README is automatically updated on each commit by AUTO_README_UPDATER.js

Last auto-update: 2025-10-25