User manual AMX I!-WEATHER

[. . . ] 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. 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. [. . . ] i!-Weather Service Subscription Current Heat Index Current Wind Chill Current Humidity Current Dew Point Current Barometric Pressure Supported Operating Systems Windows 95®/98® (with at least 48 MB of installed memory) Windows NT 4. 0® Workstation or Server (service pack 6 B or greater, with at least 64 MB of installed memory) Windows 2000® Professional or Server (running on a Pentium 233 MHz processor (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. ) Minimum PC Requirements 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 i!-Weather 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. After reading the License Agreement, select I Agree and Next to proceed. The Welcome To i!-Weather Setup dialog appears, reminding you to close all Windows programs before going any further. 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. In the i!-Weather Shortcut Creation dialog, select Install Shortcut Icons for the installed components on your desktop, if desired. Click Next in the Start i!-Weather Installation dialog to install the selected components. 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. 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. Upon completion of download select Close. i!-Weather 5 Using i!-Weather Saving Presets After you have selected a location, it is retrieved immediately. The selected preset will now display the city, state / city, country. If you select a previously used preset while save is flashing, it will be overwritten. Changing Temperature Units To change temperature units: 1. Next time a weather refresh occurs the units will be updated. Changing Wind Speed Units To change wind speed units: 1. Next time a weather refresh occurs the units will be updated. Changing Pressure Units To change pressure units: 1. Select Inches of Mercury, Millimeters of Mercury (torr), or Millibars. Next time a weather refresh occurs the units will be updated. Auto Refresh Interval Select To select an auto refresh interval: 1. At the bottom-center of the page you will find the "Automatic Refresh" options. If Off is selected, the weather can only be refreshed manually. Auto Refresh refreshes weather data for the current weather location. 6 i!-Weather Programming i!-Weather Programming i!-Weather i!-Weather is comprised of the following files: i!-WeatherApplicationTest. axs (Application Test/Implementation) i!-WeatherApplicationMod. tko (Application Module Definition) i!-WeatherEngineTest. axs (Engine Test/Demo) i!-WeatherEngineMod. tko (Engine Module Definition) i!-WeatherApplicationTest. axs / i!-WeatherApplicationMod. tko Define Module The entire application functionality of i!-Weather is contained in the i!-WeatherApplicationMod. tko file. To include the module in a program, an instance of the module must be defined in the parent program. [. . . ] An available virtual device to be used exclusively for the i!-Weather Application. A character buffer that contains the current zip code to retrieve weather data. A character buffer that contains the current station code to retrieve weather data. A character buffer that contains the encoded weather data structure. Devices Make sure the device IDs are correct in the DEFINE_DEVICE section: //i!-Weather Devices dvWEATHER_IP_CLIENT dvTP dvBROWSER_IP_CLIENT vdvWEATHER = = = = 0:4:0 128:1:0 0:5:0 33001:1:0 //INTERNET CONNECTION //i!-Weather Touch Panel //INTERNET CONNECTION FOR CITY BROWSER //VIRTUAL DEVICE 12 i!-Weather Programming i!-Weather Structures The following structures contain all the detailed weather data elements retrieved by i!-WeatherEngine module. [. . . ]