When you run the program for the first time after a new version has been posted, the system may warn you that it doesn't recognize the application's digital signature. You can safely disregard this warning and run the program.
You can send Morse, either locally or to someone else over the Internet, by typing on the keyboard.
If you prefer, you can toggle the circuit closer open and closed by pressing the Escape key instead of clicking on the Circuit Closer control.
Click on the Options button on the main KOB window to open the options window. After selecting the desired options, click on the OK button to close the options window.
Use the pull-down menu to select a specific sound card on your computer.
Check the Mute box to silence the speakers.
Use the pull-down menu to select the desired serial port. The controls in the Port panel are enabled only if you have activated the serial port interface by installing RXTX software on your computer.
Check the Keyer box if you want to connect a keyer paddle to the serial port and use it to simulate a bug.
Use the first pull-down menu to select your mode of operation:
Note: In some situations, to have a new mode setting take effect you will have to restart the program by refreshing the web page.
Use the second pull-down menu to specify whether the code reader and keyboard sender should use American Morse or International (Continental) code. To avoid confusion, it's recommended that wires 20 through 29 be used for International Morse.
If the WPM setting in the Farnsworth panel is greater than the WPM setting on the main KOB window, the code sender will send characters at the higher speed but insert enough extra space—between characters or words, as desired—so that the overall code speed is maintained at the lower rate.
Code reader: This checkbox enables or disables the code reader.
Show versions: Appends the program version numbers to the IDs displayed in the ID list.
Capture timing: Causes the program to display the timing of sent or received code. Positive numbers represent marks (in milliseconds) and negative numbers represent spaces.
In order to use MorseKOB with an external key or sounder, you'll need the following:
[Add info about recommended adapters (Cables to Go for Windows and Linux, Keyspan for Mac OS X) and how to install the driver software.]
Java itself doesn't provide access to the serial port, so if you want to connect a key or sounder to your computer you'll have to install an RXTX module specific to your operating system.
Once you've installed the RXTX software according to the instructions below, all available serial ports will appear in the pull-down list on the MorseKOB control panel. Select the one that you're using for your telegraph interface.
An easy way to tell which comm port is associated with a particular USB adapter is to unplug the adapter, note the comm ports that appear in the list, then plug the adapter in again and see which one has been added. You'll have to restart the program (by refreshing the web page, for example) to update the port list after you connect or disconnect a USB adapter. This trick doesn't work for the Mac, but the port names are more intuitive on the Mac anyway.
Download the file rxtxSerial.dll (32-bit or 64-bit version) and save it in C:\Windows (or any other location in your system's library search path).
Download the file librxtxSerial.jnilib (32/64-bit combined version) and save it in Macintosh HD/System/Library/Java/Extensions. To download the file with Safari, Control-click on the link and select Save Linked File As. Make sure Safari doesn't append a .txt extension to the filename.
Download the file librxtxSerial.so (32-bit or 64-bit version) and save it in /usr/lib (or any other location in your system's library search path).
If you have any questions, comments, or suggestions—no matter how trivial or obvious they may seem—I definitely want to hear from you. I may not be seeing the same thing on my computer and I may not have heard about it from anyone else. My email address is at the bottom of the MorseKOB home page.
MorseKOB 3.0 requires Java Version 6 or later (also known as version 1.6.0). If the MorseKOB web page doesn't display the KOB control panel, then visit java.com/en/download/testjava.jsp to see which version of Java is installed on your computer.
Mac users who delete the Apple-supplied Java program and install the latest one from Oracle must delete the old Java preferences file in Macintosh HD/Applications/Utilities, if installation of the Oracle version leaves it in place.
Also, the Java files at the user level are in Macintosh HD/Users/(username)/Library/Oracle/Java. But ordinarily there is no need to access the files in there.
To access the User-level Library folder, click on the desktop to bring the Finder to the front. Hold down the Option key and click on the Go menu. "Library" will then be listed as a choice. For some reason this is the only way to access it in Lion and Mountain Lion.
If you have trouble running the program, I may ask you for a copy of the Java console output. If you're running Windows, here's how to enable the Java console:
If you're running Mac OS X, do the following:
Once you've done this, whenever you run MorseKOB a Java console window will open up and display status and diagnostic information for the program. You can copy this data by clicking on the Copy button at the bottom of the window, which you can then insert directly into an email message.
I may also want to see a screen shot of your KOB window. Here's the procedure for doing that in Windows:
On the Mac, press Command-Shift-4 (for a portion of the screen) or Command-Shift-3 (for the entire screen) to save a screen shot to the desktop. On Linux, use Applications > Accessories > Take Screenshot.
To restore the program's options to their default settings, download and run the program ResetOptions. This program runs very quickly and without any visible output, so it may appear that it hasn't done anything. But the next time you run the KOB program, you should find that its settings have reverted to their default state.