Create Hotel Job File

The System Engineer produces a hotel master job file by adding the floor gateways, room profiles, mockup room jobs, room alerts, and room mapping.

To use the Multiroom Dashboard and API with your mockup room, you must create a hotel job with at least one room and install a licensed copy of Multiroom System Manager. Later when on-site, the System Engineer will use this hotel job file to complete the hotel configuration during acceptance testing.
Configure hotel job:

  1. Add floor gateway

  2. Add global areas to the hotel job

  3. Add room profiles, zones, and services and enter the required properties

  4. Define and add Room Alerts

  5. Import mockup room job to room profile

  6. Place devices and channels in zones

  7. Configure notional energy

  8. Configure DDRC-GRMS-E

  9. Create device hex files

  10. Add room mapping to create the initial Hotel Master Configuration

  11. Install System Manager and configure integrations to test all features

Project reference tools

  • Mockup room sign-off sheet (release for manufacturing)

  • Mockup room job files

  • Hotel Job file

  • Room Controller IP address table (not required if using Dynamic IP addresses)

  • Floor Gateway IP address table

  • DIP switch settings table

  • Site private key text file (must be kept secure)

Add floor gateway

Each floor gateway is configured with a unique IP address and floor offset (physical and logical address range), for example, 1000, 2000, 3000 etc. A global logical range is also added to all gateways (areas 65000 – 65005) for logical messages to all rooms.

The Ethernet connections between SM, PDDEG-S, and DDRC-GRMS-E are secured via TLS encryption.

Disable the UDP default multicast, unicast, and all other unnecessary protocols and ports before handing over the system to the customer. This is performed automatically when selecting the “Hotel Floor Ethernet Gateway” or “Hotel Room Ethernet Gateway” options in the Bridge Configuration Wizard.

For more information on making the system more secure, please refer to the Ethernet Gateway Commissioning Guide.
Default port numbers for Ethernet enabled devices

  • Secure

    • Port 443 for Trunk connections (System Manager - Floor Gateway)

    • Port 50443 for Floor connections (Floor Gateway – Room Controller)

  • Unsecure

    • Port 50000 for Trunk connections (System Manager - Floor Gateway)

    • Port 50003 for Floor connections (Floor Gateway – Room Controller)

Add a floor gateway to the job:

  1. Click File > New and select sb icon new empty job New Empty Job (Ctrl+N).

  2. Enter the Hotel details in the Job Properties Editor.

  3. Click sb icon save file File Save As > Save As Job File to save the Hotel job to your PC.

  4. Connect SB via an Ethernet cable and TCP/IP address to the PDDEG-S, or via a USB cable and PC Node to the serial port.

  5. Click sb icon insert from network Insert Devices from Network (Ctrl+L) and select sb icon discover network Discover Network > Discover Devices over Ethernet or search for the Ethernet gateway, or press the service switch. The gateway appears in the Discovered Devices window.

  6. Click sb icon add and load Add and Load Devices to add the gateway to the job from the Discovered Devices window. This loads the default device configuration, admin password, and properties.
    sb add load pddeg s

  7. Click sb icon save to device Save to Device.

  8. Click sb icon save file File Save to save the job to your PC.

Create and upload the gateway certificate

A Site CA Certificate (Site Private Key) must be first be created or imported into SB. The Site CA Certificate is then used to sign and upload a Device Site Certificate to the PDDEG-S gateways. When SB has a Site CA certificate, it shows a sb icon ca cert green lock icon at job level in the System and Building views.

SB shows a sb icon ca cert green lock icon next to an PDDEG-S or Ethernet device when a Device Site Certificate has been uploaded. This enables SB/SM and Ethernet devices to securely connect to the PDDEG-S gateways via a secure TLS TCP connection.

If the lock icon on an EG shows a sb icon ca cert warning warning icon, then check the tooltip as it will indicate either:

  • Device site certificate configured but Site CA used to sign the device site certificate is not found on this machine. System Builder will be unable to securely connect to this device. Ensure correct Site CA certificate is imported into this machine with the Tools menu, Set Site CA Certificate option.

  • Device site certificate configured but doesn’t match Site CA configured in job. System Builder will be unable to securely connect to this device. An updated device site certificate should be signed and uploaded to the device.

Create/import site CA certificate:

  1. From the Tools menu, select sb icon manage certificate Set Site CA Certificate to open the Site Certificate Selection window.

  2. If starting a new job, click the Create button to create a new site certificate.

    1. After creating a new site certificate, you will be prompted to Export the site certificate and save it in a secure location.

    2. For additional security when exporting the site certificate, you must enter a password. This password will be required by anyone importing the site certificate into another machine.

  3. If someone has already started commissioning any of the devices and already created a site certificate, they will need to export the certificate from their machine. You can then import the site certificate to any machines used to commission or connect to secure Ethernet devices.

