Brief synopsis

Logging programs that only offer cwdaemon to provide CW keying (e.g. TLF) have no direct means of interfacing to the popular Winkeyer devices. jWinkeyServer appears to clients as if it is cwdaemon, interprets the commands and passes them to a Winkeyer device over a standard serial interface. In addition, WinkeyServer provides GUI control of Winkeyer settings and a CW keyboard.

The inspiration for this project was Winkeyer USB server by OK2CQR. This works fine also, but it lacks some of the features I wanted. In particular, TLF implements PTT for SSB modes via cwdaemon, which isn't currently supported. I was also interested in playing with serial port control in Java, so it gave me a project to work on.

In theory, jWinkeyServer works on all platforms that support Java, but I have only tested it on Linux. I would be interested to hear from you if you have tried it out on alternative platforms.

Screenshots

     

Features

• Multi-threaded UDP cwdaemon server allows multiple clients.
• Useful for multi-single contest categories where only one physical transmitter is allowed.
• Control of virtually all Winkeyer configuration settings from an easy to use GUI.
• Consult your Winkeyer documentation for an explanation of the configuration options.
  
• Let your logging program control the speed, or use the speed pot.
• Set the max and min WPM from the GUI and see the actual setting.
• Scrollable CW keyboard entry allows stand-alone mode, or displays what the host is sending.

cwdaemon control commands are interpreted according to the following table:

Code	cwdaemon function	Winkeyer function
<ESC>'0'	Reset to default values.	Unsupported. Set through GUI.
<ESC>'2'<speed value>	Set keying speed.	Set keying speed.
<ESC>'3'<tone value>	Set sidetone (300 ... 1000Hz).	Set closest available sidetone frequency.
<ESC>'4'	Abort message.	Clear buffer (immediately aborts CW).
<ESC>'5'	Stop daemon.	Unsupported. Control through GUI.
<ESC>'6'	Set uninterruptable mode.	Unsupported.
<ESC>'7'<weight value>	Set weighting (-50 ... 50).	Set weighting (10-90%). cwdaemon 0 = 50%.
<ESC>'8'<device>	Set device for keying.	Unsupported. Makes no sense for this application.
<ESC>'9'<port number>	Obsolete.	N/A
<ESC>'a'<0|1>	PTT keying off|on.	Control Key Out jack or PTT Phono dependent on GUI setting.
<ESC>'b'<0|1>	Audio from mic|soundcard.	Unsupported. Makes no sense for this application.
<ESC>'c'<x>	Tune x seconds.	Assert Key Out for x seconds (uses 'Key Buffered').
<ESC>'d'<delay>	PTT on delay.	Unsupported. Set through GUI.
<ESC>'e'<bandindex>	Parallel port band output.	Unsupported. Makes no sense for this application.
<ESC>'f'<sound system>	Set sound system: c - console buzzer o - OSS a - ALSA p - PulseAudio n - none (no audio) s - soundcard	Partially supported: c - sidetone on n - sidetone off
<ESC>'g'<volume>	Set soundcard volume.	Unsupported. Winkeyer can't vary sidetone volume.
<ESC>'h'<opt. text>	cwdaemon debug mode	Unsupported.

cwdaemon CW text commands are interpreted according to the following table:

Text	cwdaemon function	Winkeyer mapping
+	Increase speed by 2wpm (can concatenate).	Buffered speed change +2wpm (can concatenate).
-	Decrease speed by 2wpm (can concatenate).	Buffered speed change  -2wpm (can concatenate).
~	Half space delay	Half dit delay ( '|' )
!	SN prosign	SN prosign created using merge character command.
&	AS prosign	AS prosign created using merge character command.
>	BK prosign	BK prosign created using merge character command.
<	SK prosign	SK prosign ( '>' )
*	AR prosign	AR prosign ( '<' )
=	BT prosign	BT prosign ( '=' )
(	KN prosign	KN prosign ( '(' )

Download instructions

Click on the link below to download. Extract the zip file to your chosen location.

Navigate to the contents of the extracted jWinkeyServer_xvx.zip directory, either using a terminal or with the file manager. If using a terminal, the program may be run using "java -jar jWinkeyServer.jar". From the file manager, right click and Open With Java. The terminal method will create a winkeyserver.conf file where you started it from. The file manager method will probably create it in the root of your home directory. Provided you start the program consistently it will pick-up the appropriate configuration file.

When you run the program for the first time it is likely not to be set up for the correct serial port location. Simply click on the 'Serial Port' comboBox, select the correct serial port and then click 'restart winkeyer'.

• jWinkeyServer_0v1.zip
  

Acknowledgements

• Thanks to Kustaa Nyholm for the very clever and absolutely brilliant PureJavaComm, which handles the serial port control ( https://github.com/nyholku/purejavacomm/wiki).
• Thanks to Rob Camick for the LimitLinesDocumentListener class (tips4java.wordpress.com), which limits the amount of text lines appended to the text window by deleting old lines.
  

Bug reports

Please send bug reports or feature suggestions by e-mail to the address on my contact page.