
FAQ
Where is my log file?
Where is my config.ini file?
I can't find all those files you are talking about
A big contributing factor to this problem is that Windows default settings hides system files, and also by default, don't show file extensions.
- These settings can be changed however.
- In XP go to My Computer →Tools → Folder Options -View. Mark “Show hidden files and folders” and untick the box “Hide extensions for known file types”.
- Other versions of Windows are similar, but may not be exactly like this.
Now you should find the files we talked about in the previous paragraph.
I have read the manual, Is there a compatible Hardware List?
Keeping an updated list of all the devices available is virtually impossible.
- As long as your device is able to produce NMEA 0183, OpenCPN most likely won't have any problem understanding it.
- Rather than looking for a list, which can't contain everything, ask in the support forum whether your equipment of choice is likely to work with OpenCPN before going shopping.
I am having trouble with Installation, finding Charts, and connecting GPS & Instruments.
OpenCPN crashes, what should I do?
- It is highly unlikely that uninstalling and reinstalling OpenCPN is going to resolve anything, really. But if you can't resist the temptation, help yourself, it is equally unlikely that it makes the things worse.
- You should have a look into the logfile to find out whether it contains some clues that could help isolate the problem. If the crash is related to displaying a chart, try to isolate on which one and create the simplest possible scenario we could reproduce. You should try to get fresh charts.
- You should try disabling OpenGL if it is enabled or vice versa.
- While OpenCPN is not running, move the complete data folder (C:\ProgramData\opencpn on Windows, ~/.opencpn on Linux ~/Library/Preferences/opencpn / on Mac ) to a backup location and see whether something was rotten in your local OpenCPN data. Do not delete it if you want to keep your waypoints, routes and tracks!
- If on Linux, run opencpn from command line and see whether it produces a backtrace to help identify the cause of the crash.
- Still on Linux, you can use gdb or another debugger to get the backtrace and help identify the cause of the crash.
I have a problem so I reinstalled - but that did not help.
My charts used to show up just fine in OpenCPN, but using 3.0.2 and later, they no longer work.
- OpenCPN used to display charts with an unknown projection as a Mercator chart. The same thing applies to an “UNKNOWN” or not recognized geodetic datum, where OpenCPN used to default to WGS84.
- This is no longer the case. If OpenCPN don't recognize the chart projection, it will not be displayed.
- Potentially serious errors are thus avoided.
- The event is logged in the opencpn.log.
- Users may run into problems if a chart projection is stated as “UNKNOWN” even though it really is a prefect Mercator chart.
- Unfortunately, some conversion tools take a shortcut and don't enter the “PR” tag in the kap-chart-header correctly.
- The projection of a chart can always be found, and the “PR=UNKNOWN” should always be avoided.
Official charts that OpenCPN really can't display, with a latitude < 70 degrees north/south, are very few indeed. Really only a handful of legacy, Gnomonic, large scale charts. Charts with “UNKNOWN” or blank geodetic datum are best avoided, they may be dangerously inaccurate.
I get a lot of error messages when starting OpenCPN from the Linux command line.
Messages like:
- “
ALSA lib pcm.c:2217:(snd_pcm_open_noupdate) Unknown PCM cards.pcm.side ALSA lib audio/pcm_bluetooth.c:1614:(audioservice_expect) BT_GET_CAPABILITIES failed : Input/output error(5)
” or
- “
(opencpn:8979): Gdk-CRITICAL : IA_gdk_drawable_get_size: assertion `GDK_IS_DRAWABLE (drawable)' failed
“
-
'(opencpn:8979): Gdk-CRITICAL : IA_gdk_drawable_get_depth: assertion `GDK_IS_DRAWABLE (drawable)' failed Error opening coefficient file
“
- ”
(opencpn:8979): Gdk-CRITICAL : IA_gdk_window_get_origin: assertion `GDK_IS_WINDOW (window)' failed
“
are quite normal and have nothing to do with OpenCPN. Just ignore them!
Why doesn't the plugin work?
When will OpenCPN be ported to Android?
Why does it take so long time to load vector charts?
- The behavior you see is expected for ENC charts. ENCs must be converted to internal SENC format before use for navigation. This takes a little bit of time, depending on your system capabilities. But it only has to be done once, and the converted SENCs are stored on your system for later use.
- All ECS systems must convert ENCs to SENCs. Some take longer, (like OpenCPN), so that subsequent access is faster. Some convert faster, leaving more work to do at the time of actual chart display. Its a design decision. OpenCPN is optimized for speed in real use, not for speed in conversion.
Why don't charts show at all zoom levels while quilting is enabled?
- If I turn off quilting, I can select the individual maps just fine and zoom to any level on them. No amount of clicking/hiding the maps using the map bar at the bottom of the screen show the maps. Only a zoom allows them to be seen. This problem of disappearing maps happens all over the country at different zoom levels.
- Answer: OpenGL is turned off. Without OpenGL, OpenCPN will not quilt Mercator and Transverse Mercator charts together. Try enabling OpenGL with Options (wrench tool icon)> Display> Advanced. Click on the box between “Graphics” and “Use Accelerated Graphics (OpenGL)” to put a checkmark in the box.
- When OpenGL is enabled, OpenCPN will quilt Mercator and Transverse Mercator charts (and some other projections).
- If “Texture Compression with Caching” is enabled under “OpenGL Options” there will be a delay before each chart is displayed for the first time. Subsequent display of the charts in the cache will be faster.
What are all those 'U' things all over my chart?
- Category of Zone of Confidence = Un-assessed.
- The feature being rendered is S57 Text relating to 'M_QUAL', called “Quality of Data” in “Mariners Standardy
- This is a meta-object describing the quality of data shown. The Attribute of interest is CATZOC, or “Category of Zone of Confidence”.
- The value on most US ENC's is “6”, or “un-assessed”. Thus, the 'U'.
- Unticking the box “Chart Information Objects” hides the “U” symbols.
- For a finer grain control, if you are using Display Category “Mariners Standard”, you can turn this symbol off in OpenCPN by de-selecting the box next to “Quality of Data” in 'Tool Box' / 'Vector Charts' tab 'Mariners Standard' selection list box.
What are those acronyms?
To learn the acronyms used in this application search the S57 'Object and Attribute' catalog at: http://www.s-57.com/
Also, when viewing ENC charts:
- “U's” show up all over the charts
- Text detail seems to be missing ..like bouy identification ..Bridge names and clearances etc…
- Depth sounding seem to disappear zooming in and out.
Hit Text: The A+ button. To show text.
Kap files used to be displayed correctly, now they aren't. Why?
- Old versions of OpenCPN were correcting broken KAPs on the fly. (They work on 3.2 but not on any 4. release ) The new ones don't do it anymore as the number of damaged charts circulating around decreased significantly and we gained some extra performance during chart loading. Refer to these sections of the User Documentation too.
- Chart Conversion Manual Specifically libBSB and ImgKap and Kap files.
- To fix your charts, run bdbfix on them.
What causes spurious waypoints that have to be deleted?
- Condition: Multitude of repeated waypoints, which get copied when a waypoint is dragged. Sometimes a route WP is shifted, two routes are made, one with the name, the other unnamed.
- Possible Solutions: Determine if the addition of waypoints are from inadvertantly hitting the wrong keys on the keyboard, or the mouse.
- The other possiblity is that the navobj change file is corrupted. Close O and try to delete the change file In W8.1 it is found in C:\ProgramData\opencpn/navobj.xml.changes. Normally, after that O will work again.
Can I use my Seaclear wci Charts?
I have routes and way points in Sea Clear and I would like to import them into OpenCPN. Can I do it?
- Yes. I had originally created and maintained all my routes and waypoints in SeaClear, exported them, loaded them into GPSUtility (for Windows) and saved them as text files.
- To import into OpenCPN I opened all my text files (routes and waypoints) with GPSUtility, saved that out as one big gpx file, and loaded it into OpenCPN. Works like a champ.
- I've edited them and saved them back out as GPX files with no trouble.
- Individual routes can be edited and saved in appropriately named GPX files.
I would like to send routes to my GPS via USB or via NMEA Serial connection
There are so many GPS models that the answer is a bit complicated. A lot depends on which GPS model you have. OpenCPN can communicate with many GPS receivers via a serial connection. Some GPS receivers have a serial connector that can be wired to a DB-9 serial connector. Newer ones have a USB port that will appear like a serial connection to your computer. Still newer ones appear to your computer like an external drive.
If your GPS receiver shows up as a serial connection on your computer chances are you can upload routes and waypoints directly to it from within OpenCPN. The GPS and OpenCPN have to be set to the same communication protocol. If you normally have them set to NMEA (for updating the OpenCPN chart display with position data from the GPS) you may need to change a Garmin GPS to the GRMN proprietary protocol to upload routes, waypoints, and tracks. If your GPS doesn't show up as a serial connection you may still be able to transfer routes and waypoints to it outside of OpenCPN. If the GPS appears as an external drive on your computer try this. Use OpenCPN to export your routes and waypoints to a GPX file (read the User Manual section on the Route & Mark Manager for more details). Then use your operating system to copy the GPX file from your hard drive to your GPS. If that doesn't work, try GPSBabel or EasyGPS for the transfer.
Depending on your GPS model and the way the route was created in OpenCPN you may wind up with a route on your GPS or just a list of waypoints. The route points may or may not appear as waypoints on the GPS.
- Garmin has a program called Homeport which connects to most of their small GPSmap and Plotters which will upload/download waypoints and routes. I believe it will also import gpx routes.
- EasyGPS is a free program that allows you to transfer routes, waypoints, and tracks between your Windows computer and your Garmin, Magellan, or Lowrance GPS.
- GPSBabel is another free program that allows you to transfer data between your computer and your GPS. It runs on Windows, Mac, and Linux operating systems and supports a wide range of GPS models.
- There are also some helpful notes in the manual.
- Route & Mark Manager
- Sending Routes and Waypoints to a GPS
- Hardware GPS Devices
- The oBabel plugin uses GPSBabel to transfer routes without leaving OpenCPN.
Whenever I try to open a particular chart OpenCPN crashes. What's going on?
- Chances are the chart file is corrupted.
- Note the name and number of the suspect chart and replace it with a fresh download.
- Read the log file that may contain relevant information regarding the chart.
- Sometimes the bad chart blocks OpenCPN from restarting. Follow these instructions instead - Troubleshoot Installation//
Night time Mode Title bar is bright in Windows
- In Windows, Night, F5, mode. The title bar on the floating plugin window is a bit glaring (this mode is controlled by windows by way of a theme and is not possible to change from an application) .
- The best solution is to simply “dock” the dashboard window at night, either left or right. This brings the window decorations back under OCPN control, and we recently added logic to dim it in this mode.
OpenCPN and Great Circle Navigation
- Raster charts display bearings and headings as straight, measurable lines on the chart. Similarly, Vector ENC's are rendered as Mercator projections in OpenCPN and most other ECS's for the same reason.
- For typical coastal navigation, errors which occur using rhumb line instead of great circle calculations are small for the distances usually covered by one chart.
- Mercator Charts and Mercator navigation is the standard for most navigational purposes. Other terms used instead of “Mercator Sailing” is “Loxodrome Sailing” or “Rhumb Line Sailing”.
As of OpenCPN 3.2.0 Great Circles are handled directly