Lightware RAP-B511-EU User Manual

Lightware RAP-B511-EU User Manual

Room automation panel
Table of Contents

Advertisement

Quick Links

User's Manual
RAP-B511-EU -K, -W, -S
RAP-B511-UK -K, -W, -S
RAP-B511-US -K, -W, -S
Room Automation Panel
v2.0
20-01-2021

Advertisement

Table of Contents
loading

Summary of Contents for Lightware RAP-B511-EU

  • Page 1 User’s Manual RAP-B511-EU -K, -W, -S RAP-B511-UK -K, -W, -S RAP-B511-US -K, -W, -S Room Automation Panel   v2.0 20-01-2021...
  • Page 2     RAP-B511 series – User's Manual Important Safety Instructions Waste Electrical & Electronic Equipment Common Safety Symbols WEEE Class II apparatus construction. This marking shown on the product or its literature, The equipment should be operated only from the power source indicates that it should not be disposed with other indicated on the product Symbol...
  • Page 3 The following symbols and markings are used in the document: All presented functions refer to the indicated products. The descriptions Lightware Visual Engineering supports green technologies and have been made during testing these functions in accordance with the Eco-friend mentality. Thus, this document is made for digital usage...
  • Page 4: Table Of Contents

    6.3.8. Querying the Serial Number ............61 3.1.3. Dimensions ..................16 5.4.1. Button Properties ................36 6.3.9. Compile Time ................... 61 3.1.4. Mounting RAP-B511-EU into the Outlet Box ........17 5.4.2. Configure Button ................36 6.3.10. Querying the Health Status ............61 3.1.5. Mounting RAP-B511-UK into the Outlet Box ........18 5.4.3. Configurations of the Rotary ............
  • Page 5     RAP-B511 series – User's Manual 7.3.5. Error Messages ................67 7.8.5. Set the Background Light for a Period of Time ......77 7.15.1. Device Filter Based on MAC Address .......... 88 7.3.6. Escaping ..................67 7.9. Button Group Configuration .............78 7.15.2. LW2 Control Port Blocking ............89 7.3.7. Signature ..................
  • Page 6     RAP-B511 series – User's Manual 7.20.4. Using Hexadecimal Codes ............97 7.21. RS-232 Message Recognizer .............97 7.21.1. Enable the Recognizer ..............97 7.21.2. Set the Delimiter Hex ..............98 7.21.3. Set the Timeout ................98 7.21.4. Querying the Last Recognized Message (String) ......98 7.21.5. Querying the Last Recognized Message(Hex) ......
  • Page 7: Introduction

      1. Introduction RAP-B511 series – User's Manual I ntroduction Thank you for choosing Lightware’s RAP-B511 series device. In the first chapter we would like to introduce the device highlighting the most important features in the coming sections. ç Description ç...
  • Page 8: Description

    The transparent caps are not placed onto the buttons, thus, you can easily insert the desired labels and fix Lightware devices contain a label indicating the unique serial number of the product. The structure is the the caps – see the Label and Cap Fixation section.
  • Page 9: Features Of The Device

    RS-232 Recognizer RS-232 A batch of LW3 commands (salvo) can be run by the Lightware device either by a previously Support recognizing incoming RS-232 messages to integrate with 3rd party devices or stored macro or by sending a file to the device with the desired commands.
  • Page 10: Typical Application

        1. Introduction RAP-B511 series – User's Manual 1.7. Typical Application Meeting Room Application Example VINX Application Example Conditions Actions Button Process Source Switching Scheduling Display / Projector On / Off Conditions Actions Volume Button Process Source Switching Scheduling Display / Projector On / Off Occupancy Sensor...
  • Page 11     1. Introduction RAP-B511 series – User's Manual Conference Room Application Example Conditions Actions Button Process Source Switching Scheduling Display / Projector On / Off Occupancy Sensor Lamp On / Off Screen Up / Down Volume Applied firmware package: v1.1.0b3b3 | LDC software: v2.5.1b5...
  • Page 12: Product Overview

        2. Product Overview RAP-B511 series – User's Manual Product Overview The following sections are about the physical structure of the device, input/ output ports and connectors, buttons and status LEDs. ç Front View ç Rear View ç...
  • Page 13: Front View

    / low bright / high bright / slow blink / sine pulse. Blinking of the button and rotary LEDs three times means, that the front panel functionality is locked. Unlocking is possible with Software Control - Lightware Device Controller or via LW3 protocol commands (for more details see LW3 Programmers’...
  • Page 14: Special Functions

        2. Product Overview RAP-B511 series – User's Manual 2.3. Special Functions 2.3.3. Entering Bootload Mode It may happen that the firmware upgrade process is unsuccessful 2.3.1. Behind the Front Panel and the device cannot be switched to bootload mode automatically. After removing the front plate (no special tool needed, just pull apart by hand), In this case, the device can be forced into bootload mode as follows: a USB connector, a reset button, and a live led can be seen.
  • Page 15: Installation

        3. Installation RAP-B511 series – User's Manual Installation The chapter is about the installation of the device and connecting to other appliances, presenting also the mounting options and further assembly steps. ç Mounting Options ç Electrical Connections ç...
  • Page 16: Mounting Options

    Dimensions (mm) Model The caps of the buttons are supplied separately with the product in a plastic bag. Select the desired label and insert it as shown in attached figure: RAP-B511-EU 40.5 17.6 D I S Step 1. Insert the label.
  • Page 17: Mounting Rap-B511-Eu Into The Outlet Box

    RAP-B511 series – User's Manual 3.1.4. Mounting RAP-B511-EU into the Outlet Box Step 3. Insert the RAP-B511-EU into the Outlet box and position it to get the holes aligned. Step 1. Pull apart the Front plate from the RAP-B511-EU by hand (no special tool needed).
  • Page 18: Mounting Rap-B511-Uk Into The Outlet Box

        3. Installation RAP-B511 series – User's Manual 3.1.5. Mounting RAP-B511-UK into the Outlet Box Step 3. Insert the RAP-B511-UK into the Outlet box and position it to get the holes aligned. Step 1. Pull apart the Front plate from the RAP-B511-UK by hand (no special tool needed). t l e t P - B b o x...
  • Page 19: Mounting Rap-B511-Us Into The Outlet Box

        3. Installation RAP-B511 series – User's Manual 3.1.6. Mounting RAP-B511-US into the Outlet Box Step 3. Insert the RAP-B511-US into the Outlet box and position it to get the holes aligned. Step 1. Pull apart the Front plate from the RAP-B511-US by hand (no special tool needed). t l e t P - B b o x...
  • Page 20: Electrical Connections

    Pin nr. Level and direction Wiring of LAN Cables Configurable Lightware recommends the termination of LAN cables on the basis of TIA/EIA T 568 A or TIA/EIA T 568 B standards. Ground Pin TIA/EIA T568A Wire color...
  • Page 21: Powering Options

        3. Installation RAP-B511 series – User's Manual 3.3. Powering Options 3.4. Connecting Steps RAP-B511 series automation panel is compatible with IEEE 802.3af standard - Power over Ethernet (PoE) - and one Ethernet port can receive and the other one can send power over the Ethernet line. The room automation panel can be powered by any of the following ways: Local adaptor and remote power (PoE OUT) When it is locally supplied with 48V DC adaptor, the room automation panel is able to send remote power via...
  • Page 22: Device Concept

        4. Device Concept RAP-B511 series – User's Manual Device Concept The following chapter describes the features of the device with a few real-life examples. ç General Concept ç Inputs 1. - User Interactions ç Inputs 2. - Automation Options ç...
  • Page 23: General Concept

    The operation of the RAP-B511 series is based on user interactions such as button press, or turn the rotary. interfaces (RS-232, Ethernet, GPIO, IR) ensure the compatibility with third-party units or Lightware products. These are the main triggers (or inputs) of the control functions. They can be quickly and easily customize in They make automating the whole AV system in a huddle room possible.
  • Page 24: Rotary

    PRESS RELEASE PRESS RELEASE (and the mute/unmute state) of the Lightware devices. Choose the proper schema (see more details about the compatibility table in Configurations of the Rotary section) and fill the audio port number. Custom Volume Control Schema makes it possible to configure any command for controlling a third-party device.
  • Page 25: Inputs 2. - Automation Options

    Turn on the lamp Flowchart of the real-time clock configuration process User interaction INFO: All settings of the Real-time clock is possible using the Lightware Device Contoller software (see the details in Time Settings section) or via LW3 protocol commands (in the Time Settings section).
  • Page 26: Tcp Recognizer

    (e.g. 'the lamp is turned off'). Click Ok to save. IR IN Ethernet The RS-232 recognizer settings has to be done with Lightware Device Controller Software (see details in the RS-232 Message Recognizer section) or with LW3 protocol commands (see more information in the...
  • Page 27: Outputs - Actions

    LED function for false state (when the interaction state is false) ▪ The RS-232 port of the RAP-B511 must be in Disconnect mode. (If the target device is also Lightware Example: Button2 Button3, Button4 are in the same radio group. When Button2 is pressed, its interaction unit, take care of the its operation mode, too) state changes true and the other's interaction states change false.
  • Page 28: Ethernet Message Sending

    Note. 4.4.5. HTTP Post and Put Message Sending ATTENTION! This feature means posting or putting HTTP messages from the Lightware device to another device. Encrypted transmission (HTTPS) is not supported. #new This feature allows sending HTTP post and put messages to the desired server IP:port no. Control commands can be set to the target device, but it is not suitable for processing the response (e.g.
  • Page 29: Settings For Other Interfaces

    The device can be controlled over front panel USB mini B-type connector. The interface can be used This mode is for sending control commands to a third-party (or a Lightware) device from the RAP-B511. to establish a connection to Lightware Device Controller. For more information about the LDC, see ASCII characters and binary data in hexadecimal format can be used in this case.
  • Page 30: Infra Interface

    The Event Manager feature means that the device can sense changes on its ports and is able to react new opportunities allow creating a monitoring/controlling system without connecting an additional control according to the pre-defined settings. Lightware Device Controller contains a user-friendly software tool and processor.
  • Page 31: Basic It Security

    This feature allows the LW device to be controlled over HTTP. In this case, a batch of commands is sent over HTTP to the Lightware device for processing. Save the LW3 commands into a file, post it to the The Cleartext Login tool allows setting a password for login, thus, the device will not accept any command <IP_address>/protocol.lw3 file and the commands are processed immediately.
  • Page 32: Software Control - Lightware Device Controller

    S oftware Control - Lightware Device Controller The device can be controlled by a computer through the Ethernet and RS-232 port using Lightware Device Controller (LDC). The software can be installed on a Windows PC or macOS. The application and the User’s manual can be downloaded from www.lightware.com.
  • Page 33: Install And Upgrade

    The Device Discovery window appears automatically and the program checks the available updates on Lightware’s website and opens the update window if LDC updates are found. The current and the update version number can be seen at the top of the window and they are shown in this window even with the snapshot install.
  • Page 34: Establishing The Connection

    The Ethernet tab consists of two lists: Favorite Devices: You can add any Lightware device that is connected via Ethernet and no need to ▪ browse all the available devices. Devices can be added by pressing the Add button or marking the desired device by the ...
  • Page 35: Ui Config Menu

        5. Software Control - Lightware Device Controller RAP-B511 series – User's Manual 5.4. UI Config Menu Information ribbon The label shows the device label which can be edited in the Settings menu Status tab. Device discovery window can be displayed by clicking on this ribbon.
  • Page 36: Button Properties

        5. Software Control - Lightware Device Controller RAP-B511 series – User's Manual 5.4.1. Button Properties The tab denomination depends on the button operation mode. A short description gives a hint to choose the proper condition or action for the selected button.
  • Page 37     5. Software Control - Lightware Device Controller RAP-B511 series – User's Manual Button configuration steps: Button Interactions Step 1. Choose the tab and click on the desired action or condition in the This section provides an overview of all defined events thematic list.
  • Page 38: Configurations Of The Rotary

    Type the desired commands into the proper entry fields. MMX8x4-HT420M (mixer addon) b) Lightware schema is for controlling the volume of the analog audio levels of the chosen audio port Generic LWR-C MMX8x4-HT400MC (mixer addon)
  • Page 39: Control Menu

        5. Software Control - Lightware Device Controller RAP-B511 series – User's Manual 5.5. Control Menu Schema ID Device Type MMX6X2-HT200 5.5.1. RS-232 Generic LWR-D MMX6X2-HT210 MMX6X2-HT220 MX-FR (IB/OB-A) Generic LWR-E UMX-OPT-TX150R UMX-TP-TX100 Generic LWR-F UBEX-PRO20-HDMI-F110, -F120 VINX-120AP-HDMI-ENC VINX-120AP-HDMI-ENC-DNT...
  • Page 40: Gpio

        5. Software Control - Lightware Device Controller RAP-B511 series – User's Manual 5.5.2. GPIO RS-232 Message Sending The message in the field can be sent out via the current RS-232 port. Response cannot be seen in the surface.
  • Page 41: Ethernet

    5.5.3. Ethernet HTTP Clients (HTTP Post and Put Message Sending) ATTENTION! This feature means posting or putting HTTP messages from the Lightware device to another Ethernet Ports device. Encrypted transmission (HTTPS) is not supported. Two ports are displayed in the Ethernet settings: PoE in Eth and PoE out Eth. You can check the status of the The HTTP Clients tab allows sending HTTP post and put messages to the desired server IP:port no.
  • Page 42 Encrypted transmission (HTTPS) is not supported. TCP Recognizer section. #tcprecognizer #message In this case, a batch of commands can be sent over HTTP to the Lightware device for processing. Post the commands to the <IP_address>/protocol.lw3 address and the commands are processed immediately and sequentially. #http...
  • Page 43: Infra

        5. Software Control - Lightware Device Controller RAP-B511 series – User's Manual 5.5.4. Infra 20 fingerprints can be stored in the device at the same time. Each of them can be ordered to an action in Event Manager.
  • Page 44: Macros

        5. Software Control - Lightware Device Controller RAP-B511 series – User's Manual 5.5.5. Macros DEFINITION: Macro is a batch of pre-defined commands stored in the device. #macro #new You can create your custom macros in a file, upload to the device and run at any time. This device can handle up to 50 macros.
  • Page 45: Variables

        5. Software Control - Lightware Device Controller RAP-B511 series – User's Manual 5.5.6. Variables Value Section You can set the value of the variable by the field. The type of the variable is determined automatically based A brand new area is opened by implementing the variables. You can create custom variables in number on its value (numeric/string).
  • Page 46     5. Software Control - Lightware Device Controller RAP-B511 series – User's Manual Scan and Store This tool can be used to get the value (or a part) of an LW3 property. The defined path will be checked according to the pattern and the result will be saved into the variable (number or string type).
  • Page 47: Event Manager

        5. Software Control - Lightware Device Controller RAP-B511 series – User's Manual 5.6. Event Manager 5.6.1. Event Manager in the RAP-B511 series The functionality of the Room Automation Panel is based on the Event Manager. UI config page provides an The feature means that the device can sense changes on its ports and able to react interface where the events can be set easily and they are saved in the Event Manager.
  • Page 48: The Event Editor

        5. Software Control - Lightware Device Controller RAP-B511 series – User's Manual 5.6.2. The Event Editor 5.6.3. Create or Modify an Event Press the Edit button in the desired Event line to open the Event editor window. Wizard Mode...
  • Page 49     5. Software Control - Lightware Device Controller RAP-B511 series – User's Manual The Link Tool Linking a Macro (Action) The new interface allows creating more actions DIFFERENCE: This feature is avail- for the same condition. In that case, a condition able from FW package v1.1.0b3.
  • Page 50: Special Tools And Accessories

        5. Software Control - Lightware Device Controller RAP-B511 series – User's Manual 5.6.4. Special Tools and Accessories no delay Condition = true Perform the action The Name of the Event simple delay Condition = true Delay Perform the action The name of a port can be changed by typing the new name and clicking the Set button.
  • Page 51: Clear One Or More Event(S)

        5. Software Control - Lightware Device Controller RAP-B511 series – User's Manual 5.6.5. Clear One or More Event(s) 5.7. Settings Menu Clear an Event 5.7.1. Status Press the Clear button in the Event list or in the header section in the Event editor.
  • Page 52: Network

    This cleartext login tool allows setting a password for login, thus, the device will not accept any command are TCP/IP ports in Lightware devices which are not protected by the login, so you can disable them if coming from a control interface (RS-232, Ethernet, etc…) without login. The device will be visible in the Device necessary.
  • Page 53: Time Settings

        5. Software Control - Lightware Device Controller RAP-B511 series – User's Manual ATTENTION! If the login is enabled, the password will be asked when the Built-in Miniweb is opened. Set NTP (Network Time Protocol) settings INFO: The login password is erased and the login is disabled when restoring the factory default values.
  • Page 54: Built-In Miniweb

    The Upgrading Steps section. ▪ Lightware Device Controller software supports the Miniweb feature above v1.33. Please be sure that the computer is in the same network as the RAP-B511. If the computer has multiple ▪ Ethernet connections (for example Wi-Fi and LAN connections are used simultaneously) you will have Advanced Miniweb Page to know the IP address for the one that is used for controlling the automation panel.
  • Page 55: Configuration Cloning (Backup Tab)

    Press the Clear button to remove the control page. In this case, status information becomes available about the device. The configuration cloning of Lightware LW3 devices is a simple method that eliminates the need to repeatedly configure certain devices to have identical (non-factory) settings. If the devices are installed in the same type of system multiple times then it is enough to set up only one device to fit the user’s needs and then copy...
  • Page 56: Cloning Steps In A Nutshell

        5. Software Control - Lightware Device Controller RAP-B511 series – User's Manual 5.9.1. Cloning Steps in a Nutshell 5.9.3. Upload the Settings to a Device (Restore) Installing multiple devices with the same customized configuration settings can be done in a few easy steps:...
  • Page 57: Advanced View Window

        5. Software Control - Lightware Device Controller RAP-B511 series – User's Manual 5.10. Advanced View Window LW3 protocol Pushing the button results a help window opening which describes the most important help information about LW3 protocol commands in HTML format.
  • Page 58: Lw2 Programmer's Reference

    RAP-B511 series – User's Manual L W2 Programmer' s Reference The device can be controlled through a reduced command set of LW2 protocol commands to ensure the compatibility with other Lightware products. The supported LW2 commands are described in this chapter. ç Protocol Description ç...
  • Page 59: Protocol Description

    RAP-B511 series – User's Manual 6.1. Protocol Description 6.2. Instructions for the Terminal Application Usage The protocol description hereinafter stands for Lightware protocol. The commands can be sent to the device Terminal Application in RAW format via the TCP/IP port no. 10001.
  • Page 60: General Lw2 Commands

        6. LW2 Programmer's Reference RAP-B511 series – User's Manual 6.3. General LW2 Commands 6.3.4. Querying the Control Protocol The device can be controlled with different control protocols. This command queries the active protocol of 6.3.1. Querying the Supported Commands the currently used control interface.
  • Page 61: Connection Test

        6. LW2 Programmer's Reference RAP-B511 series – User's Manual 6.3.7. Connection Test 6.3.11. View Installed Board Simple test to see if the connection is established successfully. Shows the hardware name and revision of the installed cards. Command and Response Command and Response ...
  • Page 62: Network Configuration

        6. LW2 Programmer's Reference RAP-B511 series – User's Manual 6.4. Network Configuration 6.4.3. Setting the Subnet Mask Subnet mask can be set as follows. 6.4.1. Querying the Current IP Status Command and Response The IP address settings can be queried as follows. #dhcp #ipaddress #network ...
  • Page 63: Enable/Disable The Ethernet Port

        6. LW2 Programmer's Reference RAP-B511 series – User's Manual 6.4.6. Enable/disable the Ethernet Port Command and Response  {ETH_ENABLE=<switch>}  (ETH_ENABLE=<switch>)CrLf Parameters If the <switch> parameter is 0, the port is disabled. If its value is 1, the port is enabled. Example ...
  • Page 64: Lw2 Commands - Quick Summary

        6. LW2 Programmer's Reference RAP-B511 series – User's Manual 6.6. LW2 Commands – Quick Summary General LW2 Commands Network Configuration Querying the Supported Commands Querying the Current IP Status  {LCMD}  {IP_STAT=?} Querying the Product Type Setting the IP Address ...
  • Page 65: Lw3 Programmers' Reference

    7. LW3 Programmers’ Reference RAP-B511 series – User's Manual L W3 Programmers’ Reference The device can be controlled through Lightware 3 (LW3) protocol commands to ensure the compatibility with other Lightware products. The supported LW3 commands are described in this chapter.
  • Page 66: Overview

    ‘nodes’, ‘properties’ and ‘methods’. The  MANAGEMENT Advanced View of the Lightware Device Controller software is the perfect tool for browsing and learning how  LOG the LW3 protocol can be used in practice.
  • Page 67: Command Types

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.3.3. Command Types 7.3.4. Prefix Summary DEFINITION: The prefix is a 2-character long code that describes the type of the response. GET command The following prefixes are defined in the LW3 protocol: The GET command can be used to get the child nodes, properties and methods of a specific node.
  • Page 68: Signature

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.3.7. Signature 7.3.9. Notifications about the Changes of the Properties DEFINITION: The signature is a four-digit-long hexadecimal value that can be optionally placed before When the value of a property is changed and the user is subscribed to the node, which the property belongs every command to keep a command and the corresponding responses together as a group.
  • Page 69: System Commands

    7.4.5. Resetting the Device ç GET /.ProductName The device can be restarted – the current connections (LAN, RS-232 or USB) will be terminated. æ pr /.ProductName=RAP-B511-EU-K 7.4.2. Set the Device Label Command and Response This property can be changed to a custom text. The default format of the device label is the following: ç...
  • Page 70: Enable Poe

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.4.7. Enable PoE 7.5. Cleartext Login Protection Command and Response DIFFERENCE: This feature and below commands are available from FW package v1.1.0b3. SET·/SYS/MB/POE.PoeEnabled=<PoE_status> This cleartext login tool allows setting a password for login, thus, any change in the device can be performed ç...
  • Page 71: Logout From The Device

    This property can be changed only, if the LoggedIn property is true. æ pw /SYS/MB/TIMEZONE.Timezone=CET-1CEST,M3.5.0/2,M10.5.0/3 Command and Response TIPS AND TRICKS: Timezone and daylight saving settings can be done easily and quickly with Lightware SET·/LOGIN:LoginEnable=<login_state> Device Controller software in the Time Settings section.
  • Page 72: Enable Getting Ntp From Dhcp Server

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.6.2. Enable Getting NTP from DHCP server 7.6.5. Synchronize with the NTP server When the DHCP server assigns an IP address to the device, there is an option to request an NTP time Command and Response information.
  • Page 73: Query The Local Time (Rtc)

    Event Manager. are enabled. 1: Locked - Locking and unlocking of the front panel buttons and Command and Response the rotary are possible with Lightware Device Controller software GET·/SYS/MB/RTC.<RTC_element> or via protocol command. ç 2: Force locked - The front panel buttons are locked and cannot be pr·/SYS/MB/RTC.LocalTime=<RTC_element>...
  • Page 74: Set The Button Operation Mode

    7.7.4. Set the Button Interaction State This property gives immediate feedback about the button status, which changes depending on the button Command and Response mode. When the button function is configured with Lightware Device Controller Software, this parameter is SET·/MANAGEMENT/UI/BUTTONS/<btn_ID>.Mode=<btn_mode> ç...
  • Page 75: Set The Label For The Button

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.7.7. Set the Label for the Button Button Icon and IDs Command and Response <row1> ç SET·/MANAGEMENT/UI/BUTTONS/<btn_ID>. IconId=<row1>;<row2>;<row3> laptop <row2> æ pw·/MANAGEMENT/UI/BUTTONS/<btn_ID>. IconId=<row1>;<row2>;<row3> <row3> Parameters Identifier Parameter description Parameter values <row1>;<row2>;<row3>...
  • Page 76: Button Led Configuration

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.8. Button LED Configuration Query the Actual Status Command and Response General parameters ç GET·/MANAGEMENT/UI/BUTTONS/<btn_ID>/BUTTON.ActualStatus Identifier Parameter description Parameter values pr·/MANAGEMENT/UI/BUTTONS/<btn_ID>/BUTTON.ActualStatus=<btn_status> æ <LED_ID> LED identifier (LED1 is behind the BUTTON1) LED1-11 Parameters 7.8.1. Enable the Button LED...
  • Page 77: Set The Default Intensity Of The High Brightness

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.8.3. Set the Default Intensity of the High Brightness Set the FalseFunction Here the LEDs behaviour can be defined, when the button is pressed or released. This property takes into Command and Response consideration the Set the Button Interaction...
  • Page 78: Button Group Configuration

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.9. Button Group Configuration 7.10. Volume Control Configuration 7.9.1. Set the Buttons into Groups 7.10.1. Control Lock of the Jog Dial The button mode defines which button belongs a certain group. For more information about it, see Set the This property can disable the control function of the jog dial without locking the buttons.
  • Page 79: Mute The Volume

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.10.3. Mute the Volume Query the Actual Status of the Rotary Clicking on the jog dial changes the mute state (and toggles on and off the mute LED). Command and Response Command and Response ç...
  • Page 80: Event Manager Basics

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.11. Event Manager Basics 7.11.3. Setting a Condition by Linking Another Condition Command and Response The graphical interface of the Event Manager can be found in the LDC which allows creating any kind of Events.
  • Page 81: Setting An Action By Specifying A Direct Path

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.11.5. Setting an Action by Specifying a Direct Path 7.12. Event Manager Tool Kit Command and Response 7.12.1. Setting the Delay SET·/EVENTS/E<loc>.Action=<expression> ç In most cases, the Action is performed immediately after the Condition is detected. But sometimes a delay pw·/EVENTS/E<loc>.Action=<expression>...
  • Page 82: Setting The Name Of The Event

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.12.3. Enable the Event Example 1 (simple delay) ç SET /EVENTS/E1.ConditionTimeout=10 Command and Response æ pw /EVENTS/E1.ConditionTimeout=10 SET·/EVENTS/E<loc>.Enabled=<true/false> ç If the Condition is detected (the ConditionDetect property becomes true), the ConditionTimeoutPending property pw·/EVENTS/E<loc>.Enabled=<true/false>...
  • Page 83: Querying The Condition Trigger Counter

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.12.6. Querying the Condition Trigger Counter 7.13. Variable-Management DIFFERENCE: This command is available from FW package v1.1.0b3. #new DIFFERENCE: This feature and below commands are available from FW package v1.1.0b3. #new This property shows how many times the Condition has been triggered but does not contain the number of Custom variables (30 pcs.) can be defined in number or text format which are available also in the Event...
  • Page 84: Addition And Subtraction (Cycle Method)

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.13.3. Addition and Subtraction (Cycle Method) Examples Change messages (CHG) can be seen after each response for the better understanding, which is not the part The value of a numeric variable can be increased by adding a positive value or it can be decreased by adding of the command, but it can be set as described in the Subscription section.
  • Page 85: Value Change With Intervals (Case)

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.13.4. Value Change with Intervals (Case) 7.13.5. Scan and Store This command can be used to change the value of a variable if it fits in any of the defined intervals. This command can be used to get the value (or a part of the value) of an LW3 property.
  • Page 86: Reformatting A Value

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.14. Ethernet Port Configuration Further Examples Scanned property: /MANAGEMENT/STATUS.CpuTemperature=46 C; 0;75; 0;79; 3;48; ATTENTION! When you change a network property the new value is stored but the applySettings method must be called always to apply the new settings.
  • Page 87: Query The Ip Address

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.14.3. Query the IP Address 7.14.6. Change the Subnet Mask (Static) Command and Response Command and Response ç GET·/MANAGEMENT/NETWORK.IpAddress SET·/MANAGEMENT/NETWORK.StaticNetworkMask=<netmask> ç pr·/MANAGEMENT/NETWORK.IpAddress=<IP_address> pw·/MANAGEMENT/NETWORK.StaticNetworkMask=<netmask> æ æ Example Example ç GET /MANAGEMENT/NETWORK.IpAddress ç...
  • Page 88: Apply Network Settings

    æ pw /MANAGEMENT/MACFILTER.FilterEnable=true New MAC address is saved into the 4th property with name 'Tech', which may query/set parameters from/in the Lightware device. The FilterEnable property is set to true, thus, the filter is enabled. Applied firmware package: v1.1.0b3b3 | LDC software: v2.5.1b5...
  • Page 89: Lw2 Control Port Blocking

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.15.2. LW2 Control Port Blocking 7.15.5. Powering on a Computer over Ethernet (Wake-on-LAN) This command is for blocking the LW2 control port; it is an additional protection for the Cleartext login function. The well-known wake-on-lan feature (sending magic Packet to the target PC) is available by the following command: Command and Response...
  • Page 90: Ethernet Message Sending

    The command is for sending a UDP message in ASCII-format. This method allows escaping the control characters. For more information see the Escaping section. Example – Controlling a Lightware Device Command and Response ç CALL /MEDIA/ETHERNET:tcpMessage(192.168.0.17:6107=CALL /MEDIA/VIDEO/XP:switch\(I2:O1\)\\ x0d\\x0a) ç CALL·/MEDIA/ETHERNET:udpMessage(<IP_address>:<port_no>=<message>) æ...
  • Page 91: Sending A Udp Text (Ascii-Format)

    The command is for sending a text message in ASCII-format via UDP-protocol. This method does not allow DIFFERENCE: This feature and below commands are available from FW package v1.1.0b3. escaping or inserting control characters. Http post and put messages can be sent from the Lightware device for more integration with third-party Command and Response devices. #http #new ç...
  • Page 92: Setting The Message Header

    Example Preparation ç SET /CTRL/HTTP/C1.Header=Host: 192.168.0.220\r\nContent-Type: text/xml\r\nAuthorization: Basic Step 1. Set a TCP client in the Lightware device (three TCP clients can be run at the same time), set the YWRtaW46TGlnaHR3YXJlMDE= properties of the target TCP server. æ pw /CTRL/HTTP/C1.Header=Host: 192.168.0.220\r\nContent-Type: text/xml\r\nAuthorization: Basic Step 2.
  • Page 93: Setting The Tcp/Ip Port Number Of The Tcp Server

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.18.2. Setting the TCP/IP Port Number of the TCP Server 7.18.6. Setting the Timeout Command and Response When the set time is elapsed after the last received message and delimiter was not detected, the device saves the data into the Rx, RxHex, Hash properties.
  • Page 94: Querying The Last Recognized Message (Hex)

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.18.8. Querying the Last Recognized Message (Hex) 7.18.11. Querying the Last Recognized Active Message (Hex) The recognized message is stored as a hex message in the below property till the next recognized message Command and Response or until the clear() method is called.
  • Page 95: Port Configuration

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.19. RS-232 Port Configuration 7.19.3. Databit Setting Command and Response 7.19.1. Protocol Setting SET·/MEDIA/UART/P1.DataBits=<databit> ç Command and Response pw·/MEDIA/UART/P1.DataBits=<databit> æ SET·/MEDIA/UART/P1.ControlProtocol=<cont_protocol> ç Parameters pw·/MEDIA/UART/P1.ControlProtocol=<cont_protocol> æ Identifier Parameter description Parameter values Parameters <databit>...
  • Page 96: Operation Mode

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.19.6. RS-232 Operation Mode 7.20. RS-232 Message Sending Command and Response 7.20.1. Sending a Message (ASCII-format) via RS-232 SET·/MEDIA/UART/P1.Rs232Mode=<rs232_mode> ç The command is for sending a command message in ASCII-format. This method allows escaping the control pw·/MEDIA/UART/P1.Rs232Mode=<rs232_mode>...
  • Page 97: Using Hexadecimal Codes

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.20.4. Using Hexadecimal Codes 7.21. RS-232 Message Recognizer Hexadecimal codes can be inserted in the ASCII message when using: DIFFERENCE: This feature and below commands are available from FW package v1.1.0b3. sendMessage command: CALL /MEDIA/UART/P1:sendMessage(C00\x0D) This tool can be used to recognize messages coming from the RS-232 port.
  • Page 98: Set The Delimiter Hex

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.21.2. Set the Delimiter Hex 7.21.4. Querying the Last Recognized Message (String) This property stores the delimiter that is between the messages (e.g. Cr, Lf, Space). The value has to be in The recognized message is stored as a string in the below property till the next recognized message or until hex format (e.g.0D, 0A, 20).
  • Page 99: Querying The Last Recognized Active Message (String)

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.21.7. Querying the Last Recognized Active Message (String) 7.21.9. Set the Active Timeout The recognized data is stored in string in the below property temporary. When the time set in the ActiveTimeout This property is responsible for clearing the ActiveRx, ActiveRxHex, ActiveHash properties after the elapsed property is elapsed, the property is cleared.
  • Page 100: Gpio Port Configuration

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.22. GPIO Port Configuration 7.22.1. Set the Direction of a GPIO Pin Command and Response SET·/MEDIA/GPIO/<gpio_port>.Direction=<dir> ç pw·/MEDIA/GPIO/<gpio_port>.Direction=<dir> æ Parameters <dir> I: input direction of the GPIO pin O: output direction of the GPIO pin Example ç...
  • Page 101: Lw3 Commands - Quick Summary

        7. LW3 Programmers’ Reference RAP-B511 series – User's Manual 7.23. LW3 Commands – Quick Summary System Commands Enable Getting NTP from DHCP server SET·/SYS/MB/NTP.NtpServerFromDhcp=<enable_ntp_dhcp> Query the Product Name ç Query the Active NTP Server ç GET·/.ProductName ç GET·/SYS/MB/NTP.ActiveNtpServer Set the Device Label Set NTP server ç...
  • Page 102     7. LW3 Programmers’ Reference RAP-B511 series – User's Manual Clear the Button Style Volume Control (Jog Dial) Status Indicators ç SET·/MANAGEMENT/UI/BUTTONS/<btn_ID>. IconId= ç GET·/MANAGEMENT/UI/VOLUMECONTROL/ROTARY.RotaryPosition ç GET·/MANAGEMENT/UI/VOLUMECONTROL/ROTARY.ActualStatus Button Status Indicators ç GET·/MANAGEMENT/UI/VOLUMECONTROL/ROTARY.LongPress ç GET·/MANAGEMENT/UI/BUTTONS/<btn_ID>/BUTTON.Latch ç GET·/MANAGEMENT/UI/VOLUMECONTROL/ROTARY.Clicked ç GET·/MANAGEMENT/UI/BUTTONS/<btn_ID>/BUTTON.ActualStatus Event Manager Basics ç...
  • Page 103     7. LW3 Programmers’ Reference RAP-B511 series – User's Manual Querying the Condition Trigger Counter Query the Gateway Address ç GET·/EVENTS/E<loc>.ExternalConditionTriggerCount ç GET·/MANAGEMENT/NETWORK.GatewayAddress Testing an Action Change the Gateway Address (Static) ç CALL·/EVENTS/E<loc>:ActionTest(1) SET·/MANAGEMENT/NETWORK.StaticGatewayAddress=<gw_add> ç Apply Network Settings Variable-Management ç...
  • Page 104     7. LW3 Programmers’ Reference RAP-B511 series – User's Manual HTTP Messaging Clearing the Last Recognized Stored Message ç CALL·/CTRL/TCP/C<loc>:clear() Setting the Target IP Address Querying the Last Recognized Active Message (String) SET·/CTRL/HTTP/C1.ServerIP=<IP_address> ç ç GET·/CTRL/TCP/C<loc>.ActiveRx Setting the TCP Port Querying the Last Recognized Active Message (Hex) SET·/CTRL/HTTP/C1.ServerPort=<port_no>...
  • Page 105     7. LW3 Programmers’ Reference RAP-B511 series – User's Manual Sending a Binary Message (HEX-format) via RS-232 ç CALL·/MEDIA/UART/P1:sendBinaryMessage(<message>) Using Hexadecimal Codes RS-232 Message Recognizer Enable the Recognizer SET·/MEDIA/UART/<serial_port>.RecognizerEnable=<recognizer_enable> ç Set the Delimiter Hex SET·/MEDIA/UART/RECOGNIZER.DelimiterHex=<delimiter> ç Set the Timeout SET·/MEDIA/UART/RECOGNIZER.TimeOut=<timeout>...
  • Page 106: Firmware Upgrade

    This chapter is meant to help customers perform firmware upgrades on our products by giving a few tips on how to start and by explaining the features of the Lightware Device Updater v2 (LDU2) software. The latest software and firmware pack can be downloaded from www.lightware.com.
  • Page 107: Introduction

    8.2. Preparation may exist for all users installed for all users Most Lightware devices can be controlled over more interfaces (e.g. Ethernet, USB, RS-232). But the firmware ATTENTION! Using the default Normal install is highly recommended. can be upgraded usually over one dedicated interface, which is the Ethernet in most cases.
  • Page 108: Running The Software

    When the software is started by the shortcut, the device discovery screen appears. You have two options: DISCOVER DEVICES Press the Search for devices button to start finding the Lightware devices: ▪ Starting the LDU2 by double-clicking on the shortcut/program file, or Double-clicking on an LFP2 file.
  • Page 109: The Upgrading Steps

    In the case of factory reset, you can save the settings of the device in the Lightware Device Controller software and restore it later. The following flow chart demonstrates how this function works in the background.
  • Page 110     8. Firmware Upgrade RAP-B511 series – User's Manual Step 1. Select the Firmware Package. The Meaning of the Symbols Click on the Choose Package File button and navigate to the location where Show The log about the upgrading process of the device CHOOSE PACKAGE FILE ...
  • Page 111: If The Upgrade Is Not Successful

    If an upgrade is not successful, the Export log button becomes red. If you press the button, you can ▪ download the log file as a ZIP package which can be sent to Lightware Support if needed. The log files contain useful information about the circumstances to find the root cause.
  • Page 112: Troubleshooting

        9. Troubleshooting RAP-B511 series – User's Manual T roubleshooting Usually, if the system seems not to transport the signal as expected, the best strategy for troubleshooting is to check signal integrity through the whole signal chain starting from source side and moving forward to device end. Applied firmware package: v1.1.0b3b3 | LDC software: v2.5.1b5...
  • Page 113: How To Speed Up The Troubleshooting Process

    In the case of Event Manager issue the event file and/or backup file from the Device Controller ▪ software. The more of the above information you can give us the better. Please send these information to the Lightware Support Team (support@lightware.com) to speed up the troubleshooting process. Applied firmware package: v1.1.0b3b3 | LDC software: v2.5.1b5...
  • Page 114: Appendix

        10. Appendix RAP-B511 series – User's Manual Appendix Tables, drawings, guides, and technical details as follows: ç Specifications ç Factory Default Settings ç Cable Wiring Guide ç Button Numbering ç Mechanical Drawings ç Firmware Release Notes ç...
  • Page 115: Specifications

        10. Appendix RAP-B511 series – User's Manual 10.1. Specifications 10.2. Factory Default Settings Dimensions in mm (-US)........4.6 W x 2.3 D* x 4.6 H Weight (-EU) ..................412g Parameter Setting/Value General Weight (-UK) ..................380g Button settings Compliance ..................CE Weight (-US) ..................
  • Page 116: Cable Wiring Guide

    Room Automation Panel is built with 3-pole Phoenix connector. See the below examples of connecting to a RAP-B511-EU -K, -W, -S DCE (Data Circuit-terminating Equipment) or a DTE (Data Terminal Equipment) type device: INFO: All the RAP-B511-EU models have the same size. Lightware device and a DCE Lightware device and a DTE D-SUB 9 - Phoenix D-SUB 9 - Phoenix 35.5...
  • Page 117     10. Appendix RAP-B511 series – User's Manual RAP-B511-UK -K, -W, -S RAP-B511-US -K, -W, -S INFO: All the RAP-B511-UK models have the same size. INFO: All the RAP-B511-US models have the same size. 120.6 115.9 60.3 60.3 104.7 2 gang UK...
  • Page 118: Firmware Release Notes

    ▪ Added IP port and services filtering (Advanced Control pack v3) v1.0.0b17 ▪ Added Macro capability (running partial device preset with tags) Release date: 2019-04-17 (Advanced Control pack v3) ▪ Added LMDMP (Lightware Multicast Device Management New feature: Protocol) feature. ▪ Initial release ▪ Modified...
  • Page 119: Hashtag Keyword List

    IP port blocking (IT security) This keyword is placed at the DHCP (dynamic IP address) setting in #producttype Product type query the front panel operation, the Lightware Device Controller (LDC) and #protocol RS-232 protocol setting the LW3 programmer's reference section.
  • Page 120: Further Information

    1.4. Product failures from six (6) months to the end of the warranty period will either be repaired or replaced at the discretion of Lightware. If Lightware chooses to replace the product then the replacement will be warranted for the remainder of the original unit’s warranty period.

This manual is also suitable for:

Rap-b511-kRap-b511-wRap-b511-sRap-b511-ukRap-b511-us

Table of Contents