Iambic Master

About Iambic Master

Iambic Master is a free program intended to be used as a training aid for sending CW using an iambic keyer, specifically a Winkeyer from K1EL Systems.

Caution

Since most Winkeyers will be connected to a transmitter, please take care to avoid transmitting over the air when practicing with this program.

Minimum System Requirements

Windows XP Service Pack 3 or Later

Microsoft .NET Framework 4.0 or Later

K1EL Systems Winkeyer

The system has been tested on Windows 7 with .NET Framework 4.5 and two hardware configurations:  WinkeyerUSB and MicroHAM MK2R+.

Getting Started

1.       Download the latest version of Iambic Master here.

2.       Upzip the files to any desired location on your computer, but keep them together.

3.       Ensure that your Winkeyer is powered on and connected to the computer.

4.       Ensure that other programs (such as a logger) that may control the Winkeyer are not open.

5.       Run IambicMaster.exe

6.       The first time the program is run, the Serial Port Error window is displayed.  Select the serial port used by the Winkeyer and then click Retry.

7.       When the main window is displayed, click the Winkeyer button and make sure the settings are appropriate for your configuration.  The settings take effect immediately, so you can experiment with sending while this window is open.  Close the window when finished.

8.       Enter your call.

9.       At this point the program should be ready for use.

Operation

Iambic Master operates as a game.  The objective of the game is to send the text in the Target box as accurately as possible.  What the Winkeyer decodes is displayed to the Echo box.  Each game, or run, consists of a fixed number of trials.  Each trial consists of the user attempting to send the Target text in the form of a contest exchange.  A trial goes on until the Echo Text matches the Target Text perfectly.

To begin a run, click the Start button.  All controls are locked during a run. The Abort button is available to end a run prematurely.  At the end of a completed run, the Scores window is displayed, with the latest run highlighted (although the highlight may be hard to see depending on your Windows theme).

Controls

The Controls group on the main window is used to configure a run.

Use Your Call to enter the call sign of the user.  This information is logged in the Scores table.

Use Speed to set the Winkeyer speed in units of words per minute.

Use the Display check box to show or hide the Echo box.

Use Mode to choose which type of contest exchange to use:  Sprint or Sweepstakes.  The Sweepstakes exchange tends to be longer and more difficult.

Use Run Length to set the number of trials for the run:  10, 25, or 50.  If you are a beginner, start with a length of 10, as even that may be difficult to finish.

Scoring

A perfect trial is worth “CW Speed” x “Length of Target Text” points.

When there are errors, the score is further reduced. The additional scale factor is 0.9 x “Length of Target Text” / “Length of Echo Text”.  As a result, an error at the beginning of the exchange is not too bad, but an error at the end can be quite painful.   This quirk of the scoring system adds pressure as you get toward the end of the exchange.  Note that it is best to restart at the beginning of the exchange as soon as you detect an error.  

Scoreboard

The Scoreboard section of the main window gives feedback on the current run.

The Score is shown followed by the percentage of available points in parentheses.

The number of Perfect trials is shown followed by the percentage of perfect trials in parentheses.

The Current Streak and Longest Streak of perfect trials are shown.

The current Trial number is shown.

Scores Window

The Scores window is displayed automatically at the end of a run, but it call also be opened by clicking View Scores on the main window.

Use the buttons on top to select the contest type and the run length, and the scores are tracked separately for each combination.

The last run is always highlighted (although this may be faint depending on your Windows theme).

Each column may be sorted by click on the heading.

Efficiency is the percentage of the total available points.

Perfect is the percentage of perfect trials.

Winkeyer Configuration

The Winkeyer configuration can be accessed pressing the Winkeyer button on the main window.

Winkeyers come in many forms, so this program may control all or none of these settings. 

When the program closes, all settings should return to the stand-by mode value.

Help

You may right click on the main window (outside of any controls or control groups) and select Help to access this website.

Training Program

NA0N uses the following training regimen.

1.       Sprint with Run Length 10 until 90% of total points.

2.       Sweepstakes with Run Length 10 until 90% of total points.

3.       Sprint with Run Length 25 until 90% of total points.

4.       Sweepstakes with Run Length 25 until 90% of total points.

5.       Sprint with Run Length 50 until 90% of total points.

6.       Sweepstakes with Run Length 50 until 90% of total points.

7.       Increase by 1 WPM and Repeat

The pressure really builds when you are close to 90% on one of the long runs.

Revision History

Download latest version.

 Version   Date     Description 
1.0.5587.21596 2015-04-19 Initial Release
1.0.5588.36725 2015-04-20    Fixed exceptions related to the scores file.
1.0.5995.32553 2016-05-31 Fixed an issue that might result in a incorrect speed setting.
Removed the scoring penalty for having Echo enabled.
1.0.6557.38335 2017-12-14 Fixed an issue with recent scores not displaying properly.

Iambic Master Freeware License Agreement

 

All copyrights to Iambic Master are exclusively owned by the author - Patrick Korkowski (NA0N).

Anyone may use this software. The Iambic Master software may not be rented or leased or sold.

The Iambic Master freeware version may be freely distributed, provided the distribution package is not modified. No person or company may charge a fee for the distribution of Iambic Master under any circumstances whatsoever.

Iambic Master is distributed "as is". No warranty of any kind is expressed or implied. You use at your own risk. The author will not be liable for data loss, damages, loss of profits or any other kind of loss while using or misusing this software.

You may not reverse engineer, decompile or disassemble the software, except and only to the extent that applicable law expressly permits, despite this limitation.

All rights not expressly granted here are reserved by Patrick Korkowski (NA0N).

Installing and using Iambic Master signifies acceptance of these terms and conditions of the license.

If you do not agree with the terms of this license you must cease to use the software.

Patrick Korkowski 4/19/2015