Configuration GuideHướng dẫn cấu hình

Local Alert RulesCảnh báo tại chỗ IO & Alert Engine

Create rules that make eNode-Gen2 switch a relay or publish an MQTT message when sensor values meet a condition. Rules run on the node itself, so relay control keeps working even when the cloud connection is lost. Tạo Rule để eNode-Gen2 tự bật/tắt relay hoặc gửi bản tin MQTT khi giá trị cảm biến thỏa điều kiện. Rule chạy ngay trên eNode, vì vậy relay vẫn được điều khiển kể cả khi mất kết nối Cloud.

8Rules per nodeRule / thiết bị

8Conditions per ruleĐiều kiện / Rule

32Chars per MQTT messageKý tự / bản tin MQTT

2Relays (Version A, TH)Relay (Version A, TH)

WorkflowQuy trình

Six Steps6 bước thực hiện

01Find the IPLấy địa chỉ IPHBQConnect 02Open the Web UIMở giao diện WebBrowser · LAN / SoftAPTrình duyệt · LAN / SoftAP 03Create a RuleTạo Rule mớiIO & Alert Engine 04Output & actionĐầu ra & hành độngRule headerPhần đầu Rule 05Add conditionsThêm điều kiệnCondition rowsCác dòng điều kiện 06Save & verifyLưu & kiểm traAPPLY LOGIC TO GATEWAY

Before You StartTrước khi bắt đầu

Check these points first so the rule can be created and saved without surprises.Kiểm tra các điểm sau để tạo và lưu Rule suôn sẻ.