sb site certificate create
The Site CA certificate is stored in your machine, not in the job file. To allow another machine to commission the same site you must securely send the job file, the Site CA Certificate, and the password.
Having a lock icon in SB, a gateway, or a device simply means you have created and uploaded a certificate. You still need to configure the secure connections (with the Bridge Configuration Wizard) and save to device before you can connect securely.
The certificate placed in SM, the PDDEG-S, and the DDRC-GRMS-E must be signed by the same Site CA Certificate.
The certificate can be uploaded over a TCP/UDP or serial connection.
Create and upload certificate to the floor gateway:

  1. Right-click the floor gateway in System view and select sb icon manage certificate Manage Certificate.

  2. Select Certificate Type > Device Site Certificate for TLS Connections.

  3. Click the Create and Upload button. After a minute or two, System Builder creates and uploads a signed certificate file to the gateway.

  4. Click the Close button.

sb site certificate upload

Configure the floor gateway connections

We strongly recommend configuring secure connections between System Manager, the PDDEG-S, and the DDRC-GRMS-E.

Configure floor gateway functions:

  1. Right-click the floor gateway in System view and select sb icon bridge wizard Bridge Configuration Wizard (Alt+W).

  2. Select Hotel Floor Ethernet Gateway.

  3. Select Static IPv4 Address and enter IP Address (and Gateway and Subnet mask if required).

  4. Leave Web Server unchecked.

  5. Click the Next > button.
    sb bridge wizard step 1

  6. Under Trunk Connection, select TCP IPv4, Port 51443 and Secure checkbox.
    (For unsecure Trunk Connection, select TCP IPv4, Port 50000)

  7. Under Floor Connection, select TCP IPv4, Port 50443, Secure checkbox, and click the Next > button.
    (For unsecure Floor Connection, select TCP IPv4, Port 50003).
    sb bridge wizard step 2

  8. Click the sb icon add physical range Add Physical Range icon and enter the Offset, Min, and Max values.

  9. Click the sb icon add logical range Add Logical Range icon and enter Offset, Min, and Max values.

  10. Click the sb icon add logical range Add Logical Range icon again and enter Offset = 0 (zero), Min = 65000, and Max = 65005 for the global areas.
    Ignore any popup message boxes.

  11. Click the Next > button.

    An SB Technician License is required to enter an address range without an offset.

    sb bridge wizard step 3

  12. Click the Next > button to accept the default metrics on the spur.
    You can adjust the Polling Interval if required, otherwise proceed to the next step.
    sb bridge wizard step 4

  13. Click the Finish button, then click the Yes button to confirm.

  14. Record the box number and IP address in the Floor gateway IP address table.

  15. Click sb icon save to device Save to Device.

  16. Click sb icon save file File Save to save the job to your PC.

The Hotel Floor Ethernet Gateway option in the Bridge Configuration Wizard disables the default UDP multicast connection when saved to the gateway. This means SB must now connect to the gateway using a secure Ethernet trunk connection.

Add alternative floor gateway

Network gateway redundancy is provided by adding an alternative floor gateway for every primary floor gateway in the project. The two floor gateways must be in different locations to ensure adequate redundancy.

The primary gateway and the alternative gateway are both connected via an Ethernet trunk connection. If a floor gateway fails, then SM and the DDRC-GRMS-E room controller connections will switch over to the other gateway (maximum switchover time is 2 minutes). The current connection is maintained (unless the alternative gateway fails) even if the other gateway comes back online.

Both floor gateways are listed in the job’s master configuration. However, only the primary gateway will show the connected DDRC-GRMS-E controllers in the network device tree. The two gateways should be similarly named and have identical port, routing, and metric configurations. It is recommended to commission the primary floor gateway and then copy the configuration to the alternate floor gateway.

Only these properties differ between the primary and alternative gateways:

  • User settings

  • IP address

  • Box number

Configure network gateway redundancy:

  1. Set Settings > Job Settings > Behavior > Enable network gateway redundancy to True.
    sb gateway redundancy enabled

  2. Copy and paste the primary gateway to create the alternative gateway.

  3. Select the alternative gateway, click Device Properties and set Is alternative gateway to True.
    sb alternative gateway

  4. Open the primary gateway’s Device Properties tab and select the Alternative gateway from the dropdown list.
    sb primary gateway

The security certificate must be uploaded to both gateways.

Additionally, both the primary floor gateway and alternative floor gateway IP addresses must be entered in the DDRC-GRMS-E Gateway Mapping Editor. Refer to Configure gateway mapping.

Add global areas

Global areas are used for system-wide messages to indicate day/night or current season.

Add global areas:

  1. Click the sb icon area Areas View tab.

  2. Click sb icon insert new folder Insert New Folder and name it Global Areas.

  3. Click the sb icon insert new area Insert New Area dropdown list and select Add Specific Area.
    sb add specific area

  4. In the Number field, enter 65000.

  5. In the Name field, enter Day Night Tracking.

  6. Click the OK button.
    sb add area dialog

Add room profiles

Since most hotels have a limited number of room profiles, this eliminates much of the repetition involved in adding rooms with identical configurations. The Room Profiles editor determines which zones, features, areas and services are supported by each room profile. These are displayed in the dashboard and are also available on the API.

The following room profile limitations affect the dashboard room view:

  • 1 service of each type per zone (only 1 wake-up service per suite)

  • 3 items per tile

  • 5 different service types (HVAC, Wakeup Alarm, Door, Blind/Curtain, Lighting)

  • 10 tiles per service

