######################## MUPLEX V1.0 HELP ########################### < muplex.sh > NMEA multiplexer, in server mode, receive input data from serial, USB or bluetooth, then mix all data to hard or virtual serial ports and optionnaly TCP network; in client mode, split NMEA data from network to virtual serial ports. Usage: < sudo /usr/local/sbin/muplex.sh start[&]|stop|-h|--help > At the first start a default configuration file /usr/local/etc/ muplex.conf is created. Edit it to adapt the in/out ports to your NMEA devices and softwares. This file contain complementary informations. Note: config file anterior to V1.0 is not compatible and must be renamed/erased. Superuser rights are required to configure ports and network. Note: To avoid orphans process, aka zombies, take careful to close Muplex using < muplex.sh stop >, not with < CTRL+C >. Depend of: - socat package, the engine, by Gerhard Reiger. And for the optional Graphical User Interface Muplex-GUI: - yad package. - xdg-open from xdg-utils package. - gksudo from gksu package. MUPLEX run under any Linux distro on x86 or ARM. Tested with Xinutop 2.0, based on Xfce Debian Jessie. INSTALLATION: Muplex is provided in a tar.gz archive (tgz) including GUI, menu, icons, so use: < sudo tar -xvz -C / -f muplex-x.x.tgz > Or use a package manager as PACKMGN which is distribution independent and include an uninstall function. It may be necessary to restart your WM session to display the new menu entry. Advanced users who need Muplex only in command line can extract the archive in a temp directory (ex: option -C /tmp/) and copy muplex.sh, the only one necessary file, in /usr/local/sbin. GPL 3+, Navigation beta software, use it under your own responsability ! Frank Baudet ###################### MUPLEX-GUI V0.1 HELP ######################### < muplex-gui > Optional Graphical User Interface for muplex.sh. Usage: < /usr/local/bin/muplex-gui > You can close Muplex-GUI at any moment, Muplex will keep it current state. From this GUI you can: - Start and stop muplex.sh. - Modify the Muplex configuration and restart with the new parameters. - Read the raw NMEA data (click on the terminal to freeze the display). - Use refresh button from client mode to verify the connection state or from server if you modify muplex.sh state directly by command line during Muplex-GUI open. - Read this help and the muplex.sh help. To access ports and network, superuser rights are required. If you are tired to enter superuser password every time you use Muplex-GUI, you can create an exception, adding this line in /etc/sudoers: < your_user_name ALL=(ALL) NOPASSWD: /usr/local/sbin/muplex.sh >. See also other possibility without alteration of this file in /etc/sudoers.d/. Depend of: - yad package, the GUI engine, by Victor Ananjevsky. - xdg-open from xdg-utils package. - gksudo from gksu package. Muplex-GUI run under any Linux distro on x86 or ARM. Tested with Xinutop 2.0, based on Xfce Debian Jessie. INSTALLATION: see muplex.sh. GPL 3+, Navigation beta software, use it under your own responsability ! Frank Baudet ############################ END HELP ###############################