AMX RMS CODECRAFTER User Manual
instruction manual
RMS CodeCrafter
Software
AMX Limited Warranty and Disclaimer
AMX Corporation warrants its products to be free of defects in material and workmanship under normal use for three
(3) years from the date of purchase from AMX Corporation, with the following exceptions:
• Electroluminescent and LCD Control Panels are warranted for three (3) years, except for the display and touch
overlay components that are warranted for a period of one (1) year.
• Disk drive mechanisms, pan/tilt heads, power supplies, and MX Series products are warranted for a period of one
(1) year.
• AMX Lighting products are guaranteed to switch on and off any load that is properly connected to our lighting
products, as long as the AMX Lighting products are under warranty. AMX Corporation does guarantee the
control of dimmable loads that are properly connected to our lighting products. The dimming performance or
quality cannot be guaranteed due to the random combinations of dimmers, lamps and ballasts or transformers.
• Unless otherwise specified, OEM and custom products are warranted for a period of one (1) year.
• AMX Software is warranted for a period of ninety (90) days.
• Batteries and incandescent lamps are not covered under the warranty.
This warranty extends only to products purchased directly from AMX Corporation or an Authorized AMX Dealer.
All products returned to AMX require a Return Material Authorization (RMA) number. The RMA number is
obtained from the AMX RMA Department. The RMA number must be clearly marked on the outside of each box.
The RMA is valid for a 30-day period. After the 30-day period the RMA will be cancelled. Any shipments received
not consistent with the RMA, or after the RMA is cancelled, will be refused. AMX is not responsible for products
returned without a valid RMA number.
AMX Corporation is not liable for any damages caused by its products or for the failure of its products to perform.
This includes any lost profits, lost savings, incidental damages, or consequential damages. AMX Corporation is not
liable for any claim made by a third party or by an AMX Dealer for a third party.
This limitation of liability applies whether damages are sought, or a claim is made, under this warranty or as a tort
claim (including negligence and strict product liability), a contract claim, or any other claim. This limitation of
liability cannot be waived or amended by any person. This limitation of liability will be effective even if AMX Corpo-
ration or an authorized representative of AMX Corporation has been advised of the possibility of any such damages.
This limitation of liability, however, will not apply to claims for personal injury.
Some states do not allow a limitation of how long an implied warranty last. Some states do not allow the limitation or
exclusion of incidental or consequential damages for consumer products. In such states, the limitation or exclusion of
the Limited Warranty may not apply. This Limited Warranty gives the owner specific legal rights. The owner may
also have other rights that vary from state to state. The owner is advised to consult applicable state laws for full
determination of rights.
EXCEPT AS EXPRESSLY SET FORTH IN THIS WARRANTY, AMX CORPORATION MAKES NO
OTHER WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. AMX CORPORATION
EXPRESSLY DISCLAIMS ALL WARRANTIES NOT STATED IN THIS LIMITED WARRANTY. ANY
IMPLIED WARRANTIES THAT MAY BE IMPOSED BY LAW ARE LIMITED TO THE TERMS OF THIS
LIMITED WARRANTY.
Software License and Warranty Agreement
LICENSE GRANT.
AMX grants to Licensee the non-exclusive right to use the AMX Software in the manner described in this License. The AMX Software
is licensed, not sold. The AMX Software consists of generally available programming and development software, product
documentation, sample applications, tools and utilities, and miscellaneous technical information. Please refer to the README.TXT
file on the compact disc or download for further information regarding the components of the AMX Software. The AMX Software is
subject to restrictions on distribution described in this License Agreement. YOU MAY NOT LICENSE, RENT, OR LEASE THE AMX
SOFTWARE. You may not reverse engineer, decompile, or disassemble the AMX Software.
INTELLECTUAL PROPERTY.
The AMX Software is owned by AMX and is protected by United States copyright laws, patent laws, international treaty provisions,
and/or state of Texas trade secret laws. Licensee may make copies of the AMX Software solely for backup or archival purposes.
Licensee may not copy the written materials accompanying the AMX Software.
TERMINATION. AMX RESERVES THE RIGHT, IN ITS SOLE DISCRETION, TO TERMINATE THIS LICENSE FOR
ANY REASON AND UPON WRITTEN NOTICE TO LICENSEE.
In the event that AMX terminates this License, the Licensee shall return or destroy all originals and copies of the AMX Software to
AMX and certify in writing that all originals and copies have been returned or destroyed.
PRE-RELEASE CODE.
Portions of the AMX Software may, from time to time, as identified in the AMX Software, include PRE-RELEASE CODE and such
code may not be at the level of performance, compatibility and functionality of the final code. The PRE-RELEASE CODE may not
operate correctly and may be substantially modified prior to final release or certain features may not be generally released. AMX is
not obligated to make or support any PRE-RELEASE CODE. ALL PRE-RELEASE CODE IS PROVIDED "AS IS" WITH NO
WARRANTIES.
LIMITED WARRANTY.
AMX warrants that the AMX Software will perform substantially in accordance with the accompanying written materials for a period of
ninety (90) days from the date of receipt. AMX DISCLAIMS ALL OTHER WARRANTIES, EITHER EXPRESS OR IMPLIED,
INCLUDING, BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE, WITH REGARD TO THE AMX SOFTWARE. THIS LIMITED WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS.
Any supplements or updates to the AMX SOFTWARE, including without limitation, any (if any) service packs or hot fixes provided to
you after the expiration of the ninety (90) day Limited Warranty period are not covered by any warranty or condition, express, implied
or statutory.
LICENSEE REMEDIES.
AMX's entire liability and your exclusive remedy shall be repair or replacement of the AMX Software that does not meet AMX's
Limited Warranty and which is returned to AMX. This Limited Warranty is void if failure of the AMX Software has resulted from
accident, abuse, or misapplication. Any replacement AMX Software will be warranted for the remainder of the original warranty period
or thirty (30) days, whichever is longer. Outside the United States, these remedies may not available.
NO LIABILITY FOR CONSEQUENTIAL DAMAGES. IN NO EVENT SHALL AMX 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 SOFTWARE, EVEN IF AMX 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 AMX Software is 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.
This Agreement replaces and supercedes all previous AMX Software License Agreements and is governed by the laws
of the State of Texas, and all disputes will be resolved in the courts in Collin County, Texas, USA. 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
Welcome to RMS CodeCrafter .................................................................................1
System Requirements ....................................................................................................... 1
Other PC requirements: ........................................................................................................... 1
The RMS CodeCrafter Work Area ...........................................................................3
Menu Bar........................................................................................................................... 3
File Menu ................................................................................................................................. 3
Edit Menu ................................................................................................................................. 3
View Menu ............................................................................................................................... 4
Help Menu................................................................................................................................ 4
Toolbar .............................................................................................................................. 4
Text Field Context Menu ................................................................................................... 5
RMS CodeCrafter Device Template Pages .............................................................7
Device Templates.............................................................................................................. 7
Device Template Main Page ............................................................................................. 7
Device Template Parameters Page .................................................................................. 9
Add/Edit Device Template Parameters Window .................................................................... 10
Set Range for Index or Enum Parameter............................................................................... 12
Device Template Final Page ........................................................................................... 13
RMS CodeCrafter MeetingManager Project Pages ..............................................15
Introductory Page ............................................................................................................ 15
Preferences Window .............................................................................................................. 16
Code Generation Wizard - Start Page............................................................................. 17
Code File Selection Page................................................................................................ 18
Room Information/Options Page ..................................................................................... 18
RMS Server Address Page ............................................................................................. 20
RMS Virtual and Socket Device Definitions Page........................................................... 21
Scheduling: Main Panels Page ....................................................................................... 22
Add/Edit Main Panel Window ................................................................................................. 23
Scheduling: Welcome Panels Page ................................................................................ 24
Add/Edit Welcome Panel Window.......................................................................................... 25
Named NetLinx Devices Page ........................................................................................ 26
Add/Edit Named Devices Window ......................................................................................... 27
Add All Welcome and Main Panels Window .......................................................................... 27
Monitored Third-Party Devices Page .............................................................................. 28
Add/Edit Monitored Devices Window ..................................................................................... 29
RMS CodeCrafter
i
Table of Contents
Add Device from Template Window ....................................................................................... 30
Device Parameters Page ................................................................................................ 31
Add/Edit Device Parameters Window .................................................................................... 32
Set Range for Index or Enum Parameter............................................................................... 34
i!-ConnectLinx Touch Panel Button Mappings Page....................................................... 35
Edit Touch Panel Button-mappings........................................................................................ 36
Generate NetLinx Code File Page .................................................................................. 37
Code Generation Wizard - Finished Page ...................................................................... 38
RMS CodeCrafter AssetManager Project Pages .................................................39
Introductory Page............................................................................................................ 39
Preferences Window .............................................................................................................. 40
Code Generation Wizard - Start Page ............................................................................ 41
Code File Selection Page................................................................................................ 42
Room Information/Options Page..................................................................................... 42
RMS Server Address Page ............................................................................................. 44
RMS Virtual and Socket Device Definitions Page........................................................... 45
Help Desk: Display Panels Page .................................................................................... 46
Add/Edit Help Desk Panel Window ........................................................................................ 47
Named NetLinx Devices Page ........................................................................................ 48
Add/Edit Named Devices Window ......................................................................................... 49
Add All Welcome and Main Panels Window .......................................................................... 50
Monitored Third-Party Devices Page .............................................................................. 50
Add/Edit Monitored Devices Window ..................................................................................... 51
Add Device from Template Window ....................................................................................... 53
Device Parameters Page ................................................................................................ 54
Add/Edit Device Parameters Window .................................................................................... 55
Set Range for Index or Enum Parameter............................................................................... 57
i!-ConnectLinx Touch Panel Button Mappings Page....................................................... 58
Edit Touch Panel Button-mappings........................................................................................ 59
Generate NetLinx Code File Page .................................................................................. 60
Code Generation Wizard - Finished Page ...................................................................... 61
Basic Operations ....................................................................................................63
Creating A New Device Template ................................................................................... 63
Creating A New AssetManager Project........................................................................... 64
Creating A New MeetingManager Project....................................................................... 66
Saving A Device Template File ....................................................................................... 68
Saving A Project File....................................................................................................... 68
Opening An Existing Device Template............................................................................ 68
ii
RMS CodeCrafter
Table of Contents
Opening An Existing Project............................................................................................ 69
Closing A Project Or Template File ................................................................................. 69
Importing RMS SDK Spreadsheets................................................................................. 69
SERVERINFO.TXT Window ........................................................................................... 70
Exiting RMS CodeCrafter ................................................................................................ 71
Adjusting RMS CodeCrafter ............................................................................................ 71
Changing Visual Style ............................................................................................................ 71
Web Update ........................................................................................................................... 71
Setting Template Folder Destination ...................................................................................... 71
Setting Default R.M.S. Server Address.................................................................................. 72
Setting Wizard to Generate Device Variable Warnings ......................................................... 72
Code Generation .....................................................................................................73
File Header...................................................................................................................... 73
DEFINE_DEVICES Section ............................................................................................ 73
Device definitions ................................................................................................................... 73
Device Definition Warnings .................................................................................................... 73
DEFINE_CONSTANT Section ........................................................................................ 74
Server Address Definition ...................................................................................................... 74
Maximum String/Enum Param Length ................................................................................... 74
RMSCommon.axi ............................................................................................................ 74
DEFINE_VARIABLE Section........................................................................................... 74
Device Arrays......................................................................................................................... 74
i!-ConnectLinx variables ......................................................................................................... 75
Function Definitions......................................................................................................... 77
RMSCommon Callbacks ........................................................................................................ 77
RMSDevMonRegisterCallBack .............................................................................................. 77
RMSDevMonSetParamCallBack............................................................................................ 77
RMS Device Parameters........................................................................................................ 78
Module Definitions........................................................................................................... 78
Monitored Device/Support Modules ....................................................................................... 78
Source Usage ........................................................................................................................ 78
RMS Engine ........................................................................................................................... 78
RMSUIMod............................................................................................................................. 78
RMSWelcomeOnlyUIMod ...................................................................................................... 79
KeyboardMod......................................................................................................................... 79
i!-ConnectLinxEngineMod ...................................................................................................... 79
RMSHelpUIMod (AssetManager only) ................................................................................... 79
Event Definitions ............................................................................................................. 80
RMS Engine Device ............................................................................................................... 80
RMS CodeCrafter
iii
Table of Contents
Named Devices...................................................................................................................... 80
Monitored Devices ................................................................................................................. 81
Device Parameters................................................................................................................. 81
i!-ConnectLinx ........................................................................................................................ 81
LEVEL_EVENT Block ............................................................................................................ 81
DATA_EVENT Block.............................................................................................................. 82
BUTTON_EVENT Block......................................................................................................... 83
CHANNEL_EVENT Block ...................................................................................................... 84
RMS Concepts ........................................................................................................85
Device Monitoring Framework ........................................................................................ 85
Device Values ........................................................................................................................ 85
Parameter Values .................................................................................................................. 86
Status Types .......................................................................................................................... 87
RMS SDK And RMS CodeCrafter................................................................................... 88
i!-ConnectLinx ........................................................................................................89
Using i!-ConnectLinx ....................................................................................................... 89
iv
RMS CodeCrafter
Welcome to RMS CodeCrafter
RMS CodeCrafter allows you to create NetLinx include files that contain the code necessary for
monitoring devices using one of the products in the Resource Management Suite, i.e.,
MeetingManager.
RMS CodeCrafter is a wizard application where the output is determined by data and device
information provided by you. As you navigate through the wizard, the options you select and the
data you provide will determine the NetLinx code generated in the final page.
System Requirements
RMS CodeCrafter will support the following platforms:
Windows 2000 (Service Pack 3 or greater)
If you are installing on a Windows 2000 machine, you must have Administrator rights
to install and run all required System files.
Windows XP Professional (Service Pack 1 or greater)
Welcome to RMS CodeCrafter
Other PC requirements:
Windows-compatible CD-ROM drive.
Windows-compatible mouse (or other pointing device).
At least 250 MB of free disk space.
RMS CodeCrafter will not work properly if your display settings is set to Large Font.
RMS CodeCrafter
1
Welcome to RMS CodeCrafter
2
RMS CodeCrafter
The RMS CodeCrafter Work Area
Menu Bar
File Menu
The File menu serves as a location for file management, project information and template
management.
New - Choose between:
New Project - Opens a new RMS CodeCrafter project file (.CGP) and progresses to the
Project Start Page.
New Template - Opens a new RMS CodeCrafter template file (.CGT) and progresses to
the Device Template Main Page.
Open - Choose between:
Open Project - After selecting the desired file in the open dialog window, it opens an
existing RMS CodeCrafter project file (.CGP) and progresses to the Project Start Page.
The RMS CodeCrafter Work Area
Open Template - After selecting the desired file in the open dialog window, it opens an
existing RMS CodeCrafter template file (.CGT) and progresses to the Device Template
Main Page.
Close - Closes the project or template file currently open. If the file has been edited, or is "dirty" as
indicated at the top of the window with an asterisks next to the file name, you are prompted to save
changes before closing.
Save - Saves changes made to either project or template file currently open. If the file has not been
previously been saved you are prompted to name and designate where to save the file.
Transfer Server Address File - Opens the SERVERINFO.TXT window.
Save As - Opens the save file dialog, allowing you to specify the file name and location which to
save.
Most Recently Used List - A list of most recently opened file names.
Exit - Closes the RMS CodeCrafter Wizard.
Edit Menu
The Edit Menu applies to text changes made within the RMS CodeCrafter wizard.
Undo - Undoes action taken in text areas.
Cut - Cut highlighted text from fields.
Copy - Copy highlighted text within fields.
RMS CodeCrafter
Paste - Paste cut and copied text into selected fields.
Delete - Delete selected text within fields.
Preferences - Launches the Preferences window.
3
The RMS CodeCrafter Work Area
View Menu
The View menu allows you to toggle the toolbar and status bar of the RMS CodeCrafter wizard on
and off. A check next to the title indicates it is visible. Additionally you can change the appearance
of the application itself.
Visual Style - A list of visual appearances for the wizard. Select one of the following:
Default
Office XP®
Office 2003®
Help Menu
The Help menu contains features for updating the application and provides a resource
for understanding the RMS CodeCrafter wizard.
Contents - Launches the RMS CodeCrafter help, Contents section.
Web Update - Launches the AMX Web Update utility. Internet connection is necessary.
About RMS CodeCrafter - Displays the about RMS CodeCrafter dialog containing information
pertaining to version and copyright.
Toolbar
The toolbar contains icons for the commonly used functions:
Save
Open
New
Cut
Copy
Paste
FIG. 1 RMS CodeCrafter Wizard Toolbar
New - Launches the Project Start page.
Open - Launches the open project dialog window.
Save - Saves changes made to either project or template file currently open. If the file has not been
previously been saved you are prompted to name and designate where to save the file.
Cut - Cut highlighted text from fields.
Copy - Copy highlighted text within fields.
Paste - Paste cut and copied text into selected fields.
Delete - Delete selected text within fields.
Delete
Print
Help
Print - Prints the active generated code.
Help - Launches the RMS CodeCrafter help file.
4
RMS CodeCrafter
Text Field Context Menu
Right click within any text field to access the text field context menu.
Undo - Undoes last text action.
Cut - Cuts selected text to the clipboard.
Copy - Copies selected text to the clipboard.
Paste - Pastes text from clipboard into text field.
Delete - Deletes selected text.
Select All - Selects all text within the field.
The RMS CodeCrafter Work Area
RMS CodeCrafter
5
The RMS CodeCrafter Work Area
6
RMS CodeCrafter
RMS CodeCrafter Device Template Pages
RMS CodeCrafter Device Template Pages
Device Templates
You can create persistent templates for monitored devices, where you provide the settings and
parameters. RMS CodeCrafter can then use the device templates for similar or the same devices in
other projects.
When you opt to use device templates RMS CodeCrafter pulls all available templates from the
template folder destination, which you can set in the Preferences window. You can create a new
template or open an existing template from within the File menu but either way you are brought to
the Device Template Main page to edit and set parameters.
Device Template Main Page
The Device Template Main page is the first page of the template creation process.
MS CodeCrafter
FIG. 2 Device Template Main Page
7
RMS CodeCrafter Device Template Pages
Template Name - This is the template name provided by you. This is not the file name but by
default it will be used as such when saving. Template name is displayed as a selection when you are
associating new monitored devices with an existing template.
Manufacturer - This is a text field where you can provide the manufacturer information for the
device.
Model - This is a text field where you can provide the model information for the device.\
Uses Communications Module? - Place a check in the box to enable the function. The template
will use a communication module.
Communication Timeout - Measured in 1/10ths of a second, where 0 is a valid value. If no
timeout is required, use -1.
Control Failure Detect - Placing a check in the box adds a call to RMSEnablePowerFailure() in
the generated code file.
Support Module - Click the radio button that best represents the device for the template.
Projector
Transport
Basic
Slide Projector
None
Next - Progresses the wizard to the Device Template Parameters page.
8
RMS CodeCrafter
RMS CodeCrafter Device Template Pages
Device Template Parameters Page
The Device Parameters page is a list of available parameters that can be included with the template.
There is a grid displaying all device parameters currently within the template. In the left-hand
column is a checkbox, when selected indicates the entry is to be deleted.
MS CodeCrafter
FIG. 3 Device Template Parameters Page
Add Parameter - Add a parameters entry.
Edit Parameter - Edit a selected parameters entry.
Next - Progresses the RMS CodeCrafter wizard to the Device Template Final page.
Previous - Regresses the RMS CodeCrafter wizard to the Device Template Main page.
9
RMS CodeCrafter Device Template Pages
Add/Edit Device Template Parameters Window
The Add/Edit Device Template Parameters window allows you to add device parameters or edit
existing ones.
FIG. 4 Add/Edit Device Template Parameters Window
Name - A text field you can edit to name the parameter.
Type - Select one of the parameter types:
Number
Index
String
Enum
Status - select one from the scroll list:
Not Assigned
Room Communication
Control System
Network
Security
Help Request
Maintenance
10
RMS CodeCrafter
RMS CodeCrafter Device Template Pages
Equipment Usage
Threshold Comparison Operator - select from the following:
None
Less Than
Less Than or Equal To
Greater Than
Greater Than or Equal To
Equal To
Not Equal To
Contains (String or Enum only)
Does Not Contain (String or Enum only)
Threshold Value - A text field you can edit to set threshold value. 32-bit signed number for
Number, 16-bit unsigned number for Index and any string up to 100 characters for String and
Enum.
Reset - Place a mark in the box to enable reset of threshold.
Reset Value - A text field you can edit to set reset value. 32-bit signed number for Number, 16-bit
unsigned number for Index and any string up to 100 characters for String and Enum.
Trigger - select one of the following:
None
Button
Channel
Level
Use Range (Number) - Sets the minimum and maximum for number; this value is optional.
Set Range (Enum or Index) - A drop down list of enumeration strings. You can elect to:
Add - adds the sting to the parameter use.
Remove - removes the string from parameter use.
Move Up - moves the string up the list of parameter use.
Move Down - moves the string down the list of parameter use.
OK - Closes the window and saves changes made.
Cancel - Closes window without implementing changes.
MS CodeCrafter
11
RMS CodeCrafter Device Template Pages
Set Range for Index or Enum Parameter
FIG. 5 Set Range for Index or Enum Parameter
Add string - adds the sting to the parameter use.
Remove - removes the string from parameter use.
Move Up - moves the string up the list of parameter use.
Move Down - moves the string down the list of parameter use.
OK - Closes the window and saves changes made.
Cancel - Closes window without implementing changes.
12
RMS CodeCrafter
RMS CodeCrafter Device Template Pages
Device Template Wizard Finished Page
The Device Template Wizard Finished page is the last step in making a device template.
MS CodeCrafter
FIG. 6 Device Template Final Page
Save Template to - A text field where you can either type or click the Browse button to designate
where RMS CodeCrafter wizard is to save the template file (.CGT).
Previous - Regresses the RMS CodeCrafter wizard to the Device Template Parameters Page.
Finish - Generates the template file and stores in the directory specified by the Save Template to
field.
13
RMS CodeCrafter Device Template Pages
14
RMS CodeCrafter
RMS CodeCrafter MeetingManager Project Pages
RMS CodeCrafter MeetingManager Project
Pages
Introductory Page
The Introductory page is the initial page displayed upon launching the RMS CodeCrafter wizard.
RMS CodeCrafter
FIG. 7 Introductory Page
The button you select will determine what file is generated. The buttons are as follows:
New Project - Opens a new RMS CodeCrafter project file (.CGP) and progresses to the Project
Start Page.
Open Project - After selecting the desired file in the open dialog window, it opens an existing RMS
CodeCrafter project file (.CGP) and progresses to the Project Start Page.
New Device Template - Opens a new RMS CodeCrafter template file (.CGT) and progresses to the
Device Template Main Page.
Open Device Template - After selecting the desired file in the open dialog window, it opens an
existing RMS CodeCrafter template file (.CGT) and progresses to the Device Template Main Page.
15
RMS CodeCrafter MeetingManager Project Pages
Additionally, you can set default features of the wizard with:
Edit Preferences - Launches the Preferences window.
Preferences Window
RMS CodeCrafter allows you to set user preferences.
FIG. 8 Preferences Window
Template Folder - A text field where you can either type or click Browse to designate the default
template folder destination.
Default R.M.S. Server Address - A text field where you can edit the server address for the R.M.S.
server. The default value is 0.0.0.0.
Generate Device Variable Warnings - A checkbox, when enabled adds variable warnings in the
generated code.
Save Project on Finish? - A checkbox, when enabled automatically saves your project when you
click the final Finish button.
OK - Accepts the changes and closes the preferences window.
Cancel - Closes the preferences window without incorporating the changes.
16
RMS CodeCrafter
RMS CodeCrafter MeetingManager Project Pages
Code Generation Wizard - Start Page
The Code Generation Wizard - Start page is the first page you see when you open a new or existing
project file.
RMS CodeCrafter
FIG. 9 Project Start Page
Select the appropriate RMS application - This is the RMS application code you want generated.
Click the radio button to select. Your choices are:
MeetingManager (default)
AssetManager
Enter the NetLinx code file (.AXS) or NetLinx Studio workspace file (.APW) to be integrated
into this project. - Either type or click the Browse button for the location of the file to be integrated
into the project. The file can be either a NetLinx code (.AXS) or NetLinx Studio workspace
(.APW) file. The incorporation of either file into a RMS CodeCrafter project is optional.
Next - Progresses RMS CodeCrafter to the next page.
17
RMS CodeCrafter MeetingManager Project Pages
Code File Selection Page
You will see the Code File Selection page if you selected a NetLinx Studio workspace file (.APW)
in the Project Start page. A list of all available NetLinx code files within the .APW file is displayed.
Previous - Returns the wizard back to the Project Start page.
Next - Progresses the RMS CodeCrafter wizard to the Room Information/Options page.
Room Information/Options Page
RMS CodeCrafter supports the ability to add scheduling and i!-ConnectLinx options to a project
file.
18
FIG. 10 Room Information/Options Page
i!-ConnectLinx Options:
Support pre-meeting presets? - Placing a check in this box determines if the i!-
ConnectLinx module is defined in the generated code file.
Monitor source usage? - Placing a check in this box determines if the
RMSSourceUsageMod is defined in the generated code file.
RMS CodeCrafter
RMS CodeCrafter MeetingManager Project Pages
Using multiple display devices? - This option is only available when Monitor source
usage? has been selected. Placing a check in this box determines if a call to
RMSSetMultiSource(TRUE) is included in the DEFINE_EVENT section of the
generated code.
Room Name - A text field, you provide the name of the room. (This field is required)
Location - A text field, you provide the name of the location for the room. (This field is
required)
Owner - A text field, you provide the name of the person that owns the room. (This field
is required)
Scheduling Display:
Click on the radio button for one of these options:
Main and welcome panels - If selected, both the RMSUIMod and KeyboardMod modules
are defined in the generated code file. Additionally, the arrays these two modules are
dependant upon as input arguments are defined.
Welcome panels only - If selected, only the RMSWelcomeOnlyUIMod is defined in the
generated code. Additionally, the array of Welcome Panels is defined.
No scheduling display - If selected, no scheduling mods are included in the generated
code.
Previous - Regresses the RMS CodeCrafter wizard to the Code File Selection page.
Next - Progresses the RMS CodeCrafter wizard to the RMS Server Address page.
RMS CodeCrafter
19
RMS CodeCrafter MeetingManager Project Pages
RMS Server Address Page
The RMS Server Address page allows you the opportunity to specify the IP address of the R.M.S.
server. This is optional and if left unchanged, the default specified in the Preferences window is
used.
20
FIG. 11 Server Address Page
R.M.S. Server Address - A text field where you can type the IP address of the R.M.S. server if
necessary.
Previous - Regresses the RMS CodeCrafter wizard to the Room Information/Options page.
Next - Progresses the RMS CodeCrafter wizard to the RMS Virtual and Socket Device Definitions
page.
RMS CodeCrafter
RMS CodeCrafter MeetingManager Project Pages
RMS Virtual and Socket Device Definitions Page
RMS Virtual and Socket Device Definitions page allows you to determine options related to i!-
ConnectLinx and Scheduling on the Scheduling And i!-ConnectLinx Options page.
RMS CodeCrafter
FIG. 12 RMS Devices Page
vdvRMSEngine - A text field you can edit and specify to meet your needs. The device, port and
socket location of the virtual device, RMS Engine.
dvRMSSocket - A text field you can edit and specify to meet your needs. The device, port and
socket location of the device, RMS Socket.
If these devices are defined in the integrated file, the fields are automatically populated and
protected.
i!-ConnectLinx virtual device:
vdvCLActions - A text field you can edit and specify to meet your needs. The device, port
and socket location of the virtual device, ConnectLinx.
If this device is defined in the integrated file, the fields are automatically populated and protected.
In the event the devices are not defined by the integrated file or there is no integrated file
for the project, the fields are populated by the following defaults:
21
RMS CodeCrafter MeetingManager Project Pages
vdvRMSEngine - 33001:1:0
dvRMSSocket - 0:3:0
vdvCLActions - 33002:1:0
Device definitions are added to the generated code file; otherwise, a warning statement is added in
the generated code file.
Previous - Regresses the RMS CodeCrafter wizard to the Server Address page.
Next - Progresses the RMS CodeCrafter wizard to the Main Panels page.
Scheduling: Main Panels Page
The Main Panels page allows you to add, edit and delete main panels used to display scheduling.
Main Panels page is only available if you selected Main and welcome panels on the Room
Information/Options page.
22
FIG. 13 Main Panels Page
Add Panel - Launches the Add/Edit Main Panel window. Adds a main panel to the project.
Edit Panel - Launches the Add/Edit Main Panel window. When a main panel is selected you can
edit its properties.
RMS CodeCrafter
Loading...