Sobre el proyecto

Este es un componente personalizado de Home Assistant que añade cámaras, timbres y chimes TP-Link Tapo a Home Assistant. Se distribuye a través de HACS y también se puede instalar manualmente copiando la carpeta custom_components/tapo_control en una configuración de Home Assistant. La configuración requiere habilitar la Compatibilidad con Terceros en la aplicación oficial de Tapo y abrir puertos LAN específicos para el control de la cámara, la transmisión, las grabaciones y los eventos de movimiento ONVIF. El README enfatiza que estos son puertos LAN y no deben exponerse a la WAN. Los dispositivos se descubren automáticamente cuando se vuelven a conectar a Wi-Fi, y se añaden varios dispositivos ejecutando la configuración de la integración varias veces. Solo se debe usar una integración de Tapo por dispositivo para evitar conflictos de conexión. Para cámaras y timbres, la integración crea hasta cuatro entidades de cámara (HD/SD, RTSP estándar o transmisiones directas propietarias de TP-Link), sensores binarios de movimiento y de pulsación del timbre, entidades de luz para reflectores, botones para calibrar, formatear, alarma, movimiento, reiniciar y sincronizar la hora, además de switches, selects y entidades numéricas que cubren auto track, LED, notificaciones, grabación, micrófono, HDR, zonas de privacidad, visión nocturna, intensidad del foco, sirena y más. Una fuente multimedia permite explorar y reproducir grabaciones almacenadas en la cámara, y los sensores informan diagnósticos de almacenamiento y el estado de sincronización multimedia. Los chimes obtienen entidades de número, switch, select, sensor y botón para volumen, tono de llamada, tipo de sonido, estado de red y timbre. Los servicios incluyen guardar y eliminar presets PTZ y establecer un horario de grabación semanal con rangos horarios por día y modos continuo o por movimiento. La detección de umbral de sonido puede exponer eventos de ruido como un sensor binario usando el soporte de ruido ffmpeg de Home Assistant. La sincronización multimedia descarga grabaciones en segundo plano para una reproducción rápida, con horas de retención y ruta de almacenamiento configurables, opciones de caché y precarga de miniaturas, y un evento tapo_control_media_downloaded que se dispara con el id de entrada, marcas de tiempo de inicio/fin y ruta del archivo. Las cámaras con batería y solares omiten la precarga masiva de miniaturas para volver a dormir antes. El README incluye una amplia solución de problemas: pasos para contraseña de nube no válida, elección entre transmisiones directas y RTSP, anulaciones de parámetros FFmpeg para transmisión directa, sensores de movimiento faltantes, retraso de transmisión, audio faltante, errores de autenticación y una lista de modelos de cámara, timbre y chime compatibles reportados por usuarios. También explica la entrega de eventos ONVIF pullpoint frente a webhook.