Lompat ke konten
Beranda » Dokumentasi Taphome » Smart Rules » Smart Rules – Actions: On/Off, Nilai tertentu

Smart Rules - Actions

ℹ️ Sebagian besar Smart Rule menyediakan serangkaian tindakan untuk dipilih. Perlu diingat bahwa rangkaian tersebut hanya mencakup tindakan yang relevan untuk kombinasi perangkat input & output yang digunakan dalam Smart Rule.

Halaman tindakan

ℹ️ Set dasar (default)

image-20211027-133809
  1. Tipe Aksi (Action Type)
    • Ditentukan secara otomatis oleh sistem berdasarkan jenis perangkat output
    • Contoh:
      • Untuk lampu: On/Off/Dimmer
      • Untuk tirai: Buka/Tutup/Stop
  2. Aksi Dasar (Basic Set of Actions)
    • Kumpulan aksi paling umum digunakan untuk perangkat tersebut
    • Ditampilkan langsung di antarmuka utama:
      • Nyala/Mati (untuk lampu)
      • Buka 50% (untuk tirai)
      • Set ke Mode Eco (untuk termostat)
  3. Aksi Lanjutan (Advanced Actions)
    • Diakses dengan tombol "Show more" (Tampilkan Lebih Banyak)
    • Berisi opsi spesifik dan kompleks:
      • Kontrol kecepatan kipas (level 1-5)
      • Atur durasi timer spesifik
      • Kombinasi multi-perangkat
image-20211027-134024

Pengaturan Aksi pada Smart Rules

  1. Jenis Aksi yang Tersedia
    • Hold (Tahan):
      Aksi berkelanjutan sampai ada perubahan lain
      Contoh: Lampu tetap menyala sampai dimatikan manual
    • One-time (Sekali jalan):
      Aksi sementara lalu kembali ke mode sebelumnya
      Contoh: Pompa hidup 5 menit lalu mati otomatis
  2. Set Aksi Lanjutan
    • Kumpulan semua opsi kontrol spesifik perangkat:
      • Untuk lampu: Dimmable, RGB control
      • Untuk motor: Kecepatan, arah putaran
      • Untuk HVAC: Mode, fan speed, suhu target
  3. Mode Operasi Khusus(Hanya untuk One-time)
    • Fitur khusus untuk:
      1. Melakukan aksi sekali
      2. Mengembalikan kontrol ke Smart Rule lain
    • Cara Kerja:
      • Perangkat akan beralih ke mode Automatic setelah aksi selesai
      • Hanya bekerja jika ada Smart Rule lain yang mengontrol perangkat yang sama

Jenis tindakan - cara tindakan diterapkan pada aktuator

duration

Dua Jenis Aksi Utama dalam Smart Rules

  1. One-time Action (Aksi Sekali Jalan)
    • ⬜ Ikon berbentuk kotak kosong berwarna aksen
    • Karakteristik:
      • Aksi terjadi sekali saja saat kondisi terpenuhi
      • Kontrol langsung dikembalikan setelah eksekusi
      • Cocok untuk:
        • Tombol impulse (nyala sesaat)
        • Trigger notifikasi
        • Skenario sekali pakai
    • Contoh:
      Tekan tombol → Buka pintu gerbang (3 detik) → Tutup otomatis
  2. Hold Action (Aksi Kontinu)
    • 🟦 Ikon kotak terisi penuh warna aksen
    • Karakteristik:
      • Aksi berlangsung terus selama kondisi aktif
      • Perangkat tetap dikontrol sampai:
        1. Kondisi tidak terpenuhi LAGI
        2. Ada aturan lain yang mengambil alih
      • Cocok untuk:
        • Lampu yang harus tetap menyala
        • Sistem pemanas/pendingin
        • Penguncian otomatis
    • Contoh:
      Sensor gerak aktif → Lampu menyala (selama ada gerakan) → Mati otomatis saat tidak ada gerakan

Tindakan secara detail

image-20210804-145426

Turn ON

Output device is turned ON

image-20210804-145820

Turn OFF

Output device is turned OFF

image-20210804-150014

Toggle

Jika perangkat keluaran berupa keluaran digital (switch), tindakan mengubah switch ke keadaan yang berlawanan dengan keadaan sebelum tindakan.

image-20210805-111100

Halaman tindakan

Fitur Toggle pada Perangkat Bernilai (Dimmer/Analog Output)

  1. Konsep Dasar Toggle
    Aksi yang mengubah nilai perangkat secara bergantian antara:
    • 0% (mati/nilai minimum)
    • Nilai Target (bisa fixed atau dynamic)
  2. Jenis Nilai Target
    • Fixed Value (Nilai Tetap):
      Contoh: Toggle antara 0% ↔ 50%
      [OFF] ↔ [50% brightness]
    • Last Value (Nilai Terakhir):
      Menggunakan nilai sebelumnya yang bukan nol
      Contoh:
      Jika terakhir diatur ke 75% → Toggle antara 0% ↔ 75%
  3. Sumber Nilai Terakhir
    Nilai non-zero bisa berasal dari:
    • Pengaturan manual pengguna
    • Smart Rule lain
    • Jadwal otomatis
