First copy the open2300.conf-dist file to a location where you want the open2300 tools to read their configuration information. Unless you specify the pathname when invoking the programs the config file must be called open2300.conf. Default locations in chronological order are 1. Path to config file including filename given as parameter (not supported by all tools) 2. ./open2300.conf (current working directory) 3. /usr/local/etc/open2300.conf (typical Linux location) 4. /etc/open2300.conf (typical Linux location) For Windows it is most natural to keep the config file in the same directory as the executables. But for Windows it is best to specify the full path name of the config file. Most of the advanced programs in this package can take the path to the config file as a parameter. For those small tools that cannot - it is best to run the program from the same working directory as where you have the config file. Setting the serial port. In Windows you always have access to COM1, COM2 etc. In Linux it is more tricky. Make sure that the user that runs the binaries has both read and write access to this device. Example chmod 766 /dev/ttyS1 will give access to everyone for COM2. If you want to use the program wu2300 which uploads your weather station data to Weather Underground (http://www.wunderground.com) you will need to register your station at Weather Underground first. You will then get an ID and a password. These must be changed config file. If your computer clock does not run GMT/UTC then you must set the timezone parameter also. There is no configure script. Edit the Makefile manually to change prefix and if needed install directory. Default is /usr/local/bin If you just want the binary executable in the current directory just run 'make' and skip the 'make install'. In Windows it is probably easier to skip the make install and copy the executables manually if needed. You can also run 'make open2300' or 'make dump2300' etc to just create one executable So the fast track steps again are Edit the Makefile and run... make make install To install under Windows either use the binaries or compile the sources using your favorite C compiler. The author has tested everything with the MinGW C-Compiler http://www.mingw.org/ Note: Also read the README make install only copies the most important of the binaries to the bin directory. The mysql2300 has not yet been tested under Windows at the time of the release and there is no binary version for Windows yet. For Linux it requires that you have the mysql client development stuff installed. As RPM it is the "mysql-devel" that must be installed. The mysql stuff will be further tested and developed in the next versions. The Makefile fits a RedHat default installation. If you have a different placement of mysql.h and libmysqlclient.so then find out where they are and change the Makefile. The -I switch is for the include file mysql.h and -L is for the library file libmysqlclient.so.10. Because not all have MySQL installed the make all does not include the mysql2300. Run 'make mysql2300' to build it. You need to setup a database on MySQL. The default open2300.conf assumes the database is called open2300, with a user called open2300 with password mysql2300. Run the mysql2300.sql file in mysql to create the table "weather" in your database. The pgsql2300 is built using 'make pgsql2300'. It is only available for Linux. The files in the htdocs directory is a simple PHP page. It will run on any webserver that runs PHP. Just copy the files to your web document tree. It assumes the binary fetch2300 to be in /usr/local/bin. Just change the path if needed.