Set up room profiles:

  1. Click sb icon manage room profiles File > Manage Room profiles to open the Room Profiles dialog box.

  2. Click sb icon add Add > Room profile.
    You can also sb icon duplicate Duplicate, sb icon delete Delete, sb icon import Import, and sb icon save file Export room profiles.

  3. With the room profile selected, enter a Name, Description, and Type for easier identification.
    The Type property determines the how the room is grouped and displayed on the dashboard.
    sb room profile features

  4. Enter a Group name if you have many room profiles. This property groups room profiles under submenus in SB > File > Open Room Configurations.

  5. If applicable, select Supports Floor Plan to enable the floor plan drawing to be shown on the dashboard. This is mainly used for public areas and larger suites. Refer to Add a room configuration floor plan.

  6. You can set Display name as description to True to show the Room Description (from the Room Mapping Table) instead of the room number on the dashboard. This is typically used for public areas.

  7. Select the supported room features for your project, e.g. Do Not Disturb, Make Up Room, Laundry Pickup, Service Pickup, Humidity, Temperature for a guestroom. This ensures that only relevant information is displayed on the dashboard’s Room View page. You can also set the Hotel Status Area and Temperature Area to the area numbers reserved for these functions.

    • Default Hotel Status Area = 3

    • Default Temperature Area = 17

  8. Enter the estimated room profile base power in Watts for each room state (this should be estimated by the hotel’s electrical engineer/specifier).

  9. Enter sensor information to allow dashboard users to update occupancy timeouts and AntiStumble nightlight timeouts for each room profile (See Multiroom Dashboard > Room & Suite Profiles).
    Select the number of ceiling sensors and AntiStumble sensors used in your room profile:

    Example

    A suite with:

    • 2 x ceiling sensors (Bedroom + Bathroom)

    • 2 x AntiStumble sensors (Bed Left and Bed Right)

    Would have:

    • Guest Occupancy: 4

    • Staff Occupancy: 4

    • Leaving the Bed Nightlight: 2

    • Returning to Bed Nightlight: 2

  10. Enter each sensor’s Device Code, Box number, and Motion Preset under each applicable category.
    As in the example above, you may need to reenter one sensor’s info under multiple categories. This allows each sensor to support different timeouts under various occupancy and room status conditions. These timeouts are set via the dashboard’s Configuration > Room & Suite Profiles > Room settings.
    sb room profile sensor list

  11. With the room profile highlighted, click sb icon add Add > Zone to create as many zones as the room requires. Each room profile must have at least one zone. You can enter a name for each zone for easy identification. A zone can contain one of each type of supported service:

    • HVAC

    • Wakeup Alarm

    • Door

    • Blind and Curtain

    • Lighting

    Separately serviced areas (such as rooms with their own HVAC units and balcony doors) require a separate zone.

  12. With the zone selected, click sb icon add Add > Service to add each required service to the zone. Enter a name for each service for easy identification. The Name property is displayed in the service’s tile in the dashboard Room View. Use the sb icon up Up and sb icon down Down arrows to reorder the zones and services in the dashboard Room View.

  13. Select each service (refer to the Example Services Properties screenshots below) to configure the Features and logical Areas.

  14. Click the sb icon save file Export button to save a room profile to an editable XML file. This enables profile sharing across multiple sites.
    To load an exported profile, click the sb icon import Import button and follow the prompts.

  15. Click the OK button to save your changes and close the Room Profiles window.

Example Services Properties

HVAC

  • Default Temperature Area = 17

  • Default Fan Area = 17

If using a floor plan for this room profile, select Service > HVAC Service in Floor Plan.

sb room profile hvac in floor plan
sb room profile hvac
Fan Speed Options
Switched 3-Speed Fan Variable 5-Speed Fan Variable 10-Speed Fan

Preset 1 - High
Preset 2 - Medium
Preset 3 - Low
Preset 4 – Auto
Preset 5 - Off

Preset 4 – Auto
Preset 5 - Off
Preset 7 - 20%
Preset 9 - 40%
Preset 11 - 60%
Preset 13 - 80%
Preset 15 - 100%

Preset 4 – Auto
Preset 5 - Off
Preset 6 - 10%
Preset 7 - 20%
Preset 8 - 30%
Preset 9 - 40%
Preset 10 - 50%
Preset 11 - 60%
Preset 12 - 70%
Preset 13 - 80%
Preset 14 - 90%
Preset 15 - 100%
For more information on fan speeds and HVAC profiles, refer to Configure notional energy.

Wake-Up Alarm

  • Default Wake-Up Alarm Area = 3

sb room profile wake up alarm

Door

  • Default Door Area = 3

  • Default Door Channel = 10

  • Default Room Safe Channel = 11

sb room profile door

Blind and Curtain

  • Default Curtain Area = 6

sb room profile blind

Lighting

  • Default Night Lights Area = 5

  • Default Main Room Lighting Area = 10

  • Default Bathroom Lighting Area = 11

Each Dashboard lighting tile supports up to 3 lighting areas, or a Master Lighting Area + 2 lighting areas.
sb room profile lighting

Define and add room alerts

Various room alerts can be specified for each room profile. They are displayed in the dashboard room view and are available on the Hotel Integration API. Each room alert is added to a room profile and applies to either the entire room profile or to a zone within the room profile. To trigger a room alert, the corresponding hardware must first be configured in the room.

