Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The retrieved information from Kaba is stored as Server Items. Each retrieved field from the web service request is stored as one server item. Regardless which fields are selected within the Messenger LENS interface, all fields are always shown within the NETx BMS Server. However, only 5 Server Items are counted to the license for each defined device. All other items are not counted to the license and are thus for free.

The most important information is the "Event ID" and "Event Name" which indicate the event type. This information can be linked to an XLogic command or LUA task in order to trigger some actions like changing a data point (e.g. trigger a lighting scene). The following table gives an overview of all events:

Event IDEvent Name

 

Date time Error
 Date time OK
42Deadbolt reset (retracted)
26Deadbolt / Privacy
4
Door ajar clear or Door Secure
 Door ajar Generic
41Door Ajar Guest Long
 Door Ajar Guest Short
 
Door Ajar Staff Long
 Door Ajar Staff Short
 Door Latched
 Door Unlatched
17Generic Egress
 Guest Key Used
8195Hub status OFFLINE
8194Hub status ONLINE
 Key Error - Canceled Key Used
66Key error - Expired
 Key Error - Other
 Key error - Wrong Room
55Lock status OFFLINE
54Lock status ONLINE
 Low battery
 Low Battery Clear or Battery Normal
 Mechanical Key Override
 New Guest Key Used
 Paging Keys
 Staff Key Used
 Standing Intruder
 Transaction Failed
 Wandering Intruder

...

Data points for each room

  • BuildingNumber (read only)
  • LevelNumber (read only)
  • RoomNumber (read only)
  • Description (read only)
  • GuestsCount (read only)
  • GuestName (read only)
  • GuestLanguage (read only)
  • GuestVIP (read only)
  • RoomChecked (read only)
  • ClassOfService (read only)
  • DoNotDisturb (read only)
  • RoomStatus (read and write)
  • ClearText (read only)
  • GuestArrivalDate (read only)
  • GuestDepartureDate (read only)
  • PrinterPort (read only)
  • MessageCount (read only)
  • NextMessage (write only)
  • MessageText (read only)
  • GetMessage (write only)
  • SendMessage (read and write)
  • MessageLightStatus (read only)

Room status

CodeRoom status
1Dirty/Vacant
2Dirty/Occupied
3Clean/Vacant
4Clean/Occupied
5Inspected/Vacant
6Inspected/Occupied

These are the predefined room states that are available within Fidelio/Opera. However, it is possible to specify additional room states for additional functionality. For example, further states for "Do not disturb" or "Make up room" can be defined. Using this additional room states, it is possible  to send additional information from the BMS to the Fidelio/Opera system. A typical use case is to add a KNX switch for DND that sends a user-defined room status (e.g. 7 "DND) to the Fidelio/Opera system. These additional room states have to configured within Fieldio/Opera by the Fidelio/Opera integrator.