Key digital KD-WP8-2 8 Button Programmable IP IR Wall Plate Control Keypad Instruction Manual

The Experts in Digital Video Technology and Solutions™
Setup & Programming Guide
KD-WP8-2

KD-WP8-2 8 Button Programmable IP IR Wall Plate Control Keypad

8 Button Programmable IP, IR, RS232 Wall Plate Control
Keypad with PoE for KDPlug & Present™, Compass
Control® Pro, and Third-Party Systems via Open API
Default static IP address:
192.168.1.239,port 23

Default IP Address: 192.168.1.239
Quick Setup Guide

https://keydigital.org/category/master-controllers-and-control-interfaces /KD-WP8-2

Please visit www.keydigital.com for the latest product documentation, firmware, control drivers and software downloads. Product features anc specifications are subject to change without notice
Always follow the instructions provided in this Operating Manual.

Accessories

• Qty 1: 6ft USB A to USB micro cable
• Qty 1: Brushed aluminum decora plate
• Qty 4: Decora and box mounting screws
• Qty 10: Inner button caps
• Qty 10: Outer buttons caps (clear)
• Qty 1: Flathead mini screwdriver
• Qty 1: Set button icon sheet
• Qty 1: IR Emitter, 6ft

About KD-WP8-2

Key Digital® KD-WP8-2 is an eight-button control keypad that fits into a single-gang wall box and is PoE powered. KD-WP8-2 is easily programmed via web GUI to send commands over the network to IP controlled devices directly or RS232 and IR devices via the built-in control port. KD-WP8-2 may also be integrated with Key Digital Master Controllers to control additional IR, RS232 and voltage relay devices. Button events may be configured on the press, release, toggle, or press & hold action as desired. Along with selectable blue or red backlighting, KD-WP8-2 includes multiple transparent icon sheets that are simply inserted beneath detachable transparent button caps for a modern and professional appearance. The keypad supports key combo lock & unlock and virtual keypad via password protected web UI, Key Digital Management PC Software, and KD-App. Completed project files may be exported and imported for valuable programming time reduction and straightforward rollout of multiple keypads in cookie-cutter installations. KD-WP8-2’s simplistic open API makes for easy two-way integration with professional control systems and Key Digital’s Compass Control Pro.

Key Features

• PoE Powered: Installs cleanly with PoE network switch or PoE injector (not included).
• Single-Gang: Fits U.S. single-gang wall box. Brushed aluminum decora plate included.
• Ease of Programming: Web GUI walkthrough of network settings, project import & export, button configuration, event programming and virtual event keypad access.
• IP Controller: Natively sends TCP and UDP commands in ASCII or HEX format for controlling IP devices without any additional hardware needed.
• Built-In RS232 and IR: One native RS232 and IR port on 5-pin phoenix connector
• IR, RS232, and Relay Control: Add KD-CX800, KD-MC1000, or KD-IP822/922/1022 master controllers for control of additional IR, RS232, or voltage relay devices.
• Multi-Controller Support: Integrate with any number of KD Master Controllers
• Point-to-Point Support: Direct connect network cabling from KD-WP8-2 to PoE injector and Master Controller for installation without network setup hassle.
• RS232 Command Strings: ASCII or HEX formats supported. Baud rate from 1,200 to 115,200 bps.
• IR Command Strings: Copy & paste Pronto Hex or Compass Control IR burst data.
• 160 Events Possible: Up to 10 commands on button press and release/repeat, for up to 20 events per button and 160 events total.
• Key Combo Security: Two-button press combo and auto lock setting may be applied to lock & unlock keypad.
• Virtual Keypads: Password protected web GUI with user-friendly minimal layout or Programmerfriendly layout with transmit & receive logs.
• KDMS Pro and KD-App Ready: Virtual keypad GUI options accessed by PC software and iOS app.
• Button Configuration: Red or blue LED backlighting, normal or toggle button types, press event, release event, hold for repeat, and hold for send options.
• Detachable Button Caps: 10 inner button caps, 10 outer button caps, and flathead mini screwdriver included.
• Icon Sheets: 175 transparent icons provided. Template available for custom printing.
• Open API: Simple two-way communication protocol for IP integration with control systems.

Application Diagrams

