Tuya Local untuk Smart Home ke lokal tanpa internet

Awalnya dulu, Tuya itu apa.
Tuya adalah perangkat Smart Home. Menyala matikan, redup terang lampu. Mengatur Smart Plug, Smart MCB, waktu nyala mati, timer, Smart Lock dan lainnya.
Alat ini harus menyebut kata Tuya, artinya bisa di daftar ke aplikasi Android Tuya, Smart Living, Smart Life.
Jadi Tuya adalah platform yang dibuat Tuya, dan produsen mengunakan layanan Tuya sebagai aplikasi kontrol perangkat mereka.

Karena berbasis aplikasi Android, juga butuh internet. Perangkat Tuya harus terhubung ke network, WIFI dan internet.
Bila kita diluar rumah, misal kita dapat On/off perangkat dengan aplikasi. Contohnya, bila kamar memiliki satu Smart Plug, bisa mematikan semua koneksi listrik dari HP.

Disisi lain ada kebutuhan local, selain Tuya App, beberapa antusias ingin mengakses ke jaringan LAN.
Tujuannya juga berbeda, membuat otomatisasi, memerintahkan perangkat Tuya Menyala (Lampu), ketika sensor lain menditeksi ada orang.
Disini pengaturan dengan sebuah server kecil disebut Home Assistant server, hanya butuh 12V/DC.
Ini terintegrasi, softwarenya dikembangkan home-assistant.io. Jadi sudah masuk IoT atau Smart Home.
Nanti ngak terbatas buat rumah aja, bisa otomatisasi, pertanian, gedung dan lainnya.
Tuya ini nempel di Home Assistant, istilahnya menjadi salah satu daftar disana. Nanti dapat di akses secara local, karena ada server yang menangani.

Tuya Cloud vs Tuya Local: Mengapa Memilih Salah Satunya

Memilih cara mengintegrasikan perangkat Tuya ke dalam Home Assistant berasal dengan dua opsi utama:

Tuya Cloud (integrasi resmi) dan Tuya Local / Local Tuya dengan LAN internal dari pengembang komunitas.

Keduanya menawarkan pendekatan berbeda dengan alasan pemakaian yang spesifik.

Tuya App / Cloud

Dengan aplikasi, instalasi mudah, membutuhkan koneksi internet
Integrasi ini bersifat plug-and-play langsung dari aplikasi Tuya, atau terditeksi dari menu Home Assistant.
Sangat ideal untuk pengguna yang menginginkan pengaturan cepat, ngak perlu setting aneh aneh, tanpa perlu pencarian Local Key atau instalasi komponen pihak ketiga.
Opsi ini cocok jika koneksi internet stabil dan latensi sekian milidetik tidak menjadi masalah.
Kontrol dari luar rumah, asalkan Tuya di rumah memiliki internet, dan App Tuya di smartphone memiliki internet.

Tuya Local

Alasan utama adalah keandalan offline dan kecepatan respons.
Setelah setup, sebenarnya tidak membutuhkan internet selama pearngkat bekerja.
Menghubungkan perangkat secara langsung melalui Local Area Network (LAN termasuk Ethernet, WIFI) dan ke server Home Assistant tanpa bergantung server eksternal internet, tapi dari server kita sendiri yang juga menangani perangkat lain.

Opsi ini wajib digunakan jika ingin automasi tetap berjalan saat internet mati, menghilangkan jeda waktu (latensi) saat mengeksekusi perintah.
Dan terpenting bila anda ingin mengakses parameter data teknis perangkat yang biasanya diblokir , di kurangi, dibatasi, oleh sistem Tuya Cloud.

Ini gambaran cara kerja aplikasi Tuya Cloud, dan Tuya Local ke jaringan LAN.

Kendali Smart Home Tanpa Keterbatasan Cloud
Bagi para pengguna Home Assistant, mengintegrasikan perangkat ekosistem Tuya (seperti lampu pintar, stopkontak, atau sakelar) hal lumrah.
Karena disanalah seni mengutak utik perangkat IoT atau Smart Home ke koneksi Local atau terintegrasi ke perangkat lain.
Bahkan dengan mem-Flash perangkat Tuya menjadi koneksi Arduino atau wireless sebagai ESPHome untuk jaringan local.
Kadang, menggunakan integrasi bawaan Tuya Cloud sering kali membawa masalah tersendiri.

Kendala, data perangkat sering dibatasi API rate limits (dikurangi) dari Tuya Cloud.
Disini kita juga bertanya, mengapa perangkat Tuya memiliki grafik monitoring lebih lambat, patah-patah atau kurang detil ?
Lebih buruk lagi, karena perangkat sangat bergantung pada koneksi internet, sistem Smart Home dapat lumpuh (offline) saat terjadi gangguan internet (ISP) bila terlalu lama.

