Mutual Synchronization between Masters and One-Way Sync to Slaves with independent release

English Version

1. Overview

The "One-way Sync & Free Release with Multi-Master" Quick App (Version 2.0.1) is an advanced synchronization tool designed for FIBARO smart home systems. It features a unique hybrid logic: Mutual Synchronization between Masters and One-Way Sync to Slaves with Independent Release.

Within the same group, if you configure multiple Master switches, they will fully synchronize with each other (turning one Master ON/OFF will automatically turn all other Masters in that group ON/OFF). Simultaneously, this state is pushed down to all Slave switches. However, Slave switches retain their independence—manually toggling a Slave switch will not affect the Masters or other devices in the group. This is ideal for master bedrooms, open-plan living rooms, or dual-control stairs where multiple main switches need to stay in sync, but local sub-lights must remain independent.

2. Key Features

• Multi-Master Mutual Sync: Multiple Master switches within the same group automatically sync states bi-directionally (all ON or all OFF together).

• One-Way Slave Sync: Master states are seamlessly pushed to all Slave switches in the group.

• Independent Slave Operation (Free Release): Slave switches can be toggled locally without affecting the Masters or triggering the rest of the group.

• Lightning-Fast Event Engine: Utilizes Fibaro's /api/refreshStates for real-time, event-driven responsiveness without heavy polling delays.

• Auto-Healing Mechanism: Automatically verifies device states 5 seconds after a command is sent. If a device misses the signal, the Quick App will resend the command to ensure 100% synchronization accuracy.

• Auto-Configuration & Cleanup: Automatically creates required variables upon initialization and cleans up deprecated variables from older versions.

• Dynamic Grouping: Manage multiple sync groups (default is 3, scalable dynamically) using independent Object-Oriented Modules.

3. UI Breakdown & Visuals

The Quick App provides a clean, interactive dashboard within the Fibaro interface:

• Control Buttons (BT01, BT02, etc.): Allow you to manually trigger a sync group directly from the app. The buttons dynamically change color (Green for ON, Gray for OFF) and update their text based on the group's real-time state.

• Status Labels: Each group features a dedicated label showing the exact status of its configured Master (M) and Slave (S) devices (e.g., M: [106➜ON | 322➜ON 💡] ✧ S: [41➜ON | 178➜OFF ❌]).

4. Variables Configuration

Navigate to the "Variables" tab to configure your groups:

• Allbutton: Defines the number of sync groups you want to display and manage (Default: "3").

• logLevel: Sets the diagnostic output level in the console (DEBUG, INFO, WARN, ERROR).

• sw_DXX_master: Enter the Device IDs of your Master switches, separated by commas (e.g., "106, 322"). All IDs entered here will sync mutually.

• sw_DXX_slaver: Enter the Device IDs of your Slave switches, separated by commas (e.g., "41, 178, 179").

5. Quick Installation Guide

1. Download: Download the .fqax file.

2. Import: In your Fibaro Home Center, go to Settings > Devices > Add Device > Other > Upload File and select the .fqax file.

3. Auto-Setup: Wait a moment. The Quick App will automatically reboot and set up the necessary variables.

4. Configure: Go to the Variables tab of the newly added Quick App.

5. Assign IDs: Input your Master IDs (separated by commas for multiple masters) and Slave IDs into sw_D01_master, sw_D01_slaver, etc.

6. Done! Save your changes. The engine will instantly pick up the configurations and begin syncing.

Vietnamese Version

1. Overview (Tổng quan)

Quick App "Đồng bộ 1 chiều & Giải phóng độc lập" (Phiên bản 2.0.1) là công cụ đồng bộ nâng cao dành cho hệ thống nhà thông minh FIBARO . Tiện ích này sở hữu sự kết hợp logic độc đáo: Tự động đồng bộ chéo giữa các Master và Đồng bộ 1 chiều xuống các Slave với tính năng giải phóng độc lập.

Trong cùng một nhóm cấu hình, nếu bạn khai báo nhiều công tắc Master, chúng sẽ tự động đồng bộ trạng thái qua lại với nhau (bật/tắt một Master bất kỳ thì các Master còn lại trong nhóm sẽ cùng ON hoặc cùng OFF). Đồng thời, trạng thái này sẽ được truyền tiếp xuống các công tắc Slave. Ngược lại, các công tắc Slave vẫn giữ nguyên tính độc lập—khi bạn bật/tắt Slave tại chỗ, nó sẽ không ảnh hưởng ngược lại nhóm Master hay các thiết bị khác. Logic này cực kỳ hoàn hảo cho phòng ngủ master (công tắc cửa và công tắc đầu giường cùng là Master), phòng khách không gian mở hoặc cầu thang đảo chiều, nơi các công tắc chính cần đồng nhất trạng thái nhưng các đèn phụ vẫn có thể tắt độc lập.

