©DJ5QV

About

Mhuxd is a device router for microHam keyers. It runs on the Linux operating system only. Supported microHam keyers are:

  • micro KEYER

  • micro KEYER II

  • DIGI KEYER

  • DIGI KEYER II

  • MK2R & MK2R+

  • CW KEYER

Features

  • automatically discovers any supported microHam keyers

  • handles multiple keyers simultaneously

  • graphical web front end to perform configuration changes

  • can provide configurable virtual serial ports and routes those to specific keyer channels (e.g. CAT, K1EL Winkey etc.)

  • configuration of the K1EL Winkey chip

  • configuration of the microKEYER II / III display

License

Mhuxd is available under the GNU General Public License, version 2.

ClearSilver is licensed under the New BSD license.

Acknowledgements:

  • microHam – For providing the protocol specification and support

  • Marc Lehmann and Emanuele Giaquinta – For libev

  • Brandon Long – For the ClearSilver template system

  • Igor Sysoev, Joyent Inc. et al. – For http_parser

  • Google Inc., Filipe Almeida – For streamhtmlparser

Installation

Installation from package

work-in-progress, home page http://mhuxd.dj5qv.de should provide up-to-date steps to install packages for Debian and Debian based distributions, e.g. Ubuntu.

Compiling from Source


Download the source from the Download page and extract it, e.g.

tar -xzvf mhuxd-0.53.tar.gz


Change into the source directory. Perform:

export CFLAGS=-O2

./configure

make

make install

This will install everything into /usr/local. If you want everything in a single folder you can use the –prefix option of configure:

./configure --prefix=/usr/local/mhuxd-0.50

make

make install

Make sure that the required kernel modules are loaded:

modprobe ftdi_sio

modprobe cuse

Start mhuxd on command line:

sudo /usr/local/sbin/mhuxd

The WebUI

The WebUI provides a graphical interface to mhuxd. It is only accessible locally, that means on the computer where mhuxd is running.

To access the WebUI make sure that mhuxd is running. Open the web interface on:

http://localhost:5052

mhuxd home
Figure 1. WebUI Home page

The web interface consists of several tabs:

mhuxd all tabs

  • Home – showing some generic information and a list of detected microHam keyers

  • Daemon – configuration of the virtual serial ports and log level

  • Keyer tabs – each detected keyer has it’s own tab allowing keyer specific configuration


mhuxd led green

Keyer is connected and online

mhuxd led yellow

Keyer is connected but not online (powered off)

mhuxd led red

Keyer is not connected


Warning
 Currently the status LEDs do not update automatically. The status can be updated by pressing the refresh button of the browser.

Keyer Configuration

Keyer Pages

Mhuxd supports multiple keyers simultaneously. Therefore for each detected keyer a separate page is created in the WebUI.

mhuxd keyer tabs


The left side menu contains the configuration categories. Not all categories are available for each keyer type.

mhuxd left menu
Figure 2. Menu for the micro Keyer II. The available categories depend on the keyer type.


  • Keyer Mode Follows RIG – Only available for DK2, MK2 and MK2R+. With this option enabled the keyer sets the keyer mode according to the rig mode. For this to work you must have configured the rig type and serial parameters in the “Radio Menu”. Additionally the option “Use CAT Decoder if Connected” must be enabled there.

  • Current Mode – This shows the current keyer mode and allows to change it. Note that this page does not update automatically. You can push the refresh button of you browser to update this page.


This menu is not available for CW KEYER. This page allows to configure the serial parameters between the keyer and the transceiver:

  • Baud Rate

  • Data Bits

  • Stop Bits

  • RTS/CTS Handshake

Refer to your transceivers manual on how to set these parameters.

For DIGI KEYER II, micro KEYER II and MK2R(+) additional options are available. These options affect the keyers capability to send CAT commands to the rig on its own:

  • Rig Type: Select your rig. This tells the keyers internal CAT decoder which rig is attached. If it is in Icom the selection will autofill the Icom Address field. You may choose “none” here which will reliably disable CAT queries from the keyer.

  • Icom Address: If you use an Icom rig this field must contain the Icom address in decimal notation. Usually this field gets auto filled from the Rig Type selection.

  • PW1 connected: Select this option if you have an Icom PW1 amplifier connected to the same bus as the rig. When enabled the keyer will periodically generate “auto-info”, preventing queries (and possible collisions) by PW1.

  • Digital Over Voice: Choose how LSB, USB and FM modes are interpreted:

    • Band Map – set keyer mode according to band map

    • Always Voice – set keyer mod always to VOICE

    • Always Digital – set keyer mode always to DIGITAL

  • Use CAT Decoder if Connected: Select this to enable the keyers CAT decoder even when the keyer is USB connected to a computer. The CAT decoder is used to synchronize the keyers mode with the rig mode. If disabled the keyer mode must be selected in the WebUI or by an application. The decoder is always active when the keyer is not USB connected to a computer.

  • Don’t Interfere USB control: Disable CAT queries by the keyer if it is USB connected to a computer. Only answers to the computer will be interpreted. This may not work as advertised for DIGI KEYER II and maybe other keyers.

Note
 The original microHam device router for Windows can interpret CAT commands and even send CAT requests. This way the device router can synchronize the keyer mode with the rig mode automatically. Such functionality is not implemented in mhuxd (yet).

This menu is only available for keyers with AUX support (microKEYER II). Allows to specify the serial parameters of the AUX port.

This page allows the configuration of the PTT operation. The available options vary between keyer types.

Note
 This is a very basic overview. Please refer also to the original microHam documentation for your keyer.

  • PTT CW – Select PTT source(s) for CW mode

  • PTT Voice – Select PTT source(s) for VOICE mode

  • PTT Digital – Select PTT source(s) for DIGITAL mode

  • LNA PTT – Enable LNA PTT relay

  • PA PTT – Enable PA PTT relay

  • PA PTT Tail (x 10ms) – PA PTT Tail time

  • LNA PTT Tail (x 10ms) – LNA PTT Tail time

  • PTT Lead (x 10ms) – PTT Lead time

  • CW in Voice – Allow CW operation in VOICE mode (MK2, MK2R(+) only)

  • Sound Card PTT – key PTT when soundcard produces audio (MK2, DK2 only)

  • Downstream over Footswitch – when soundcard produces audio the audio source will be switched from microphone to sound card, even if the foot switch is pressed (untested, DK2, MK2 only)

This menu is available for MK2/3 only. The first section “Display Option” allows configuration of the displays brightness, contrast and it’s default content.

In the second section “Display Report” you can chose which events you want to have displayed.

This menu is currently only available for keyers containing a K1EL Winkey chip. In the first section certain Winkey parameters can be configured.

Detailed description on the TODO list. Meanwhile please refer to your keyers documentation and/or to the Winkey1 Version 10 document at www.k1el.com.

Example Index