KD-WP8-2 IP Device Control: KD-WP8-2 sends commands directly to the devices via the network.

KD-WP8-2 Built-In Control: KD-WP8-2 controls 1 IR and 1 RS232 device via 4pin Phoenix on rear. For IP control, KD-WP8-2 sends commands directly to the devices via the network.

Additional IP, IR, RS, Relay Control: KD-WP8-2 controls 1 IR and 1 RS232 device via 4-pin Phoenix port. For IP control, KD-WP8-2 sends commands directly to the devices via the network. For additional IR, RS232, and Relay control, KD-WP8-2 sends command string and burst info to supported KD Master Controller.

No network switch Required: KD-WP8-2 is powered by PoE Injector with connectivity to Master Controller. KD-WP8-2 controls 1 IR and 1 RS232 device via 4-pin Phoenix port. For additional IR, RS232, and Relay control, KD-WP8-2 sends command string and burst info to supported KD Master Controller

Quick Setup Guide

Button Caps
PPT or PDF icon sheets (including blank spaces and font info) may be downloaded for custom printing.

1. Remove the desired button icons from the provided sheets.

2. Place icon piece on top of inner button cap (white).

3. Place outer button cap (clear) on top of inner button cap. Ensure the icon placement is still centered. a. IMPORTANT: Tab and slot must be oriented on Left and Right sides of button.

4. Place button onto desired space on KD-WP8-2 with light downward pressure until button clicks into place.
   a. Ensure the button placement corresponds with button numbering (1-8) as programmed.

5. If needed, buttons may be removed using the provided mini flathead screwdriver to gently pry on the outer left or right side.

6. Install KD-WP8-2 and decora plate into wall box after all programming is confirmed.

Note: Peel protective film from icon sheetbefore removing button icons.

Connect

1. Connect KD-WP8-2 to PoE providing network switch or PoE injector.
2. Connect USB cable from service port into programming PC. This will be used for initial setup of desired IP address.
3. For IR control, use the included IR emitter according to the below pinout
4. For RS232 control, use an RS232 cable (not included) with stripped wire ends and insert according to below pinout. For ease of installation, a pre-stripped cable with pinout documented by the manufacturer is recommended. Example
   KD-WP8-2 Pin #| Signal| Cable on KD Accessory
   ---|---|---
   | 1| IR Out| Striped wire on KD IR Emitter
   2| Ground (shared by IR and RS-232)| Solid wire on KD IR Emitter
   3| RS-232 TxD| (not included)
   4| RS-232 RxD| (not included)
5. If controlling additional IR, RS232 or voltage relay devices, add KD-CX800, KD-MC1000, or KD AVoIP Encoders/Decoders with built-in Master Controller functionality to network.

Configure

1. Set the desired IP Address and Control Mode via KDMS Pro
   a. Open KDMS Pro software and perform a USB Scan, ensuring that KD-WP8-2 is connected to PC via USB cable.
   b. Select YES, when asked if your device is a Master Controller.c. (1) Select the KD-WP8-2, (2) enter the desired IP settings, (3) press SAVE disc to update settings, and wait for unit to reboot.d. Select the desired Control Mode of the KD-WP8-2
   i. Standard / Compass (default): KD-WP8-2 executes commands as programmed in web UI. IR & RS232 ports may execute commands as programmed in web UI or in Compass Control. This is the most common mode of use.ii. KeyCode Open API (optional): KD-WP8-2’s IR and RS232 ports may execute commands as controlled by third-party control system. See Open API Control of IR & RS232 Ports section for more details.
   IMPORTANT: KD-WP8-2’s IR and RS232 ports cannot simultaneously run in both Standard / Compass mode and Open API mode. In Open API mode, the built-in IR & RS232 commands programmed in web UI and Compass will NOT run. However, IP commands programmed into KDWP8-2 may run regardless of the selected control mode.
   e. (Optional) if KeyCode Open API Mode is selected, configure the ports as desired. See Open API Control of IR & RS232 Ports section for more information.f. KD-WP8-2 may now be configured using web UI.
   g. If using a master controller, connect via USB and repeat step 1c to set IP address.