Define room alerts:

  1. Click File > sb icon manage room profiles Manage Room Profiles to open the Room Profiles editor.

  2. Click the Room Alerts tab.

  3. Click sb icon add Add and select the required room alert.

  4. Edit the Name, Severity, Minimum Elapsed Time (before the alert is triggered) and the Notification Frequency.
    For Humidity, Soil Moisture, and Temperature, you must enter the Lower Threshold and Upper Threshold values.

  5. Room Alerts can be added more than once with different parameters as required.
    Click the beginning of the row to sb icon delete Delete a room alert. You can also sb icon save file Export and sb icon import Import room alerts to/from an XML file.

sb room profile alerts
Add room alerts to room profile:

  1. Click the Room Profiles tab.

  2. Select the required Room Profile or Zone.

  3. Click sb icon add Add > Alert and the select the required alert. The alert will be grey if it has already been added.

  4. Click the Apply or OK button.

sb room profile add alerts
To enable the Dashboard to identify offline DALI drivers/lamps, DALI drivers must be placed into zones in the room controller’s Outputs editor. Lamp Health must be enabled.

Disabled room devices will:

  • Not be seen in the dashboard room view Alerts and Health page

  • Not be reported as offline

  • Not trigger a Device Offline room alert

  • Not be deployed to as part of a firmware or configuration deployment

  • Have a sb icon device disabled disabled device icon in the SB device tree

Room Alert Descriptions

Guestroom Alerts

Room Alert Description

iah icon device health Device Health

Indicates the online/offline status of room devices after the minimum elapsed time. Requires the Device Online Status metric. To exclude devices, set Device Properties > Device Identification > Room device enabled to False.

iah icon entrance door Entrance Door

Indicates when the entrance door has been left open for the minimum elapsed time. Requires a room controller or DLLI8I8O Entrance Door Dry Contact Input and/or Access Control System message.

iah icon room status Room Status

Indicates the current room status after the minimum elapsed time (requires a UI, Dashboard, or PMS to set the room status):
iah icon do not disturb Do Not Disturb (Privacy)
iah icon laundry pick up Laundry Pick Up
iah icon make up room Make Up Room
iah icon service pickup Service Pickup

iah icon guest well being Guest Well-Being

Indicates that the room has remained occupied but no-motion has been detected for the minimum elapsed time. Default = 24 hours.

iah icon lamp health Lamp Health

Indicates that a DALI driver or lamp is offline.

Zone Alerts

Room Alert Description

iah icon door status Door Status

Indicates when a balcony door has been left open for the minimum elapsed time. Requires a Balcony Door Dry Contact Input.

iah icon fcuc filter dirty FCUC Filter Dirty

Indicates the FCUC filter is dirty after the minimum elapsed time. Requires an FCUC Air Filter Dry Contact Input.

iah icon fcuc drip tray full FCUC Drip Tray Full

Indicates the FCUC drip tray is full after the minimum elapsed time. Requires an FCUC Drip Tray Overflow Dry Contact Input.

iah icon humidity Humidity

Indicates the humidity is below the Lower Threshold value or above the Upper Threshold value for the minimum elapsed time. Requires a Humidity Sensor.

iah icon room safe closed Room Safe Closed

Indicates that the safe door is closed when guest checks in or out. Requires a room controller or DLLI8I8O Safe Door Dry Contact Input.

iah icon soil moisture Soil Moisture[1]

Indicates the soil moisture is below the Lower Threshold value or above the Upper Threshold value for the minimum elapsed time. Requires a Soil Moisture Sensor.

iah icon temperature Temperature

Indicates the temperature is below the Lower Threshold value or above the Upper Threshold value for the minimum elapsed time. Requires a network user interface with temperature sensor.

iah icon water leak Water Leak[1]

Indicates bathroom water leak. Requires a room controller or FCUC Bathroom Water Leak Dry Contact Input.
DALI alerts (Channel offline, Driver/Ballast failure, Lamp failure) do not need to be configured in the Room Alerts editor. Once DALI channels are placed into zones, DALI alerts are automatically displayed in the dashboard. Device Health must be enabled.
Alert notifications are set up after SM installation in the SM Configuration Tool > Site Settings.

Import mockup room job to room profile

After adding room profiles to the job, you can open them from the File > Open Room Configurations menu. Each room profile is linked to a specific room configuration (mockup room). After making changes to a room configuration, click Rebuild Master Job.

sb open room config
The room configuration tree has a light purple background color to show that you are viewing a room profile.
Areas, System, and Building properties are unique in each room configuration, but Job properties are common.
Room profiles that are mapped cannot be deleted. Before deleting, you must first remove the profile from the room mapping table.
Add mockup room job to a room configuration:

  1. Click File > Open Room Configurations and select the required room profile.

  2. Click File > Import System Builder Job…, select the job file, and click the Open button to import the mockup room job file for that room configuration.
    (You can also manually add the mockup room devices and areas to the room configuration).

  3. Click the Test button to confirm that there are no device conflicts.
    If there are device conflicts, you must correct the mockup room job file before importing.

  4. Click the Import button.

  5. Click the Close button, then click sb icon save file File Save ( Ctrl+S ) to save the job to your PC before selecting the next room profile.

  6. Repeat these steps for each room profile in your project.

