About
mhuxd is a daemon that implements the microHam keyer protocol. This protocol allows to multiplex
multiple communication channels over a single serial USB connection. The daemon provides virtual serial ports to allow
hamradio applications to access those channels and make use of the various functions of those keyers.
mhuxd talks to the keyer via an USB serial port (e.g. /dev/ttyUSB0). Prerequisite for this port to be
available is that the kernel driver ftdi_sio is available and loaded. Additionally the kernel driver
cuse must be available to enable mhuxd to provide virtual serial ports.
Features
- Supposed to support these keyers:
- CW KEYER (untested)
- Digikeyer (untested)
- Digikeyer II
- microKEYER
- microKEYER II (untested)
- MK2R & MK2R+ (untested)
- micro2R (untested)
- Virtual serial ports for radio control, winkey, FSK and PTT.
- Can continuously run in the background regardless of the keyer being connected or not.
- Supports most of the keyer's configuration items.
- Optional debug logging. Includes all the traffic sent through mhuxd
News
- May 13th 2012: Wrong download links corrected
- Due to a typo the download links to the 0.30-2 packages where actually refering to 0.30-1. This has been amended now.
- May 9th 2012: CQRLOG's WinKey support now working with mhuxd
- Petr's has fixed an issue with CRQLOG's WinKey support. Version 1.4.1 contains the fix.
It's available on the CQRLOG site.
- May 8th 2012: Updated Debian / Ubuntu packages to 0.30-2:
- mhuxd startscript did not create the /var/run/mhuxd folder.
- May 6th 2012: Version 0.30-1 is out with these changes:
- Renamed default config file from mhuxd.cfg to mhuxd.conf
- In mhuxd.cfg changed section name <Device> to <Daemon>.
- Added options Device, DevDir and LogLevel to section <Daemon>.
- Fixed a bug that prevented r1FrBase to be applied to MK1 keyers.
- Removed command line switched -d and -s (can be configured in mhuxd.conf now)
- Name of VSP subdirectory /dev/ can now be configured (DevDir).
- Debian/Ubuntu packaging, including:
- start/stop script
- creation of user and group mhuxd
- --list-dev option was showing all FTDI devices instead of microHam devices only.
- Audio switching can be configured in letter notation (e.g. r1FrBase_Cw AAA01)
- Build system converted to GNU Autotools (./configure and friends).
- Manpage created for mhuxd
- 0.22 alpha (not released)
- As default VSP devices are now in /dev/mhux/ (e.g. /dev/mhux/cat1).
- Added missing initialization for 2nd radio on MK2R(+) devices.
- Cleanup in mhux.cfg.sample
- 0.21 alpha (not released)
- Implemented SIGHUP handling. Upon SIGHUP mhuxd now reloads the config file. Only the <Keyer> section is re-applied so far.
- Fixed invalid free() in cleanup code when not using the -c option.
Quick setup
- Installation from Debian / Ubuntu packe
- Download the appropriate package.
- Install the package as root or by sudo (dpkg -i <mhuxd_....deb>).
- Modify /etc/mhuxd.conf to match your radio's CAT settings (BaudRate, DataBits, StopBits, RtsCts, RadioType).
- Restart mhuxd (/etc/init.d/mhuxd restart).
- Installation from Source
- Download the source code.
- Extract the archive (tar -xzvf mhuxd-0.30.tar.gz).
- Build mhuxd:
- ./configure --sysconfdir=/etc
- make
- make install (as root / sudo)
- Modify /etc/mhuxd.conf to match your radio's CAT settings (BaudRate, DataBits, StopBits, RtsCts, RadioType).
- Start mhuxd: /usr/local/sbin/mhuxd -b
Download
The latest version can be downloaded
here. Debian packages are available (working on Ubuntu as well) for 32 Bit and 64 Bit environments.
Let me know if you want to see packages for other distributions.
Bugs/Problems/Todo
- No way yet to access keyers flags channel yet (e.g. to get notified when PTT is keyed).
- CQRLOG versions 1.4.0 and earlier have some problems with WinKey support. It is fixed in CQRLOG 1.4.1.
