AMX PCLINK WEB User Manual

i!-PCLink/Web
instruction manual
integration!Solutions
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.
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
Introduction ...............................................................................................................1
Supported Operating Systems .......................................................................................... 1
Minimum PC Requirements .............................................................................................. 1
Installing i!-PCLink/Web .................................................................................................... 1
Running i!-PCLink/Web ............................................................................................3
Control Panel..................................................................................................................... 5
NetLinx Connection ........................................................................................................... 6
Application Shortcuts....................................................................................................... 11
Preferences ..................................................................................................................... 12
i!-PCLink/Web Application .....................................................................................13
Main Page ....................................................................................................................... 13
Shortcuts ......................................................................................................................... 14
File Browser .................................................................................................................... 15
Internal Web Browser...................................................................................................... 16
Programming i!-PCLink/Web .................................................................................19
Commands ...................................................................................................................... 19
In-bound Strings .............................................................................................................. 21
Out-bound Strings ........................................................................................................... 22
Channels ......................................................................................................................... 22
Levels .............................................................................................................................. 23
Module............................................................................................................................. 23
i!-PCLinkWeb
i
Table of Contents
ii
i!-PCLinkWeb

Introduction

i!-PCLink/Web™ is an application for Microsoft© Windows that integrates a NetLinx control system with the files on the computer. By installing i!-PCLink/Web, a NetLinx system can take control of your computer by allowing you to browse for files and open them in their associated applications. For instance, on a touch panel, you can navigate to a directory containing Microsoft© Word documents. If you then select the file and press open, Microsoft© Word will be launched on the computer and that file will open. You can open any file type by simply selecting it. You can also open your internet browser and open any web site directly simply by telling i!-PCLink/Web which site to open. i!-PCLink/Web also has the ability to send keyboard input and control other applications windows running on the system. i!-PCLink/Web is an ideal solution for developing kiosk based systems or any NetLinx solution that must interact with a PC.

Supported Operating Systems

Windows 2000® Professional or Server (running on a Pentium 500 MHZ processor
(minimum requirement); with 128 MB of installed memory).
Windows XP® Professional (running on a Pentium 500 MHZ processor (minimum
requirement); with 128 MB of installed memory).
Introduction
Windows 2003® Server (running on a Pentium 933 MHZ processor (minimum
requirement); with 256 MB of installed memory).

Minimum PC Requirements

Windows-compatible mouse (or other pointing device)
At least 20 MB of free disk space (150 MB recommended)
VGA monitor, with a minimum screen resolution of 800 x 600
A Network adapter
Internet Explorer 5.5 (or newer) is required to use the i!-PCLink/Web internal web
browser.
If you are installing i!-PCLink/Web on a Windows 2000, Windows XP, or Windows 2003 machine, you must have Administrator rights to install and run all required system files.

Installing i!-PCLink/Web

1. In Explorer, double-click i!-PCLinkWeb2Setup.exe from the directory window where you
downloaded the i!-PCLink/Web2 install program.
2. After reading the License Agreement, select I Agree and Next to proceed.
i!-PCLinkWeb
3. The Welcome To i!-PCLink/Web Setup dialog appears, reminding you to close all Windows
programs before going any further. Click Next to proceed.
4. In the Select!-PCLink-Web2 Install Location dialog, use the Browse button to navigate to a
directory other than the default install directory, if desired. Click Next.
1
Introduction
5. In the i!-PCLink/Web2 Shortcut Creation dialog, select Install Shortcut Icons for the installed
components on your desktop, if desired.
6. Click Next in the Start i!-PCLink/Web Installation dialog to install the selected components.
7. The program prompts you to restart your system to complete the installation.
2
i!-PCLinkWeb

Running i!-PCLink/Web

i!-PCLink/Web normally runs in the system tray as a small globe icon.
FIG. 1 i!-PCLink/Web in The System Tray
You can double-click on this icon to bring up the i!-PCLink/Web control panel. You can also right click on the icon to bring up a menu with Restore, Connect/Disconnect, Preferences, Help and Exit.
Running i!-PCLink/Web
FIG. 2 i!-PCLink/Web Context Menu
Restore will bring up the i!-PCLink/Web control panel.
i!-PCLinkWeb
FIG. 3 Control Panel
3
Running i!-PCLink/Web
FIG. 4 Preferences
The Connect/Disconnect item will change depending on the current connection state; it
will allow you to change the connection state.
The Preferences option will open the i!-PCLink/Web preferences dialog. From the
Preferences dialog you can choose options to "Prompt for Program Exit" and "Start i!­PCLink/Web with Windows"
Help displays the i!-PCLink/Web Help File
Exit causes i!-PCLink/Web to shutdown.
The system tray icon will show the current connection state by changing the icon. The icon may be one of these three states: Connected, Disconnected or Listening.
System Tray Icons
The Connected icon is a globe icon similar to the icon in the upper-left corner of the control panel and informs you that the i!-PCLink/Web application is connected to a NetLinx master.
The Disconnected icon is the same as the above icon with a red "X" in the lower right hand corner and informs you that the i!-PCLink/Web application is not connected to a NetLinx master.
The Listening icon is similar to the connected icon with an hourglass in the lower right hand corner informing you that the i!-PCLink/Web application is waiting for a master to initiate a connection.
4
i!-PCLinkWeb
Loading...
+ 22 hidden pages