Solusi terbaik untuk masalah ini adalah bermigrasi ke Tuya Local dan berdampingan dengan Tuya Cloud sendiri.
Dengan metode ini, server Home Assistant akan berkomunikasi langsung dengan perangkat Tuya melalui jaringan lokal (LAN) rumah.
Dan aplikasi Tuya App juga tetap ada untuk di remote jarak jauh, sehingga keduanya berjalan beriringan. Tidak perlu dihilangkan salah satu, keduanya harus ada.

Perangkat yang dibutuhkan Tuya Local.

Tuya Local adalah software / program yang di install. Sedangkan hardware dibutuhkan :

1. Server Home Assistant, terhubung ke perangkat Tuya dari App atau Tuya Home Assistant. Belum punya bisa bikin atau test di PC.
2. Internet
3. Perangkat Tuya
4. Satu computer untuk setup.

Persiapan Sebelum Memulai Local Tuya
Sebelum masuk ke tahap instalasi, pastikan telah menyiapkan berikut:

1. Program Terminal & SSH (Putty): Memerlukan akses ke terminal Home Assistant atau dari terminal OS. Jika belum ada, pasang Addon Terminal & SSH melalui menu Settings > Addons.
2. Akun GitHub: Dibutuhkan untuk otentikasi saat menginstal HACS dari komunitas, dapat dibuat menyusul
3. Aplikasi Tuya / SmartLife: Pastikan perangkat pintar sudah terhubung dan berfungsi normal di aplikasi Android.
4. IP Statis : Disarankan untuk mengunci alamat IP (DHCP Reservation / Static IP) perangkat Tuya di pengaturan Router WiFi. Memastikan Home Assistant tidak kehilangan jejak perangkat jika IPnya berubah setelah router di restart.

Tahap 1: Instalasi HACS (Home Assistant Community Store)

HACS adalah semacam App Store pihak ketiga untuk Home Assistant yang memungkinkan menginstal integrasi buatan komunitas.
1. Buka web Home Assistant , lalu buka Terminal (masuk sebagai Root / User). Atau langsung di terminal server.
2. Masuk ke folder dimana anda menginstall Home Assistant. 

    cd /home/admin/homeassistant/config 

(Catatan: Sesuaikan nama folder tersebut).

3. Jalankan script instalasi HACS perintah ini:

    curl -sfSL https://get.hacs.xyz | tr -d '\r' | bash -



4. Setelah proses selesai, Restart Home Assistant agar sistem me-load HACS.
5. Ke menu Settings > Devices & Services> klik tombol Add Integration di pojok kanan bawah.

Tahap ini harus dilalui, karena HACS diperlukan untuk install program di Home Assistant.

6. Ketik dan cari kata HACS, lalu klik.
7. Anda akan diberikan kode aktivasi. Copy kode tersebut dan klik tautan otorisasi GitHub yang muncul.

8. Masuk (login) ke akun GitHub, copy kode, dan konfirmasi. HACS kini berhasil terhubung.
Ini baru tahap awal, untuk ijin download / integrasi program dari komunitas HA.

Tahap 2: Instalasi Integrasi TuyaLocal
Karena Tuya Local adalah integrasi kustom, perlu download lewat HACS.
Integrasi ini tidak muncul di pencarian awal, sehingga harus ditambahkan manual.

1. Buka browser web dan akses halaman repositori ini: 

    https://github.com/make-all/tuya-local

2. Cari dan klik tombol/link Open HACS REPOSITORY ON.



3. Jika diminta, masukkan alamat IP server Home Assistant (umumnya langsung terhubung ke IP Home Assistant).
4. Pada menu popup HACS di Home Assistant, pilih Add lalu klik Download.
5. Penting:Setelah download selesai, Reboot (Restart) Home Assistant sekali lagi agar integrasi Tuya Local terbaca sistem.

Proses persiapan Tuya Local sudah selesai.
Sekarang tinggal memasukan perangkat Tuya agar dapat di akses oleh Tuya Local.

Tahap 3: Konfigurasi dan Penambahan Perangkat Tuya
Kini saatnya menghubungkan perangkat Tuya ke Home Assistant secara lokal.
Semua perangkat Tuya yang ada di App, akan di ambil / terditeksi Tuya Local.
Tapi butuh otorisasi untuk ijin Tuya Local mengambil informasi dari aplikasi Tuya.

1. Masuk ke Settings > Devices & Services> klik Add Integration.
2. Ketik Tuya Local pada kolom pencarian dan klik integrasi tersebut.



