Nice DMBM v1.1 – RTI Driver

Driver Info

Release – R1.1

Introduction

Nice have evolved from merely producing devices to crafting memorable brand experiences for customers. At Nice, the solutions contribute to creating living spaces enhancing quality of life, leveraging technology to reduce stress and complications. Nice’s commitment to innovation has earned worldwide recognition. In 2023, the company achieved global acclaim, securing multiple distinguished industry accolades across various prestigious events.

This Driver enables integrate “DMBM” a module of Nice Modular System with RTI processors for Control & Monitor of Blinds / Shades.

Driver Features

This version of driver supports connecting Nice Modules on IP. RS232 support will be added in upcoming releases.

Can auto detect Automation Modules (Devices), Endpoints (Motors), Motor Groups, Scenes when connected on IP.

Up to 120 Motors can be controlled.

Supports auto driver build of driver (Variables, Functions, Events, etc.) based on configured modules.

Prerequisites (Nice Module(s) configuration as per manufacturer’s guidelines)

Install all devices and motors.

Configure all necessary parameters like Static IP Address, etc. using “Nice Configuration Tool”.

Detect all devices & motors connected.

Add new Groups and Scenes as required (optional).

Add “Nice DMBM” driver to your Apex project.

Driver Settings

Driver Settings:

Driver Name - Enter Driver Name to identify this instance of driver in program.

IP Address - Enter IP Address of DMBM module.

TCP Port - Enter TCP/IP port No. of DMBM module. The default port No. is 23.

Debug Settings: (To be enabled while or used only for troubleshooting & driver performance monitoring. Uncheck all options after final programming)

Error Trace - Check to view ‘Error’ messages generated by Driver.

Warn Trace - Check to view ‘Warning’ messages generated by Driver.

Info Trace - Check to view ‘Information’ messages generated by Driver.

After aforementioned setting are done…

Press “Get Device Data” under "Driver Configuration” on left side of the Driver Settings area.

Devices, Motors, Groups & Scenes will be auto discovered by Driver. On successful discovery, following setting will be visible.

All below mentioned settings are reference for UI programming. Changing the same is optional.

Module-x Settings:

Module-x Name - Name to identify this Module in program.

Motor-y Name - Name to identify this Motor in program.

Group Settings:

Group-g Name - Name to identify this Group in Program.

Scene Settings:

Scene-s Name - Name to identify this Scene in Program.

NOTE: After getting device data or every time if the Names are modified, it is must to press “Build Driver” under "Driver Configuration” on left side of the Driver Settings area to update the data in Driver.

“x” in Module Settings represent Automation Module No. This setting category is available for each of the Automation Module.

“y” in Motor Setting represents the Motor No. (1 to 120). This setting is available for each of the Motor in Automation Module.

“g” in Group Setting represents the Group No. (1 to 255). This setting is available for each of the Group created with Nice Configuration Tool.

“s” in Scene Setting represents the Scene No. (1 to 255). This setting is available for each of the Scene created with Nice Configuration Tool.

Functions:

Module-x: Individual Control of Motors.

Movement

Motor - Select Motor.

Movement - Select movement “Open”, “Close” or “Stop”.

Intermediate Position

Motor - Select Motor.

Intermediate Position - Select preset Position.

Position

Motor - Select Motor.

Position - Enter Position between 0 & 100. This function can also be assigned to Slider Object in UI.

Move Sequence [Sends Motor Movement commands in loop Open -> Stop -> Close -> Stop. . .]

Motor - Select Motor.

Group: Control of all Motors configured in Group.

Movement

Group - Select Group.

Movement - Select movement “Open”, “Close” or “Stop”.

Intermediate Position

Group - Select Group.

Intermediate Position - Select preset Position.

Position

Group - Select Group

Position - Enter Position between 0 & 100. This function can also be assigned to Slider Object in UI.

Move Sequence [Sends Group Movement commands in loop Open -> Stop -> Close -> Stop. . .]

Group - Select Group.

Scene:

Trigger

Scene - Select Scene that needs to be triggered.

Variables: (Name – Type. Description)

Module-x: For each of the Motor connected to this Module.

Status - String. Present status of Motor Movement. [“Opening”, “Closing”, “Halfway”, “Open”, “Close”]

Opening - Boolean. To indicate if Shade is Opening.

Closing - Boolean. To indicate if Shade is Closing.

Open - Boolean. To indicate if the Shade is fully Open.

Close - Boolean. To indicate if Shade is fully Close.

Halfway - Boolean. To indicate if Shade is not fully Open or Close.

Position - Integer. Position of Shade in percentage between 0 & 100.

Groups: Variables are available for configured Groups.

Position - Integer. Set Position of Shade Group in percentage between 0 & 100.

Events:

Module-x: For each of the Motor connected to this Module.

Opening - Triggered when Shade is Opening.

Closing - Triggered when Shade is Closing.

Open - Triggered when Shade is fully Open.

Close - Triggered when Shade is fully Close.

Halfway - Triggered when Shade is not fully Open or Close.

Revision History:

V 1.0 - Initial Release.

V 1.1 - Added Sequential Movement function to Motors & Groups to send commands in loop Open -> Stop -> Close -> Stop. . .

Important:

See “Driver Configuration Guide” for complete details of how to configure the Driver.

Last Changed: 25th Nov 2024.