Technical Information

Software-On-Board Online Manual

 
SOB Unlock Codes

Registered or Licensed SOB users can request up to 3  SOB Unlock Codes with this web form.

Each computer will generate a unique PC_CODE on the About SOB form. Press the green-question-mark button (pictured) to get the unique PC_CODE for your computer, enter it into the web form, then enter the UnlockCode received via email, back into the box on the About SOB form.

The standard UnlockCode will enable AccessLevel=1.  This level of access will allow unlimited Waypoints and Route TurnMarks, and will enable additional features in the program. The free trial-period will be extended to 6 months with this UnlockCode.

AccessLevel=2 is available by purchasing a SOB Standard User License (DigiBOAT Shop) and, in addition to enabling all of the Level-1 bonuses, it also enables the additional APA and APB autopilot output NMEA sentences on the Raw NMEA data form, and removes the trial period.

The SOB Network Version requires AccessLevel=4, this can also be purchased on our Shop webpage.

 


C-MAP Electronic Charts: MAXonPC and MAX C-CardsNT+ Cartridges and NT+/PC are the only chart formats compatible with SOB. The obsolete CF85 and CM93 formats can not be used with SOB. Owners of these old charts should inquire with their local C-MAP Dealer or Office for generous upgrade pricing for the new versions.

SOB comes complete with 15 full detail Demonstration C-MAP (NT+ or MAX) Charts for your evaluation purposes. Use these charts to trial both SOB and the C-MAP digital chart system for your own needs. 

To use other specific C-MAP charts for your area, you will have to purchase the Chart Licence Code from C-MAP directly.

See also:    |   Quick Start Manual Page   |   C-MAP Electronic Charts   |   C-MAP Charts Manual Page 

 


Supported NMEA Sentences
(not complete)

 

CODE

Talk/Listen

Enabled

Description

 

Radar

RSD

L

yes

RADAR System Data (Talker is ARPA)

Wind

VPW

L

 

Speed with/against wind (VMG) in knots

VWR

L

yes

Apparent Wind Direction and velocity

VWT

L

 

True wind direction and velocity

MWV 

L

yes

Wind Speed and Angle 

MWD 

L

 

Wind Direction

Depth, Temps & Other

DBK

L

yes

Depth below keel

DBT

L

yes

Depth below Transducer

DPT

L

yes

Depth & Transducer offset

MTW

L

yes

Water Temperature

PSTOB

L

yes

Battery Volts (Dataline Proprietary)

VLW

L

 

Distance Logs

AutoPilot 

APA

T

yes*

Autopilot format A

APB

T

yes*

Autopilot sentence B

BOD

T/L

yes

Bearing - Origin to Destination waypoint

BWR

T/L

yes

Bearing and Distance to Waypoint (Rhumb Line)

BWC

T/L

yes

Bearing and Distance to Waypoint (Great Circle)

XTE

T/L

yes

Cross track error

ASD

 

 

Autopilot system data

AAM

 

 

Arrival Alarm 

Ship & Nav

GLL

L

yes

GPS Position (Global Latitude & Longitude)

GLP

L

yes

Time and Position

HDM

L

yes

Compass Heading

VTG

L

yes

Course/Speed over Ground

VHW

L

yes

Course/Speed over Water

ZDA

L

yes

Time and Date

HCHDT

L

 

Heading True - Gyro Course True

       

RMA

 

 

Navigation data from present position (Loran sentence)

RMB

T/L

yes

Recommended minimum navigation information

RMC

T/L

yes

Recommended minimum specific GPS/Transit data

RME

 

 

Loran Sentence

RMZ

 

 

Garmin proprietary

GPS Data

GGA

L

yes

GPS Fix data

GSA

L

yes

GPS dilution of precision and active satellites 

GSV

L

yes

Satellites in view

SGD

L

yes

Accuracy

Waypoints & Routes

BWW

L

yes

Bearing from Source waypoint to Destination waypoint

WDC

L

yes

Distance to Waypoint (Great Circle)

WDR

L

 

Distance to Waypoint (Rhumb Line)

WCV

L

yes

Velocity Made Good to Waypoint

ZTG

L

yes

Time to go to Waypoint

