rospogrigio/localtuyaFork
Localtuya
LocalTuya is a local control integration and home automation driver for Tuya-based smart hardware. It functions as a local API gateway that enables direct communication with devices over a local network to bypass external cloud servers.
The system retrieves security tokens and encrypted local keys from cloud APIs to establish authenticated communication channels. It translates raw device signals and numeric indices into standardized functional entities, such as sensors and switches, to facilitate hardware management without cloud reliance.
The project covers a broad range of capabilities including climate control management, smart energy monitoring for voltage and power consumption, and device onboarding. It also includes diagnostic utilities for capturing low-level network traffic, debugging connectivity, and recovering unresponsive hardware.
Features
- Local Gateway Control - Executes commands over the local area network to bypass external cloud servers and minimize dependency on internet connectivity.
- Smart Home Hardware Drivers - Provides a driver layer that translates smart home API commands into low-level network packets for Tuya hardware.
- Hardware Entity Mappings - Translates raw device signals and numeric indices into standardized functional entities like sensors and switches.
- Cloud API Credential Integrations - Implements connectivity to developer platforms using secret keys to discover and configure compatible smart hardware.
- Smart Home Bridges - Manages home automation hardware via a local network to ensure functionality during internet outages and reduce latency.
- IoT Gateway Local Bridges - Implements a local bridge that retrieves security tokens to enable direct hardware control without cloud reliance.
- Device Communication Layers - Communicates directly with hardware over a local network to execute commands without relying on external cloud servers.
- Tuya Cloud Bypass Tools - Connects Tuya smart hardware to a local network to control devices without relying on external cloud servers.
- Local Control Integrations - Enables direct local network communication with Tuya-based smart hardware to bypass external cloud servers.
- Local Device Token Retrievals - Retrieves security keys and tokens from cloud APIs to establish encrypted local communication channels with smart hardware.
- Local Key Retrievals - Fetches and updates encrypted local security keys from cloud APIs to establish authenticated communication channels.
- Key Exchange Protocols - Retrieves encryption tokens from external APIs to establish secure authenticated channels for local hardware communication.
- HVAC Control Mappings - Manages heaters, thermostats, and air conditioners by mapping data points to temperature, mode, and power settings.
- Device Onboarding - Allows connecting to hardware via auto-discovery or manual input and verifying connectivity during setup.
- Device Health Diagnostics - Includes utilities for capturing low-level network traffic and logs to diagnose IoT device connectivity and health.
- Device Operational Parameter Configurators - Provides a guided interface to modify individual smart device parameters to ensure proper local operation.
- Vendor-Specific Protocols - Provides specialized communication protocols for managing and monitoring specific manufacturer hardware without cloud reliance.
- Persistent TCP Connections - Maintains active TCP connections to hardware to reduce command latency and ensure immediate device responsiveness.
- Automatic Connection Recovery - Implements automatic reconnection logic and reset commands to restore communication with unresponsive or zombie hardware.
- Energy Consumption Trackers - Tracks real-time voltage and power consumption from compatible hardware to monitor electrical usage within a home.
- Vendor Integrations - Local control for Tuya-based devices without cloud dependencies.
