?? readme.html
字號(hào):
</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
?? 快捷鍵說明
復(fù)制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號(hào)
Ctrl + =
減小字號(hào)
Ctrl + -