Differences

This shows you the differences between two versions of the page.

--- ve.can:nmea-2000:start [2021-03-15 00:10] – mvader
+++ ve.can:nmea-2000:start [2021-12-09 10:24] – [3.2 NMEA 2000 instancing] mvader
@@ Line 3: / Line 3: @@
 ===== 1. Introduction =====
-This technical document explains how to integrate a Victron system onto a Marine MFD, such as those from Garmin, Raymarine Navico and other brands.
+==== 1.1 Summary ====
+This document explains how to integrate a Victron system onto a marine MFD also known as a chart plotter. Compatible brands include Garmin, Raymarine, the Navico brands B&G, Simrad and Lowrance as well as Furuno.
-There are multiple ways to integrate, so make sure to closely read the complete introductory chapter to find the best method for your type of system.
+There are multiple options, and how to best integrate depends on the customer requirements, preferred MFD brand and model as well as used Victron components.
-=== Systems with a GX Device ===
+Make sure to closely read this full document to find the best method for your type of system.
-For most installations and integrations, it will be best to use one of our [[venus-os:start|GX Products]]. It acts as a hub, collecting information from connected equipment, such as Inverters, Battery Monitors and Chargers; and then making them available to the MFD.
+{{:ve.can:nmea-2000:image_hml5_nmea2k_arrows.png?direct&500 |}}//Picture showing the two integration options, NMEA2000 and HTML5 App. Click to see full size and see the difference between the two.//
+==== 1.2 What is NMEA 2000? ====
+NMEA 2000 is a communications standard used for connecting marine sensors and display units within ships and boats.
-There are two ways to connect a GX Device to a MFD:
+Victron Energy is a member of the NMEA 2000 organisation, and we have several of our products certified by NMEA 2000.
-- the (simpler) plug and play like method uses an Ethernet connection, which enables the MFD App. Available for [[https://www.victronenergy.com/panel-systems-remote-monitoring/marine%20mfd%20gx%20integration%20-%20raymarine|Raymarine]], [[https://www.victronenergy.com/panel-systems-remote-monitoring/marine%20mfd%20gx%20integration%20-%20garmin|Garmin]], as well as the [[https://www.victronenergy.com/panel-systems-remote-monitoring/marine%20mfd%20gx%20integration|Navico brands B&G, Lowrance and Simrad]]. Click those links to go straight to all information, videos and manuals.
+NMEA 2000 is sometimes also refered to as N2K, for brevitiy.
-- in an the NMEA2000 network. See the [[https://www.victronenergy.com/media/pg/Cerbo_GX/en/marine-mfd-integration-by-nmea2000.html |NMEA 2000 chapter in the Cerbo GX manual]] for details.
-Both connections can be made and used at the same time, and each has its advantages and disadvantages. The MFD App is by far the simplest and plug and play-like method. It presents an easy to use system overview without requiring any configuration. The NMEA 2000 integration on the other hand, whilst being more complex, allows more customisation on the MFD: the data will show up in the data-tree of the MFD, and most MFDs then allow the user to configure various pages and combinations of information. This is not so with the MFD App, as the only available settings are to show or hide battery parameters (Voltage, SOC, Current) as well as naming the batteries.
+==== 1.3 What is the MFD HTML5 App? ====
+The MFD HTML5 App is a simple to install and setup integration into all main marine MFD brands, including Raymarine, Garmin, Navico and Furuno. Truly plug-and-play: once the Victron GX Device and the MFD are connected via ethernet, a Victron logo will appear in the App menu of the MFD. Behind that button, there is a page to monitor and control the Victron Energy system. The information on screen automatically adapts to the installed Victron system.
-Note that, besides making information available on NMEA 2000, a GX Device can also read tank level data from NMEA 2000. More information in [[https://www.victronenergy.com/live/ccgx:start#connecting_nmea-2000_tank_senders|the NMEA 2000 tank sender section in the CCGX Manual]].
+==== 1.4 Other integration options ====
+This document only covers integration via NMEA2000 as well as the MFD HTML5 App. There are two other alternatives, commonly used to integrate Victron equipment in a Marine applications.
-=== Direct connection - products with a VE.Can port only ===
+First of all Modbus-TCP. Typically used on larger vessels, Modbus-TCP is a protocol commonly used for (custom) designed SCADA systems. The Victron GX devices all support the Modbus-TCP protocol. More information in the [[ccgx:modbustcp_faq|]].
-Some of our products feature a VE.Can port; and can thus be directly connected to the NMEA 2000 network. No electronic converter necessary; only a plug conversion cable, the [[https://nocache.victronenergy.com/accessories/ve-can-to-nmea2000-micro-c-male|VE.Can to NMEA2000 cable]].
+The other alternative is SignalK. More information about that in the [[venus-os:large|Venus OS Large manual]]. Do take note of the contents of the Support chapter.
-=== Using our converter interfaces (DEPRECATED!) ===
+===== 2. Integration details =====
-  * [[https://www.victronenergy.com/accessories/ve-bus-to-nmea2000-interface|VE.Bus to NMEA 2000 interface]]
+==== 2.1 Systems with a GX Device ====
-  * [[https://www.victronenergy.com/accessories/ve-direct-to-nmea2000-interface|VE.Direct to NMEA 2000 interface]], for BMV Battery Monitors (only).
-Note that the use of both those interfaces is deprecated. Use a GX Device instead.
+For most installations and integrations, it will be best to use one of our [[venus-os:start|GX Products]]. It acts as a hub, collecting information from connected equipment, such as Inverters, Battery Monitors and Chargers; and then making them available to the MFD.
-=== What is NMEA 2000? ===
+The GX devices offer both above introduced integration options: NMEA2000 as well as the Victron HTML5 App.
-NMEA 2000 is a plug-and-play communications standard used for connecting marine sensors and display units within ships and boats.
+The HTML5 integration is available for  [[https://www.victronenergy.com/panel-systems-remote-monitoring/marine%20mfd%20gx%20integration%20-%20raymarine|Raymarine]], [[https://www.victronenergy.com/panel-systems-remote-monitoring/marine%20mfd%20gx%20integration%20-%20garmin|Garmin]], [[https://www.victronenergy.com/panel-systems-remote-monitoring/furuno |Furuno]] and Navico brands: [[https://www.victronenergy.com/panel-systems-remote-monitoring/marine%20mfd%20gx%20integration|B&G, Lowrance and Simrad]]. Click those links to go straight to all information, videos and manuals.
-Victron Energy is a member of the NMEA 2000 organisation, and we have several of our products certified by NMEA 2000.
+When connected to the onboard NMEA2000 network, the GX Device can read data from the network (tank level and GPS information). Also it can make data from Victron devices connected to the GX Device available on the NMEA2000 network. That latter feature is called NMEA2000-out, more information in the [[https://www.victronenergy.com/media/pg/Cerbo_GX/en/marine-mfd-integration-by-nmea2000.html|NMEA 2000-out chapter in the Cerbo GX manual]].
-For brevity, this document will refer to NMEA 2000 as N2K.
+Both the NMEA2000 and HTML5 App/Ethernet connections can be made and used at the same time.
-=== Modbus-TCP Integration ===
+Each has its advantages and disadvantages, and together they complement each other:
-For larger vessels, using custom designed SCADA systems, the recommended protocol to use is ModbusTCP. See our [[ccgx:modbustcp_faq|]].
+The MFD HTML5 App is the simpler one to setup as its plug and play. It presents an easy to use system overview without requiring any configuration. The system overview shown will automatically adapt to the type of Victron system installed. The (only) available configuration is defining the batteries as well as giving them names.
-===== 2. Varia =====
+The NMEA 2000 integration is more complex, and allows more customisation on the MFD: the data will show up in the data-tree of the MFD, and most MFDs then allow the user to configure various pages and combinations of information.
+As mentioned above, a GX Device can also read tank level data from NMEA 2000. More information in the [[https://www.victronenergy.com/media/pg/Cerbo_GX/en/installation.html#UUID-9813aef4-8178-293b-12ef-0048b064271f|the Installation chapter of the GX manual]].
-==== 2.1 VE.Can products (Skylla-i, Skylla-IP44, Lynx Shunt, Lynx Ion+Shunt and more) ====
+==== 2.2 Products with a VE.Can port ====
-Since the Victron VE.Can communication protocol is based on N2K, the following products can all be connected directly to a N2K network. The only thing necessary is a plug converter: the [[https://www.victronenergy.com/cables/ve-can-to-nmea2000-cable|VE.Can to NMEA 2000 cable]].
+All Victron products that feature a VE.Can port can be directly connected to the NMEA 2000 network, using the [[https://nocache.victronenergy.com/accessories/ve-can-to-nmea2000-micro-c-male|VE.Can to NMEA2000 cable]].
   * Skylla-i 24V Battery Chargers
-  * Skylla IP44 Battery Chargers
+  * Skylla IP65 Battery Chargers
-  * Lynx Shunt Battery Monitors
+  * Lynx Shunt VE.Can Battery Monitor
-  * Lynx Ion + Shunt all models
+  * Lynx Smart BMS
   * SmartSolar MPPT Solar Chargers with VE.Can communications port
-{{ :ve.can:nmea-2000:schema_nmea2000-vecan_mppt-skylla_nov_2016.png?nolink&700 |}}
+{{ :ve.can:nmea-2000:schema_nmea2000-vecan_mppt-skylla_nov_2016.png?nolink&500 |}}
+==== 2.3 Tank monitoring integration ====
-==== 2.1 Raymarine & EmpirBus ====
+The GX devices can measure tank levels, and make the resulting data available on the NMEA2000 network. Also, they can read tank level data from the N2K network.
-Besides using NMEA 2000 and/or the Lighthouse App, integration onto Raymarine MFDs can also be done with an [[http://www.trigentic.com/#nxt-mcu|Empirbus NXT MCU ]]. Though both are connected to the same N2K network, the NXT MCU translates the N2K PGNs originating from the Victron equipment into Raymarine proprietary messages.
+Below sections explain the details of each integration type.
-In the [[http://www.empirbus.com/clickOnce/EmpirBusStudio-Demo/|EmpirBus Studio software]] you will find dedicated Victron building blocks than can be drawn onto the diagram.
+=== Integration A) GX Device to MFD and NMEA2000 ===
-Next, use the [[http://www.trigentic.com/#empirbus-graphic|EmpirBus Graphical tool]] to design the pages for on the Raymarine MFDs.
+Some of Victron GX monitoring products feature built-in tank level inputs. For example the [[https://www.victronenergy.com/panel-systems-remote-monitoring/cerbo-gx|Cerbo GX]], which is the most common GX device, has four inputs that can take a resistive tank level sender.
-The EmpirBus system requires the data instance of battery status and dc detailed status to be unique when using multiple sources. ([[ve.can:changing_nmea2000_instances#changing_a_data_instance|how to change data instances]])
+Also, all GX devices can also have their number and types of tank level inputs expanded by adding one or multiple [[https://www.victronenergy.com/accessories/gx-tank-140|GX Tank 140]] modules. It has four inputs, of which each can be configured to measure either voltage (0-10V) or current (4-20mA).
+All tank level inputs feature customisable naming, setting a type (fresh water, fuel, black water and more), configurable filtering and damping settings as well as setting up a custom tank shape for non-square tanks.
-==== 2.2 Maretron ====
+The GX Device can transmit the resulting tank levels to the NMEA2000 network. See the [[https://www.victronenergy.com/media/pg/Cerbo_GX/en/marine-mfd-integration-by-nmea2000.html|NMEA2000-out chapter in the GX manual]] for information on how to set that up. Note that the MFD HTML5 App does not include showing tank levels.
-All data sent out by Victron devices can be picked up by the Maretron MFDs & software. See the [[http://www.maretron.com/products/N2KView.php|Maretron N2KView® vessel monitoring and control software]].
+=== Integration B) NMEA2000 to GX Device and VRM Portal ===
-===== 3. PGN overview =====
+The other way around is possible as well: the Victron system reading tank level data from NMEA2000.
+The tank data will be shown in the GX device user interface as well as on the VRM Portal. Screenshots below.
+Compatible tank senders are listed in the [[https://www.victronenergy.com/media/pg/Cerbo_GX/en/installation.html#UUID-9813aef4-8178-293b-12ef-0048b064271f|GX manual, installation chapter]].
+{{ :ve.can:nmea-2000:gx_touch_tanks_overview.png?direct&400 |}}
+//Above picture: GX Touch 50, showing multiple tank levels. Coming from either the NMEA2000 network, directly connected resistive tank senders or via the GX Tank 140 accessory.//
+//Below screenshot shows a similar system, but then on the [[https://vrm.victronenergy.com|VRM Portal]].//
+{{ :ve.can:nmea-2000:vrm_tanks.png?direct&800 |}}
+==== 2.4 NMEA 2000 GPS integration ====
+Our GX devices can read location, altitude, speed and course from the NMEA2000 network. For details, see the GX manual.
+Note the other way around does not work. A GX Device which has a USB GPS installed does not emit GPS data out onto the NMEA2000 network as part of the NMEA2000-out function.
+==== 2.5 Using our converter interfaces (DEPRECATED!) ====
+  * [[https://www.victronenergy.com/accessories/ve-bus-to-nmea2000-interface|VE.Bus to NMEA 2000 interface]]
+  * [[https://www.victronenergy.com/accessories/ve-direct-to-nmea2000-interface|VE.Direct to NMEA 2000 interface]], for BMV Battery Monitors (only).
+Note that the use of both those interfaces is deprecated. Use a GX device instead.
+===== 3. NMEA2000 Details =====
+==== 3.1 PGN Lists ====
 Refer to our [[https://www.victronenergy.com/upload/documents/Whitepaper-Data-communication-with-Victron-Energy-products_EN.pdf|Datacommunication whitepaper]], page 8 and beyond, for a list of Victron products and their supported PGNs.
-===== 4. FAQ =====
+==== 3.2 NMEA 2000 instancing ====
-Note that there are many more generic frequently asked questions answered in the [[https://www.victronenergy.com/upload/documents/Whitepaper-Data-communication-with-Victron-Energy-products_EN.pdf|Data communication white paper]].
+NMEA 2000 Instances are used to identify multiple similar products connected on the same network.
-==== Q1: What about instances? Device instances, data instances? ====
+There are several types of instances, the most important ones being the **Device instance** as well as the **Data instances**.
-See [[ve.can:changing_nmea2000_instances|]] for details on that.
+More information about instances is in [[https://www.victronenergy.com/media/pg/Cerbo_GX/en/marine-mfd-integration-by-nmea2000.html#UUID-97031b2e-6b21-dd88-56ee-31c0aaca9183|the NMEA2000 chapter in the GX manual]].
-==== Q2: What about terminators and network layout? ====
+=== What settings need to be made? For example instances? ===
-A N2K CAN bus network needs to be laid out as in a backbone configuration, using drop cables to connect to each device. Also, there should be only two terminators in the network. Therefore:
+That is a commonly asked question. The answer depends on the used brand of MFD:
+For **Garmin, Furuno, Maretron and Navico (B&G, Lowrance, Simrad) systems**: none. No instances, also not data instances such as the DC Detailed instance, need to be changed. It all works out of the box, other than configuring what field to show where on the MFD.
+For **Raymarine**, you might need to do some configuration: for systems with a SmartShunt and a SolarCharger, or multiple SmartShunts, or a Lynx Smart BMS, the data instances need to be configured to be unique. More information about that in the [[https://www.victronenergy.com/live/venus-os:mfd-raymarine|Victron & Raymarine document]], in the last chapter.
+==== 3.3 Terminators and network layout ====
+A N2K CAN-bus network needs to be laid out as in a backbone configuration, using drop cables to connect to each device. Also, there should be only two terminators in the network. Therefore:
   * Use the NMEA 2000 cable as the backbone.
-  * Run a separate drop cable separately to each Victron device. The drop cable will be one of these three products:
+  * Run a separate drop cable separately to each Victron device [[https://nocache.victronenergy.com/accessories/ve-can-to-nmea2000-micro-c-male|VE.Can to NMEA 2000 cable]]
-    * [[https://www.victronenergy.com/accessories/ve-bus-to-nmea2000-interface|VE.Bus to NMEA 2000 interface]]
-    * [[https://www.victronenergy.com/accessories/ve-direct-to-nmea2000-interface|VE.Direct to NMEA 2000 interface]]
-    * [[https://nocache.victronenergy.com/accessories/ve-can-to-nmea2000-micro-c-male|VE.Can to NMEA 2000 cable]]
   * Only terminate the NMEA 2000 backbone, do not terminate on the VE.Can side.
-==== Q3: What PGNs does a GX Device transmit on N2K? ====
+Or:
+  * Have the N2K network on one side, with one terminator. On the other end, change to the Victron network, with also one (Victron) terminator at the end.
+The first option is more aligned with the official N2K method. But, in case of multiple Victron products that need to be connected to the N2K network, will require more wire runs and definitively more NMEA2000 to VE.Can conversion cables.
+==== 3.4 Further reading on Victron and NMEA 2000 ====
+  * [[https://www.victronenergy.com/upload/documents/Whitepaper-Data-communication-with-Victron-Energy-products_EN.pdf|Data communication white paper]]
+  * [[https://www.victronenergy.com/media/pg/Cerbo_GX/en/marine-mfd-integration-by-nmea2000.html|Cerbo GX manual, NMEA 2000 chapter]]
+  * [[https://community.victronenergy.com/topics/NMEA%202000%20-%20N2K.html|NMEA2000 related discussions on Victron Community]]
+===== 4. Varia =====
+==== 4.1 Raymarine & EmpirBus ====
+Besides using NMEA 2000 and/or the Lighthouse App, integration onto Raymarine MFDs can also be done with an [[http://www.trigentic.com/#nxt-mcu|Empirbus NXT MCU ]]. Though both are connected to the same N2K network, the NXT MCU translates the N2K PGNs originating from the Victron equipment into Raymarine proprietary messages.
+In the [[http://www.empirbus.com/clickOnce/EmpirBusStudio-Demo/|EmpirBus Studio software]] you will find dedicated Victron building blocks than can be drawn onto the diagram.
+Next, use the [[http://www.trigentic.com/#empirbus-graphic|EmpirBus Graphical tool]] to design the pages for on the Raymarine MFDs.
+The EmpirBus system requires the data instance of battery status and dc detailed status to be unique when using multiple sources. ([[ve.can:changing_nmea2000_instances#changing_a_data_instance|how to change data instances]])
+==== 4.2 Maretron ====
+All data sent out by Victron devices on the N2K network can be picked up by the Maretron MFDs & software. See the [[http://www.maretron.com/products/N2KView.php|Maretron N2KView® vessel monitoring and control software]].
+===== 5. FAQ =====
+=== Q1: Can/must both Ethernet and and N2K connection be made between Victron GX and MFD? ===
+Both can be made at the same time.
+Ethernet is needed to get the MFD App, as explained above.
-See the [[https://www.victronenergy.com/live/ccgx:start#marine_mfd_integration_by_nmea2000|NMEA 2000 chapter in the CCGX manual]] for details.
+And an N2K connection is needed to get data to show in other fields on the MFD.
-==== Q4: Can integration onto Raymarine displays also be done without Empirbus NXT? ====
+See annotated screenshot above for which is what.
-Yes, see [[https://www.victronenergy.com/panel-systems-remote-monitoring/marine%20mfd%20gx%20integration%20-%20raymarine|the Raymarine integration page on our website]].