background image

Appendix

21

KPDesign Keypad Design Program

Appendix

Application Note: DMS/IMS on NetLinx

This application note applies to:

DMS and IMS keypads

NetLinx

DMS-IMSMod.tko

Using the DMS-IMSMod.tko module, you can connect the DMS and IMS keypads to a NetLinx 

system. Using the KPDesign program, you can design the pages to be displayed on these keypads.

But how many keypads can you run on a single system?

AMX has tested 48 DMS keypads, along with 8 NXI's, on a single master and found the the system 

requires some modification.

This application note will tell you what you need to do to make it work.

KPDesignTools.axi

If you are using KPDesignTools.axi to generate your pages, be aware that this include file 

uses a large chuck of volatile memory. This file basically holds a set of DMS/IMS pages 

in memory before writing them out: that's 254 pages with 150 items each with 40 

characters of text plus change. If you try to compile both this file and more than 20 copies 

of DMS-IMSMod.tko (i.e. 20 keypads), the system will likely run out of memory.

If you are including more than 20 copies of DMS-IMSMod.tko, you will not be able to 

run all copies of the modules AND the KPDesignTools.axi file at the same time, but the 

only time you really need the KPDesignTools.axi is when you are building the pages. 

You do not need this file to run the pages. If you are using KPDesign to generate your 

pages, you don't need KPDesignTools.axi at all.

Thresholds

You will need to modify the threshold values for LonTalk and the Interpreter. Basically, you are 

allowing more messages to be concurrently handled by the system than the default allow.

In most systems, changing these setting will have no affect on the system. These two values will 

only affect systems running a large number of devices.

To change these threshold settings, go to Terminal or Telnet and type the following:

set threshold<return>

Next, will be prompted for 3 threshold values. You want to set the value to 200, 300 and 200 

respectively:

>set threshold

This will set the thresholds of when particular tasks are pended. The threshold is the number of 

messages queued before a task is pended. Use extreme caution when adjusting these values.

Current Interpreter Threshold = 10

Enter new Interpreter Threshold (Between 1 and 2000) (Default=10): 200

Summary of Contents for KPDesign

Page 1: ...instruction manual Software KPDesign Keypad Design Program...

Page 2: ...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 Cor poration s Limited Warranty and which...

Page 3: ...PDesign 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 Item...

Page 4: ...ng 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...

Page 5: ...wn 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 an...

Page 6: ...contains useful information pertaining to this release 6 In the Select KPDesign 1 0 Program Manager Group dialog select the Program Manager group to add KPDesign icons to 7 In the KPDesign 1 0 Shortcu...

Page 7: ...roject file with a specified filename Save All Saves all open project files Print Opens the Print sub menu with two print options Graphical Prints the page in blocks of six buttons up to 12 lines on a...

Page 8: ...d Copy Copies the selected page or items to the clipboard Append Cut Cuts the selected page or items and appends it to the end of the clipboard contents rather than overwriting them Append Copy Copies...

Page 9: ...sert Item dialog Move Up Moves the selected items up one position in the Items list Move Down Moves the selected items down one position in the Items list Properties Opens the Item Properties dialog V...

Page 10: ...instance if you select a page and then choose Cut or Copy from the drop down or a right click menus the software cuts copies FIG 2 KPDesign toolbar Toolbar Icons Icon Name Description New Page Create...

Page 11: ...ical keypad window is a simulation of the LCD and buttons but does not actually send Push Commands When you click on the Up and Down menu buttons in the simulation The LCD text scrolls Up or Down as i...

Page 12: ...Introduction 8 KPDesign Keypad Design Program...

Page 13: ...t the DMS or IMS graphic in the center and the editing frame on the right 4 Choose File Save to save the new KPD file to a specified directory Setting Panel Properties 1 Select a Panel in the Panel Na...

Page 14: ...ng small or auto font size To set a flip to a different page when this item is selected then select the name of the target page from the Page dropdown menu To flip to a specific item on the target pag...

Page 15: ...list shows each item as it will appear on the display panel If you find an error or anything that you want to change in the Record you ll have to fix it in the source file and re import the file a Se...

Page 16: ...In this case select Pages 3 Click Next to invoke the Step 2 dialog where you can select the page s that you want to export 4 Click Next to invoke the Step 4 dialog where you can select the fields that...

Page 17: ...erentiates between types of levels 5 Click Next to invoke the Summary dialog which indicates the total number of Items exported 6 Click Finish to exit the export file wizard Copying and Pasting Page I...

Page 18: ...use or write a new program in NetLinx Studio that Defines the Virtual devices Defines the Keypad devices Associates the KPD file with defined devices Once you have a program 1 In the DEFINE DEVICE sec...

Page 19: ...ev strFileName strVarTextArray Where Module_Name is a unique name For example DEFINE_MODULE DMS IMSMod mdlDMS or DEFINE_MODULE DMS IMSMod mdlIMS For example Module_Name DMS IMSMod tko Virtual_Dev A vi...

Page 20: ...HAR strVarTextArray 100 40 STARTUP CODE GOES BELOW DEFINE_START StrFileName avcnt11 kpd DEVICE NUMBER DEFINITIONS GO BELOW DEFINE_DEVICE dvVIRT 33001 1 0 dvDMS 10001 1 0 VARIABLE DEFINITIONS GO BELOW...

Page 21: ...ully compiled the Source Code file that contains the keypad module and downloaded it to the Master To download a KPD file to a keypad in the active Project 1 Open the Project containing the DMS or IMS...

Page 22: ...Using KPDesign 18 KPDesign Keypad Design Program...

Page 23: ...aded to the master Flip Errors Problem Solution This is sometimes seen when doing page flips to bar graphs or slider pages This is a bug in an older version of the DMS IMS module This can be corrected...

Page 24: ...Troubleshooting 20 KPDesign Keypad Design Program...

Page 25: ...you are including more than 20 copies of DMS IMSMod tko you will not be able to run all copies of the modules AND the KPDesignTools axi file at the same time but the only time you really need the KPD...

Page 26: ...Up and Down always retain the same functions for all pages IMS prints item 1 text at bottom of main page Only 1 font is allowed per line Use Previous as a page name for previous page flips TIME LDATE...

Page 27: ...999 to 9999 All other versions Bargraghs and Text mode for DMS can range from 255 to 255 IMS Version 5 0 or less has a problem with bargragh offsets other than 0 or less than 0 The maximum allowed ran...

Page 28: ...h text or temperature mode Title mode value min max and step are optional Defaults are Value is returned as a string Example String Return SET SV CR SM Mode Number BARGRAPH 1 TEXT 2 TEMPERATURE 3 SV V...

Page 29: ...text for variable text channels 1 1024 SHO variable text address 1 255 ON OFF 1 0 Turns Button On or Off show hide Since Variable text channel is sent as byte only 1 255 sup ported with this command...

Page 30: ...DMS Only AF Auto Font DMS Only WW Word Wrap DMS Only TEMP Indoor Outdoor Temperatures DMS Only ITEMP Indoor Temperature DMS Only OTEMP Outdoor Temperature DMS Only TIME Time 12 hour Format Only DMS On...

Page 31: ...Appendix 27 KPDesign Keypad Design Program...

Page 32: ...of AMX Corporation AMX reserves the right to alter specifications without notice at any time In Canada doing business as Panja Inc DALLAS TEXAS LOS ANGELES CALIFORNIA MEXICO CITY MEXICO ONTARIO CANADA...

Reviews: