{"id":16,"date":"2014-05-10T12:27:21","date_gmt":"2014-05-10T19:27:21","guid":{"rendered":"http:\/\/openskipper.org\/openskipperwordpress\/?page_id=16"},"modified":"2014-05-28T03:18:27","modified_gmt":"2014-05-28T10:18:27","slug":"technical-details","status":"publish","type":"page","link":"http:\/\/openskipper.org\/openskipperwordpress\/?page_id=16","title":{"rendered":"Technical Details"},"content":{"rendered":"<h2>NMEA Messages<\/h2>\n<p>Many nautical instruments generate messages in an NMEA 0183 or NMEA 2000 (N2k) format. These messages might give the boat speed or water depth. OpenSkipper is designed to process and display the data contained in these messages. OpenSkipper can also process AIS messages which give information about other vessels; these messages might be received by your VHF radio or AIS receiver, and then transmitted via an NMEA 0183 or NMEA 2000 connection to a PC.<\/p>\n<h2>Incoming Streams<\/h2>\n<p>OpenSkipper can receive NMEA 0183, NMEA 2000 (N2k) and AIS messages and decode (some of) them to extract the data in the messages. NMEA 0183 and AIS messages can be received via a COM port or the internet (via UDB or TCP\/IP). NMEA 2000 messages can be received using the Actisense NGT1-USB NMEA-to-USB converter or over the internet. We describe each of the message sources as a <b>stream<\/b>. OpenSkipper can also process log files (in various formats) that have been recorded from NMEA instruments.<\/p>\n<h2>Out-going Streams<\/h2>\n<p>As well as processing incoming streams, OpenSkipper can forward messages (or generate new messages) into outgoing streams. For example, N2k messages might be forwarded to another computer using a TCP\/IP connection, or broadcast over a network using UDP. This allows scenarios such as a yacht relaying its N2k data to a chase boat to give the chase boat&#8217;s crew a real time display of the yacht&#8217;s performance. Streams can also be recorded to (and replayed) from log files.<\/p>\n<h2>Decoding Message<\/h2>\n<p>OpenSkipper provides editors (called \u2018explorers\u2019) for displaying and editting the XML definition files used to describe how an N2k, AIS or 0183 message should be decoded. For NMEA 2000, these XML files will can be produced using the <a href=\"https:\/\/github.com\/canboat\/canboat\">Canboat<\/a> software.\u00a0 (See the Canboat <a href=\"https:\/\/github.com\/canboat\/canboat\/blob\/master\/analyzer\/pgn.h\">pgn.h<\/a> file for the latest CanBoat PGN information.) The definition files are not yet complete; we welcome more definition details and corrections. Note that OpenSkipper has default definition files built in to the executable. You can edit and save these to disk, and then use them as your default definitions.<\/p>\n<h2>Parameters<\/h2>\n<p>The user can define \u2018Parameters\u2019 such as speed that automatically update their values when the appropriate N2k or 0183 message arrives. A parameter such as &#8216;speed&#8217; can be updated by either N2k or 0183 messages. The parameter definitions define the named fields given in the N2k, AIS and 0183 definitions that should be used to update the value for each parameter.<\/p>\n<h2>Data Display<\/h2>\n<p>The user can design their own screen displays that are used to graphically display values of parameters. As of April 2014, these are defined using a &#8216;Displays.xml&#8217; file. Any standard C# control can be added, with an \u2018extender\u2019 being provided to add NMEA properties specifying which Open Skipper parameter should be displayed, and the name of the control\u2019s property that should be used to do this. More sophisticated custom controls can also be built that directly interpret the messages.<\/p>\n<h2>Web Server<\/h2>\n<p>OpenSkipper has a simple built in Web server. (You need admin privileges to run this under Vista.) This lets you serve up a selection of parameters which get updated in real time. Using an ad-hoc wireless network, you can now view your boat instruments on your WiFi cell phone or tablet.<\/p>\n<h2>Good luck!<\/h2>\n<p>There is still lots to do. As always, we hope to expand the code and its documentation over time, but we hope this is a useful first step. <i>Andrew Mason<\/i><\/p>\n<p>PS: We are not experienced C# programmers; this is our first experiment with C# and so there will be mistakes that we would love to have corrected. All feedback welcome.<\/p>\n<p>All copyrighted terms, including NMEA, NMEA 018, NMEA 2000, Actisense, and NGT1, are the property of their respective owners. Everything provided in Open Skipper is available in the public domain, and has not been obtained as the result of signing any non-disclosure agreements with Actisense or NMEA.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>NMEA Messages Many nautical instruments generate messages in an NMEA 0183 or NMEA 2000 (N2k) format. These messages might give the boat speed or water depth. OpenSkipper is designed to process and display the data contained in these messages. OpenSkipper &hellip; <a href=\"http:\/\/openskipper.org\/openskipperwordpress\/?page_id=16\">Continue reading <span class=\"meta-nav\">&rarr;<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"open","ping_status":"open","template":"","meta":{"footnotes":""},"class_list":["post-16","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"http:\/\/openskipper.org\/openskipperwordpress\/index.php?rest_route=\/wp\/v2\/pages\/16","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/openskipper.org\/openskipperwordpress\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"http:\/\/openskipper.org\/openskipperwordpress\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"http:\/\/openskipper.org\/openskipperwordpress\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/openskipper.org\/openskipperwordpress\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=16"}],"version-history":[{"count":5,"href":"http:\/\/openskipper.org\/openskipperwordpress\/index.php?rest_route=\/wp\/v2\/pages\/16\/revisions"}],"predecessor-version":[{"id":28,"href":"http:\/\/openskipper.org\/openskipperwordpress\/index.php?rest_route=\/wp\/v2\/pages\/16\/revisions\/28"}],"wp:attachment":[{"href":"http:\/\/openskipper.org\/openskipperwordpress\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=16"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}