R00

T/L

 

Waypoints in active route

RTE

T/L

yes**

Waypoints in active route

WPL

T/L

yes**

Waypoint location

       
*   AccessLevel=2  Unlock Code Required (email support@digiboat.com.au)
** RTE & WPL output (talking) to be enabled in an “interim” SOB release

NOTE: SOB supports more NMEA sentences than listed above, including the AIS and ARPA commands. 


Connecting NMEA Navigation Devices

Any navigation instrument that is NMEA 0183 compatible can connect to SOB.

Examples: GPS, Autopilot, RADAR, Apparent Wind Instruments, SONAR (Echo Sounder) for Depth, Speed LOG, Electronic Compass (fluxgate, gyro), Temperature Senders, Volt Meters.


Typical Laptop Connections
(from left): Printer, USB, Docking Station, 
Serial/RS-232 (female 9-pin Serial plug below), 
External Monitor, External Mouse/Keyboard

Example Connection Scenarios


Example 1: I have a Garmin GPSMAP-232 and I need some info on what pins to connect to on my laptop. I don't have an autopilot or any other NMEA devices.

Example 2: Some laptops don't have any serial ports, but have available USB ports.

Example 3: A new USB GPS connected straight to the USB socket on the laptop...go straight to Step 4

Step 1  

You need the PC connection cable supplied by Garmin as a standard accessory: 
Example for "GPSMAP-232"  http://shop.garmin.com/accessories_for_product.jsp?sku=010-00250-00
Power/data cable (bare wires)    Part #: 010-10083-00     $23.30 
Notice that they also have: 
USB to RS232 converter cable
      Part #:010-10310-00     $59.99  
which we need for example 2 in Step 3

Also, with this particular model of the Garmin, and if you have 240/110 Volt power at the GPS unit, you have the option to skip Step 2 by getting Part #010-10275-00/1    

 

Step 2 
Connect a regular "9-pin Female Serial Plug" to the NMEA wires from 
Part 010-10083-00 (for our example 1) 

The serial plug is available from Computer or Electronics shops for a few dollars.
If you don't have serial ports (example 2), you must still connect the serial plug to the wires from the GPS ... see step 3. 

Determine, from the Garmin manual or any notes that came with the accessory, which of its NMEA output wires are GROUND and which is DATA (each product chooses to name these differently - sometimes NEG & POS, or EARTH for GROUND, or OUT for DATA,  etc etc).

The wire-to-plug connection involves soldering two (or three) small wires to even smaller holes. The soldering is easy, it's the fiddly parts that make this job more complex. Test the connection using the "tug test", it will want to be a strong solder joint to survive the marine environment. Recommend that you knot or kink the wire before it leaves the plug housing to prevent direct pulling on the solder joints, some plugs include a clamping mechanism where-in the wire usually needs to be padded-out for the clamp device to work effectively.  

The pin numbers are impressed into the plastic of the plug next to the correct pin. Pin 3 is only connected  if the accessory cable has a wire for NMEA-IN - this allows SOB to talk to the GPS, perhaps uploading waypoints or routes, if they're compatible. 
Only pins 2 & 5 are required for SOB to connect to a GPS. Pin 3 typically connects SOB to an AutoPilot.

 

Step 3 
If your laptop doesn't have a serial port, you'll need a USB to RS232 Converter Cable, again from Computer or Electronics shops for about $60 AUD. 
This will complete the link between the Serial GPS plug and the computer's USB socket.

Notice that Garmin also supply them as an accessory (see example in Step 1).

 

Step 4  
Install the driver for the USB-COM converter cable (or USB GPS driver for Example 3).

Use Windows™ Device Manager* to confirm that a Virtual COM Port has been assigned to it (COM5 in the example at left, SOB should be set to use COM5 when the GPS is connected to the USB to Serial Cable.)

The newer USB GPS devices will also require a virtual COM port to be assigned. Use Device Manager to check for the Virtual Port assignment, and to know which COM number SOB should use.

* Device Manager: is awkward to locate on your computer. The easiest way to run Device Manager is to select Run... from the Start menu, then type DEVMGMT.MSC and press OK.
* or, Try this shortcut
Open Device Manager (Select [Open] when asked. Wont work with Win98)

 