Place devices and channels into zones

The Dashboard’s Control Center page reports device status by zone. User interface and sensor devices must be placed in the room zone where they are located. For single-zone guestrooms, this can remain as Unassigned (Master).

Place a device into a room zone:

  1. Click File > Open Room Configurations and select the required room profile.

  2. Select the device (UI or sensor).

  3. Click the Device Properties tab.

  4. Under Device Identification > Room zone, click the dropdown list and select the zone.

  5. Repeat steps 1 to 4 for each UI and sensor in your room configuration.

sb device id room zone

DALI controller channels must have a room zone selected. This enables DALI alerts to be identified by their location in the guestroom.

Place a DALI controller channel into a room zone:

  1. Click File > Open Room Configurations and select the required room profile.

  2. Select the DALI controller (the DDBC120-DALI and DDBC320-DALI are supported).

  3. Click the Outputs editor tab.

  4. In the Room Zone column for each lamp driver, click the dropdown list and select the zone.

sb ddbc120 dali outputs
If you have one or more DDBC120-DALI or DDBC320-DALI controllers in a room/suite, the DALI drivers need to be localized using the Multiroom Dashboard. For more information refer to Multiroom Dashboard > Management Luminaires.
For security reasons, the DDBC320-DALI Ethernet port must be disabled.

Add a room configuration floor plan

If you have selected Supports Floor Plan in the Room Profile settings, then you can add a floor plan drawing and associated fixtures and devices to the corresponding room configuration. The floor plan will be displayed within the room view on the multiroom dashboard.

To view the floor plan, the user can open the Monitor & Control tab and click the iah icon floor plan view Floor Plan icon in the top right corner and then select one of the following two views:

  • Service & Health

  • Lights & Devices

Light fixtures and devices need to be placed within a zone in their actual location on the floor plan. However, service and health icons are automatically created and placed in the appropriate zone based on the services selected in the Room Profile > Zone Properties.

The following service and device icons are shown on the dashboard:

Service & Health Lights & Devices

  • iah icon floor plan service lighting Lighting

  • iah icon floor plan service hvac HVAC

  • iah icon floor plan service drapery Drapery

  • iah icon floor plan service doors Doors

  • iah icon floor plan device lights Lights

  • iah icon floor plan device env Environmental

  • iah icon floor plan device drapery Drapery

  • iah icon floor plan device doors Doors

  • iah icon floor plan device occupancy Occupancy
Note that a floor plan drawing must be cropped to only show part of the floor plan for the specific room profile. To crop the floor plan please use relevant software applications that can handle PDF files and vector drawings.
In File > Manage Room Profiles, ensure you have added the zones and required services to each zone before adding them to a floor plan.
Currently, user interfaces are not shown on Multiroom Dashboard floor plans.
iah floor plan service health
Service & Health
iah floor plan lights devices
Lights & Devices
Add fixtures and devices to a room profile floor plan:

  1. Click File > Open Room Configurations and select the required room profile.

  2. Click the sb icon floor plan Show Floor Plan Window or sb icon float floor plan window Float Floor Plan Window icon.

  3. Click the sb icon background image Background Image icon and select a PDF file that has a cropped floor plan drawing showing the room.

  4. On the floor plan toolbar, select sb icon draw zone region Draw Zone Region.

  5. Click and drag a rectangle to draw a zone region for each zone in your room profile.

    sb floor plan draw zone

  6. Enter the zone region name or keep the default name.

  7. (Optional) Select a colour from the colour picker or enter the RGB values and click OK. You can use this to visually group or differentiate zones.

  8. Right-click the zone region to make changes.

    If applicable, you can set a new center point to change the location of the zone label (and service icons on the dashboard). Right-click the zone region and select sb icon set centre point Set Center Point and click in the zone where you want the label to appear.

    You can also add to the zone shape by drawing an adjoining zone and giving it the same zone number.

  9. Drag a service placeholder device from the System View or Building View tree into a zone where it is physically located on the floor plan.

  10. Drag your DDRC-GRMS-E and other controllers onto the floor plan. These are not shown on the dashboard.

  11. Select Building View and click the sb icon expand tree Expand icon to show the DDRC-GRMS-E outputs (physical channels).

  12. sb icon output dragged Drag a physical channel to a location on the floor plan to add a fixture. The icon shows a green plus sign while dragging. You can scale the size of the fixture icon by dragging the red handles.

  13. Right-click a fixture to open the fixture context menu and make other changes to the fixture icon. For example, you can click sb icon edit Edit Properties to select a different fixture profile.

  14. Continue dragging physical channels to each zone until you have added all the fixtures in your room.

    sb floor plan zone fixtures

  15. Right click a controller in System View or Building View and select sb icon save to device Save to Device.

  16. Click File > sb icon manage room profiles Manage Room profiles to open the Room profiles dialog.

  17. Select the room profile and zone for the room configuration with the floor plan.

  18. From the Zone in Floor Plan dropdown list select the zone region that contains the icons for this zone.

  19. Click Apply or OK.

    sb room profiles zone in floor plan

Configure notional energy

Notional energy is calculated per room based on the estimated consumption of each load in the room. This data is presented in the Multiroom Dashboard for reporting, analysis, maintenance, and monitoring. Notional energy values are updated hourly on the dashboard and can be aggregated across the whole hotel or per building/wing as required.

