readme.html

gps数据显示软件

            </pre>
            The first id is my bluetooth dongle on the pc, the second is the gps device.
            So, with this id, we can create a virtual serial port using <code>rfcomm</code>:
            <pre>
            rfcomm bind /dev/ttyS50 00:0D:B5:30:3C:0A
            </pre>
            As rxtx does not allow <code>/dev/rfcomm0</code> as serial device, I used <code>/dev/ttyS50</code>
            (all ttys below 50 were already existent in my installation). A symlink from
            ttyS50 to rfcomm0 also works!
            </p>
            <p>
            After this, I set some port parameter (I'm not sure, if this is really needed!):
            <pre>
            stty -F/dev/ttyS50 -raw -onlcr
            </pre>
            Now, GPSTool or GPSylon can use the serial port <code>/dev/ttyS50</code> for
            communication with the nmea bluetooth gps device.
            </p>
            <p>
            After closing the application, one should release the bluetooth serial port:
            <pre>
            rfcomm release /dev/ttyS50
            </pre>
            Please note, that all these commands (except for the application start)
            need to be run as root!
            </p>

          <a name="installation"></a>
            <h2>Installation</h2>
            <p>
              No installation of GPSylon itself is needed. Nevertheless, some dependencies
              exist:

              <ul>
                <li>
                  Java in Version 1.4 (or better) is needed. It can be obtained from
                  <a href="http://java.sun.com">Sun's Website</a>. Development is
                  currently done with version 1.5, but tests are done for version 1.4.
                  Java version 1.3 will NOT work!
                </li>
                <li>
                  <p>
                  Starting from Gpsylon V0.5.2, NO installation of the Java serial
                  libraries are needed anymore! The native libraries are shipped with
                  Gpsylon and start scripts are provided (for Linux and Windows)
                  for Gpsylon and Gpstool (ther command line application). So just unpack
                  the archive, and run (or double click) <code>gpsylon.cmd</code>, <code>gpstool.cmd</code>
                  (for Windows) respectivly <code>gpsylon.sh</code>, <code>gpstool.sh</code> for
                  Unix (Native Libraries for Linux, Sun Solaris and MacOSX are provided).
                  As there is no Apple
                  computer around for testing, I am not sure, if the unix scripts will work.
                  Feedback is welcome!
                  </p>
                  <!--
                  Java Communications API is needed, if you want to access a serial gps
                  device directly (if the gps daemon is used or NMEA data is read from a
                  file, this is not necessary). Sun released a new API just recently (only
                  for Windows and Linux), so the decision was made to stick to the packages
                  from <a href="http://www.rxtx.org">RXTX</a>. Use the 2.1 version of
                  the libraries (with the gnu.io package name), NOT the javax.comm packages.
                   -->
                  <!--
                  For Windows use the package provided from
                  Sun at
                  <a href="http://java.sun.com/products/javacomm/index.html">the comm-api
                    webpage</a>. For Linux I used the package provided at
                  <a href="http://www.rxtx.org">RXTX</a>. I used the version that uses
                  javax.comm, not the one using gnu.io (to stay compatible with Sun's
                  naming).
                  -->
                  <p>
                    Jan van Haarst reported that
                    <a href="http://www.brianpoe.com/comfoolery/">comfoolery</a>
                    can be used to forward the serial data to a network socket. GPSylon may
                    connect to this socket when it is configured to use gpsd instead of
                    the serial device.
                  </p>
              </ul>
            </p>
            <a name="installation_database"></a>
            <h3>Database for Location Markers</h3>
            <p>
              GPSylon is able to store and retrieve location markers from
              relational databases via JDBC. By default it uses the pure java
              open source <a href="http://hsqldb.sourceforge.net">Hypersonic
              DB (hsqldb)</a>. It has the advantage that no installation is needed and
              GPSylon creates a database on demand without any hassle.
            </p>
       <p>
        As the
        <a href="http://164.214.2.59/gns/html/index.html">geonet dataset</a>
        is quite large (e.g. Austria 50 thousand entries,
        Germany 170 thousand entries), hsqldb seemed quite slow. So I gave it a
        try with mysql and it seems to be faster! Especially
        searching for location markers is faster by a factor 5 to 10! So I
        added a script
        that creates the table(s) needed (syntax differs slightly from
        the hsqldb syntax). The following steps are needed to use a
        mysql database instead of the built in hsqldb:
        <ul>
         <li>Install MySQL :-)</li>
         <li>
          Create the database: e.g. with the command
          <code>mysqladmin create gpsmap</code>
         </li>
         <li>Start GPSylon and edit database settings in the preferences
          (Location Marker tab):</li>
         <ul>
          <li>
           JDBC Url: <code>jdbc:mysql://localhost/gpsmap</code>
          </li>
          <li>
           JDBC Driver: <code>com.mysql.jdbc.Driver</code>
          </li>
          <li>
           SQL Script to create the Database:
           <code>sql/create_loation_mysql.sql</code>
          </li>
         </ul>
         <li>quit GPSylon</li>
         <li>on the next start, GPSylon tries to access the new database, but
          cannot (as the tables are missing). It asks for administrators
          username/password (try "root" and empty password :-) so it can create
          the table(s). It will also add a user "sa" with no password for
          normal usage (access limited to gpsmap database).</li>
         <li>That should be it! From now on, all location markers are stored
          and retrieved from the MySQL database.</li>
        </ul>
        For Postgresql support use the following configuration:
        <ul>
         <li>JDBC Url: jdbc:postgresql://localhost/gpsmap</li>
         <li>
          JDBC Driver: <code>org.postgresql.Driver</code>
         </li>
         <li>
          SQL Script to create the Database:
          <code>sql/create_loation_postgresql.sql</code>
         </li>
        </ul>
        The rest of the postgresql configuration is similar to the mysql
        configuration (install database, create a gpsmap database, create user
        and user rights, ...)
       </p>
            <a name="run_gpsmap"></a>
              <h2>Run GPSylon</h2>
              <p>
                To start GPSylon, <a href="https://sourceforge.net/project/showfiles.php?group_id=64816">download</a> the gpstool-archive, unpack it and call<br>
                  <code>java -jar gpssylon.jar</code><br>
                    or if your environment is setup to handle jar-archives correctly, simply
                    double click on the jar-archive (should work under
                    windows). All needed classes are contained in the jar file.
                    If you have the ant environment installed, call <code>ant run</code>.
              </p>
              <p>
                For commandline arguments (everything may be configured in the
                application as well!), call<br>
                  <code>java -jar gpsylon.jar --help</code><br>
              </p>
	      <h3>Mouse Modes</h3>
	      GPSylon supports different mouse modes. Mouse modes may be added
	      as plugins. At the moment, two mouse modes are available:
	      <ul>
	      <li>Navigation Mode: click anywhere in the map to zoom in and
	      center at the clicked position. If the shift-key is held, a click
	      zooms out. More navigational functionality will be implemented
	      soon (pan, ...)</li>
	      <li>Download Mode: If the download mode is used, a window opens
	      that displays some information about the map(s) to download. In
	      the map window, a red rectangle (with crossed lines) shows the
	      current location and size (size may not be exact and varies
	      slightly from one internet map server to another). The user may
	      change the location either by clicking in the map or by changing
	      the coordinates in the download window. The coordinates may be
	      entered in different formats (decimal, using the degree sign,
	      etc.). The user may click and drag in the map to draw a
	      rectangle. If the rectangle is larger that a single map, more
	      than one rectangle is shown and the number of maps to download is
	      shown in the download window. Please do not download maps
	      excessively, as the companies that provide the maps do not like
	      that and will stop their service if it is misused!</li>
	      </ul>
	      <a name="plugins"></a>
	       <h2>Plugins</h2>
	       <p>
	       GPSylon supports plugins of various kinds. The plugin-jars
	       are used without the need to set the
	       <code>CLASSPATH</code>. All jars in the directories
	       <code>[home]/.gpsylon/plugins</code> and in the
	       <code>plugins</code> directory of the applicaton are used.
	       </p>
              <a name="download"></a>
                <h2>Download</h2>
                Please download the latest distribution of GPSylon at the
                <a href="http://sourceforge.net/project/showfiles.php?group_id=64816">download
                  page on sourceforge</a>.
                <a name="status"></a>
            <h2>Status</h2>
            <p>
             GPSylon is in beta-status. It runs quite stable, but many features
             are
             not implemented yet.
            </p>
            <a name="press"></a>
             <h2>Articles about GPSylon</h2>
             <p>
               Elliotte Rusty Harold, the author of quite a few books about Java, mentioned GPSylon
               in his <a href="http://www.cafeaulait.org/">Cafe au Lait blog</a>.
             </p>
            <a name="otherprojects"></a>
             <h2>Other Projects</h2>
             <p>
               Other projects that use parts of the gpsinput/gpsylon code are:
               <ul>
                 <li><a href="http://www-adele.imag.fr/~donsez/dev/osgi/gpspositionproducer/readme.html">GPS Position Producer</a></li>
               </ul>
             </p>
             <p>
               Projects that are somehow related to this project:
               <ul>
                 <li><a href="http://www.gpsdrive.cc">Gpsdrive</a> was the main inspiration to write gpsylon.</li>
                 <li><a href="http://mapgeneration.berlios.de/">MapGeneration</a> tries to create free
                 vector data from NMEA streams - this was one of the goals gpsylon was written for!</li>
                 <li><a href="http://maps4free.de">Maps4Free</a> tries to do the same as a community project.</li>
               </ul>
             </p>
            <a name="todo"></a>
             <h2>To Do List</h2>
             <p>
              urgent:
              <ul>
               <li>option to use always info from gpsdrive</li>
               <li class="todo-done">optionally draw rectangle for small scale maps that do not
                show (done (map manager plugin)): done</li>
               <li>download maps also larger than 1280x1024</li>
               <li>use repaint(int,int,int,int): mostly done</li>
               <li>are there GPS devices, that do not send RMC (for gps