openplotter / openplotter-serial

OpenPlotter app to manage serial devices

openplotter-serial

OpenPlotter app to manage serial devices

Installing

For production

Install openplotter-settings for production and just install this app from OpenPlotter Apps tab.

For development

Install openplotter-settings for development.

Install dependencies:

sudo apt install openplotter-settings gpsd gpsd-clients

Clone the repository:

git clone https://github.com/openplotter/openplotter-serial

Make your changes and create the package:

cd openplotter-serial
dpkg-buildpackage -b

Install the package:

cd ..
sudo dpkg -i openplotter-serial_x.x.x-xxx_all.deb

Run post-installation script:

sudo serialPostInstall

Run:

openplotter-serial

Pull request your changes to github and we will check and add them to the next version of the Debian package.

Documentation

https://openplotter.readthedocs.io

Support

http://forum.openmarine.net/forumdisplay.php?fid=1

openplotter-serial's Issues

Openplotter-serial creates invalid udev statements for USB by Position

When adding new USB devices using the GUI the UDEV file contains invalid definitions for devices. After reboot the devices are not found correctly due to the random nature in which USB devices are allocated at startup. The UDEV file contains:

KERNEL=="ttyUSB1*", KERNELS=="1-1.5.4:1.0",SYMLINK+="ttyOP_gps4"
KERNEL=="ttyUSB2*", KERNELS=="1-1.5.2:1.0",SYMLINK+="ttyOP_autop"
KERNEL=="ttyUSB3*", KERNELS=="1-1.5.1:1.0",SYMLINK+="ttyOP_wind"

but should contain:

KERNEL=="ttyUSB*", KERNELS=="1-1.5.4:1.0",SYMLINK+="ttyOP_gps4"
KERNEL=="ttyUSB*", KERNELS=="1-1.5.2:1.0",SYMLINK+="ttyOP_autop"
KERNEL=="ttyUSB*", KERNELS=="1-1.5.1:1.0",SYMLINK+="ttyOP_wind"

as this allows for the random suffix number.

Flatpak serial device access.

Just a drive-by note: Using serial devices from Flatpak requires some udev rules support. I havn't looked into if you are handling it elsewhere, but otherwise this seems like having the infrastructure in place.

Documentation: https://opencpn.org/wiki/dokuwiki/doku.php?id=opencpn:opencpn_user_manual:getting_started:opencpn_installation:flatpak#flatpak_access_to_serial_devices
and https://github.com/OpenCPN/OpenCPN/blob/master/LINUX_DEVICES.md