Installation Instructions

You, first of all, need to have the Dallas 1-Wire Weather Station WS-1 Kit with DS9097U-9 serial port adapter. Regarding the assembly and installation of 1-Wire Weather Station Kit, refer to http://www.ibutton.com/weather/index.html.

To set up the software, you need to follow the next installation instructions:

  1. After downloading the zip file for this bean package, unzip it, using the jar command or any unzip utility. This automatically creates a new directory with the bean package name and extracts files into it.

  2. To install the native library, run the setup.exe utility in the lib directory. It will copy the WSNative.dll file in the lib directory to your Windows system directory.

    Note: If you run VisualAge for Java under the WIN32 (Windows95/NT) platform, you need to copy the WSNative.dll file in the lib directory to the <VisualAge>/ide/program directory instead of running the setup.exe utility.

  3. To use these beans in a visual builder tool, import this product jar file in the lib directory into your visual builder tool. Please refer to the User's Guide for your visual builder tool for instructions on how to import jar files.

  4. To use these beans without a visual builder tool, add a jar file in the lib directory to your CLASSPATH setting.

  5. To use the WindDirectionMonitor bean, you need to prepare the ini.txt file. To do it, you should download iButton TMEX Runtime Environment ftp://ftp.dalsemi.com/pub/auto_id/licensed/TM311B32.exe and the 1-Wire Weather Station Demo program ftp://ftp.dalsemi.com/pub/auto_id/weather/1-WireWeather.exe. Then install the software and run the CreateList utility from 1-Wire Weather Station package. Follow the instructions the utility provides you with.
    ATTENTION! The vane should point to the north before you start moving it. Otherwise, the WindDirectionMonitor bean will give you the wrong wind direction.
    Then copy the ini.txt file (it can be found in the same directory where the CreateList utility is.):

    1. For JDK, to the <JDK>/lib directory
    2. For Visual Age, to the <VisualAge>/ide/program/lib directory
    3. For Visual Cafe or JBuilder, to <VisualCafe or JBuilder>/java/lib directory.

    Note: Don't change manually the ini.txt file content, otherwise the WindDirectionMonitor bean will not work properly. If you need to change the file content, remove the old file and run the CreateList utility.

  6. To run the demo application provided with this package, follow the instructions in the Readme.html  file in the demo directory.

Note: This bean package includes separate jar files for design and run-time functions. Import the design-time jar file (weatherstation.jar) into your visual builder tool, and use the run-time jar file (weatherstation_Runtime.jar) for the optimal run-time performance.

Note for the Visual Age users: If you have forgotten to install the native library, you will not see the WeatherStation bean on the design surface of our Demo. Close your visual composition editor, install the native library, and open the Demo in the visual composition editor again. Then refresh the interface for the WeatherStation bean. To see the correct icon for the WeatherStation bean in palette, switch to large icons. You will see the icon for WeatherStation instead of the default VisualAge icon. After this, you can switch back to small icons.