3. Pilih SmartLife (atau Tuya) jika ingin menambahkan seluruh perangkat ke Home Assistant.
4. Masukkan User Code Tuya / SmartLife. (Anda bisa menemukan kode ini di dalam aplikasi ponsel pada menu 'Account and Security').
5. Layar akan menampilkan QR Code. Buka aplikasi Tuya/SmartLife di ponsel, lalu gunakan fitur scan untuk membaca QR Code tersebut.
6. Proses selesai! Sekarang dapat menambahkan dan mengendalikan perangkat Tuya ke TuyaLocal.

Sudah selesai, nanti perangkat Tuya akan masuk ke daftar perangkat Home Assistant. Tapi koneksinya LAN / Local, bukan ke server Cloud yang jauh disana.



Catatan: Pastikan server Home Assistant dan perangkat Tuya berada di jaringan WiFi/LAN yang sama agar komunikasi lokal dapat terjadi.

Video ini cara install Tuya Local :

Mengapa Tuya Local menarik

Beralih ke kendali lokal memberikan keuntungan yang sangat signifikan untuk sistem smart homeAnda:

Bebas Limitasi Cloud
Karena berjalan di jaringan internal (LAN), Anda tidak lagi dibatasi oleh kuota penarikan data dari server Tuya Cloud. Waktu respons (latensi) saat menyalakan/mematikan lampu menjadi instan (tanpa jeda).

Anti Mati saat Internet Putus:
Automasi dan kendali perangkat tetap berjalan normal 100% meskipun koneksi internet rumah sedang gangguan.

Pembacaan Sensor Lebih Akurat & Detail:
Data perangkat dapat dikirim lebih detail. Misalnya, pada smart plug, metrik kelistrikan seperti Voltase dan Daya (Watt) bisa dibaca secara realtime.

Interval Fleksibel:
Memegang kendali penuh untuk membatasi atau mempercepat pembaruan data (interval waktu polling) langsung dari Home Assistant, menghemat beban sistem tanpa campur tangan pihak ketiga.

Membuka Fitur Tersembunyi:
Beberapa entitas (sensor atau tombol) yang sebelumnya disembunyikan atau diblokir oleh integrasi Cloud standar, kini dapat diaktifkan (Enable) melalui TuyaLocal.

Analisis Tuya Local vs. Tuya Cloud / App

1. Latensi dan Waktu Respons (Response Time)
Tuya Cloud: Memiliki latensi struktural. Walau sekali klik langsung bekerja, sebenarnya data berputar dari rumah ke server di luar negeri dan kembali ke rumah anda.Jalur komunikasi (routing) mengharuskan sinyal perintah mengalir dari Home Assistant ? Router ? ISP ? Server Tuya (seringkali lintas negara) ? ISP ? Router ? Perangkat.
Ini menghasilkan jeda (delay) mulai dari ratusan milidetik hingga beberapa detik.

Tuya Local: Latensi mendekati nol.

Komunikasi dieksekusi secara point-to-point di dalam Local Area Network (LAN): Home Assistant ? Router ? Perangkat. Eksekusi perintah (seperti menyalakan lampu) terjadi secara instan.

2. Ketergantungan Infrastruktur (Reliability & Uptime)
Tuya Cloud: Menjadi Single Point of Failure(SPOF) berbasis eksternal. Jadi sebenarnya App ada di tangan, tapi pengaturan perindah jauh dari rumah kita.
Jika terjadi pemadaman koneksi internet dari ISP, kabel fiber optik terputus, atau server Tuya sedang dalam masa pemeliharaan (maintenance/ down), seluruh automasi perangkat Tuya lumpuh total.

Tuya Local:Beroperasi 100% secara offline jaringan internal.
Selama router dan server Home Assistant bekerja, automasi dan kontrol perangkat tetap dieksekusi sempurna tanpa membutuhkan akses internet.

3. Privasi dan Pemusatan Data (Data Privacy)
Tuya Cloud:Merekam status (state), waktu penggunaan, kebiasaan automasi, dan data telemetri lainnya ke server pihak ketiga.
Tuya Local:Seluruh log (logbook), riwayat (history), dan data metrik perangkat hanya tersimpan pada databaseserver Home Assistant lokal (seperti SQLite atau MariaDB).
Tidak ada transmisi stateoperasional ke luar jaringan (kecuali Anda secara eksplisit mengizinkannya).

4. Resolusi Data dan Limitasi API (Data Granularity & Polling)
Tuya Cloud: Terikat pada API Rate Limitsuntuk mencegah beban server yang berlebih.
Protokol pollingdan pushdibatasi oleh sistem Tuya, menyebabkan pembaruan sensor (misal: sensor daya, suhu, atau kelembapan) mengalami delay pelaporan atau hanya diperbarui secara periodik.
Tuya Local: Mendukung high-frequency polling.
Pengguna memegang kendali penuh atas konfigurasi interval polling.
Parameter teknis seperti tegangan (Voltage), arus (Ampere), dan daya (Watt) pada smart plugatau sakelar dapat diperbarui dan dibaca secara real-time.