2. Connect to KD-WP8-2 via LAN with web UI.
   a. Open web browser and type in the IP address of the KD-WP8-2 as set in step 1 or use default IP address 192.168.1.239 if you did not adjust the IP address.
   b. Enter admin password to login to web UI. Default password is 12345678.
   IMPORTANT: LAN connection between the computer and KD-WP8-2 must be constant and stable to prevent lost work. The LAN connection re-synchronizes upon entering sub-menus, applying, or saving new settings.

3. Set Device Info.
   a. Device Name is displayed on the virtual keypad and is useful if multiple KD-WP8-2s are on the network.
   b. LED Brightness applies to all button LED’s. 1-10 value, with default setting of 10.
   c. Admin Password used for accessing web UI.
   d. User Password set for accessing Virtual Keypad.
   e. Key Combo used to lock & unlock keypad. This is helpful for preventing unauthorized use.
   f. Soft Reset may be used to wipe all programming and settings except network and password.
   g. Reboot for power cycling KD-WP8-2 without physically disconnecting LAN/PoE cable.

4. (Optional) Network Settings. DHCP may be applied if desired.
   Note: Configuration Step 1 uses KDMS Pro software for applying desired IP settings for ease of connecting via USB. Once your computer is on the same network with KD-WP8-2 it is typically easiest to do all device settings and programming using web UI.

5. (Optional) Import Project is used when loading a completed project file where multiple identical / similar systems are installed.

6. Apply Button Settings for each button.
   See figure 6 for Button Settings and options for each.
   a. Button Name: Displayed in the virtual keypad and helps the Programmer keep button events organized.
   i. Max 9 alpha-numeric characters supported (incl space).
   b. Button Type: Normal or Toggle. Toggle button allows for unique event every other time the button is pressed. If Toggle, the Second Press LED is the default LED setting immediately after project load. See Example 1 in the Additional Common Button & Event Examples section. c. Button Press LED type: Red, Blue, or None (Off). Additional LED events can be programmed in the Events section, including LED behavior of other buttons.
   d. Hold Event type: Off, Hold for Repeat, or Hold for Send. If either Hold type is selected, enter a range between 0.5 – 10 seconds.
   When Hold for Repeat is selected, there is a check box that allows you to conveniently duplicate the events of the button press, or you may uniquely program the press and hold events. See Examples 1 and 2 in the Additional Common Button & Event Examples section. Note that Hold events are not supported in Virtual Keypads from mobile and tablet browsers. KD-App does support Hold events.
   e. Release Event: On or Off. Release Event On allows for unique event programming on the button Press & Release. Release event cannot be used when any Hold type is selected.
   f. Choose the next button (1-8) and repeat above steps.
   g. (Optional) If needed, you may refresh the settings from the active project in keypad.
   CAUTION: Settings will revert to previously loaded project. Please load updates to ensure unsaved settings are not lost.

7. Program Events (aka Commands) for each button.
   IMPORTANT NOTES:
   • Many device commands can be found in the IR, RS232 or IP Device Database manager software downloaded HERE. Please refer to the owner’s manual or API document of the controlled device for command info if not.
   • ASCII IP and RS232 command strings which include special characters like %, /, <, >, etc may require entry as HEX data type. Convert each character in the string from ASCII to HEX using a CONVERSION TABLE and use 0D as a carriage return and 0A as a line feed if required. See figure 7z.
   • ASCII and HEX strings have 512 maximum characters.a. Choose desired Button Action to program as previously set in Button Settings:

1. Button Press (Normal)
2. Button First or Second Press (Toggle)
3. Hold for Repeat or Hold for Send, if enabled
4. Release Event, if enabled
   b. Enter desired name of each event. This is helpful for the programmer to keep programming organized. Max 16 alpha-numeric characters supported (incl space).
   c. Choose Event Type. Example images for each event type are found in the following pages.
5. LED Addition controls LED behavior for any of the 8 buttons in addition to the pressed button’s typical LED behavior. See figure 7c1.
6. IP Command sends commands to control a device at the specified IP address and Port number.
   TCP or UDP formats are supported and the data type may be String (ASCII) or HEX format. Enter command info into the Data cell, including \r for carriage return and \n for line feed if necessary. An adjustable delay can be added after the IP Command is sent. See figure 7c2.