Notional energy properties are divided into three power categories:

  • Lighting

  • HVAC (Heating & Cooling)

  • Base power

Project reference tools:

  • Notional energy load sign-off sheet

Notional lighting power

Notional lighting power uses the estimated maximum load power, channel level, and run-time for lighting circuits to arrive at a notional energy consumption value.

Configure notional power for lighting:

  1. Click File > Open Room Configurations and select the required room profile.

  2. In System view, select a controller and click the Outputs tab.

  3. In the Load (Watts) column, enter the maximum power consumption of the load in Watts for each lighting circuit.

  4. In the Power Category column, select Lighting for each lighting circuit.

  5. Repeat steps 2 to 4 for each controller in the room profile. Ensure that you have included all channels with connected loads.

  6. Click sb icon save file File Save to save the job to your PC.

sb ddrc grms e outputs

Notional HVAC power

Notional HVAC power uses estimated HVAC energy consumption along with recorded run-time to arrive at a notional energy consumption value. It is calculated from the values entered in an HVAC profile based on manufacturer specifications, fan speed, and the difference between the setpoint and actual temperature.

  • If HVAC status is Cooling or Auto, and actual temp is equal to or higher than setpoint, then the HVAC profile valve table is used for the power calculation. If actual temp is lower than setpoint, the first row of the valve table is used.

  • If HVAC status is Heating, the first row of the valve table is used for the power calculation.

  • If HVAC status is Energy Holdoff or Off, then notional power is zero.

Configure notional power for HVAC:

  1. Click Tools > sb icon hvac profiles HVAC Profiles.

  2. Click sb icon add Add to add a new HVAC profile (refer to the HVAC profile example for typical values).

  3. Enter the values in the Cold Valve properties, as provided by the HVAC system consultant.

  4. Enter the values in the Valve table, as provided by the HVAC system consultant.

    • Click sb icon add Add to add another valve settings row.

    • Select a row number and click sb icon insert Insert to add a row above the selected row.

    • Select a row number and click sb icon delete Delete to delete a row.

  5. Select the Fan speed type from the dropdown list (3-, 5-, or 10-speed) and select either Enter fan voltage and current or Enter fan power. Enter the values in the Fan Speed table, as provided by the HVAC system consultant.

  6. Repeat the previous steps process for each HVAC profile used in the hotel.

  7. Click the OK button to close the editor.
    sb hvac profile editor

  8. After creating the HVAC profiles, click File > sb icon manage room profiles Manage Room Profiles and select a room profile > zone > HVAC service.

  9. Select an HVAC Profile for the zone from the dropdown list.

  10. Click the Apply button to save your changes, or OK to save your changes and close the Room Profiles window.

sb room profile hvac select

Notional base power

Notional base power combines the estimated load for each room state (for non-controlled loads such as minibar, coffee machine, TV, permanently powered outlets, etc.), along with the energy consumption and run-time of plug loads connected to switched outputs, to arrive at a total notional energy consumption value.

Base power has two components:

  • Fixed – Load in Watts specified per room state (non-controlled plug loads).

  • Variable – Load in Watts specified for each circuit with Power Category = Power (controlled plug loads).

Configure fixed base power:

  1. Click File > sb icon manage room profiles Manage Room Profiles and select a room profile.

  2. In the Notional Energy group, enter the estimated power consumption in Watts for each room state:

    1. Base Power Checked in & Occupied

    2. Base Power Checked in & Unoccupied

    3. Base Power Checked out & Occupied

    4. Base Power Checked out & Unoccupied

  3. Click the Apply button to save your changes, or OK to save your changes and close the Room Profiles window.

  4. Repeat the previous steps for each room profile.

  5. Click sb icon save file File Save to save the job to your PC.

sb room profile notional energy
Configure variable base power:

  1. Click File > Open Room Configurations and select the required room profile.

  2. In System view, select a controller and click the Outputs tab.

  3. In the Load (Watts) column, enter the maximum power consumption of the load, in Watts, for each power circuit.

  4. In the Power Category column, select Power for each power circuit.

  5. Repeat the previous steps for each controller. Ensure that you have included all channels that have loads connected.

  6. Click sb icon save file File Save to save the job to your PC.

sb ddrc grms e outputs

Configure DDRC-GRMS-E

Create and upload the DDRC-GRMS-E certificate

A Device Site Certificate for TLS Connections must be uploaded to the DDRC-GRMS-E in each room before you can configure a secure connection. To create a Device Site Certificate in the DDRC-GRMS-E, you must first create/import a Site CA Certificate from System Builder Tools > sb icon manage certificate Set Site CA Certificate. Refer to Create and upload the gateway certificate.

The certificate uploaded to SB/SM, PDDEG-S and GRMS-E must be signed by the same Site CA Certificate.
The certificate can be uploaded over a TCP/UDP or Serial connection.
The DDRC-GRMS-E must have a box number.
Create and upload certificate to the DDRC-GRMS-E:

  1. Click File > Open Room Configurations and select the required room profile.

  2. Connect SB to the room network.

  3. In System view, select the DDRC-GRMS-E load controller and click sb icon manage certificate Manage Certificate.

  4. Set Select Certificate type to – Device Site Certificate for TLS Connections.

  5. Click the Create and Upload button. After a minute or two, System Builder creates and uploads a signed certificate file to the device.

  6. Click the Close button.