image-20210805-110845

Perhatikan, bahwa tindakan Toggle hanya tersedia sebagai tindakan Satu Kali saja.

image-20210805-110013

Set value

Value of the output device is set to desired level. Available for continuously controlled outputs (dimmers, analog outputs etc.).

image-20210805-110452
image-20210805-114536

Set range

The device is set to the value from the defined range, which is closest to the last device value before the action

image-20210811-111946
image-20210804-150229

Impulses

Output device is switched between two states/values defined as On and Off

image-20211027-134404

Parameter Aksi Impuls pada Smart Rules

  1. Status On
    • Nilai/batas yang dianggap sebagai kondisi NYALA
    • Contoh:
      • Dimmer: >0%
      • Relay: Kontak tertutup
      • RGB: Brightness >0%
  2. Status Off
    • Nilai/batas yang dianggap sebagai kondisi MATI
    • Contoh:
      • Analog: 0% atau ≤5% (tergantung konfigurasi)
      • Digital: Kontak terbuka
  3. Delay Awal
    • Waktu tunda sebelum aksi pertama dieksekusi
    • Satuan: Milidetik/detik/menit
    • Contoh Use Case:
      Delay 2 detik → Memberi jeda setelah trigger
  4. Durasi
    • Panjang waktu tiap fase On/Off:
      timeline :
      title Satu Siklus
      section On
      3 detik : Durasi Nyala
      section Off
      1 detik : Durasi Mati
    • Catatan: Berlaku untuk kedua state
  5. Pengulangan
    • Jumlah siklus penuh On-Off yang dihasilkan
    • Contoh:
      Repeat=3 → [On→Off]×3 kali
    • Special Case:
      • 0 = Terus menerus
      • 1 = Satu impuls saja
image-20210804-153403

Keep original state/value

Output device is keeping actual state/value

image-20210804-153749

Stop timer

One-time action that stops timer action started by other Smart rule

image-20210804-153925

None

No action. Smart Rule does nothing (is bypassed) and makes output device available for other Smart Rule or manual control.

image-20210804-154412

Timer

Mekanisme Aksi Tertunda dan Berdurasi di Smart Rules

  1. One-time Action dengan Timer
    • Cara Kerja:
      sequenceDiagram :
      Trigger->> +Sistem: Kondisi terpenuhi
      Sistem->> +Perangkat: Delay awal (jika ada)
      Sistem->> Perangkat: Eksekusi aksi (durasi tertentu)
      Sistem->> -Perangkat: Kembalikan kontrol setelah selesai
    • Karakteristik:
      • Setelah eksekusi, perangkat bebas dikontrol oleh:
        • Smart Rule lain
        • Perintah manual
      • Contoh Use Case:
        [Tombol] → [Delay 2s] → [Buka Pintu 5s] → [Selesai]
  2. Hold Action dengan Timer Cerdas
    • Alur Kerja:
      graph TD :
      A[Trigger Aktif] --> B{Delay Selesai?}
      B -->|Ya| C[Eksekusi Aksi]
      C --> D{Trigger Masih Aktif?}
      D -->|Ya| C
      D -->|Tidak| E[Lepaskan Kontrol]
    • Fitur Unik:
      • Selama trigger masih aktif, aksi akan diperpanjang otomatis
      • Tetap melepas kontrol setelah kondisi tidak terpenuhi
      • Contoh Implementasi:
        Sensor Gerak → [Delay 10s] → [Lampu Nyala 2 menit]
        • Jika gerak terus terdeteksi: timer diperpanjang
        • Jika tidak ada gerak: mati setelah 2 menit

Perbandingan Visual:

ParameterOne-timeHold
Kontrol Pasca AksiLangsung dilepasDilepas setelah trigger off
Ekstensi DurasiTidak adaOtomatis jika trigger tetap on
Cocok UntukAksi instan sekali pakaiSkenario terkondisi terus

Perhatikan bahwa Timer hanya melakukan tindakan tertentu, jangan pernah mengatur perangkat keluaran kembali ke keadaan sebelum tindakan dilakukan.

Tindakan gabungan

ℹ️ Perangkat yang dikontrol secara terus-menerus (output analog, dimmer, dsb.) menyediakan kontrol terpisah untuk Switch (On/Off/Toggle) dan Value. Dualitas ini didukung oleh tindakan Smart Rule sehingga Anda dapat memilih apakah tindakan tersebut memengaruhi Switch atau Value atau Keduanya. Fitur canggih tersebut memungkinkan Anda untuk mengontrol Switch dengan satu Smart Rule dan Value dengan Smart Rule lainnya yang sangat berguna untuk manajemen pencahayaan, dsb.

ℹ️ Basic View

ℹ️ Advanced view

ℹ️ doc_tap_action_value3 ;

ℹ️ Show more - opens menu for combined action

ℹ️ Advanced view with combined action menu

ℹ️ Value - action settings for device value part only

ℹ️ Digital output - action settings for device Digital output (Switch) part only

Back to top arrow