Seperti dibawah ini, voltase yang berbentuk kotak, hanya diambil dari perubahan data oleh Tuya Cloud.
Bandingkan dengan Tuya Local, perubahan data lebih sering diambil, membuat voltase lebih akurat.
Bahkan kita dapat mengatur seberapa besar perubahan data, misal di buat jedah per 30 detik, 1 menit, 5 menit, sesuai kebutuhan. Setting dapat dilakukan dengan Home Assistant.



Walau mengunakan Smart Plug yang harganya kurang dari 100 ribuan.
Dengan aplikasi Tuya, data voltase tidak akan terlihat untuk monitoring. Dengan Tuya Local di Home Assistant, tampilan grafik voltase terlihat fluktuasi dari menit ke menit.
Jadi kita tahu, kapan voltase di rumah kita stabil untuk menjalankan perangkat elektronik, dan voltase turun untuk menghindari perangkat yang butuh power besar.

Dengan Home Assistatn, juga dapat diatur jedah sensor. Dari per 2 menit menjadi 10 menit bila tidak diperlukan detail. Mengatur waktu penyimpan data, bila anda ingin membuat data history di setiap sensor, misal sensor suhu, kelembapan dan lainnya.

5. Eksposur Entitas dan Data Points (DPs)
Tuya Cloud: Protokol integrasi cloud standar sering kali mengabaikan Data Point(DP) sekunder.
Entitas seperti kode errordiagnostik, mode memori (power-on state), transition time, atau kalibrasi sensor sering disembunyikan.
Tuya Local: Membaca langsung raw Data Points(DPs) dari cip mikrokontroler perangkat (seperti ESP8266/ESP32/Beken).
Pengguna dapat mengekspos (Enable) entitas diagnostik tersembunyi dan melakukan manipulasi kontrol parameter perangkat keras tingkat rendah langsung dari DashboardHome Assistant.

6. Limitasi Eksekusi Automasi
Tuya App (SmartLife):Logika automasi dibatasi pada parameter yang disediakan aplikasi (IFTTT dasar) dan terisolasi (vendor lock-in).
Tuya Local: Mengonversi perangkat Tuya menjadi entitas independen di Home Assistant.
Memungkinkan integrasi lintas protokol (menggabungkan pemicu dari sensor Zigbee/Z-Wave untuk mengeksekusi aktuator Tuya Wi-Fi), penulisan skrip kompleks (Jinja2 templating), dan manipulasi statetanpa limitasi ekosistem produsen.

7. Kekurangan
Ketika internet mati, maka Tuya tidak dapat dikendalikan. Sedangkan jaringan lokal LAN tetap dapat mengendalikan perangkat.
Kebalikannya, bila semua kita serahkan ke server Home Assistant, dan tiba tiba disana bermasalah. Tentu sistem otomatisasi berhenti.
Misal mengatur lampu nyala mati pada jam jam 6 sore sampai jam 6 pagi.
Disini untuk otomatisasi sederhana tidak masalah. Kita dapat mengatur Dual Schedule di App Tuya, dan  Tuya Local.
Bila salah satu offline, rusak, terputus, sistem lain dapat mengantikan dan tetap bekerja.

Yang tidak bekerja, bila kita mengatur sistem otomatisasi seluruhnya di server Home Assistant. Namanya server mati, tentu menjadi masalah koneksi ke semua perangkat termasuk perangkat berbasis Tuya.
Itu saja.

Tuya Local hanya salah satu program, untuk mengakses perangkat Tuya dari Cloud ke Local, cocok untuk perangkat standar.
Rating tertinggi adalah LocalTuya Rospogrigio, salah satu paling legendaris.

Ingin membuat server Home Assistant.
Ikuti cara ini , modal Android TV / STB bekas yang sudah di Root.
Silakan di coba. Jangan di install ke internal memory, pake memory card (microSD) / Flash Drive dan boot, install program disana.



Server Home Assistant PC/Notebook/Computer
Mau belajar dulu pake PC / notebook bikin server Home Assistant.
Modal microSD+ adapter USB, Flash Drive, pasang ke USB port.

Catatan Pemakaian:

Jangan menghapus perangkat dari aplikasi Tuya / SmartLife di Android anda.
Meskipun Home Assistant mengendalikannya secara lokal, perangkat Tuya tetap memerlukan otentikasi awal (Local Key) yang dikelola aplikasi aslinya.
Biarkan aplikasi Tuya tetap terinstal sebagai jaring pengaman (cadangan) network.