7. Delay Addition adds an extra delay (0.1 -10 seconds) to control slower devices. See figure 7c3.
8. Built-In IR executes IR commands from the built-in IR port on the rear of KD-WP8-2. The IR command can be pasted from any Pronto Hex document or from Key Digital’s IR Manager. An adjustable delay can be added after the command is sent. See figure 7c4.
9. Built-In RS232 executes RS232 commands from the built-in RS232 port on the rear of KD-WP8-2. Baud Rate is selectable from 1,200 to 115,200 bps. String (ASCII) or HEX data type may be selected and command info may be entered into the Data cell, including \r for carriage return and \n for line feed. An adjustable delay can be added after the command is sent. See figure 7c5.
10. IR KD-CX/922 sends IR command info to KD-CX800, KD-IP922, KD-IP1022, or KD- IP822 master controllers at the specified IP address and port number and selected I/O port. If KD-IP822 is used, please only select from I/O port 1 or

2. The IR command can be pasted from any Pronto Hex document or from Key Digital’s IR Manager. See figure 7c6.

7. IR KD-MC1000 sends IR command info to KD-MC1000 master controller at the specified IP address and port number and selected I/O port. The IR command can be pasted from any Pronto Hex document or from Key Digital’s IR Manager. See figure 7c7.
8. RS232 KD-CX/922 sends RS232 command info to KD-CX800, KD-IP922, KD-IP1022, or KD-IP822 master controllers at the specified IP address and port number and selected I/O port. Port 1 is not selectable as all MC models do not support RS232 on port 1. Baud Rate is selectable from 1,200 to 115,200 bps. String (ASCII) or HEX data type may be selected and command info may be entered into the Data cell, including \r for carriage return and \n for line feed. An adjustable delay can be added after the command is sent. See figure 7c8.
9. RS232 KD-MC1000 sends RS232 command info to KD-MC1000 master controller at the specified IP address and port number and selected I/O port. Baud Rate is selectable from 1,200 to 115,200 bps. String (ASCII) or HEX data type may be selected, and command info may be entered into the Data cell including \r for carriage return and \n for line feed. An adjustable delay can be added after the command is sent. See figure 7c9.
10. Relay KD-MC1000 sends info to KD-MC1000 to set the Relay port to On (Normally Open) or Off (Normally Closed). See figure 7c10.
    d. (Optional) If needed, you may refresh the settings from the active project in keypad.
    e. (Optional) You may move the current selected event up or down within the programming sequence.
    You may insert a new event or delete the selected event. Note that 10 events are maximum per button action.
    f. (Optional) You may delete all events on the current button.
    g. Choose the next button (1-8) and repeat above steps a-c.
    h. You may choose to (1) copy and (2) paste the events from a programmed button to a desired destination button using the (3) Duplicate Apply button. This is a time saver when many of the events are similar on the buttons. Common Button & Event Examples
    Example 1: Toggle Button.
    The Button must first be configured as a Toggle button type in the button configuration step.Unique events may be programmed on the First and Second Button Actions. Example 2: Hold for Repeat.
    The Button must first be configured for the Hold for Repeat Event and the hold time must be specified in the button configuration step.With Same as Press applied, there is no need to program the repeated event. If unique repeated events are required, de-select Same as Press checkbox and program the Press and Hold for Repeat button actions individually. By default, Same as Press is not selected. Example 3: Hold for Send.
    The Button must first be configured for the Hold for Send Event and the hold time must be specified in the button configuration step. In this example, the user must hold the button for 3.0 seconds before the Hold for Send event is executed.A Hold for Send button may also execute events on the initial button press. Or, you may leave the Press event empty if no events are desired on the initial button press.

8. Export Project
   IMPORTANT: Firmware updates will wipe the KD-WP8-2 of its current project load. Please export a project backup file before performing firmware updates and re-load the file after completion.
   a. Press Export Project to export a .kwp project file for backup on your computer so that it may be used for loading into another KD-WP8-2.
   b. Press Load to Keypad to load the programmed file into the KD-WP8-2. After successful project load and connectivity of your controlled device(s) and (optional) Key Digital Master Controllers, you may now use KD-WP8-2!

