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:
- a result line β Pass β 8/8 confirmed, or how many were not, or that a device was not put back β with the room, the time, whether the devices were simulated or live, and the slowest command;
- findings in plain sentences, most urgent first β for example a device that accepted a command but never changed, one that did not go back to its original setting, or one that answered slower than a second;
- Per-device round-trip β for each device the time its command took (minimum, average, maximum) as a bar that is green under a second, amber under three and red above;
- Every command (open it to see it) β what was sent, whether the device accepted it, whether the device itself reported the new value, how long that took, and whether the original was put back.
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:
- The number at the left is the device's place in the room as guest apps receive it (1, 2, 3 β¦). A disabled device shows a dash β no app gets it, so it takes no number.
- The device's icon is a switch for how much of the device guests see. Click it to go visible β hidden β disabled β visible. Hidden devices still work here but are not listed for guests (the icon is grey with a mark); disabled devices are not served to guests at all and have no controls (dashed grey line) β the line stays so you can turn it back on. Hover over the icon to see which it is.
- Click the name to rename it. Its address (used by apps) follows the name.
- The tag chip shows how many tags the device carries; hover to see their names. Click it for the whole tag list: ticked tags are on the device (first tag first) β click one to take it off, click another to add it, or type a new name to create a tag.
- The small circular arrow reads the room; ms shows how long the last command took (amber over a second, red over three).
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.
- Simulated β commands change a virtual room that lives in memory; nothing reaches the building. This is how every site starts, and it is safe for training and testing. The virtual room goes back to its start when idle.
- Live β commands move the real lights, curtains and thermostats. Rooms shows a Live building warning: check the room is empty first.
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:
- 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;
- reads the device back and checks it really changed (it waits a few seconds for a slow device);
- 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:
- It runs only when you press it; there is no automatic schedule yet.
- Rooms with a guest are not tested, and neither is a room whose Do Not Disturb is already on. Devices whose value cannot be read are skipped, because there would be nothing to put back.
- Curtains are not moved unless you tick Also move the curtains.
- With live devices you must first tick I understand this sends test commands to real devices. Simulated sites need no confirmation.
- Each test is kept as a report under History β Test reports, and rooms whose latest test failed count in the number on the History menu item.
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.
- The scents a diffuser can give depend on the capsules inside it; the screen offers only those. A scent the capsules do not allow is refused with the list of the ones that are.
- Deepscent does not report which scent is playing, so the screen shows the last one chosen here or from a guest's phone.
- A diffuser that is not connected to Deepscent (the cloud) is shown with a warning.
- Deepscent needs its own credentials in the project (the integration is set up once by whoever runs the platform, like SE). Until then diffusers on a live site show as "not connected" and cannot be controlled; simulated sites work without.
- Check-out switches a room's scent off, so the next guest is not met by the previous guest's scent.
Adding and editing a device
- 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.
- β― β 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:
- Name β renaming gives the device a new address. Apps that stored the old address must use the new one.
- Enabled β off means guests do not have the device at all (broken or removed). Its references are kept for when it comes back.
- Hidden from lists β guests do not see it in their list, but scenes still control it (for example a cove light).
- Tags β tick the tags that apply.
β― β 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.
- 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.
- 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.
- 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.
- 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.
- Save a room as a template β pick a room that already has its devices, give the template a name, and press Save.
- Open a template to see its devices and the SE points they use. Remove a device from a template, Rename or Delete the template. None of this changes rooms that were already set up from it.
- Import from another site copies a template from a hotel you manage. It works wherever rooms expose points with the same names.
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.
- 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.
- 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.
- 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.
- 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.