sb certificate manager ddrc grms e

Configure gateway mapping

In the room controller, the gateway mapping lists the details of every floor gateway in the project. This enables the installer to select the DDRC-GRMS-E to floor gateway connection by setting the ID2 DIP switches.

Add gateway mapping:

  1. Click File > Open Room Configurations and select the required room profile.

  2. Connect SB to the room network.

  3. In System view, select the DDRC-GRMS-E load controller.

    Ensure that SB is using the correct box number for the DDRC-GRMS-E - this should match the ID1 DIP switch setting on the controller. If you make any changes the DIP switch setting, reset the controller before proceeding.

  4. Click the Gateway Mapping tab.

  5. Click sb icon add Add to add a gateway mapping row (you can also import and export the rows).
    sb gateway mapping

  6. Enter the Primary IP4 Address, Alternative IP address and Port (50443) for the floor gateways and the corresponding DIP switch number. Primary and Alternate gateways must be in the same subnet.

  7. Repeat for every floor gateway in the hotel project.

To enable the Alternative IP address, open Tools > Settings > Job Settings > Behavior and set Enable network gateway redundancy to True.

Configure the DDRC-GRMS-E connections

Configure DDRC-GRMS-E gateway functions:

  1. Right-click the DDRC-GRMS-E and select sb icon bridge wizard Bridge Configuration Wizard ( Alt+W ).

  2. Select Hotel Room Ethernet Gateway.

  3. If using DHCP, uncheck the Static IPv4 Address property or enter a static IP address (the Gateway address, Subnet mask, and DNS server address properties are the same as in the Port Editor under IPv4 properties but are not relevant for the DDRC-GRMS-E).

  4. Click the Next > button.
    sb bridge wizard grms step 1

  5. Select Use Gateway Mapping Port and select the Secure checkbox. Then click the Next > button.
    sb bridge wizard grms step 2

    If you do not select Use Gateway Mapping Port, then you can manually enter the IP address and port of a single floor gateway, however you will not be able to change it with the ID2 DIP switches.

  6. Click the Next button.
    sb bridge wizard grms step 3

  7. Click the Next button.
    sb bridge wizard grms step 4

  8. Click the Finish button.

  9. Press F12 or click sb icon save to device Save to Device.

  10. Click sb icon save file File Save to save the job to your PC.

Create device hex files

The device hex files must be sent with the hotel job file to enable device manufacturing and preprogramming.

To complete the room profile configuration, you must unassign the box number from the room controller as this will be set by the DDRC-GRMS-E DIP switches.

Set room controller box number to unassigned:

  1. Right-click the room controller and select sb icon change box number Change Box Number.

  2. Tick the Unassigned checkbox.

  3. Click the OK button.

  4. Click sb icon save file File Save to save the job to your PC.

  5. Repeat for each room profile.

Check the structure in System view. Ensure all required room devices have been added under the room controller and all logical areas appear as expected.
sb system view ddrc grms e
sb logical view room template 1

A device hex file is the image that the factory uses to preprogram a room device. Each room device hex file is exported from System Builder and forms part of the package that the system engineer sends to Dynalite.

Save device hex file:

  1. On your PC, create a Mockup Room folder and a Device Hex Files sub-folder.

  2. Click File > Open Room Configurations and select the required room profile.

  3. Within your selected SB room configuration, select a device to be exported.

  4. Select File > Export > Device to Hex File. SB automatically names the file with the device type and box number.

  5. Select the required Mockup room and Device Hex Files folder.

  6. Click the Save button.

  7. Repeat the previous steps for each device in your mockup room.

  8. Repeat this procedure for each room configuration.

sb save device hex file

Add room mapping

SB uses the room mapping table to build all the rooms in the Master configuration. You can enter the mapping data manually or import the data from a spreadsheet (.csv file).

The room mapping configures the offsets for each room. Ensure the offsets match the offsets in the floor gateway. For example, a mapping entry for room 101 with an offset of 1040 will require that a floor gateway exists with the offset of 1000.

At this stage it is only necessary to add the room mapping for your mockup rooms. This enables you to ensure correct functionality before deploying to the complete hotel. You can add to the room mapping table later when acceptance testing each floor at the customer’s site.
Set up room mapping:

  1. Click File > Open Room Configurations > Master to see the hotel job master configuration.
    Opening the Master configuration builds the complete hotel structure. It is populated by each room configuration in combination with the room mapping table.
    sb open room config

    If you have many rooms, when you click File > sb icon rebuild master job file Rebuild Master Job, it can take a few minutes for SB to build the Master configuration.
    The Master configuration can have different connection settings to a Room configuration.

  2. Click File > sb icon manage room profiles Manage Room Profiles to open the Room Profiles dialog box.

  3. Click the Room Mapping tab.

  4. Click sb icon add Add to add a room mapping entry, or select the beginning of a row to sb icon delete Delete a room mapping entry. Each room requires:

    • Location (building, tower, wing, and/or floor separated by a /)

    • Room Number (Do not enter leading zeros in the room number)

    • Room Description

    • Room Area Offset

    • Room Profile

    • FIAS Server (set to default unless additional FIAS servers are set up in SM)

    • Room Mapping State (Active / Inactive)

    The dashboard displays the Room Number for rooms and suites, and the Room Description for all other room types.
    The data in the Location column creates the folders and floors displayed in the dashboard. These are sorted alphanumerically by default. To change the order, click sb icon edit building Edit Building and manually drag the folders and floors to different positions. The order is indicated by the Index value.

    sb room mapping

  5. Add your mockup rooms to the mapping table.

  6. Click the OK button to save the room mapping table and close the Room Profiles window.

  7. Click sb icon save file File Save ( Ctrl+S ) to save the job to your PC.

