AMX WEATHER User Manual
i!-Weather
instruction manual
integration!Solutions
Software Warranty Agreement
GRANT OF LICENSE. AMX Corporation grants to you the right to use the enclosed i!-Weather 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
val 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.
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
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.
that you may either (a) make one copy of the SOFTWARE solely for backup or archi-
AMX Corporation disclaims all other warranties, either expressed or implied, including, but
. In no event shall AMX Corporation be liable for any damages
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 .............................................................................................. 1
Installing i!-Weather........................................................................................................... 2
i!-Weather NetLinx Components ....................................................................................... 2
i!-Weather Applications ............................................................................................................ 2
i!-Weather Touch Panel Interfaces........................................................................................... 2
i!-Weather Engines................................................................................................................... 3
Using i!-Weather .......................................................................................................5
Configuring i!-Weather ...................................................................................................... 5
Entering Location by Zip Code .......................................................................................... 5
Entering Location by Station ID......................................................................................... 5
Using the "Browse for Location" Feature .......................................................................... 5
Saving Presets .................................................................................................................. 6
Changing Temperature Units ............................................................................................ 6
Changing Wind Speed Units ............................................................................................. 6
Changing Pressure Units .................................................................................................. 6
Auto Refresh Interval Select.............................................................................................. 6
Programming i!-Weather ..........................................................................................7
i!-WeatherApplicationTest.axs /
i!-WeatherApplicationMod.tko ........................................................................................ 7
Define Module .......................................................................................................................... 7
Devices .................................................................................................................................. 11
Constants ............................................................................................................................... 11
i!-WeatherEngineTest.axs / i!-WeatherEngineMod.tko ................................................... 12
Define Module ........................................................................................................................ 12
Devices .................................................................................................................................. 12
Structures............................................................................................................................... 13
Request New Weather Data .................................................................................................. 14
Receive New Weather Data ................................................................................................... 15
Changing Temperature, Pressure, & Speed Formats ............................................................ 15
Channels ......................................................................................................................... 17
i!-Weather Virtual Channel Map ............................................................................................. 17
Request Channels.................................................................................................................. 17
Status & Request Channels ................................................................................................... 17
Debug Channels .................................................................................................................... 17
i!-Weather
i
Table of Contents
Notification Channels ............................................................................................................. 18
Status Only Channel .............................................................................................................. 19
Commands...................................................................................................................... 19
i!-Weather Virtual Device SEND_COMMANDS ..................................................................... 19
Examples ............................................................................................................................... 20
Appendix A ...............................................................................................................1
Error Codes....................................................................................................................... 1
ii
i!-Weather
Introduction
i!-Weather™ is an application that allows you to retrieve and display current weather with 5-day
forecasting from AMX’s weather provider.
Current Weather Content:
City name for current weather Current Heat Index
Current Temperature Current Wind Chill
Wind Direction Current Humidity
Wind Speed Current Dew Point
Current Conditions Current Barometric Pressure
Forecasting Content:
High / Low Temperature
Introduction
Forecasted Conditions
In order to run i!-Weather, you will need the following:
A NetLinx™ Master with Ethernet that can reach the Internet.
i!-Weather Service Subscription
Supported Operating Systems
Windows 95
Windows NT 4.0
64 MB of installed memory)
Windows 2000
(minimum requirement); 300MHz or faster recommended, with 96 MB of installed
memory.)
Windows ME® (running on a Pentium 266 MHZ processor (minimum requirement);
300 MHZ or faster recommended, with 96 MB of installed memory.)
Windows XP® (running on a Pentium 266 MHZ processor (minimum requirement);
300 MHZ or faster recommended, with 128 MB of installed memory.)
®
/98® (with at least 48 MB of installed memory)
®
Workstation or Server (service pack 6 B or greater, with at least
®
Professional or Server (running on a Pentium 233 MHz processor
Minimum PC Requirements
i!-Weather
Windows-compatible mouse (or other pointing device)
At least 50 MB of free disk space (150 MB recommended)
VGA monitor, with a minimum screen resolution of 800 x 600
A Network adapter
1
Introduction
Installing i!-Weather
1. In Explorer, double-click i!-WeatherSetup.exe from the directory window where you
downloaded the i!-AgendaPlus install program.
2. After reading the License Agreement, select I Agree and Next to proceed.
3. The Welcome To i!-Weather Setup dialog appears, reminding you to close all Windows
programs before going any further. Click Next to proceed.
4. In the Select i!-Weather Install Location dialog, use the Browse button to navigate to a
directory other than the default install directory, if desired. Click Next.
5. In the i!-Weather Shortcut Creation dialog, select Install Shortcut Icons for the installed
components on your desktop, if desired.
6. Click Next in the Start i!-Weather Installation dialog to install the selected components.
7. The program prompts you to restart your system to complete the installation.
i!-Weather NetLinx Components
i!-Weather Applications
i!-Weather is comprised of the following applications:
i!-WeatherApplicationMod.tko: The i!-WeatherApplication module is the fully
developed NetLinx application for retrieving detailed weather data from a given location.
i!-WeatherApplicationTest.axs: NetLinx sample code provided to demonstrate the
proper implementation and usage of the i!-WeatherApplication module.
i!-Weather Touch Panel Interfaces
i!-Weather provides the following user interfaces:
i!-Weather(640X480).tpd: A fully functional user-interface (UI) which allows you to
specify location by zip code, browse to a location, setup presets and select units for
temperature, wind speed, and pressure. (for use with G3 touch panels)
i!-Weather(320x240).tpd: A display-only version for use on smaller resolution panels
(320 x 240). This version allows you to select presets and view all weather content. (for
use with G3 touch panels)
i!-Weather(1024x768).tp4: A fully functional user-interface (UI) which allows you to
specify location by zip code, browse to a location, setup presets and select units for temp,
wind speed. (for use with G4 touch panels)
i!-Weather.kpd: A display only DMS keypad layout. This version allows you to select
presets and view all weather content.
2
i!-Weather
i!-Weather Engines
i!-Weather is comprised of the following:
i!-WeatherEngineMod.tko: This i!-WeatherEngine module is provided to allow custom
NetLinx programs to retrieve weather data in a structured programmable format.
i!-WeatherEngineTest.axs: NetLinx sample code provided to demonstrate the usage of
the i!-WeatherEngine module.
Introduction
i!-Weather
3
Introduction
4
i!-Weather
Using i!-Weather
Configuring i!-Weather
For Subscription Information Contact AMX At: 800-932-6993, option 3.
Entering Location by Zip Code
To enter a location by Zip code:
1. Navigate to the "i!-Weather Select Location" page.
2. Select Enter Zip Code.
3. Enter the 5-digit zip code.
4. Press Done.
This will return you to the "i!-Weather Select Location" page and display the corresponding city in
the "current location" field. From this page you can save the location, or return to the "Main Page".
Entering Location by Station ID
Using i!-Weather
To enter a location by Station ID:
1. Navigate to the "i!-Weather Select Location" page.
2. Select Enter Station ID.
3. Enter the 4-character Station ID.
4. Press Done.
This will return you to the "i!-Weather Select Location" page and display the corresponding city in
the "current location" field. From this page you can save the location, or return to the "Main Page".
Using the "Browse for Location" Feature
To use the "Browse for Location" feature:
1. Navigate to the "i!-Weather Select Location" page.
2. Select either Browse International or Browse US.
3. Select Country or State.
4. Press Select.
5. Select the desired city. This will display the Station ID used on the "Enter Station ID" page.
This will also return you to the "i!-Weather Select Location" page and display it in the "current
location" field. From this page you can save the location or return to the "Main Page".
From time to time the browsable list of cities may become outdated, or new cities may come online.
It may be necessary to update these lists. To update these lists:
i!-Weather
1. Navigate to the "i!-Weather Select Location" page.
2. Select Update Location Lists.
3. Select Start Download to begin downloading the files.
4. Upon completion of download select Close.
5
Loading...