1. Manuals
  2. Brands
  3. Yacht Devices Manuals
  4. Gateway
  5. YDPG-01
  6. User manual

Yacht Devices YDPG-01 User Manual

Python gateway
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
User Manual
Yacht Devices Python Gateway YDPG-01
also covers models
YDPG-01N, YDPG-01R
Software version
1.00
2024

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the YDPG-01 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Yacht Devices YDPG-01

Summary of Contents for Yacht Devices YDPG-01

  • Page 1 User Manual Yacht Devices Python Gateway YDPG-01 also covers models YDPG-01N, YDPG-01R Software version 1.00 2024...
  • Page 2 © 2024 Yacht Devices Ltd. Document YDPG-002. March 13, 2024 Web: https://www.yachtd.com/ NMEA 2000® is a registered trademark of the National Marine Electronics Association. SeaTalk NG is a registered trademark of Raymarine UK Limited. Garmin® is a registered trademark of Garmin Ltd.

  • Page 3: Table Of Contents

    Contents Introduction Warranty and Technical Support I. Product Specifications II. NMEA Basics III. Installation of USB Drivers and Connection to PC IV. Installation and Connection to NMEA V. LED Signals VI. Firmware Updates VII. Programming the Device VIII. Device Reset Appendix A.

  • Page 4: Introduction

    The Device allows the creation of gateways between NMEA 0183 and NMEA 2000, at UART and CAN bus level with the standard Python library, or at NMEA level with the Yacht Devices library. It also allows to connect NMEA 0183 devices working at different speeds, to process, filter and modify data on the fly. The Device's internal disk can be used by user code to store logs and other data.

  • Page 5: Warranty And Technical Support

    Warranty and Technical Support 1. The Device warranty is valid for two years from the date of purchase. If a Device was purchased in a retail store, the sales receipt may be requested when applying for a warranty claim. 2. The Device warranty is terminated in case of violation of the instructions in this Manual, case integrity breach, or repair or modification of the Device without the manufacturer’s written permission.

  • Page 6: Product Specifications

    I. Product Specifications Figure 1. Drawing of YDPG-01N (left) and YDPG-01R (right) models of Gateway Our devices are supplied with different types of NMEA 2000 connectors. Models with R at the end of the model name are equipped with NMEA 2000 connectors and are compatible with Raymarine SeaTalk NG. Models with an N in the model suffix are equipped with NMEA 2000 Micro Male connectors.
  • Page 7 Device can be powered from USB or from NMEA 2000 interfaces, measurements above are with 100 Ohm load connected to the NMEA 0183 port. Yacht Devices Ltd declares that this product is compliant with the essential requirements of EMC directive 2014/30/EU and radio and TTE directive 1999/5/EC.

  • Page 8: Nmea Basics

    II. NMEA Basics This section describes the basics of NMEA 0183 and NMEA 2000 networks. We recommend getting familiar with this section before connecting the Device. These networks are very different at the electrical and software levels. NMEA0183 also has made a long evolutionary path, but thanks to its simplicity and cheapness, it is still very popular and widely used.
  • Page 9 NMEA 0183, until version 2.0 (1992), used a «single-ended» RS-232 interface with one TX line and one RX signal line (grey at Figure 2.a) and ground line (dotted at Figure 2.a) used as reference for TX and RX signals. Therefore, old devices have only three wires. Since version 2.0, NMEA 0183 has been based on a «differential»...
  • Page 10 2. NMEA 2000 NMEA 2000 network runs at 250 kbps and allows up to 60 physical devices to be connected. Unlike NMEA 0183, there are no «talkers» and «listeners». All devices can «talk» and all devices receive all messages. Many electronic manufacturers presented «branded» versions of NMEA 2000. Raymarine SeaTalk NG, Simrad SimNet, FurunoCAN differ only in the type of connectors used.
  • Page 11 The network backbone (between 2 and 2 at Figure 4) has two data lines (called CAN HIGH and CAN LOW and two power lines. Power lines should be connected to a 12-Volt power supply (see 3 at Figure 4). Low- powered devices, like our Gateway, take power directly from the network backbone.

  • Page 12: Installation Of Usb Drivers And Connection To Pc

    III. Installation of USB Drivers and Connection to PC The Device is connected to a USB port of a PC and is compatible with the USB 1.1 protocol (1998) and later. It is therefore compatible with all modern laptops and PCs. The Device can be powered from the USB port (as well as from the NMEA 2000 port) and you will see LED signals after connection (otherwise it means that the cable or the USB port is damaged).
  • Page 13 Figure 5. Device Manager on Windows 11 The Device uses Windows drivers and should be installed automatically. To check the installation, you can open the «Device Manager» from the «Control Panel» and check the presence of the YDPG-01 disk and the USB serial device.
  • Page 14 2. Installation on Microsoft Windows 7 and earlier versions The USB serial port driver for Microsoft Windows can be found in the root folder of the mass storage device (which does not require a driver and should be accessible immediately after connection) or in the Downloads section of www.yachtd.com.
  • Page 15 To check the installation on Microsoft Windows 7 and earlier versions of Microsoft Windows, run «Device Manager» from «Control Panel». If the «YDPG-01 Virtual COM Port» is in the «Other devices» section (see Figure 6), run «Update Driver Software...» from the context menu, then select «Browse my computer for driver software»...
  • Page 16 3. Installation on Linux (Ubuntu) The Device uses a system CDC ACM driver. After connecting the Device, type the dmesg command in a terminal. Figure 8. Output of dmesg command on Ubuntu At the end of the output, you will see the properties of the Device, the name of the serial port and the name of the disk.
  • Page 17 Once the Device has been connected, click on the Apple icon and select the «About This Mac» menu item. Click the «More Info...» and «System Report...» buttons in the window that opens. Locate «YDPG-01 Virtual COM Port» in the USB subsection of the Hardware section, as shown in Figure 9.

  • Page 18: Installation And Connection To Nmea

    IV. Installation and Connection to NMEA The Device requires no maintenance. When deciding where to install the Device, choose a dry mounting location. Avoid places where the Device may be flooded with water, as this can damage it. The Device has no galvanic isolation between NMEA 2000 and USB ports, please read the Section III before connecting the Device to USB.
  • Page 19 Note that many NMEA 0183 devices, including the Gateway, have different wire colors than specified in the Standard. Please check the label on cable and/or documentation before connecting. Table 1. NMEA 0183 Wire Colors Signal NMEA 0183 Standard Python Gateway Talker TX+ (A) White Talker TX- (B)

  • Page 20: Led Signals

    V. LED Signals The Device is equipped with a bi-color LED that indicate the Device’s state. The Device produces a short single green flash after powering on, indicating that the Device is functioning. 1. Normal operation signals During normal operation, the Device produces a series of five or six flashes every five seconds. The flashes indicate the status of the Device's interfaces during the last five seconds and have the following meaning: •...

  • Page 21: Firmware Updates

    VI. Firmware Updates The firmware updates are available in the Downloads section of www.yachtd.com Open the downloaded archive containing the update and read the README.TXT file, which may contain important information about the update. The Device has no galvanic isolation between NMEA 2000 and USB ports, please read Section III before connecting the Device to USB.
  • Page 22 Figure 10. YDPG-01 in the list of boat network devices on Simrad NSX MFD — 22 —...

  • Page 23: Programming The Device

    VII. Programming the Device The internal disk of the Device contains the boot.py file (which initializes the libraries and configures the Device's peripherals, including the speed of the NMEA 0183 ports) and the main.py file (which is empty and intended for user code). These files are executed sequentially by the Device when it is powered on. Your software supplier will provide these files, and the software supplied may also contain libraries (other files with a .py filename extension).
  • Page 24 If the Device does not have a running program, you will see the Python prompt, as shown in Figure 11. If you are using the terminal for the first time, use the help() command to get basic information about working with the terminal and interactive prompt (REPL). The running program or code can be aborted by pressing Ctrl+C and (after that) the Python interpreter can be soft reset by pressing Ctrl+D.
  • Page 25 To test the NMEA 2000 connection, type the command can.test() in the REPL to receive and print ten 29- bit identifier messages (NMEA 2000 messages) from the CAN bus. To test NMEA 0183 reception, type the command uart_rx.test() to receive and print ten lines received from NMEA 0183. The result of these two commands is shown at Figure 11.
  • Page 26 To add the sixth flash to the normal operation signals sequence (see Section V), type in the REPL or add to the main.py the line led.green() or led.red() to select the corresponding color. Documentation of Yacht Devices library for Python Gateway and code samples are published online at: http://www.yachtd.com/products/python_gateway/lib.html Please note that programming requires knowledge of the NMEA protocols.

  • Page 27: Device Reset

    VIII. Device Reset There are two types of reset: hardware reset and software reset. The Device can also be rebooted by switching it off (disconnecting it from both the USB and NMEA 2000 network, or switching off both NMEA 2000 and USB) and then switching it on again (from USB and/or NMEA 2000). A hardware reset returns your Device to the state in which it was originally purchased.

  • Page 28: Appendix A. Troubleshooting

    Appendix A. Troubleshooting Situation Possible cause and correction 1. LED is controlled by user program. Switch off the Device No LED signals (disconnect the USB cable and switch off the NMEA 2000 network), and then switch it on again. For one second after switching on, the Device’s LED should show a short green signal.
  • Page 29 Table 3 continued Situation Possible cause and correction 1. Driver problem. If you have connected the Device to a new USB port, Application terminal program cannot open Device re-connect it to the previously used port. Check that the USB device is serial port correctly connected and recognized (see Section III).

  • Page 30: Appendix B. Supported Nmea 2000 Messages

    Appendix B. Supported NMEA 2000 Messages This appendix contains messages used in service communication with other devices on the network. «No» in the table below means that the Gateway will not process or send these messages during service communication with other devices. Note that service communications are not affected by user program. Message Receive Transmit...
  • Page 31 PC software (with a hardware connector to the NMEA 2000 network). If you have Yacht Devices NMEA 2000 Wi-Fi, USB or Ethernet gateways or routers, you can download our free CAN Log Viewer software (runs on Microsoft Windows, Mac OS X and Linux) at http://www.yachtd.com/downloads/.

  • Page 32: Appendix C. Device Connectors

    Appendix C. Device Connectors Figure 1. NMEA 2000 connectors of YDPG-01R (left) and YDPG-01N (right) models The USB connector (type Mini-B female) and NMEA 0183 wires are shown in Figure 1 in the Section I. — 32 —...
  • Page 33 NOTES — 33 —...

This manual is also suitable for:

Ydpg-01nYdpg-01r

Table of Contents