Add interconnecting rooms

Multiroom System Manager allows rooms with interconnecting doors or a shared entrance lobby (vestibule area) to have a common doorbell, room status and occupancy status when connected. The hotel must provide a list of rooms that can be physically connected to each other.

If interconnecting rooms have a shared lobby with an indicator panel, then this needs to be wired to one of the rooms. An area in that room needs to be assigned to the panel to receive hotel status messages from System Manager. If the shared lobby indicator panel has a doorbell button, then this should be configured to send messages to this area.

If additional hardware is used to connect to the indicator panel, this will require a separate room profile.

For rooms capable of being interconnected, Dashboard users will see a Link/Unlink Rooms button in the top right corner of the Room view. When linked, the rooms in building and floor view will show the sb icon linked rooms Linked icon.

iah interconnected rooms
Example interconnected rooms
iah interconnected rooms shared lobby
Example interconnected rooms with a shared lobby
Add Interconnecting rooms:

  1. Click File > sb icon manage room profiles Manage Room Profiles to open the Room Profiles dialog.

  2. Click the Room Mapping tab.

  3. Click sb icon edit interconnecting rooms Edit Interconnecting Rooms.

  4. Click sb icon add Add to add an Interconnecting Rooms entry, or select a row to sb icon edit Edit or sb icon delete Delete that entry.
    sb interconnecting rooms

  5. In the Add/Edit Interconnecting Rooms window, enter the connected room numbers.
    Each entry requires a list of at least two room numbers, with each room separated by a comma.

  6. Select the appropriate checkboxes for rooms sharing:

    • Room Status

    • Doorbell

    • Occupancy

  7. For rooms with a shared lobby, select Contains Shared Lobby and enter the trunk area number for the shared lobby area in one of the adjoining rooms (double-check that it is in the correct range according to the mapping table).
    sb interconnecting rooms edit

  8. Click the OK button.

  9. Click the OK button again.

Supported Link Types > Occupancy must be selected for the Guest Well-Being alert to function in interconnected rooms.

Behavior of interconnected rooms in System Manager:

  1. When Room Status Link Type is enabled and SM receives a set or reset hotel room status message (DND, MUR, LPU, RMS) and the room is currently linked then SM will send the hotel status message back to the currently linked rooms. If a shared lobby area has been configured, then SM will also send the hotel status message to the shared lobby area to update the status on the shared lobby indicator panel.

  2. When Room Status Link Type is enabled and rooms are unlinked (either manually from dashboard or automatically when any of the rooms are checked out) and a shared lobby area has been configured then SM will send to messages to reset (clear) all hotel status on the shared lobby indicator panel (DND, MUR, LPU, RMS).

  3. When Doorbell Link Type is enabled and SM receives a doorbell on or off message and the room is currently linked, then SM will send the doorbell on or off message to all other rooms currently linked. If a shared lobby area has been configured and SM receives a doorbell message from the shared lobby area, then SM will send the doorbell message to all rooms that are currently linked. If rooms are not currently linked, then no message will be sent by SM. Doorbell messages are DyNet1 opcode 0x6B Channel 1 with Preset 1 for Doorbell ON and Preset 4 for Doorbell OFF.

  4. When Occupancy Link Type is enabled. If a room that is currently linked reports as occupied, then SM will show all rooms as occupied in the dashboard. Only if all linked rooms are unoccupied shall all linked rooms be shown as unoccupied. When a linked room reports as being unoccupied any linked rooms that are still believed to be occupied by SM shall be sent a Door Closed message to trigger an occupancy check in the room. Shared lobbies are not included in occupancy syncing.

Importing and exporting room mapping

You can add room mapping entries for every guestroom, or click the sb icon save file Export button to create an editable CSV file and use a spreadsheet editor to complete the room mapping.

When importing the Room Mapping data into Excel:

  1. Under the Data menu, select From Text/CSV.

  2. In the Import window, select Do not detect data types and click the Load button.

  3. Once the spreadsheet is complete, save your changes.

When on-site at the hotel, import the complete spreadsheet by clicking the sb icon import Import button to load the saved file back into the Room Mapping table.

sb room mapping csv

Install System Manager for the mockup room

To use the Multiroom Dashboard and integrations with your mockup room, you must create a hotel job with at least one room and install a licensed copy of Multiroom System Manager. This allows you to check the room logic with the Dashboard and third-party systems.

System Manager Server for the customer will be installed later at the hotel site. For more information refer to System Manager installation.

1. Not available to all markets. Contact your Interact representative for more information.