IoT Manager

IoT Manager is for the room devices β€” lights, thermostats, curtains, courtesy panels (Do Not Disturb, Make Up Room), occupancy sensors and scent diffusers. Its menu follows the IoT Simulator's manager portal (Rooms, Provisioning, Settings β€” called IoT settings here), plus Device status for the state and history of every device; the portal's Dashboard is the console's own Dashboard. It is used by engineering. You need the Devices area β€” see Areas and roles, and the rooms' template must have Room controls ticked in Features & rooms. Until the site is connected to a building system (GRMS), the IoT Manager menu has only Connect a building system, which opens Settings β†’ Integrations β†’ Building systems; its pages say the site has no room devices yet. For the order to set up a whole site, see Setting up a site.

Menu Tabs For
Device status Status Β· Test reports Β· Checks & commands Every room device now and each room's last 24 hours; what each Batch test found; device checks and commands over time
Live rooms (the room button at the top of the screen) Read and control one room now β€” with Live, Batch test and Preset buttons
Provisioning Devices Β· Discovery Β· Room Templates Β· Room types Β· Roll out Set up rooms and their devices (which building devices belong to which room: Settings β†’ Property β†’ Rooms & floors)
IoT settings Presets Β· Tags Β· Sites Β· Discovery Scene values, the tag list, the building connection, the automation server

Dashboard and History

Room checks

Every 15 minutes every room with devices is read from the building system (read only β€” nothing is switched). A room that cannot be read opens an issue on the Dashboard; it closes by itself when the room reads again. The Dashboard's Room devices panel shows the totals β€” OK, Slow, Failing, Not checked β€” and Device status shows each room. Its menu item carries a number when something is wrong: rooms whose latest check or batch test failed and commands that failed in the last 24 hours. Without Room devices (IoT) in the site's service package, rooms are not checked and the IoT Manager is hidden.

Device status

Device status has three views.

Status (the default) shows every room device at once: how many devices are set up (by type), how the rooms did in the last 15-minute check β€” OK, Slow, Failing, Not checked β€” how fast the building system answers, and when the last check ran. Below, one row per room: its devices, its state now (with the error if it failed), a bar of the last 24 hours (one mark per check β€” green in time, amber slow, red failed; point at a mark for the time and result), the share of checks that passed, and the response time. The Dashboard's Room devices panel shows only the totals and links here.

Test reports shows one report per Batch test, newest first β€” like the IoT Simulator's Test Reports. A report that has problems opens by itself. Each report has:

Filter by room, or tick Problems only.

Checks & commands lists device checks and commands, newest first, so you can look back when something went wrong: when did the room stop answering, and what was happening around it. Tick Problems only to see just the failures. Every command shows the room, the device and value, how long it took, and how it ended. Command records are kept for 14 days and check records for 30 days.

Rooms

Live rooms

Rooms shows one room's devices as they are now and lets you control them. Next to the title is the room button (Room 101 β–Ύ): click it for the rooms that have devices, grouped by room type, with a search box β€” type a number and press Enter to open the first match. Pick a room and its devices appear as a list, one device per line. The room you looked at last is opened next time.

Above the list:

Button What it does
Refresh (circular arrow) Reads the room from the building now
Live / Stop Follows the room: it is read again every 5 seconds, and the room shows a green dot in the list. Off by default β€” otherwise the room is read only when you ask
Batch test Tests every device in this room, with a preview, a progress bar and a result table β€” see Batch test
Preset Saves what the room is doing right now as a scene β€” see Saving a preset from a room

Each line works like the IoT Simulator's:

Blocks. Devices whose first tag is the same are gathered in a block named after the tag β€” Bedside Lamps, Main lights. The block's head has its own controls for all of them at once: On / Off for every device in the block that switches, and Brightness for the ones that dim (it is not shown if none do). Hover over a control to see how many devices it moves; if some do not answer, the message says how many did (4 of 6 answered). The arrow opens and closes a block.

Order. Drag a line by its handle (left edge, shown on hover) to put it where you want it, or drag a block's handle to move the whole block. With the keyboard, focus a handle and press ↑ / ↓. Drop a device on another block to move it there β€” that tag becomes its first tag. To take a device out of a block, take the tag off with the tag chip. The order is saved at once, and guest apps receive the room in this order (see the Client API). Devices that have not been placed β€” a device added later, say β€” come at the end.

