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

<figure><img src="/files/97d0c69ca0d3761288e9b13e7ef84b719eee3ec5" alt=""><figcaption></figcaption></figure>

### 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.&#x20;

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

<figure><img src="/files/5f6dc5d2099e8c6b45a28f8944c6a845b1b88055" alt=""><figcaption></figcaption></figure>

* 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/<CU3_MAC>/Hotelroom/<HotelRoom_Address>
  ```
* **Set (subscribe)**

  ```
  inels/set/<CU3_MAC>/Hotelroom/<HotelRoom_Address>
  ```

#### 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&#x20;

| 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&#x20;

| 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) |


---

# 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/inels-design-manager-idm3/hotel-szoba-objektum.md?ask=<question>
```

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.