Step 5 
(Optional) If SOB doesn't autodetect the correct COM port on startup, use "COM Detector" (renamed to SOB_COM.EXE with SOBv90) to preset SOB to the COM port discovered with Device Manager in Step 4.

See this section of the Manual to check that the GPS and PC are connected and exchanging data ...
COM Detector V2 is supplied with SOB and can be found on your hard disk here: \SOBvMAX\sob_com. It is also available for download.
Try this shortcut to run SOB_COM (Select [Open] when asked, this link wont work unless sob_com is installed in the default location: c:\SOBvMAX\sob_com.exe)

 

SOB COM Detector V2 (sob_com.exe)
In this example, the PC has three COM ports that are suitable for SOB to use (COM1, 4 and 9). SOB has been configured to use COM1 & COM4.

SOB will use the previously used COM port (if still available), or else it will use the first valid COM port found when it next starts up.

Here is the matching view of Device Manager:

For this example:

COM1 is the native serial port installed in the PC.

COM4 is a "virtual" serial port from a USB connected GPS.

COM9 is an unused "virtual" serial port, from a USB-Serial Converter.

More Connection Info


SOBv90 can read NMEA data from two separate COM ports (whether native serial ports, or "virtual" ports created by a USB-Serial Converter, or USB/BlueTooth GPS) - for connecting multiple NMEA Talker devices to SOB, if they can't be "daisy chained" they will need to be multiplexed to use a single serial port. (See our Shop for Multiplexers)

If no spare serial ports are available on the computer, a USB to Serial Converter is usually a simple solution. These cheap devices easily create more COM ports by using the new USB interface. They are also available as Dual or Quad serial converters ... see our Shop page for samples...


Multiplexer
combines multiple Serial/COM 
devices to use a single PC Serial/COM Port

Most NMEA devices will be automatically set up with the proper settings. If you are experiencing communication problems, check the following settings are correct...

Configure your NMEA devices for:

  • 0183 compatible protocol
  • 4800 bps (baud rate)
  • NMEA Version 2.x (or any lower version)
  • WGS84 Standard (for GPSs)

Consult the device's manual to enable the device for Data Output or NMEA Output (or similar).

A selection of Multiplexers is available from our Shop

Multiple NMEA Listeners can be wired to read the NMEA sentences transmitted by SOB via the COM port output (RMC, APA, BOD etc).

To determine if SOB is receiving the NMEA data correctly, double-click the chart display to show the Raw NMEA Data form. The window panel on the right will fill with clear, ordered alphanumeric "sentences" similar looking to this list: 

$GPBOD,337.8,T,318.4,M,GNDZR0
$GPRTE,1,1,c,0,GNDZR
$PGRME,3.6,M,4.9,M,6.1
$GPGLL,3637.320,S,17452.979,E,234541
$GPRMC,234542,A,3637.322,S,17452.980,E,008.3,154.5,211102,019.4
$GPRMB,A,0.01,R,0,GNDZR0,3514.481,S,17411.581,E,089.3,337.8,-008.3
$GPGGA,234542,3637.323,S,17452.980,E,1,11,0.9,26.9,M,28.9,M,0
$GPGSA,A,3,05,06,10,15,17,18,23,24,26,29,30,0,1.5,0.9,1.
$GPGSV,3,1,11,05,10,341,38,06,64,239,44,10,52,138,45,15,08,259,3
$GPGSV,3,2,11,17,29,250,40,18,07,311,34,23,76,298,44,24,21,099,4
$GPGSV,3,3,11,26,35,034,43,29,42,048,44,30,25,307,37,0,0,0
$PGRMZ,88,f
$PGRMM,WGS 8

 

Sample Wiring Diagrams

  • USB Multiplexor

  • Daisy chained NMEA Instruments;
    and multiple other Serial Devices

  • Multiple NMEA Instruments and Multiplexor

  • GPS + Autopilot

  • 2x GPS (one backup) + Autopilot

  • Multiple nav and other serial devices and redundant computer

  • Multiple nav instruments + AIS, no multiplexer

