Differences

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

--- ve.can:nmea-2000:start [2021-03-15 17:31] – [1.1 Summary] mvader
+++ ve.can:nmea-2000:start [2025-02-06 21:54] (current) – [1.2 MFD Integration] mvader
@@ Line 1: / Line 1: @@
-====== NMEA 2000 & MFD integration guide ======
+====== Marine Integration Guide ======
 ===== 1. Introduction =====
 ==== 1.1 Summary ====
-This technical document explains how to integrate a Victron system onto a Marine MFD, such as those from Garmin, Raymarine, the Navico brands B&G, Simrad and Lowrance as well as Furuno other brands.
-There are multiple options, and how to best integrate depends on the customer requirements, MFD brand and model as well as used Victron components.
+This guide provides an overview of integrating Victron systems with marine networks. These features include:
-Make sure to closely read this full document to find the best method for your type of system.
+  * **MFD (Chart Plotter) Monitoring**: Compatible with Garmin, Raymarine, Furuno, and the Navico brands B&G, Simrad, and Lowrance.
+  * **Tank Level Monitoring**: Seamlessly integrate tank level data between the NMEA 2000 network, Victron GX devices and the VRM Portal.
+  * **NMEA2000-out feature**: Share tank data, as well as other data such as Battery, DC & AC system data from GX devices to the NMEA 2000 network.
+  * **GPS Integration**: GX devices can read GPS data (e.g., location, speed) from NMEA 2000 but do not output GPS data to the network.
+  * **Advanced features powered by Signal K**: Includes wireless AIS, anchor alarms, and automatic trip logging.
-{{: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.//
+This document serves as a high-level overview with links to relevant manuals for detailed setup instructions.
-==== 1.2 What is NMEA 2000? ====
-NMEA2000 is a communications standard used for connecting marine sensors and display units within ships and boats.
-Victron Energy is a member of the NMEA 2000 organisation, and we have several of our products certified by NMEA 2000.
+==== 1.2 MFD Integration ====
-NMEA 2000 is sometimes also refered to as N2K, for brevitiy.
+Integration with MFDs depends on customer requirements and equipment used. A GX device (e.g., Cerbo GX or Ekrano GX) is typically involved, with two main options:
-==== 1.3 What is the MFD HTML5 App? ====
+  - **NMEA 2000 Integration**: Connect the GX device directly to the NMEA 2000 network.
-The MFD HTML5 App is a very 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.
+  - **HTML5 App Integration**: Connect the GX device and MFD via Ethernet to enable Garmin OneHelm or Raymarine LightHouse Apps.
-==== 1.4 Other integration options ====
+**Comparison of 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.
-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|]].
+  - **NMEA 2000**: Offers customizable data pages on the MFD but requires more configuration.
+  - **HTML5 App**: Plug-and-play with an auto-configured system overview but less customizable.
-The other alternative is SignalK. More information about that in the [[venus-os:large|Venus OS Large manual]]. Do take note of the chapter on Support in that document.
+**Illustration**:
-===== 2. Integration details =====
+{{ :ve.can:nmea-2000:garmin_mfd_complex_system_horisontal_split.png?direct&800 |}}
-==== 2.1 Systems with a GX Device ====
+  * Right bar: NMEA 2000 data.
+  * Bottom: HTML5 App integration.
-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.
+=== Further reading by brand ===
-There are two ways to connect a GX Device to a MFD:
+  * [[https://www.victronenergy.com/media/pg/Cerbo_GX/en/marine-mfd-integration-by-app.html#UUID-d5fa693e-1c4b-ec20-be20-e0baf8803e6e|Garmin integration details]]
+  * [[https://www.victronenergy.com/media/pg/Cerbo_GX/en/marine-mfd-integration-by-app.html#UUID-906e773b-f29c-2b77-56a8-d9ade87cc418|Raymarine integration details]]
+  * [[https://www.victronenergy.com/media/pg/Cerbo_GX/en/marine-mfd-integration-by-app.html#UUID-0e93850d-da2f-8bd9-9ce6-cc2546605459|Furuno integration details]]
+  * [[https://www.victronenergy.com/media/pg/Cerbo_GX/en/marine-mfd-integration-by-app.html#UUID-d5fa693e-1c4b-ec20-be20-e0baf8803e6e|Navico integration details]]
-- the (simpler) plug and play like method uses an Ethernet connection, which enables the MFD HTML5 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.
+==== 1.3 Tank monitoring ====
-- 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 Victron GX devices offer a user-friendly **Tank Level Page** to centralize and visualize data, as well as integration with MFDs and the NMEA 2000 network.
-The MFD HTML5 App is the simplest to setup as its pure 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.
+**Key Features:**
+  * Monitor tank levels on the GX device and VRM Portal.
+  * Access NMEA 2000 tank data or share GX tank data with NMEA 2000.
+  * Customize tank naming, shapes, and damping for accurate readings.
+  * Expand capabilities with the [[https://www.victronenergy.com/accessories/gx-tank-140|GX Tank 140]] module for voltage (0-10V) or current (4-20mA) inputs.
-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.
+**Visual Examples:**
-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]].
+{{ :ve.can:nmea-2000:brief_page_tanks.png?direct |}}
-==== 2.2 Products with a VE.Can port ====
+{{ :ve.can:nmea-2000:tank_grouping.png?direct |}}
-Some of our products feature a VE.Can port; which can be directly connected to the NMEA 2000 network. No electronic converter is necessary. The conversion cable required is the [[https://nocache.victronenergy.com/accessories/ve-can-to-nmea2000-micro-c-male|VE.Can to NMEA2000 cable]].
+{{ :ve.can:nmea-2000:vrm_tanks.png?direct&800 |}}
-These products include our Skylla-i battery chargers, Lynx Shunt VE.Can battery monitor as well as the Skylla IP65 battery charger series.
+** Video that demonstrates the tank page on the GX**
-==== 2.3 Tank monitoring ====
+ {{youtube>lwFUtSZFEz4?large}}
-When discussing integration of tank level data, there are two topics to separate: one is to have tank levels measured by a Victron tank level adapter sent out to the NMEA2000 network, to display on an MFD for example.
-And the other is for Victron monitoring systems to read tank level data available on the NMEA2000 network and show it on the Victron screens as well as transmit to the VRM Portal for remote monitoring.
+=== Further details ===
+  * **Resistive tank level inputs built-in to the Cerbo GX and Ekrano GX:** See [[https://www.victronenergy.com/live/venus-os:start:the GX product page]] for details on the built-in tank inputs.
+  * **Reading data from NMEA 2000 Tank senders into the GX Device and VRM Portal:** The GX device can read tank level data from compatible sensors on the NMEA 2000 network. This information is then displayed on the GX interface, including the dedicated tank level page, and synced with the VRM Portal. For compatibility details, see [[https://www.victronenergy.com/media/pg/Cerbo_GX/en/connecting-supported-non-victron-products.html#UUID-9f759229-3e91-5a02-891c-2206c9625753|the 3rd party NMEA 2000 tank sender section in a GX manual]].
+  * **Transmitting GX tank levels to the NMEA 2000 network:** For vessels with advanced monitoring setups, the GX device can also send tank data back to the NMEA 2000 network, enabling MFDs and other connected devices to access and display the information. For further information, see the [[https://www.victronenergy.com/media/pg/Cerbo_GX/en/marine-mfd-integration-by-nmea-2000.html|MFD integration by NMEA 2000 chapter in the GX manual]]. Note that the manual includes specifics steps for Garmin, Raymarine, Furuno and Navico systems.
-Both are possible. Below sections explain the details of each integration type.
+==== 1.4 NMEA2000-out feature ====
-=== Integration A) GX Device to MFD and NMEA2000 ===
+Victron Energy GX devices feature an NMEA 2000-out function: when enabled, the GX device acts as a bridge: it makes the data of all connected Battery monitors, Inverter/chargers, as well as other products connected to the GX device, available on the NMEA 2000 network.
-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.
+Using that feature, and having the GX device connected a NMEA 2000 network, Marine MFDs can read this data and visualise it to the user. Often in a highly configurable manner.
-Besides the built-in tank level inputs, 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. These have four inputs, which each can be configured to measure 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.
+==== 1.5 Advanced features powered by Signal K ====
-The GX Device can transmitted to 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.
+Signal K unlocks powerful features:
+  * **Wireless AIS & Navigation Data**: Share NMEA 2000 data via WiFi for apps like Navionics.
+  * **Anchor Alarm**: Reliable and easy-to-use alarm.
+  * **Automatic Logbook**: Track journeys effortlessly.
-=== Integration B) NMEA2000 to GX Device and VRM Portal ===
+More details:
+  - [[https://www.victronenergy.com/live/venus-os:large#signal_k|Venus OS Large manual]].
+  - [[https://svrenaissance.com/victron-cerbo-gx-on-steroids/|Victron Cerbo GX on steroids blog post]].
-The other way around is possible as well: the Victron system reading tank level data from NMEA2000.
+==== 1.5 Modbus-TCP, mostly for SCADA systems ====
-The tank data will be shown in the GX device user interface as well as on the VRM Portal. Screenshots below.
+Ideal for larger vessels, the GX built-in Modbus-TCP server enables SCADA system integration. For more details, see the [[https://www.victronenergy.com/live/ccgx:modbustcp_faq|Modbus-TCP FAQ]].
-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]].
+===== 2. Integration details by Victron product =====
-TODO ADD SCREENSHOTS
+==== 2.1 Systems with a GX Device ====
+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.
+==== 2.2 Other products featuring a VE.Can port ====
+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 NMEA 2000 cable]].
+  * Skylla-i 24V Battery Chargers
+  * Skylla IP65 Battery Chargers
+  * Lynx Shunt VE.Can Battery Monitor
+  * Lynx Smart BMS
+  * SmartSolar MPPT Solar Chargers with VE.Can communications port
+  * Multi RS
+  * Inverter RS
+{{ :ve.can:nmea-2000:schema_nmea2000-vecan_mppt-skylla_nov_2016.png?nolink&500 |}}
-==== 2.4 Using our converter interfaces (DEPRECATED!) ====
+==== 2.3 VE.Bus and VE.Direct to NMEA 2000 interfaces  (DEPRECATED!) ====
   * [[https://www.victronenergy.com/accessories/ve-bus-to-nmea2000-interface|VE.Bus to NMEA 2000 interface]]
@@ Line 88: / Line 118: @@
 Note that the use of both those interfaces is deprecated. Use a GX device instead.
+===== 3. NMEA 2000 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.
+==== 3.2 NMEA 2000 instances ====
-===== 3. Varia =====
+Instances are used in an NMEA 2000 network to identify multiple similar products connected to the same network.
+As an example, take a system with two battery monitors (one for the main battery bank, and another for the hydraulic-thruster bank) and also a Quattro inverter/charger. All three of those devices will send their battery voltage measurements out on the NMEA 2000 network. For the displays to show these values at the right place, they need to know which voltage belongs to what battery. That is what instances are for.
-==== 3.1 VE.Can products (Skylla-i, Skylla-IP44, Lynx Shunt, Lynx Ion+Shunt and more) ====
+There are various types of instances, and for marine systems are two that matter: the Device instance and the Data instance. The Data instance goes by various different names, like Fluid instance, Battery instance and DC instance.
-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]].
+NMEA 2000 defines three different instances:
-  * Skylla-i 24V Battery Chargers
+  * Data instances (Battery instance, Fluid instance, and similar)
-  * Skylla IP44 Battery Chargers
+  * Device instance
-  * Lynx Shunt Battery Monitors
+  * System instance
-  * Lynx Ion + Shunt all models
-  * SmartSolar MPPT Solar Chargers with VE.Can communications port
-{{ :ve.can:nmea-2000:schema_nmea2000-vecan_mppt-skylla_nov_2016.png?nolink&700 |}}
+=== When is manual configuration of instances needed? ===
+  * For **Garmin, Furuno, Maretron and Navico (B&G, Lowrance, Simrad) systems**: no configuration needed. Required fields can be configured and selected on the MFD, usually by pressing and holding on a data field in the data bar until the selection pane comes up.
+  * For **Raymarine**, before selecting the data on the MFD, the Battery and DC Detailed instance typically needs to be set up to be unique. For details, see the [[https://www.victronenergy.com/media/pg/Cerbo_GX/en/marine-mfd-integration-by-app.html#UUID-906e773b-f29c-2b77-56a8-d9ade87cc418|GX manual, Raymarine section]].
-==== 3.2 Raymarine & EmpirBus ====
+=== Further reading on NMEA 2000 instances ===
-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.
+  * [[https://www.victronenergy.com/media/pg/Cerbo_GX/en/marine-mfd-integration-by-nmea-2000.html|the NMEA 2000 chapter in the GX manual]].
+  * [[ve.can:changing_nmea2000_instances|How to change instances]]
+==== 3.3 Terminators and network layout ====
-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.
+A NMEA 2000 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:
-Next, use the [[http://www.trigentic.com/#empirbus-graphic|EmpirBus Graphical tool]] to design the pages for on the Raymarine MFDs.
+  * Use the NMEA 2000 cable as the backbone.
+  * Run a separate drop cable separately to each Victron device [[https://www.victronenergy.com/accessories/ve-can-to-nmea2000-micro-c-male|VE.Can to NMEA 2000 cable]]
+  * Only terminate the NMEA 2000 backbone. Do not install a terminator in any of the VE.Can ports on the Victron products.
-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]])
+Or:
+  * Have the NMEA 2000 network on one side, with one terminator. On the other end, change to the Victron network, with also one (Victron) terminator at the end.
-==== 3.3 Maretron ====
+The first option is more aligned with the official NMEA 2000 method. But, in case of multiple Victron products that need to be connected to the NMEA 2000 network, will require more wire runs and definitively more NMEA 2000 to VE.Can conversion cables.
+==== 3.4 DC Voltage compatibility ====
-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]].
+The Victron VE.Can network accepts 9 to 70VDC.
-===== 4. NMEA2000 PGN overview =====
+The NMEA-2000 network used to be 9 to 16VDC, which is, or will be, expanded to also include 24V. Which means that some NMEA-2000 devices are 9 to 16VDC, some are 9 to 30VDC, and some allow higher voltages.
-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.
+Also, the Victron VE.Can network will (in most cases) be powered with battery voltage. So for a 48V system, the voltage on the VE.Can network **exceeds** the NMEA-2000 accepted voltage levels.
-===== 5. FAQ =====
+Therefore, it is important to **not** connect those power cables.
-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]].
+The Victron cable used to connect both networks together, the [[https://www.victronenergy.com/accessories/ve-can-to-nmea2000-micro-c-male|VE.Can to NMEA 2000 cable]], has a removable fuse which is to be removed in case separation is necessary. A printed warning label is attached to the cable to warn about this.
-==== Q1: What about instances? Device instances, data instances? ====
-See [[ve.can:changing_nmea2000_instances|]] for details on that.
-==== Q2: What about terminators and network layout? ====
+==== 3.5 Galvanic isolation ====
-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:
+When connecting a GX to an NMEA 2000 network, it is recommend to do so using a galvanically isolated CAN-Bus port.
-  * Use the NMEA 2000 cable as the backbone.
+This is especially the case when your NMEA backbone and GX are powered from separate power sources or do not share a common ground. These are the two most popular models that feature such galvanically isolated port:
-  * Run a separate drop cable separately to each Victron device. The drop cable will be one of these three products:
-    * [[https://www.victronenergy.com/accessories/ve-bus-to-nmea2000-interface|VE.Bus to NMEA 2000 interface]]
+  * Cerbo GX MK2 (launched in 2024 as a successor to the Cerbo GX which did not feature an isolated port)
-    * [[https://www.victronenergy.com/accessories/ve-direct-to-nmea2000-interface|VE.Direct to NMEA 2000 interface]]
+  * Ekrano GX
-    * [[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.
+On both above products, VE.Can port 1 has galvanic isolation. VE.Can port 2 does not.
+For a full list of which ports feature isolation, see [[https://www.victronenergy.com/live/venus-os:start|this document]].
+==== 3.6 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-nmea-2000.html|Cerbo GX manual, NMEA 2000 chapter]]
+  * [[https://community.victronenergy.com/tag/nmea_2000_-_n2k |NMEA 2000 related discussions on Victron Community]]
+===== 4. Maretron =====
+All data sent out by Victron devices on the NMEA 2000 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 or must both Ethernet and and NMEA 2000 connection be made between Victron GX and MFD? ===
+Both can be made at the same time.
-==== Q3: What PGNs does a GX Device transmit on N2K? ====
+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 NMEA 2000 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]].