Tutorial Integrasi LocalTuya Home Assistant (Part 2)

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 :

1. 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
   
2. 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

1. Klik menu HACS > Integration
2. Klik tombol explore and add repositories, kemudian cari LocalTuya
3. Klik install, setelah proses install selesai restart Home Assistant
4. Setelah kembali online, Masuk ke menu configuration > Integrations dan klik tombol “add integration” dikanan bawah
5. Cari LocalTuya

Metode 2 – Install via file explorer menggunakan WinSCP

1. Download file localtuya

   https://github.com/rospogrigio/localtuya/archive/refs/tags/v3.2.2.zip

2. ekstrak file, dan copy folder localtuya yang ada di dalam folder custom_components
   

   Copy folder localtuya

3. lalu paste menggunakan software winSCP ke dalam folder /usr/share/hassio/homeassistant/custom_components
   

   Paste folder menggunakan software WinSCP

4. Done

Cara Menambahkan device tuya ke Localtuya sbb :

Metode 1 – via config flow

1. Masuk ke menu configuration > integrations
2. Klik tombol “add integration”, kemudian cari Localtuya
3. Localtuya anda secara otomatis mendeteksi device tuya yang terhubung didalam jaringan yang sama, Silahkan Pilih device yang ingin ditambahkan dari drop down
4. Masukan detail nama, device ID, local key kemudian klik submit.

Konfigurasi device tuya

Metode 2 – via configuration.yaml

1. Edit file configuration.yaml menggunakan file editor
2. 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 tuya

Berikut 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)