# Integráció: iNELS rendszer a 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).

   <figure><img src="https://4130956762-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FErjlplToL8l7jIChGVB2%2Fuploads%2F7aCAKNIwSwaJaqLILlsT%2Fimage.png?alt=media&#x26;token=afe4a3f7-3f54-4393-85b9-002eee19a17a" alt=""><figcaption></figcaption></figure>

   * **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.

<figure><img src="https://4130956762-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FErjlplToL8l7jIChGVB2%2Fuploads%2FfbF8BLho56bJmWalqmge%2Fimage.png?alt=media&#x26;token=8e2ba4e5-bf38-4d86-b069-fd735f65afb3" alt=""><figcaption></figcaption></figure>

#### 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.

<figure><img src="https://4130956762-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FErjlplToL8l7jIChGVB2%2Fuploads%2FxWf5cZvdkBce4JH5ZJWE%2Fimage.png?alt=media&#x26;token=323458fc-25a0-4817-9dff-cbfe3fc7144d" alt=""><figcaption></figcaption></figure>

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="<https://youtu.be/Y2BLwPWHmys>" %}

***

### 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.