Device Controls
Dimmable light On / Off and a brightness slider β€” the command is sent when you let go
On/off light On / Off
Curtain Open / Close buttons
Courtesy panel Off Β· MUR (make up room, amber) Β· DND (do not disturb, red) Β· STC (skip the cleaning, purple)
Thermostat On / Off, βˆ’ / + for the setpoint (the room temperature is beside it), and fan buttons Auto Β· Low Β· Mid Β· High on a line of their own
Occupancy sensor Shows Occupied or Vacant
Scent diffuser Off / On, and a list of scents from its capsules; a warning if it is not connected

Turning a light on returns it to its last brightness, or full if it was at 0. A device that is disabled has no controls; one with no reading needs its vendor references checked in Provisioning β†’ Devices. You need the Operations or Devices area at Operator or above to send commands.

Commands and their results are listed under History.

Saving a preset from a room

Set the room the way you want it β€” lights at some level, the thermostat, the curtain β€” then press Preset. The dialog lists what will be saved (every controllable setting of every enabled device that has been read), lets you pick a scene name (bright, dimmed, cool, … or a new name) and, if that scene already has values in this room, choose to overwrite it or keep it and save under a new name. Settings that have not been read yet are left out and named. The scenes are the ones edited in IoT settings β†’ Presets.

Result Meaning
ok The building did it. A note says if it answered late
timeout No answer in time, and the device does not hold the new value
unknown No answer in time, and the device could not be read to check
error The building refused the command

History is kept for 14 days.

Simulated and live

A site's devices are either Simulated or Live.

A Devices admin switches a site in IoT settings β†’ Sites β†’ Edit β†’ Devices. If a site is set to Live but the IoT service has no building credentials yet, it keeps running simulated and Rooms says so. A room that has no SE space (see Provisioning β†’ Rooms) also stays simulated when the site is Live β€” there is nothing in the building for it to reach β€” and Rooms says that too. That is how the demo room 633 keeps working next to real rooms.

Batch test

Batch test checks that devices really respond. Open a room in Rooms and press Batch test: you see a preview of what will be done, then press Run batch test, watch the progress bar, and get a result table with Run again. To test several rooms, run it in each of them. For every device it:

  1. sends a small test change β€” a light's level moves 20 points, the thermostat's setpoint half a degree, a light switch flips, the courtesy panel goes to Do Not Disturb;
  2. reads the device back and checks it really changed (it waits a few seconds for a slow device);
  3. puts the original setting back and reads it once more to be sure.

Every room ends up as it started. If a device does not return to its original setting, that is shown in red as NOT restored β€” the most urgent kind of problem β€” and it stays in the count on the menu until a later test passes; set it back by hand in Rooms.

Good to know:

Provisioning

Rooms

The Rooms tab of Provisioning is the site's room list β€” the same screen as Settings β†’ Property β†’ Rooms & floors: create, rename and delete rooms, and give each room its SE space and device group. TV Manager and IoT Manager share it because both hang off rooms.

Devices

Devices lists the room devices of the site: lights, thermostats, curtains, courtesy panels (Do Not Disturb, Make Up Room), occupancy sensors, and scent diffusers. Pick a room, or see all rooms. Needs attention shows devices that are disabled or not fully mapped.

Column Meaning
Device Its name and its address (for example 632_desk-lamp) β€” what apps use to reach it
Vendor references Mapped β€” every required point has a reference Β· Partly mapped β€” some are missing Β· Not mapped β€” none yet
Tags What the device is for, or which devices form one control
State Enabled or Disabled, and Hidden

Each hotel's devices come from its building management system. Adding one here does not create anything in the building β€” it records how to reach what is already there.

Scent diffusers

A scent diffuser is not reached through SE but through Deepscent, which knows each diffuser by a device id (for example lounge_08D1F91AC360). Add the device as a Scent diffuser and enter that id as its Deepscent device id β€” one id covers both switching it on and choosing a scent. Two diffusers in a room are two devices.

Adding and editing a device

  1. Add device β€” choose the room and type, and give it a name, such as Desk Lamp. Its address is made from the room number and the name.
  2. β‹― β†’ Edit β€” enter its vendor references: the building management system's id for each point, and its path. A dimmable light has one point (its level); a curtain has a control and a state point; a courtesy panel has three (Make up room, Do not disturb, Skip cleaning); a thermostat has one per setting. Points marked * are required. Clearing a reference unmaps that point.

In the same dialog:

β‹― β†’ Remove deletes the device with its references, tags, and scene values.

The same reference may be used in several rooms β€” useful when one set of test devices is shared.

The tag list itself is kept in IoT settings β†’ Tags.

Discovery

