# iNELS BUS egységek hozzáadása az Inspiniához MQTT-n keresztül

Ez a verzió lecseréli az elavult lépéseket és tiszta, lépésről lépésre útmutatót nyújt, amely alkalmas **iNELS Wiki**.

## **iNELS BUS integráció Inspiniába MQTT-n keresztül (frissített kézikönyv)**

### **Bitek és egész számok használata a SkyPlatformon**

Ez a kézikönyv elmagyarázza, hogyan integrálhatók az iNELS BUS egységek Inspiniával használva **MQTT**, a legfrissebb frissítés alapján, ahol **az iNELS BUS eszközöket már nem közvetlenül adják hozzá a SkyPlatformhoz**.\
Az integrációt mostantól a következőkkel végzik: **Bitek** és **Egész számok** amelyek a BUS állapotokat és parancsokat képviselik.

## **Rendszerkövetelmények**

Szükséged lesz:

* **iNELS központi egység** (CU3-07M, CU3-08M, CU3-09M, CU3-10M)
* &#x20;MQTT broker
* **Inspinia érintőpanel** (4", 8" vagy 10") vagy MiniServer
* **SkyPlatform fiók-hozzáférés**
* **MQTT Explorer** (opcionális, de ajánlott a payloadok ellenőrzéséhez)

## **Add meg az MQTT broker hitelesítő adatait az iDM-ben**

1. Add hozzá a biteket és egész számokat a rendszerkezelőben, és kösd őket az iNELS eszközökhöz az iDM projektben
2. Menj a **CU konfigurációhoz** az iDM-ben.
3. Írd be az MQTT broker hitelesítő adatait:
   * Broker címe
   * Port
   * Felhasználónév
   * Jelszó
4. Mentsd a konfigurációt a CU-ra.
5. Mentsd vissza az egész projektet a CU-ra.

Ez a lépés lehetővé teszi, hogy a CU csatlakozzon az MQTT brokerhez és közzétegye a BUS adatokat.

## **Adj hozzá iNELS MQTT eszközt a SkyPlatformhoz**

A frissített verzióban az iNELS BUS egységek **nincsenek hozzáadva** a SkyPlatformhoz.\
Ehelyett hozzáadsz egy **iNELS MQTT eszközt** és konfigurálod a Bitek és Egész számokat.

#### Hogyan add hozzá:

1. Nyisd meg a SkyPlatformot → **Eszközök** → **Eszköz hozzáadása**.

2. Válaszd ki **iNELS MQTT**.

   <figure><img src="https://4130956762-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FErjlplToL8l7jIChGVB2%2Fuploads%2FaJweUWrjEiEYi4Rwcj3i%2Fimage.png?alt=media&#x26;token=d88e15f8-3da5-466d-bde3-00ddd5ad73e7" alt="" width="315"><figcaption></figcaption></figure>

3. Add meg ugyanazokat a **MQTT broker hitelesítő adatokat** amelyeket az iDM-ben használtál.

<figure><img src="https://4130956762-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FErjlplToL8l7jIChGVB2%2Fuploads%2FQSdLApy885F00eCIdMWa%2Fimage.png?alt=media&#x26;token=ab78e786-c14e-4075-8fc4-8578d7925719" alt="" width="375"><figcaption></figcaption></figure>

## **Adj hozzá Bitek és Egész számokat a SkyPlatformon**

A broker adatok megadása után:

1. Az iNELS MQTT eszköz ablakában kattints **Bit hozzáadása** vagy **Egész szám hozzáadása**.
2. Most meg kell adnod a következőket: **Eszköz azonosító (Device ID)** és **Bit/Egész szám index**.

<figure><img src="https://4130956762-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FErjlplToL8l7jIChGVB2%2Fuploads%2FopSK5Sul8MAGRr8BDerx%2Fimage.png?alt=media&#x26;token=d56fa915-7602-4f62-82f9-1f76c89ceea0" alt="" width="375"><figcaption></figcaption></figure>

#### Hogyan található meg az Eszköz azonosító:

Használd **MQTT Explorer** és figyeld az iNELS MQTT témákat.

* **Bit eszközazonosítók** ezzel kezdődnek: **D00001**
* **Egész szám eszközazonosítók** ezzel kezdődnek: **E00001**

#### Hogyan működik az indexelés:

* Minden Bit eszköz **40 bitet tartalmaz**
  * Kezdő index = **001**
  * Vég index = **039**

Példa: inels/status/2C6A6F10XXXX/bits/D00001\
Ha az EszközID = `D00001`, a rendelkezésre álló témák között szerepelni fognak:

{"last\_seen":"2025-03-25T03:29:50.+0100Z",\
"state":{"000":0,"001":0,"002":0,"003":0,"004":0,"005":0,"006":0,"007":0,"008":0,"009":0,"010":0,"011":0,"012":0,"013":0,"014":0,"015":0,"016":0}}

#### Fontos megjegyzések

* Győződj meg róla, hogy a Bit száma a SkyPlatformon **megegyezik az iDM Monitorban szereplő ugyanazzal a Bit számmal**.
* Ellenőrizd, hogy ugyanaz a Bit szám létezik a **MQTT Bit állapot témában**.
* Ha eltérés van, a kapcsolat **nem fog működni**.

Egész számok esetén az indexelés ugyanazt a szerkezetet követi, de **egész szám értékekre**.

Add hozzá az összes szükséges Bitet/Egész számot.

## **Add hozzá a Bitek/Egész számok a tervezési felülethez**&#x20;

1. Menj a **Tervezés** a SkyPlatformon.
2. Húzd a Bit vagy Egész szám objektumot a tervezési felületre.
3. Kösd össze a következőkkel:
   * Gombok
   * Kapcsolók
   * Felhasználói felület elemei
   * Más eszközök
   * Automatizálások

Ez lehetővé teszi az Inspinia számára, hogy parancsokat küldjön az iNELS-nek vagy megjelenítse az állapotokat.

<figure><img src="https://4130956762-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FErjlplToL8l7jIChGVB2%2Fuploads%2FQbMF3Yf9rV0TIkZABgOt%2Fimage.png?alt=media&#x26;token=a7cb0654-048f-41eb-8d10-75ea36a0fb8d" alt=""><figcaption></figcaption></figure>

## **Összekapcsolás több CU között**

Mivel az MQTT egy **broker-alapú** protokoll, a Bitek és Egész számok felhasználhatók még arra is, hogy:

* Eszközöket kapcsoljanak össze **több CU között**
* Indítsanak inter-CU eseményeket
* Szinkronizálják a helyiségek vezérlését (hotel, kereskedelmi vagy lakossági)

Ez nagyon egyszerűvé teszi a rendszerek közötti integrációt.

## **Fontos megjegyzések és legjobb gyakorlatok**

* Használd **MQTT Explorer** annak ellenőrzésére, hogy a CU közzéteszi-e az értékeket.
* A Bit leképezéseknek meg kell egyezniük **iDM**, **MQTT**, és **SkyPlatform**.
* Ha egy Bit nem reagál, ellenőrizd:
  * Hibás index
  * Hibás eszközazonosító
  * Az egység nincs kiválasztva exportálásra az iDM-ben
  * Helytelen MQTT hitelesítő adatok