Click any thumbnail to display the Schematic Diagram, use the full size diagram if you wish to Save or Print

Raytheon SeaTalk example



Configuring and Checking the COM/Serial Port 

Using Windows™ HyperTerminal to test Serial Port Data

A simple and useful program that is automatically installed with Windows, is HyperTerminal. (Start>>Programs>>Accessories>>Communications).

As HyperTerminal starts, check the screens are similar to these below:

Type any name in this box (we suggest NMEA or GPS etc):

Select the first COMx in the list, if this doesn't work then (later on) we'll try the others:
 

Ensure that 4800 bps (or baud) is selected:

If the screen doesn't start to fill with data, then the COMx chosen is probably not the one receiving data. First, try pressing the [On-Hook Telephone] button to start the connection. Otherwise, press the [Properties] button (the right-hand one) and select a different COMx port to test.

A successful connection will look similar to the following sample:



Further Help with SOB COMM/Serial Connections

  • A utility program SOB_COM.EXE  is available on the Download page which can assist with troubleshooting Serial Port issues, and will clearly display any Serial Ports that are available and compatible with SOB. 
    "Detector" can also be used to set/reset SOB's default COMM Ports and baud rates used.

  • Extra help with connecting hardware for use with SOB can be found in the FAQS (Frequently Asked Questions), or on our Message Board

  • Registered SOB users can contact support@digiboat.com.au for assistance with their SOB-NMEA connections. 

  • For data cables for GPS to PC connecting, check the particular device's website, eg: www.garmin.com

  • Email us and request a schematic diagram to help you wire up your own cable (provide details of equipment you are using)



 

Installation Notes


SOB is installed in an unconventional manner ... 

SOB  is designed to be self contained within its own folder (similar to MYOB or the DOS programs of old...). This enables an installed copy of the program, with its data and charts, to be simply copied to any other disk and run as if fully installed. 

A pre-installed copy of SOB can run from a USB Storage Drive, Network Drive, even a large memory card.    NOTE: that SOB can NOT run from a CD-ROM or other read-only storage device, or any folder without read/write access privileges - SOB needs to be able to create certain files on the disk which is not possible with a CD-ROM or security protected drive.

SOB doesn't care where its folder is located on the hard disk, for example:

  • C:\SOB  (our default, and recommended, installation folder)
  • C:\Program Files\SOB (in the regular Windows program folder)
  • C:\My Documents\SOB  (in your personal folder)
  • D:\Navigation\SOB   (second hard drive or other storage device)
  • \\BRIDGE\C\Nav\SOB   (network drive)

    ...are all valid locations for SOB.

For Win2000 and WinXP computers, ensure that you have read/write rights to your SOB installation folder, both (1) while installing,  and (2) whenever you run SOB. If you don't have multiple user ID's on your system then you may need to be logged-in as "Administrator"

SOB Installation Folders


C:\SOB 

sOb.exe The main program file.
SOB_COM.exe Utility program to help configure the Serial/COM ports that SOB uses
uninst.exe If SOB was setup using a self-installing file (instead of simply copying it from another computer), this uninstall program will clean SOB off your computer, however, any Routes, Waypoints or Log files you created will not be removed. 
 
QuickStart.pdf Print this file for easy reference while using SOB.
RELEASE NOTES.pdf Printable document that highlights the new/different features with the latest version
 
ReadMe.txt/Notes.txt
Warning.txt
MOB.txt
Required text files.
SOB will not function successfully without these files present in the same folder as SOBv??.exe.
 
cmWin32.dll
FSYS03.dll 
Required C-MAP library files.
WWB00200.dll
The C-MAP world overview chart, used as the background chart in SOB.
mfc42.dll
msvcrt.dll

Windows library files. Generally not required but included for any systems that do not have these automatically installed with Windows.

 

C:\SOB\Charts 

  • *.MCP  Licensed chart files

    Licensed (purchased) C-MAP Charts are, by default, stored in:
     C:\Program Files\C-MAP NT PC Selector\Charts

    These licensed charts can be moved/copied to SOB's C:\SOB\Charts folder. However you will need to Backup/Restore your Chart License Codes also to this folder from within C-MAP's Chart Selector program.

    (see also C-MAP Charts)

 