9. Virtual Keypad (Pro)
   The Pro Virtual Keypad allows complete control as if you were physically pressing the KD-WP8-2 buttons. In addition to two-way buttons, the Pro Virtual Keypad also provides a log of executed events. All LED feedback in the Virtual Keypad is identical to the physical keypad.
   a. Device Name is displayed as set in the Device Info setting.
   b. Button Names are displayed as set in the Button settings.
   c. Keypad Logs provide info for each event within the button press.
   d. Keypad Logs may be Cleared or Exported as a text file.
   A User Virtual Keypad may also be accessed for a simplified end-user level GUI. See the User Virtual Keypad section for more information. Notes: For best performance, do not run Pro Virtual Keypad and User Virtual Keypad simultaneously.
   Virtual Keypad is optimized for PC web browsers. For iOS users, KD-App is recommended. For Android users, Chrome browser is recommended.

10. (Optional) Firmware
    IMPORTANT: Firmware updates will wipe the KD-WP8-2 of its current project load. Please export a project backup file before performing firmware updates and re-load the file after completion. Consult with Key Digital Technical Support before updating. Hard-wired network connection is recommended.
    a. Download latest firmware file from the Key Digital website, press Browse File button to choose the saved file. A success message provides information about the new firmware version number and release date.
    b. Press the Update Firmware button to proceed and see the status of the firmware update and the rebooting of the unit.

Control
IP Device Control – For IP Control, KD-WP8-2 sends commands directly to the devices via the network. No Master Controller necessary.

• Ensure that the KD-WP8-2 is on the same network with the device you are controlling via IP.
• Refer to the Programming Events section for more information.
• Refer to the Owner’s Manual of the device for control codes.
• Some devices may require IP control to be enabled in the setup menu and power saver / eco mode to be disabled to be controlled when in power off / standby.
• Verify control of the device using a terminal software like TeraTerm or Hercules for Hex devices.

IR, RS, Relay Control: KD-WP8-2 features 1 built-in IR and 1 built-in RS232 port for device control. For additional IR, RS232, or Relay controlled devices, KDWP8-2 sends command string and burst info to any amount KD Master Controllers.

• Ensure KD-WP8-2 is on the same network as the KD Master Controller and the devices have been configured with unique IP addresses.

• Refer to the Programming Events section for more information.
  Key Digital Master Controllers

  Model| Description| Ports| Power
  KD- MC1000| MC w/ 3.5mm 10’s| 6xMulti-function, 1xRS, 1xRelay| Power Supply
  KD- CX800| MC w/ Phx 10’s| 1x1R, 2xMulti- function| PoE
  KD- IP1022| AVoIP Enc/Dec w/ Phx 10’s| 1x1R, 2xMulti-function| PoE
  KD- IP922| AVoIP Enc/Dec w/ Phx 10’s| lx1R, 2xMulti-function| PoE
  KD- IP822| AVoIP Enc/Dec w/ Phx 10’s| 1x1R, 1xMulti-function| PoE

• For IR, locate the device’s IR sensor, test for reliable control by repeatedly pressing button, observe the emitter blinking and successful control of the device before securing the IR emitter over the IR sensor. Use IR emitter blackout covers to prevent the emitter from falling and light from corrupting the IR signal.
• For RS232, null modem adapters or gender changers may be needed depending on the pinout of the device.
• Verify control of the device using a USB to RS232 adapter and a terminal software like TeraTerm or Hercules for Hex devices.

INSTALLATION IN GANG BOX

1. Ensure the keypad is programmed and all 8 buttons are placed on the keypad.
2. Connect network cable from PoE network switch or PoE injector into KDWP8-2 LAN (POE) port.
3. Insert KD-WP8-2 into the gang box, ensure it is right-side-up by confirming with the wording “TOP” printed on keypad. Then, fasten by using the long mounting screws.
4. Place the decora plate into position and fasten using the short decora screws.
5. Test the buttons by pressing a few times each, ensuring that they pop back into position and are not obstructed by the decora plate.

User Virtual Keypad

The Virtual Keypad allows complete control as if you were physically pressing the KD-WP8-2 buttons. The virtual keypad buttons display keypad & button naming, and blinks according to the LED indicator table for twoway feedback identical to the physical keypad. A similar virtual keypad is available using the Key Digital iOS app.
a. In your web browser (Internet Explorer not supported), enter the address