instruction manual KPDesign Keypad Design Program So ftw are Software Warranty Agreement GRANT OF LICENSE. AMX Corporation grants to you the right to use the enclosed KPDesign software program (the SOFTWARE) on a single central processing unit (CPU). This license is for object code only and does not convey any rights to use of the source code. This Agreement does not authorize you to distribute the SOFTWARE. COPYRIGHT. The SOFTWARE is owned by AMX Corporation, and is protected by United States copyright laws and international treaty provisions. Therefore, you must treat the SOFTWARE like any other copyrighted material (e.g., a book or musical recording) except that you may either (a) make one copy of the SOFTWARE solely for backup or archival purposes, or (b) transfer the SOFTWARE to a single hard disk provided you keep the original solely for backup or archival purposes. You may not copy the written materials accompanying the SOFTWARE. OTHER RESTRICTIONS. You may not rent or lease the SOFTWARE, but you may transfer the SOFTWARE and accompanying written materials on a permanent basis provided you retain no copies and the recipient agrees to the terms of this Agreement. You may not reverse engineer, decompile, or disassemble the SOFTWARE. If the SOFTWARE is an update or has been updated, any transfer must include the most recent update and all prior versions. You may use only one version of the SOFTWARE at any time. You may not use the version of the SOFTWARE not being run on your CPU on any other CPU or loan, rent, lease or transfer them to another user whether with or without consideration. LIMITED WARRANTY LIMITED WARRANTY. AMX Corporation warrants that the SOFTWARE will perform substantially in accordance with the accompanying written materials for a period of ninety (90) days from the date of receipt. Any implied warranties on the SOFTWARE and hardware are limited to ninety (90) days and one (1) year, respectively. Some states/countries do not allow limitations on duration of an implied warranty, so the above limitation may not apply to you. CUSTOMER REMEDIES. AMX Corporation's entire liability and your exclusive remedy shall be, at AMX Corporation's option, either (a) return of the price paid, or (b) repair or replacement of the SOFTWARE that does not meet AMX Corporation's Limited Warranty and which is returned to AMX Corporation. This Limited Warranty is void if failure of the SOFTWARE or hardware has resulted from accident, abuse, or misapplication. Any replacement SOFTWARE will be warranted for the remainder of the original warranty period or thirty (30) days, whichever is longer. NO OTHER WARRANTIES. AMX Corporation disclaims all other warranties, either expressed or implied, including, but not limited to implied warranties of merchantability and fitness for a particular purpose, with regard to the SOFTWARE, the accompanying written materials, and any accompanying hardware. This limited warranty gives you specific legal rights. You may have others which vary from state/country to state/country. NO LIABILITY FOR CONSEQUENTIAL DAMAGES. In no event shall AMX Corporation be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or any other pecuniary loss) arising out of the use of or inability to use this AMX Corporation product, even if AMX Corporation has been advised of the possibility of such damages. Because some states/countries do not allow the exclusion or limitation of liability for consequential or incidental damages, the above limitation may not apply to you. U.S. GOVERNMENT RESTRICTED RIGHTS The SOFTWARE and documentation are provided with RESTRICTED RIGHTS. Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of The Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or subparagraphs (c)(1) and (2) of the Commercial Computer Software--Restricted Rights at 48 CFR 52.227-19, as applicable. Manufacturer is AMX Corporation, 3000 Research Drive, Richardson, TX 75082. If you acquired this product in the United States, this Agreement is governed by the laws of the State of Texas. Should you have any questions concerning this Agreement, or if you desire to contact AMX for any reason, please write: AMX Corporation, 3000 Research Drive, Richardson, TX 75082. Table of Contents Table of Contents Introduction ...............................................................................................................1 Supported Operating Systems ................................................................................................. 1 Minimum PC requirements....................................................................................................... 2 Installing KPDesign ........................................................................................................... 2 The KPDesign Work Area ................................................................................................. 2 Menu Bar........................................................................................................................... 3 File menu ................................................................................................................................. 3 Edit menu ................................................................................................................................. 4 Panel menu .............................................................................................................................. 4 Page menu............................................................................................................................... 5 Item menu ................................................................................................................................ 5 View menu ............................................................................................................................... 5 Tools menu .............................................................................................................................. 5 Help menu................................................................................................................................ 5 Toolbar .............................................................................................................................. 6 Panel Navigator........................................................................................................................ 6 Graphical Navigator ................................................................................................................. 7 Editor Window .......................................................................................................................... 7 Using KPDesign ........................................................................................................9 Creating a New File........................................................................................................... 9 Setting Panel Properties.................................................................................................... 9 Adding a New Page......................................................................................................... 10 Adding an Item ................................................................................................................ 10 Saving the KPD File ........................................................................................................ 10 Importing Files to a Project.............................................................................................. 10 Exporting Files................................................................................................................. 11 Exporting All Pages and Items from a project file .................................................................. 11 Exporting Pages from a project file ........................................................................................ 12 Exporting Items from a project file.......................................................................................... 12 Exporting Pages with Items from a project file ....................................................................... 13 Copying and Pasting Page Items .................................................................................... 13 Using KPDesign Files in NetLinx Studio ......................................................................... 13 NetLinx Modules .................................................................................................................... 14 Minimum Support Requirements for NetLinx Modules........................................................... 14 Configuring NetLinx Source Code for KPD Files ................................................................... 14 Source Code Entry................................................................................................................. 15 KPDesign Keypad Design Program i Table of Contents Sample NetLinx Code ............................................................................................................ 15 Compiling the NetLinx Code .................................................................................................. 17 Downloading the Source Code File to the Master.................................................................. 17 Troubleshooting ..................................................................................................... 19 KPD file error ......................................................................................................................... 19 Page flip errors ...................................................................................................................... 19 Errors while downloading KPD files ...................................................................................... 19 Appendix ................................................................................................................. 21 Application Note: DMS/IMS on NetLinx .......................................................................... 21 Thresholds ............................................................................................................................. 21 Notes on Pages............................................................................................................... 22 IMS Main Page....................................................................................................................... 22 Bargraph Notes ...................................................................................................................... 23 Custom Text Notes ................................................................................................................ 23 Send Commands ............................................................................................................ 24 Embedded Text Codes ................................................................................................... 26 ii KPDesign Keypad Design Program Introduction Introduction The KPDesign software design program enables creation of user interface (UI) pages for the PLKDMS and PLK-IMS KeyPads. This design tool provides a method for programmers and system designers to create a set of pages, menus, and an associated output file. KPDesign generates KPD files that can be imported into a Project in the NetLinx Studio program. The NetLinx Studio compiler uses Modules (code blocks) to accommodate KPDesign files in the compiled Source Code file, and handles transferring the code to the Master, and to the keypad(s). Features: ! ! ! Set temperature display as Fahrenheit or Centigrade (default is Fahrenheit) Set temperature minimum and maximum limits Set display to large or small with right, center, or left justification with word wrapping (PLK-DMS only) Up, Down, Enter, Contact, Mic, and Temperature Compensation configuration for a selected keypad Channel maps of push channels, variable text Quick link simulation to associated pages Auto Assign push channels and/or variable text channels for one or more selected items. Keypad Simulation ! ! ! ! ! If you are familiar with TPDesign, you will find working similarities within the KPDesign program. Supported Operating Systems ! ! Windows 95®/98® (with at least 48 MB of installed memory). Windows NT 4.0® Workstation or Server (service pack 6B or greater, with at least 64 MB of installed memory). If you are installing KPDesign on a Windows NT or Windows 2000 machine, you must have Administrator rights to install and run all required System files. ! Windows 2000® Professional or Server (running on a Pentium 233 MHZ processor (mi ...