# Integráció: iNELS rendszer NETx BMS-sel MQTT protokollon keresztül
### Tartalomjegyzék:
1. **Bevezetés**
2. **Rendszerkövetelmények**
3. **Architektúra áttekintése**
4. **MQTT beállítása**
* Brocker konfiguráció
* iNELS központi egység beállítása
* NETx BMS MQTT modul beállítása
5. **Témák és üzenettörzs**
* Előre definiált témák
* Üzenettörzs formátuma
6. **NETx BMS Multiprotocol Server**
* Telepítés és beállítás
* Protokollkonverzió PMS, ajtózár-rendszerek stb. felé
7. **Tesztelés és érvényesítés**
8. **Hibaelhárítás**
9. **Támogatás és karbantartás**
***
### 1. Bevezetés
Ez a kézikönyv lépésről lépésre útmutatást ad az iNELS rendszer NETx BMS-sel történő integrálásához MQTT protokoll használatával. Ez a beállítás ideális szállodai és kereskedelmi projektekhez, ahol a NETx BMS felügyelő platformként működik, és protokollkonverziót végez más rendszerek felé, mint például PMS (Property Management System), ajtózár-rendszerek és egyebek.
Az MQTT kommunikációs protokoll kihasználásával ez az integráció lehetővé teszi az iNELS vezeték nélküli és BUS egységek monitorozását és vezérlését a NETx BMS rendszeren keresztül.
***
### 2. Rendszerkövetelmények
Az integráció megkezdése előtt győződjön meg arról, hogy a következő rendszerek és eszközök rendelkezésre állnak:
* **iNELS központi egységek** (kommunikációhoz és vezérléshez)
* **MQTT broker** (pl. Mosquitto, EMQX vagy bármely MQTT-kompatibilis broker)
* **NETx BMS mag** vagy **NETx Multiprotocol Server**
* **MQTT modul** a NETx BMS számára
***
### 3. Architektúra áttekintése
Az integráció az alábbi architektúrát követi:
1. **iNELS központi egységek** csatlakozik egy **MQTT broker**.
2. **NETx BMS-hez** a saját **MQTT modul** előre definiált témákra iratkozik fel az iNELS rendszertől a brokeren keresztül.
3. A NETx BMS kezeli a monitorozást, vezérlést és a protokollkonverziót külső rendszerek felé, mint például a PMS vagy az ajtózár-rendszerek.
Az MQTT broker közvetíti az összes kommunikációt az iNELS és a NETx BMS között, lehetővé téve a valós idejű adatcserét és parancsvégrehajtást.
***
### 4. MQTT beállítása
#### Brocker konfiguráció
1. **Telepítsen és konfiguráljon egy MQTT brokert** (pl. Mosquitto).
2. Győződjön meg róla, hogy a broker elérhető mind az iNELS központi egységek, mind a NETx BMS számára.
3. Szükség esetén biztosítsa a brokert hitelesítéssel (felhasználónév/jelszó) és/vagy SSL tanúsítványokkal a titkosított kommunikációhoz.
#### iNELS központi egység beállítása
1. Az iNELS rendszerhez való hozzáférés az iDM-en keresztül a BUS rendszerhez és az eLAN gateway weboldalán keresztül a vezeték nélküli rendszerhez.
2. Határozza meg az iNELS egységeket az Eszközkezelőben, amelyek MQTT-t fognak publikálni/iratkozni.
3. Navigáljon a **Kommunikációs beállításokhoz** > **MQTT beállítások**.
4. Állítsa be a következő paramétereket:
* **Broker címe**: az MQTT broker IP-címe vagy hosztnév.
* **Port**: Szokásos MQTT portok (1883 nem titkosított, 8883 SSL-hez).
* **Kliensazonosító**: Egyedi azonosító minden központi egység számára.
* **Hitelesítés**: Adja meg az MQTT broker hitelesítő adatait, ha szükséges.
#### NETx BMS MQTT modul beállítása
1. Nyissa meg a **NETx BMS Konfigurációs Eszközt**.
2. Telepítse a **MQTT modul** ha még nem áll rendelkezésre.
3. Konfigurálja az MQTT kapcsolatot az alábbiak megadásával:
* **Broker címe**: az MQTT broker IP-címe vagy hosztnév.
* **Port**: Egyeztesse a broker portjával (1883).
* **Adatpont definíció**: Adja meg az iNELS témákat (részletezve az 5. fejezetben).
***
### 5. Témák és üzenettörzsek
Az iNELS és a NETx BMS közötti kommunikációt előre definiált MQTT témák és a hozzájuk tartozó üzenettörzsek kezelik. Ezek a témák lehetővé teszik mindkét rendszer számára az állapotok megfigyelését és vezérlőparancsok kiadását.
#### Előre definiált témák
Íme néhány példa téma, amely használható:
**Állapot téma üzenettörzse (bit-ek)**
**Téma:** `inels/status/2C6A6F104825/bits/000001`
**Üzenettörzs:**
Másolás
```
{
"last_seen": "2024-03-15T13:02:07.+0100Z",
"state": {
"000": 1,
"001": 0,
"002": 0,
...
"040": 0
}
}
```
**Beállító téma parancs (bit-ek)**
**Téma:** `inels/set/2C6A6F104825/bits/000001`
**Parancs:**
Másolás
```
{
"cmd": {
"005": "toggle"
}
}
```
**Állapot téma üzenettörzse (egész számok)**
**Téma:** `inels/status/2C6A6F104825/integers/000001`
**Üzenettörzs:**
Másolás
```
{
"last_seen": "2024-03-15T13:11:33.+0100Z",
"state": {
"000": 2556,
"001": 0,
"002": 97,
...
"020": 0
}
}
```
**Beállító téma parancs (egész számok)**
**Téma:** `inels/set/2C6A6F104825/integers/000001`
**Parancs:**
Másolás
```
{
"cmd": {
"002": 97
}
}
```
***
### 6. NETx BMS Multiprotocol Server
A **NETx BMS Multiprotocol Server** lehetővé teszi a protokollkonverziót az iNELS és más rendszerek, például a PMS vagy az ajtózárak között.
#### Telepítés és beállítás
1. Telepítse a **Multiprotocol Server** a hivatalos NETx telepítési útmutató használatával.
2. Konfigurálja az iNELS rendszert MQTT-n keresztül forrásprotokollként a Multiprotocol Serverben.
3. Állítson be célprotokollokat modulokként (pl. PMS, ajtózár-rendszerek) a konverzióhoz.
Határozza meg a leképezéseket az iNELS és a külső rendszerek között, biztosítva, hogy minden parancs/állapot helyesen legyen irányítva.
### Protokollkonverzió PMS, ajtózár-rendszerek stb. felé
{% embed url="" %}
***
### 7. Tesztelés és érvényesítés
#### Tesztelési lépések:
1. Ellenőrizze, hogy az iNELS központi egységek sikeresen csatlakoznak-e az MQTT brokerhez.
2. Erősítse meg, hogy a NETx BMS feliratkozott a releváns témákra és kapja az adatokat.
3. Tesztelje a vezérlőparancsokat úgy, hogy payloadokat küld a NETx BMS-ből az iNELS-nek, és ellenőrizze a fizikai választ (pl. lámpák ki/be kapcsolása).
4. Győződjön meg róla, hogy az iNELS állapotfrissítései helyesen tükröződnek a NETx BMS felületén.
***
### 8. Hibaelhárítás
* **Kapcsolódási problémák**: Ellenőrizze az MQTT broker naplóit, hogy mind az iNELS, mind a NETx BMS megfelelően csatlakozik-e.
* **Téma/üzenet eltérés**: Ellenőrizze, hogy a témák és az üzenettörzsek helyesen vannak-e definiálva és formázva.
* **Késleltetett frissítések**: Győződjön meg arról, hogy az MQTT QoS (Quality of Service) szint megfelelően van beállítva a projektje számára (általában QoS 1 vagy 2).
***
### 9. Támogatás és karbantartás
A folyamatos karbantartáshoz győződjön meg arról, hogy:
* Az MQTT broker rendszeresen megfigyelés alatt áll a csatlakoztathatóság szempontjából.
* Az iNELS és a NETx BMS firmware-/szoftverfrissítései alkalmazásra kerülnek.
* A naplókat időszakosan ellenőrzik hibák vagy bontások szempontjából.
Komplexebb problémák esetén forduljon az iNELS és a NETx BMS illetékes támogatási csapatához segítségért.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://wiki.inels.com/inels-bus-hu/harmadik-feltol-szarmazo-integracio/integracio-inels-rendszer-netx-bms-sel-mqtt-protokollon-keresztul.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.