eNode-Gen2 is powered and connected to the network via Ethernet or Wi-Fi.eNode đã được cấp nguồn và kết nối mạng qua Ethernet hoặc Wi-Fi.
The computer or phone used for setup is on the same LAN / Wi-Fi as the eNode (or joined to the eNode's own Wi-Fi, see Step 2 – Method B).Máy tính/điện thoại dùng để cấu hình kết nối cùng mạng LAN/Wi-Fi với eNode (hoặc kết nối Wi-Fi do eNode phát, xem Bước 2 – Cách B).
The channels you want to use as conditions (e.g. temp, humi) are declared in Polling Configuration and saved with ⚡ Apply All → 💾 Save All to Flash.Các kênh đo muốn dùng làm điều kiện (ví dụ temp, humi) đã được khai báo trong Polling Configuration và đã bấm ⚡ Apply All → 💾 Save All to Flash.
To drive a relay, the device must be a version with relays: Version A or Version TH (2 relays each).Muốn điều khiển relay: thiết bị phải là phiên bản có relay: Version A hoặc Version TH (mỗi bản 2 relay).
Use Chrome or Safari, not an in-app mobile browser.Dùng Chrome hoặc Safari, không dùng trình duyệt nhúng trong ứng dụng di động.

Orange markers 1 2 3 in the text match the numbered markers on the screenshots. Screenshots are illustrative; IP addresses, channel names and values on your device may differ. Ký hiệu 1 2 3 trong bài tương ứng với các số tròn màu cam trên ảnh. Ảnh chụp chỉ để minh họa; IP, tên kênh và giá trị trên thiết bị của bạn có thể khác.

Step 1Bước 1

Find the eNode IP AddressLấy địa chỉ IP của eNode

Goal: know the local IP address of the eNode so you can open its Web UI in Step 2.Mục tiêu: biết địa chỉ IP nội bộ của eNode để mở giao diện Web ở Bước 2.

In HBQConnect, open the device dashboard and select the Thông tin thiết bị (Device information) tab 1.Trên HBQConnect, mở dashboard của thiết bị và chọn tab Thông tin thiết bị 1.
Check Ethernet Status 2 to see whether an Ethernet cable is connected.Xem ô Ethernet Status 2 để biết eNode đang có cắm cáp mạng hay không.
Pick the IP address from the table below and note it down.Chọn IP theo bảng dưới đây và ghi lại.

ConnectionTình trạng kết nối	Use the IP inDùng IP ở ô	NotesGhi chú
Ethernet cable connectedCó cắm cáp Ethernet	Local LAN IP 3	Assigned automatically by the router (DHCP).IP do router cấp tự động (DHCP).
Ethernet cable not connected (Ethernet Status = Disconnected)Không cắm cáp Ethernet (Ethernet Status = Disconnected)	Local Wifi 4	Shown only when the eNode is connected to the cloud.Chỉ hiển thị khi eNode đã kết nối Cloud.

Example (figure below): Ethernet Status is Disconnected, so use the Local Wifi IP 192.168.1.250. Ví dụ (hình dưới): Ethernet Status đang là Disconnected, nên dùng Local Wifi IP là 192.168.1.250.

HBQConnect device information tab showing Local LAN IP, Local Wifi IP and Ethernet Status — 1 Device information tab · 2 Ethernet Status · 3 Local LAN IP · 4 Local Wifi IP · 5 Alert Rule Config1 Tab Thông tin thiết bị · 2 Ethernet Status · 3 Local LAN IP · 4 Local Wifi IP · 5 Alert Rule Config

No IP shown in HBQConnect? The eNode is usually not connected to the cloud yet. Open the Web UI through the eNode's own Wi-Fi instead (Step 2 – Method B). Không thấy IP trên HBQConnect? Thường do eNode chưa kết nối Cloud. Hãy vào giao diện Web qua Wi-Fi do eNode phát (Bước 2 – Cách B).

Step 2Bước 2

Open the eNode Web UIMở giao diện Web của eNode

Method A — Over the LANCách A — Qua mạng LAN

Use the IP address from Step 1.Dùng IP lấy ở Bước 1.

Connect the computer to the same LAN / Wi-Fi as the eNode.Kết nối máy tính vào cùng mạng LAN/Wi-Fi với eNode.
Open Chrome or Safari, type http://<IP address> and press Enter. Example: http://192.168.1.250Mở Chrome hoặc Safari, gõ http://<địa chỉ IP> rồi nhấn Enter. Ví dụ: http://192.168.1.250
The ENODE-GEN2 WEB UI opens, with its functions in the left menu.Trang ENODE-GEN2 WEB UI hiện ra, các chức năng nằm ở menu bên trái.

Method B — eNode Wi-Fi (SoftAP)Cách B — Wi-Fi do eNode phát (SoftAP)

When the IP is unknown, the eNode is not on the cloud, or there is no LAN on site.Khi chưa biết IP, eNode chưa kết nối Cloud, hoặc hiện trường không có mạng LAN.

On a computer or phone, join the Wi-Fi network broadcast by the eNode. Network name and password: ask your administrator.Trên máy tính hoặc điện thoại, kết nối vào mạng Wi-Fi do eNode phát. Tên mạng và mật khẩu: liên hệ quản trị viên.
Open a browser and go to http://192.168.4.1/Mở trình duyệt, truy cập http://192.168.4.1/
The Web UI opens, same as Method A.Giao diện Web hiện ra giống Cách A.
When finished, reconnect to your usual Wi-Fi network.Cấu hình xong, kết nối máy trở lại mạng Wi-Fi thường dùng.

Important: the computer must be on the same network as the eNode. If they are on different networks, the browser cannot open the page. Lưu ý quan trọng: máy tính phải cùng mạng với eNode. Nếu máy tính và eNode ở hai mạng khác nhau, trình duyệt sẽ không mở được trang.

Step 3Bước 3

Create a New RuleTạo Rule mới

In the left menu, select 🔔 IO & Alert Engine 1.Ở menu bên trái, chọn 🔔 IO & Alert Engine 1.
Click + Add New Rule 2 at the top right. A new rule block (RULE 1, RULE 2, …) appears.Bấm + Add New Rule 2 ở góc trên bên phải. Một khung Rule mới (RULE 1, RULE 2, …) xuất hiện.
The Rules: x/8 counter 3 shows how many rules exist. At 8/8 the + Add New Rule button is greyed out: delete an unused rule first.Bộ đếm Rules: x/8 3 cho biết số Rule đã tạo. Khi bộ đếm là 8/8, nút + Add New Rule bị mờ: cần xóa một Rule không dùng trước khi tạo Rule mới.

IO and Alert Engine page with 8 of 8 rules — Alert Engine page with all 8/8 rules used (+ Add New Rule greyed out). 4 is an Alert Message rule, see Step 4.Trang IO & Alert Engine đang có đủ 8/8 Rule (nút + Add New Rule bị mờ). 4 là ví dụ Rule gửi Alert Message, xem Bước 4.

Step 4Bước 4

Choose the Output and ActionChọn đầu ra và hành động

The rule header decides whether the rule runs and what the eNode does when the condition occurs.Phần đầu của mỗi Rule quyết định Rule có chạy hay không, và khi điều kiện xảy ra thì eNode làm gì.

STATUS 1: Active runs the rule. Inactive pauses it while keeping its settings.STATUS 1: chọn Active để Rule hoạt động. Chọn Inactive để tạm dừng Rule mà vẫn giữ cấu hình.
TARGET DEVICE 2: Relay 1 / Relay 2 switch a relay on the eNode; Alert Message publishes an MQTT message to the configured broker and does not drive a relay.TARGET DEVICE 2: Relay 1 / Relay 2 bật/tắt relay trên eNode; Alert Message gửi bản tin MQTT lên MQTT Broker đã cấu hình, không điều khiển relay.
Set the action 3 for the selected target (table below).Thiết lập hành động 3 theo Target Device đã chọn (bảng dưới).
To delete the rule, click Delete Rule or the icon button next to it 5.Muốn xóa Rule: bấm Delete Rule hoặc nút biểu tượng bên cạnh 5.

Rule header with status, target device, start and end action — 1 STATUS · 2 TARGET DEVICE · 3 START / END ACTION · 4 + Add Sensor / Rule · 5 delete rule1 STATUS · 2 TARGET DEVICE · 3 START / END ACTION · 4 + Add Sensor / Rule · 5 xóa Rule

FieldTrường	Shown when target isHiện khi Target là	MeaningÝ nghĩa
START ACTION	Relay 1 / Relay 2	Action when the rule condition becomes true: Turn ON or Turn OFF.Hành động khi điều kiện của Rule bắt đầu đúng: Turn ON (bật) hoặc Turn OFF (tắt).
END ACTION	Relay 1 / Relay 2	Action when the rule condition is no longer true: Turn ON or Turn OFF.Hành động khi điều kiện của Rule hết đúng: Turn ON hoặc Turn OFF.
START MSG	Alert Message	MQTT message sent when the condition becomes true. Max 32 characters.Nội dung bản tin MQTT gửi khi điều kiện bắt đầu đúng. Tối đa 32 ký tự.
END MSG	Alert Message	MQTT message sent when the condition is no longer true. Max 32 characters.Nội dung bản tin MQTT gửi khi điều kiện hết đúng. Tối đa 32 ký tự.

Typical use: START ACTION = Turn ON, END ACTION = Turn OFF → the relay is on during the alert and off afterwards.Cách dùng thông thường: START ACTION = Turn ON, END ACTION = Turn OFF → relay bật khi có cảnh báo, tắt khi hết cảnh báo.
Cut a load during the alert (e.g. stop a pump at high water level): START ACTION = Turn OFF, END ACTION = Turn ON.Muốn ngắt tải khi có cảnh báo (ví dụ ngắt bơm khi mực nước cao): START ACTION = Turn OFF, END ACTION = Turn ON.
Alert Message example (Step 3 figure, 4): START MSG = rl1_on, END MSG = rl1_off → the eNode publishes “rl1_on” when the condition occurs and “rl1_off” when it ends.Ví dụ Alert Message (hình ở Bước 3, 4): START MSG = rl1_on, END MSG = rl1_off → eNode gửi “rl1_on” khi điều kiện xảy ra và gửi “rl1_off” khi điều kiện kết thúc.

Relays: Relay 1 / Relay 2 exist only on Version A and Version TH. Versions without relays use Alert Message only. Keep relay loads within the relay rating; use an intermediate contactor for large loads (motors, pumps). Relay: Relay 1 / Relay 2 chỉ có trên Version A và Version TH. Phiên bản không có relay chỉ dùng Alert Message. Tải nối vào relay phải nằm trong giới hạn của relay; tải lớn (motor, bơm) cần dùng contactor trung gian.

Step 5Bước 5

Add Trigger ConditionsThêm điều kiện kích hoạt

5.1 Add and fill in a condition row5.1 Thêm và điền dòng điều kiện

Click + Add Sensor / Rule 1. A new condition row 2 appears with default values.Bấm + Add Sensor / Rule 1. Một dòng điều kiện mới 2 xuất hiện với giá trị mặc định.
Fill in each column as described in the table below.Điền các cột của dòng điều kiện theo bảng bên dưới.
For more conditions, click + Add Sensor / Rule again. Up to 8 conditions per rule.Cần nhiều điều kiện thì bấm + Add Sensor / Rule thêm lần nữa. Mỗi Rule có tối đa 8 điều kiện.

New condition row after clicking Add Sensor / Rule — 1 + Add Sensor / Rule button · 2 new condition row with default values1 Nút + Add Sensor / Rule · 2 dòng điều kiện mới với giá trị mặc định

ColumnCột	MeaningÝ nghĩa	ExampleVí dụ
TRIGGER SOURCE	Channel used as the condition. The list only contains channels declared in Polling Configuration.Kênh đo dùng làm điều kiện. Danh sách chỉ gồm các kênh đã khai báo trong Polling Configuration.	temp
CONDITION	> Greater · < Less · = Equal · ≠ Not Equal> lớn hơn · < nhỏ hơn · = bằng · ≠ khác	> (Greater)
THRESHOLD	Comparison threshold, in the channel's unit.Ngưỡng so sánh, cùng đơn vị với kênh đo.	25
HYSTERESIS	Dead band that stops the rule from toggling when the value hovers around the threshold; channel's unit. See 5.2.Khoảng đệm để Rule không bật/tắt liên tục khi giá trị dao động quanh ngưỡng; cùng đơn vị với kênh đo. Xem 5.2.	1
NEXT LOGIC	Joins this row with the row directly below: AND or OR. The last row shows “-”. See 5.3.Cách nối dòng này với dòng ngay bên dưới: AND hoặc OR. Dòng cuối cùng hiển thị “-”. Xem 5.3.	OR
Remove	Deletes the condition row (ACTS column).Xóa dòng điều kiện (cột ACTS).	–

Rule with two condition rows joined by OR — 1 rule with two condition rows · 2 NEXT LOGIC = OR joins row 1 and row 21 Rule có 2 dòng điều kiện · 2 NEXT LOGIC = OR nối dòng 1 với dòng 2

5.2 How hysteresis works5.2 Hysteresis hoạt động thế nào?

Hysteresis separates the switch-on and switch-off levels: a condition becomes true when the value crosses the threshold, but only stops being true once the value moves back past the threshold by the hysteresis amount.Hysteresis tạo khoảng đệm giữa mức bật và mức tắt: điều kiện bắt đầu đúng khi giá trị vượt Threshold, nhưng chỉ hết đúng khi giá trị lùi lại quá Threshold thêm một khoảng bằng Hysteresis.

CONDITION	Becomes true whenBắt đầu đúng khi	Stops being true whenHết đúng khi
> (Greater)	value > Thresholdgiá trị > Threshold	value < Threshold − Hysteresisgiá trị < Threshold − Hysteresis
< (Less)	value < Thresholdgiá trị < Threshold	value > Threshold + Hysteresisgiá trị > Threshold + Hysteresis

Hysteresis is also applied to = (Equal) and ≠ (Not Equal).Với = (Equal) và ≠ (Not Equal), eNode cũng áp dụng Hysteresis.

Example: temp > 25, Hysteresis = 1. Above 25 °C → true. Drops to 24.5 °C → still true (inside the band). Below 24 °C → false. Ví dụ: temp > 25, Hysteresis = 1. Nhiệt độ lên quá 25 °C → điều kiện đúng. Giảm về 24,5 °C → vẫn đúng (đang trong khoảng đệm). Xuống dưới 24 °C → hết đúng.

Tip: Hysteresis = 0 can make a relay chatter when the value hovers near the threshold. Set it larger than the sensor's normal fluctuation. Mẹo: Hysteresis = 0 dễ làm relay đóng/ngắt liên tục khi giá trị dao động sát ngưỡng. Nên đặt Hysteresis lớn hơn mức dao động bình thường của cảm biến.

5.3 Combining conditions (AND / OR)5.3 Kết hợp nhiều điều kiện (AND / OR)

AND: true when both conditions are true.AND: đúng khi cả hai điều kiện cùng đúng.
OR: true when at least one condition is true.OR: đúng khi ít nhất một điều kiện đúng.
Precedence follows C/C++: AND is evaluated before OR.Thứ tự ưu tiên giống C/C++: AND được tính trước OR.

Condition rows (top to bottom)Các dòng điều kiện (từ trên xuống)	Evaluated aseNode hiểu là
A OR B	A \|\| B
A AND B OR C	(A && B) \|\| C
A OR B AND C	A \|\| (B && C)

Tip: the UI has no parentheses. To get (A OR B) AND C, create 4 rows: A AND C OR B AND C (row 1 = A, row 2 = C, row 3 = B, row 4 = C). Mẹo: giao diện không có dấu ngoặc. Muốn có (A OR B) AND C, hãy tạo 4 dòng: A AND C OR B AND C (dòng 1 = A, dòng 2 = C, dòng 3 = B, dòng 4 = C).

ExampleVí dụ

Complete Configuration ExampleVí dụ cấu hình hoàn chỉnh

Requirement: turn Relay 1 on when temperature > 25 °C or humidity > 60 %RH; turn it off when both are back to normal.Yêu cầu: bật Relay 1 khi nhiệt độ > 25 °C hoặc độ ẩm > 60 %RH; tắt Relay 1 khi cả hai trở lại bình thường.

STATUS ActiveTARGET DEVICE Relay 1START ACTION Turn ONEND ACTION Turn OFF

RowDòng	TRIGGER SOURCE	CONDITION	THRESHOLD	HYSTERESIS	NEXT LOGIC
1	temp	> (Greater)	25	1	OR
2	humi	> (Greater)	60	1	-

Then save with Step 6 (APPLY LOGIC TO GATEWAY 4).Sau đó lưu cấu hình theo Bước 6 (nút APPLY LOGIC TO GATEWAY 4).

Example rule: Relay 1 on when temp above 25 or humi above 60 — 1 Relay 1 output (Turn ON / Turn OFF) · 2 row temp > 25, Hysteresis 1, OR · 3 CONDITION list · 4 APPLY LOGIC TO GATEWAY1 Đầu ra Relay 1 (Turn ON / Turn OFF) · 2 dòng temp > 25, Hysteresis 1, OR · 3 danh sách CONDITION · 4 nút APPLY LOGIC TO GATEWAY

Result: Relay 1 turns on when temperature exceeds 25 °C or humidity exceeds 60 %RH, and turns off when both conditions are no longer true. With Hysteresis = 1, a temperature that exceeded 25 °C must fall below 24 °C, and a humidity that exceeded 60 %RH must fall below 59 %RH, before that condition clears. Kết quả: Relay 1 bật khi nhiệt độ vượt 25 °C hoặc độ ẩm vượt 60 %RH, và tắt khi cả hai điều kiện đều không còn đúng. Nhờ Hysteresis = 1: nhiệt độ đã vượt 25 °C phải giảm xuống dưới 24 °C, độ ẩm đã vượt 60 %RH phải giảm xuống dưới 59 %RH thì điều kiện tương ứng mới hết đúng.

Step 6Bước 6

Save and VerifyLưu cấu hình và kiểm tra

6.1 Save6.1 Lưu cấu hình

Click APPLY LOGIC TO GATEWAY at the bottom of the page, below the rules (Example figure, 4).Bấm APPLY LOGIC TO GATEWAY ở cuối trang, bên dưới các Rule (hình Ví dụ, 4).
All rules are stored in the eNode's Flash memory and survive a restart. “Gateway” on this button means the eNode itself.Toàn bộ Rule được lưu vào bộ nhớ Flash của eNode và vẫn giữ nguyên sau khi khởi động lại. “Gateway” trên nút này chính là eNode.

Changes are not stored on the eNode until you click APPLY LOGIC TO GATEWAY. Click it again after every rule change. Chưa bấm APPLY LOGIC TO GATEWAY thì thay đổi chưa được lưu vào eNode. Bấm lại nút này sau mỗi lần thay đổi Rule.

6.2 Verify the rule6.2 Kiểm tra Rule hoạt động

Relay: in the Web UI, open 📊 Live Monitoring and watch Relay 1 / Relay 2 change state when the condition occurs.Relay: trên giao diện Web, mở 📊 Live Monitoring và xem trạng thái Relay 1 / Relay 2 thay đổi khi điều kiện xảy ra.
HBQConnect: the Alert Rule Config panel (Step 1 figure, 5) updates to show the saved rules.HBQConnect: mục Alert Rule Config (hình ở Bước 1, 5) được cập nhật theo các Rule vừa lưu.
Alert Message: check that the START MSG / END MSG messages arrive at the MQTT broker or receiving platform.Alert Message: kiểm tra bản tin START MSG / END MSG trên MQTT Broker hoặc nền tảng nhận dữ liệu.

Quick test: temporarily set the threshold close to the current value so the rule fires; once confirmed, restore the real value and click APPLY LOGIC TO GATEWAY. Mẹo thử nhanh: tạm đặt Threshold sát giá trị hiện tại để Rule kích hoạt; kiểm tra xong thì đặt lại giá trị thật và bấm APPLY LOGIC TO GATEWAY.

TroubleshootingXử lý sự cố thường gặp

SymptomHiện tượng	What to doCách xử lý
Web UI does not open by IPKhông mở được trang Web bằng IP	Make sure the computer is on the eNode's network. Re-check Ethernet Status to use the right IP (LAN or Wi-Fi), or connect via SoftAP `http://192.168.4.1/`.Kiểm tra máy tính cùng mạng với eNode. Xem lại Ethernet Status để dùng đúng IP (LAN hay Wi-Fi), hoặc vào qua SoftAP `http://192.168.4.1/`.
No IP shown in HBQConnectKhông thấy IP trên HBQConnect	The eNode is not connected to the cloud. Use SoftAP (Step 2 – Method B).eNode chưa kết nối Cloud. Vào giao diện Web qua SoftAP (Bước 2 – Cách B).
Needed channel missing from Trigger SourceTrigger Source không có kênh cần dùng	Declare the channel in Polling Configuration, click Apply All → Save All to Flash, then reopen IO & Alert Engine.Khai báo kênh trong Polling Configuration, bấm Apply All → Save All to Flash, rồi mở lại trang IO & Alert Engine.
+ Add New Rule is greyed outNút + Add New Rule bị mờ	All 8/8 rules are used. Delete an unused rule.Đã đủ 8/8 Rule. Xóa một Rule không dùng.
Relay chatters on/offRelay đóng/ngắt liên tục	Hysteresis is 0 or too small. Increase it.Hysteresis bằng 0 hoặc quá nhỏ. Tăng Hysteresis.
Relay does not switchRelay không tác động	Check: STATUS = Active; device is Version A or TH; APPLY LOGIC TO GATEWAY was clicked; the value in Live Monitoring really crossed the threshold.Kiểm tra: STATUS = Active; thiết bị là Version A hoặc TH; đã bấm APPLY LOGIC TO GATEWAY; giá trị đo ở Live Monitoring đã thực sự vượt ngưỡng.
Alert Message not receivedKhông nhận được Alert Message	Check the MQTT Broker tab and the eNode's network connection; START MSG / END MSG must be 32 characters or fewer.Kiểm tra cấu hình tab MQTT Broker và kết nối mạng của eNode; START MSG / END MSG không quá 32 ký tự.
Rules lost after restartRule bị mất sau khi khởi động lại	APPLY LOGIC TO GATEWAY was not clicked. Reconfigure and apply.Chưa bấm APPLY LOGIC TO GATEWAY. Cấu hình lại và bấm APPLY.

← Back to eNode-Gen2 main page← Quay về trang chính eNode-Gen2 Back to top ↑Lên đầu trang ↑