Seperti kita ketahui, Home Assistant mensupport devices yang menggunakan ekosistem tuya. tuya sendiri mempunyai official Integration, namun integration tuya adalah berbasis Cloud Based yang artinya untuk menjalankan perintah ke device tuya Home Assistant membutuhkan koneksi internet, tentunya hal ini akan sedikit mengganggu jika kondisi jaringan sedang bermasalah, maka kita tidak bisa mengontrol device tuya.
Untuk mengatasi Hal tersebut, kita bisa menggunakan integrasi LocalTuya, yang memungkinkan kita mengontrol device tuya melalui jaringan lokal saja. sehingga ketika jaringan internet bermasalah kita masih tetap dapat mengontrol device.
Berikut ini kita akan bahas, bagaimana cara mengintegrasikan LocalTuya di Home Assistant
Prerequisite :
- Untuk mengintegrasikan device tuya menggunakan LocalTuya membutuhkan Local Key tiap device, untuk itu anda harus mengekstrak local key device Tuya yang anda punyai, anda bisa ikut langkah-langkah mendapatkan local key disini Cara mendapatkan Local Key device Tuya untuk integrasi LocalTuya menggunakan node.js – HASSIO atau bisa mengikuti video tutorial berikut (136) How to get Device Local Key from tuya smart to Integration localtuya in Home Assistant – YouTube
- Home Assistant supervisor sudah terinstall HACS, jika belum install HACS silahkan ikuti langkah-langkah install HACS
Langkah – Langkah install sbb :
Metode 1 – Install menggunakan HACS
- Klik menu HACS > Integration
- Klik tombol explore and add repositories, kemudian cari LocalTuya
- Klik install, setelah proses install selesai restart Home Assistant
- Setelah kembali online, Masuk ke menu configuration > Integrations dan klik tombol “add integration” dikanan bawah
- Cari LocalTuya
Metode 2 – Install via file explorer menggunakan WinSCP
- Download file localtuya
https://github.com/rospogrigio/localtuya/archive/refs/tags/v3.2.2.zip
- ekstrak file, dan copy folder localtuya yang ada di dalam folder custom_components
- lalu paste menggunakan software winSCP ke dalam folder /usr/share/hassio/homeassistant/custom_components
- Done
Cara Menambahkan device tuya ke Localtuya sbb :
Metode 1 – via config flow
- Masuk ke menu configuration > integrations
- Klik tombol “add integration”, kemudian cari Localtuya
- Localtuya anda secara otomatis mendeteksi device tuya yang terhubung didalam jaringan yang sama, Silahkan Pilih device yang ingin ditambahkan dari drop down
- Masukan detail nama, device ID, local key kemudian klik submit.
Metode 2 – via configuration.yaml
- Edit file configuration.yaml menggunakan file editor
- tambahkan config sesuai kebutuhan, berikut ini contoh configuration
localtuya:
- host: 192.168.1.x
device_id: xxxxx
local_key: xxxxx
friendly_name: Tuya Device
protocol_version: "3.3"
entities:
- platform: binary_sensor
friendly_name: Plug Status
id: 1
device_class: power
state_on: "true" # Optional
state_off: "false" # Optional
- platform: cover
friendly_name: Device Cover
id: 2
open_close_cmds: ["on_off","open_close"] # Optional, default: "on_off"
positioning_mode: ["none","position","timed"] # Optional, default: "none"
currpos_dps: 3 # Optional, required only for "position" mode
setpos_dps: 4 # Optional, required only for "position" mode
span_time: 25 # Full movement time: Optional, required only for "timed" mode
- platform: fan
friendly_name: Device Fan
id: 3
- platform: light
friendly_name: Device Light
id: 4 # Usually 1 or 20
color_mode: 21 # Optional, usually 2 or 21, default: "none"
brightness: 22 # Optional, usually 3 or 22, default: "none"
color_temp: 23 # Optional, usually 4 or 23, default: "none"
color: 24 # Optional, usually 5 (RGB_HSV) or 24 (HSV), default: "none"
brightness_lower: 29 # Optional, usually 0 or 29, default: 29
brightness_upper: 1000 # Optional, usually 255 or 1000, default: 1000
color_temp_min_kelvin: 2700 # Optional, default: 2700
color_temp_max_kelvin: 6500 # Optional, default: 6500
scene: 25 # Optional, usually 6 (RGB_HSV) or 25 (HSV), default: "none"
music_mode: False # Optional, some use internal mic, others, phone mic. Only internal mic is supported, default: "False"
- platform: sensor
friendly_name: Plug Voltage
id: 20
scaling: 0.1 # Optional
device_class: voltage # Optional
unit_of_measurement: "V" # Optional
- platform: switch
friendly_name: Plug
id: 1
current: 18 # Optional
current_consumption: 19 # Optional
voltage: 20 # Optional
Catatan :
Saat ini localtuya belum mendukung semua device tuyaBerikut ini daftar device yang di support localtuya :
- Saklar lampu 1 s/d 3 Gang
- Smart Plug termasuk Power Extension Strip
- Lampu
- Covers
- Fans
Dokumentasi repositori Localtuya (github) bisa diakses disini rospogrigio/localtuya: local handling for Tuya devices (github.com)
0 Comments