C:\SOB\DemoCharts 

  • DMC0xxxx.MCV  Files of this format are unlicensed demonstration C-MAP charts from various locations around the world, including: 
    Sydney ; Auckland ; Singapore ; Maldives ; Hawaii ; etc 

C:\SOB\Logfiles 

  • *.log  Text file captures of NMEA data.
    These files can be copied, archived, renamed etc using regular Windows file-manipulation techniques (Explorer, dragging etc)

    NMEA Log files can be loaded into SOB and replayed as a simulation
  • SOB_NMEA_DATA.log
    This NMEA logfile is opened each time SOB starts. NMEA data is saved to the file if ticked on the Raw NMEA Data Form. 
    This file can NOT be accessed whilst SOB is running, however after exiting SOB, copy, move or rename this file for easy recall to replay the voyage. 
  • !messages.txt 
    All text from the Messages ViewPanel in SOB is periodically logged to the file

C:\SOB\Routes 

  • {route name}.rte each route created in SOB is saved in its own file 

  • PastTrack001(yyyy-mm-dd).rte 
    On program exit, or when requested on the AllRoutes form, SOB will convert the visible PastTrack to a regular Route file. This file can be re-loaded into SOB as a Route and reversed, activated, analysed etc using the standard Route tools.
    NOTE: the PastTrack will NOT be automatically saved to a file if there has been less than (about) 20 minutes of running time.

    Using Windows Explorer and normal file manipulation commands, these plain text Route files can be:  deleted, archived, backed-up, emailed, copied and reloaded

C:\SOB\Waypoints 

  • !default.wpt  
    This is the "current state" of Waypoints used by SOB's last session ; and to be automatically loaded when SOB next starts.

  • {filename}.wpt
    User defined groups of Waypoints stored in their own files for easy loading/unloading into SOB

  • *.txt   or   *.csv
    Move/Copy any raw waypoint file lists in TXT or CSV format to this folder for importing into SOB via the AllWaypoints Form.
    The raw files must be formatted as lists of waypoints in columns with the headings: 
    NAME,  LAT,  LONG
    .
    Each field should be separated by a comma or semi-colon; Lat/Lng can be in any of the three regular formats for expressing an angle (dec-deg, deg-dec-min, deg-min-sec) if decimals are used, they must be a full-stop (ie: US/UK numbering format).

    For example:
    File: SOB\Waypoints\Microline.csv

    NAME, LAT, LNG
    SINGAPR, 04°11.020, 134°55.885
    SAVE011, 00°48.734, 124°11.743
    SAVE012, 00°48.734, 124°11.743
    SAVE013, 01°02.123, 124°22.150
    BINTAN1, 01°10.754, 104°17.651
    ROSEBAY, -33°52.242, 151°15.950
    SHOALBY, -32°43.202, 152°10.432
    KAPLAN , -34°23.043, 150°51.533
    HELSGTE, -26°22.751, 153°07.113
    DREHUNC, -20°54.543, 167°15.470
    B'JOEY , -33°35.102, 151°19.531
    RIVER , 05°12.193, 110°16.172
    BATANGI, 01°09.760, 111°55.483

 

 

C:\SOB\PastTracks 

  • !PastTrack.txt 
    When underway, SOB regularly logs information about the current position, speed, heading, wind, depth etc into this PastTrack file.
    This file is useful for in-depth analysis of a journey (using Excel charting for example)
    The  !PastTrack.txt  file will grow at about 1Mb every 24 hours while underway. We recommend you rename or delete this file periodically.
    (refer to Power Users Manual Page)

  • !LastTrack.trk
    Is a log file of the visible track from the previous SOB session, this is used to re-load the track from the last SOB session, when SOB next starts. 
    Creative use of this file allows any previous logged track to be re-loaded into SOB
    (see Power Users Manual Page)
C:\SOB\Routes\archived
C:\SOB\Waypoints\archived
 
  • Before any Routes, Waypoints, Logs, or PastTracks are overwritten, the original copy is moved to the appropriate archive folder for backup or retrieval

 


<<  Power Users Page  |   Manual Index   |   DigiBOAT Home   |   Networking >>