# Szálloda-szoba objektum
### Bevezetés
A **Hotel-szoba objektum** egy **virtuális eszköz** a CU3 központi egységen belül.
* Kifejezetten arra tervezték, hogy **szállodai és vendéglátóipari projektekhez**.
* Összegyűjti az összes **vendég-, szoba- és klímafunkciót** egyetlen objektumba.
* Az információ automatikusan elérhető **a recepciós szoftverek, PMS (Property Management Systems) és BMS (Building Management Systems) számára**.
A Hotel-szoba objektummal már nem kell külön kezelni több eszközt vagy jelet – minden **egy helyen egyesítve van**.
### A Hotel-szoba objektum előnyei
* Több tucat jel külön konfigurálása helyett (foglaltság, Ne zavarjanak, takarítás, HVAC beállítás, ventilátorsebesség stb.) az összes érték **egy objektumban összesítve van**.
* PMS/BMS integráció esetén a rendszernek csak fel kell iratkoznia **szobánként egy MQTT témára**, ami minimalizálja a bonyolultságot és a hibákat.
* A takarítási szolgálat azonnal látja **a MUR és DND jeleket** a PMS-ben → nincsenek felesleges szobalátogatások.
* A karbantartó csapatok nyomon követhetik **a HVAC teljesítményét** (hőmérséklet, páratartalom, szelepállapot) távolról.
* A recepció rendelkezik **valós idejű láthatósággal** a vendég jelenlétéről, riasztásokról és jelenetekről.
* Kevesebb manuális folyamat → **alacsonyabb személyzeti költségek és nagyobb hatékonyság**.
* Egyaránt jól működik **kis butik hotelek esetén** vagy **nagy, több épületből álló üdülőhelyeknél**.
* Minden CU3 több Hotel-szoba objektumot is képes kezelni, és minden objektumnak ugyanaz az interfésze.
* A szállodák szabadon használhatják az iNELS Hotel Reservation Software (iHRS) szoftvert vagy csatlakozhatnak **harmadik fél PMS/BMS rendszereihez**.
* A nyílt MQTT/JSON interfész biztosítja a kompatibilitást **felhőalapú platformokkal, egyedi műszerfalakkal vagy mobilalkalmazásokkal**.
### 2. Fő jellemzők
* **Vendég- és szobaállapot** → Foglaltság, Ne zavarjanak (DND), Takarítás szükséges (MUR), inas/szolgáltatás hívása.
* **Klímavezérlés** → Aktuális hőmérséklet, páratartalom, harmatpont, beállított értékek, korrekció.
* **HVAC vezérlés** → Mód, terv, ventilátorsebesség.
* **Szoba események** → Ajtó/ablak állapot, kártya események.
* **Jelenetek** → Üdvözlő jelenet + 5 testreszabható szobajelenet.
* **MQTT integráció** → Szobánként egy téma, JSON tartalom a könnyű PMS/BMS integrációhoz.
* **Kétirányú** → Mindkettő **állapot olvasása** és **vezérlés írása** támogatott.
### 3. Paraméterek az iDM-ben
A Hotel objektum elérhetővé tételéhez a legújabb iDM verzióra van szükség a projektben. Szükséges továbbá a CU firmware-ének frissítése is.
Amikor hozzáad egy **Hotel-szoba objektum** elemet az iDM-ben, ezt fogja látni:
* **Cím**: Az objektum egyedi azonosítója a CU3-ban
* **Név/Leírás**: A projekt dokumentációjához
* **Szoba-azonosító (Room-ID)**: Numerikus érték (0 – 65535) → összekapcsolja az objektumot a szobaszámmal
### 4. Eszköz struktúra
A Hotel-szoba objektum a következő adatpontokat tartalmazza:
#### Vendég- és szobaállapot
* **Foglaltság** → Vendég a szobában (igaz/hamis)
* **DND** → Ne zavarjanak
* **MUR** → Takarítás szükséges
* **Inas** → Szolgáltatás hívása
#### Klímavezérlés
* **Aktuális hőmérséklet**
* **Kívánt fűtési beállítás (setpoint)**
* **Kívánt hűtési beállítás (setpoint)**
* **Korrekció** (kalibrációs eltolás)
* **Páratartalom**
* **Harmatpont**
#### HVAC vezérlés
* **Vezérlés** → Fűtés / Hűtés / Ki
* **Vezérlési mód** → Terv / Kézi / Eco / Száraz stb.
* **Vezérlési terv** → Alap / Nyaralás / Ünnepnap
* **Ventillátor sebesség** → Alacsony / Közepes / Magas / Auto / Ki
#### Szoba események
* **Ajtó állapota** → Nyitva/Zárva
* **Ablak állapota** → Nyitva/Zárva
#### Jelenetek
* **Üdvözlő jelenet**
* **Jelenet 1 – Jelenet 5** (testreszabható)
### 5. Kapcsolódás az iDM-ben
* Adjon hozzá egy **Fűtés- és hűtésvezérlő (HCA)** a **Rendszermenedzserben**.
* A **Kapcsolatok**, válassza ki a **Hotel-szoba objektum**.
* Az iDM automatikusan létrehozza a belső vezetékeléseket a Hotel-szoba objektum és a HCA között.
* A klíma bemeneti adatait automatikusan beköti a HCA-hoz. Például: Aktuális hőmérséklet, Kívánt fűtési beállítás, Kívánt hűtési beállítás, Korrekció (kalibrációs eltolás), Páratartalom, Harmatpont
{% hint style="warning" %}
**Fontos**: A HCA kimeneteit (ventilátorszabályzó, szelep szabályzó) továbbra is be kell vezetni a **fizikai kimeneti relékhez vagy analóg kimenetekhez** amik szabályozzák a HVAC berendezéseket.
{% endhint %}
### 6. MQTT integráció
#### Téma struktúra
* **Állapot (publish)**
```
inels/status//Hotelroom/
```
* **Set (subscribe)**
```
inels/set//Hotelroom/
```
#### Példa státusz payload
```json
{
"timestamp": "2025-08-25T18:45:52Z",
"room_id": "1",
"occupancy": false,
"dnd": false,
"mur": true,
"buttler": true,
"temperature": {
"current": 23.5,
"set_heat": 22,
"set_cool": 24,
"correction": 1
},
"humidity": 55,
"dew_point": 14.8,
"control": "Heat",
"control_mode": "Plan",
"control_plan": "Base",
"fan_speed": "Low",
"door_status": "Closed",
"window_status": "Closed",
"scenes": {
"welcome_scene": true,
"scene_1": false,
"scene_2": true,
"scene_3": false,
"scene_4": true,
"scene_5": false
}
}
```
***
#### Példa Set (beállítás) payload
```json
{
"dnd": true,
"mur": false,
"buttler": false,
"temperature": {
"set_heat": 21,
"set_cool": 24,
"correction": 0
},
"control": "Cool",
"control_mode": "Manual",
"control_plan": "Holiday",
"fan_speed": "Auto",
"door_status": "Closed",
"window_status": "Closed",
"scenes": {
"welcome_scene": false,
"scene_1": true,
"scene_2": false,
"scene_3": false,
"scene_4": false,
"scene_5": true
}
}
```
### Payload referencia
#### Ventillátor sebesség
| Kulcs | Név | Leírás |
| ----- | -------- | --------------------------------------- |
| 0 | Alacsony | Ventilátor alacsony sebességen |
| 1 | Közepes | Ventilátor közepes sebességen |
| 2 | Magas | Ventilátor magas sebességen |
| 3 | Auto | Automatikus ventilátorsebesség-vezérlés |
| 4 | Ki | Ventilátor kikapcsolva |
#### HVAC vezérlés
| Kulcs | Név | Leírás |
| ----- | ----- | -------------------- |
| 0 | Hűtés | Hűtési mód aktív |
| 1 | Fűtés | Fűtési mód aktív |
| 2 | Ki | Rendszer kikapcsolva |
#### HVAC módok
| Kulcs | Név | Leírás |
| ----- | ----- | -------------------- |
| 0 | Hűtés | Hűtési mód aktív |
| 1 | Fűtés | Fűtési mód aktív |
| 2 | Ki | Rendszer kikapcsolva |
Vezérlési módok
| Kulcs | Név | Leírás |
| ----- | ---------- | --------------------------------------------- |
| 0 | Terv | A ütemezett terv követése |
| 1 | Kedvenc1 | Felhasználó által meghatározott kedvenc mód 1 |
| 2 | Kedvenc2 | Felhasználó által meghatározott kedvenc mód 2 |
| 3 | Kedvenc3 | Felhasználó által meghatározott kedvenc mód 3 |
| 4 | Kedvenc4 | Felhasználó által meghatározott kedvenc mód 4 |
| 5 | Ventilátor | Csak ventilátor mód |
| 6 | Eco | Energiatakarékos mód |
| 7 | Kézi | Kézi felülírás mód |
| 8 | Száraz | Párátlanítási mód |
#### Terv vezérlési módok
| Kulcs | Név | Leírás |
| ----- | -------- | -------------------------------------------- |
| 0 | Alap | Alap (alapértelmezett) terv |
| 64 | Nyaralás | Nyaralási terv |
| 128 | Ünnepnap | Ünnepnapokra vonatkozó terv (speciális eset) |