2. Key Features (Tính năng chính)

• Tự đồng bộ giữa các Master (Multi-Master Sync): Các công tắc Master trong cùng một nhóm tự động đồng bộ trạng thái qua lại (cùng ON hoặc cùng OFF khi một nút thay đổi).

• Đồng bộ một chiều xuống Slave: Trạng thái từ nhóm Master được truyền suốt đến các công tắc Slave một cách mượt mà.

• Slave hoạt động độc lập (Free Release): Có thể bật/tắt Slave tại chỗ mà không tác động ngược lại Master hay kích hoạt các thiết bị khác trong nhóm.

• Động cơ xử lý siêu tốc: Sử dụng API /api/refreshStates của Fibaro để nhận diện sự kiện tức thời theo thời gian thực, không gây trễ tín hiệu do cơ chế polling.

• Cơ chế tự phục hồi (Auto-Healing): Hệ thống sẽ tự động kiểm tra lại trạng thái thiết bị sau 5 giây kể từ khi ra lệnh. Nếu phát hiện thiết bị trượt lệnh, Quick App sẽ tự động gửi lệnh bù để đảm bảo tính đồng bộ 100%.

• Tự động cấu hình & dọn dẹp: Khi khởi tạo, hệ thống tự động sinh các biến cần thiết và dọn sạch các biến rác từ những phiên bản cũ.

• Tùy biến nhóm động: Quản lý nhiều nhóm đồng bộ cùng lúc (mặc định là 3 nhóm, có thể mở rộng linh hoạt) nhờ cấu trúc hướng đối tượng (OOP).

3. UI Breakdown & Visuals (Giao diện hiển thị)

Quick App cung cấp một bảng điều khiển gọn gàng, trực quan ngay trên giao diện Fibaro:

• Nút điều khiển (BT01, BT02, v.v.): Cho phép bạn bật/tắt nhanh toàn bộ một nhóm đồng bộ trực tiếp từ app. Nút sẽ tự động đổi màu (Xanh lá khi ON, Xám khi OFF) và cập nhật chữ theo trạng thái thực tế.

• Nhãn trạng thái: Mỗi nhóm có một nhãn riêng để báo cáo chính xác trạng thái hiện tại của từng thiết bị Master (M) và Slave (S) (Ví dụ: M: [106➜ON | 322➜ON 💡] ✧ S: [41➜ON | 178➜OFF ❌]).

4. Variables Configuration (Cấu hình biến)

Chuyển sang tab "Variables" (Biến) của Quick App để cấu hình thông số:

• Allbutton: Số lượng nhóm đồng bộ bạn muốn hiển thị và sử dụng (Mặc định: "3").

• logLevel: Cấp độ ghi log trên console (DEBUG, INFO, WARN, ERROR).

• sw_DXX_master: Điền các ID của thiết bị Master, cách nhau bởi dấu phẩy (VD: "106, 322"). Các ID nằm trong ô này sẽ tự động đồng bộ chéo với nhau.

• sw_DXX_slaver: Điền các ID của thiết bị Slave, cách nhau bởi dấu phẩy (VD: "41, 178, 179").

5. Quick Installation Guide (Hướng dẫn cài đặt nhanh)

1. Tải về: Tải file cấu hình có đuôi .fqax.

2. Nhập file (Import): Truy cập vào Home Center, chọn Settings > Devices > Add Device > Other > Upload File và chọn file .fqax vừa tải.

3. Tự động thiết lập: Đợi một vài giây để Quick App tự khởi động lại và khởi tạo các biến hệ thống cần thiết.

4. Cấu hình: Chuyển sang tab Variables của Quick App vừa được thêm.

5. Gán ID: Điền ID các thiết bị Master (cách nhau bằng dấu phẩy nếu có nhiều Master) và các ID Slave vào các biến sw_D01_master, sw_D01_slaver, v.v. tương ứng.

6. Hoàn thành! Bấm lưu (Save). Hệ thống sẽ ngay lập tức kích hoạt động cơ đồng bộ theo cấu hình mới.