Discovery finds a room's devices in SE (the building automation system) so you do not type references by hand. It needs the Devices area, Operator or above. A scan only reads SE β€” nothing changes until you press Apply.

  1. Pick the Room and press Scan SE. The scan lists SE's buildings, floors and spaces (a space is what SE calls a room). If the room is already linked to a space, that space is chosen for you.
  2. Choose the Building, Floor and Space. The screen reads the space's points and groups the ones it recognises into devices: lights, curtain, thermostat, courtesy panel, occupancy sensor.
  3. Review each device. New devices are ticked and can be renamed; Different means the room already has a device of that name whose SE points are not the ones SE reports now (it is re-mapped, keeping its name, tags and scenes); Already mapped needs nothing. A device with a required point missing is left unticked, because it would not work.
  4. Press Apply. Devices are created or re-mapped, and β€” if you leave the boxes ticked β€” the room is linked to the SE space and to the device group its points belong to.

Below the devices, Other points lists what nothing recognised. That is usually right: most of SE's points are plant, energy and scene points, not room devices. Tick Show every point to see all of them, including points on other servers. No longer in SE lists references the room still has that SE stopped reporting; they are never removed automatically.

The server the hotel uses is chosen in IoT settings β†’ Discovery; points on other servers are hidden here by default.

Names you gave devices in other rooms are reused: a point with the same SE name as one already mapped elsewhere is suggested with the name you chose there.

Room Templates

A Room Template saves the devices of a tested room: what each device is, its name, whether it is hidden or off, its tags and any scene values you changed β€” and which SE point each device uses, by name. Point ids differ from room to room, but rooms of the same kind expose points with the same names, so another room can be matched automatically.

Room types

Provisioning β†’ Room types links each room type (for example Deluxe or Suite) to the IoT template its rooms are set up with, and shows for each type how many of its rooms have devices and how many were set up with that template. Choose the template in the IoT template column (it is saved at once β€” the same setting as in Settings β†’ Property β†’ Rooms & floors β†’ Room types). Changing it does not touch rooms already set up; press Roll out on the type to set its rooms up with the template. A type's devices are also what a guest can choose before arrival.

Roll out

Roll out gives a template to several rooms at once.

  1. Choose the template β€” one template for every ticked room, or From each room's type to give each room its type's IoT template (rooms whose type has none show set it and cannot be ticked). Roll out on a room type opens this screen in that mode with the type's rooms ticked. Press Scan SE and choose the building.
  2. Each room is matched to the SE space with the same name (Room 0101 matches room 101). If a name matches more than one space, or none, the room is left for you to pick the space. Rooms that already have devices are unticked.
  3. Press Read for the ticked rooms. For each room you see how many of the template's devices were found; anything missing is listed by SE point name, and SE points the template does not know about are mentioned too.
  4. Press Apply. Rooms are linked to their SE space and device group; devices are created with the template's names, tags and scene values. A device whose required point is missing is skipped and reported, never created half-working. Devices a room already has are re-mapped but keep their names and settings.

Then run a Batch test in a room, and after the next 15-minute check see in Device status that every room answers.

IoT settings

Presets

Presets holds each device's scene values: Bright and Dimmed for lights, Cool, Neutral, and Warm for thermostats. Every device follows its type's defaults until you change one of its values β€” changed values are marked custom. Reset to defaults makes it follow the defaults again.

Type Scene Default
Dimmable light Bright Β· Dimmed 100 % Β· 50 %
On/off light Bright Β· Dimmed On Β· Off
Thermostat Cool Β· Neutral Β· Warm 20 Β°C Β· 22.5 Β°C Β· 25 Β°C, power on, fan Auto

Values outside what a device accepts (for example a level above 100) cannot be saved.

Tags

The Tags tab holds the site's tag list. A tag says what a device is for (Reading lights) or which devices belong together as one control. Its name is what guests read, and can be changed at any time. Add tag creates a new one; Delete removes it from every device that carries it. A tag is put on a device when you edit the device in Provisioning β†’ Devices, or with the tag chip in Rooms. A device's first tag decides which block it is shown in on the Rooms screen.

Sites

The Sites tab holds the hotel's connection to its building system: the time zone (for housekeeping times and daily reports), the SE device group new rooms are addressed through, and whether the devices are Simulated or Live (see Simulated and live). Only a Devices admin can switch to Live. The building system's account is not kept here β€” each site connects its own in Settings β†’ Integrations β†’ Building systems β†’ Schneider Electric.

Discovery

SE can show the same physical point through more than one automation server (for example ES HQ and Automation Server), and only one of them works β€” mapping the wrong one gives a room that looks complete and controls nothing. List the server(s) your hotel uses, in order. Points on other servers are then hidden by default and never suggested. Leave it empty if your SE only shows each point once.