Radio Panel

The radio panel displays and controls the VFO of the connected radio. The check box shows/controls the connection status. The VFO frequency text edit field will display the frequency in MHz and can be edited directly to change the VFO frequency. The VFO stepper up/down arrows will change the radio VFO 10 Hz up or down with each click of the keyboard up/down arrows, or you can set up the Griffin PowerMate to send up/down arrow clicks.

If you hold the mouse pointer over the VFO Stepper and scrub the scroll pad up and down the VFO frequency will be tuned.

The VFO slider will change the frequency continuously as well.

To activate a specific control like the VFO stepper you will have to Tab the control into focus first. Make sure your System Preferences / Keyboard / Shortcuts settings allow you to tab through all the controls (Full Keyboard Access).

Radio Prefs

Connecting the Computer to your Radio for CAT (Computer Aided Tuning / Rig Control)

The Radio popup allows you to store 8 different radio configurations.

The Clear Setting button clears the settings for the selected radio configuration.

The Adaptive Polling check box allows the polling rate to decrease when there is less activity, if you are using a band decoder, amplifier or any device which is using a Y-cable to listen in to the CAT polling you may want to disable this to poll once a second.

The Echo port popup chooses the USB/Serial port to output amplifier/SteppIR etc. tuning frequency data at the baud rate selected from the Baud Rate popup, while the Format popup chooses Kenwood/Icom format. The Icom Format also requires the CI-V address to be specified. You may need a null-modem adapter to reverse the data lines depending on your configuration. The commands to the echo port >> and the commands returning from the echo port << are captured in the Debug Log if the Radio prefs Debug Log check box is enabled.

The Command Delay text field specifies the number of milliseconds delay between CAT command bytes, the lower the better for VFO responsiveness, 0 for newer radios.

The Split Delay text field specifies the number of milliseconds delay between Mode and Band changes for Auto Tune and Split. This delay comes into play during a Split or Auto Tune operation to provide settling time between mode and band changes to give the radio some time to settle. Some radios cannot respond to commands immediately after a band or mode change. For most modern radios Split Delay can be set to 10 ms (the default and minimum). The K3 and FT-897 require 100 or 200 ms to settle. Generally the lower the number the better. If the number is too low the mode may be set incorrectly during a split operation.

The Cluster QSX tuning check box will set split for dxcluster spots where MacLoggerDX can parse comment fields with QSX 14100.0, UP 3, DWN 2, DOWN 5 etc. Split spot frequencies will show in italics in the Spot panel. The parser is reasonably accurate and handles the majority of cases but the syntax for reporting QSX in the comments field of a dxcluster spot is far from standardised so some false positives/negatives or bad QSX values may occur.

The TX Param popup supplies an optional audio routing parameter for radio PTT.

TS-590S, TS-990S 0-Mic, 1-Data


Keyer Window

The PTT and CW popups in the Radio Prefs will determine how the radio is set to transmit and how CW is generated.

If you want to use pre-recorded audio files or text-to-speech keying, the Speech popup should be set to your radio sound card (USB Audio Codec) not the Built-in-Output since you want the audio to go to the radio not the Mac speakers. You may also have to configure the radio menus so that the radio will take it’s modulation audio from the internal sound card instead of the microphone jack.



The Keyer Window is activated with the Keyer button in the VFO Panel or with the Shortcuts menu Keyer menu item.

The Type Ahead check box will send the CW as you type instead of waiting for you to press the return key or the CW button.

The Type Ahead Filter value will apply a small pacing filter (0 - 1000 ms) giving the transmission a smoother rhythm. A value of 0 removes the filter completely.

The Speed text edit area allows you change the send speed for both Radio generated CW and DTR/RTS CW (with USB Keyers this field is not editable but shows the setting of the Keyer Speed pot).

The Dit Interval: text edit area allows you change the 'dit' intervals between words in DTR/RTS CW.

The Macro popup will place the selected Macro in the text input are and expand any variables in the macro. You can define keyboard shortcuts for the Keyer Macros and because the Keyer Macros menu is duplicated in the Shortcuts menu the Keyer Panel does not need to be foremost for the keyboard shortcut to work. Unlike the Keyer Macros popup, the Keyboard Macros will also automatically send the macro to the CW keyer.

The Repeat every n seconds check box will cause the CW, Speech or Sound file to be retransmitted every n seconds.

The Sound file popup will select a pre-recorded sound file (~/Documents/MLDX_Logs/recorded_sound_files) to play.

The Play button will send the selected pre-recorded audio file. The audio files are loaded from ~/Documents/MLDX_Logs/recorded_voice_files/

The Speak button cause the text in the text edit area to be converted to speech and sent.

The Clear button will clear the text input area.

The Cancel button will stop CW or speech transmission immediately (you can also use the escape key for this).

The Record button will allow you to record voice announcements to play back over the air (requires Mac OS X 10.7 or later). The files will be stored in ~/Documents/MLDX_Logs/recorded_voice_files/.

Pressing return will activate the CW button and send the CW. The escape key or the Cancel button will cancel it.

The CW button causes the CW in the text edit area to be sent by toggling the DTR, RTS or both lines on the radio serial port or by sending the text to the radio or Keyer.

The Status light and text will tell you which CW, PTT methods and Audio output device you have chosen in the radio prefs and if the keyer device has been opened successfully.

Text enclosed by square brackets will be elided as a prosign by the K1EL and DTR/RTS keyers. [AA] will be sent as .-.-


CW and Text-To-Speech Macros

Variable Replaced with Example
@MYCALL station call VE3VRW
@MYNAME Operator Don Agro
@MYQTH Station QTH Toronto, Ontario, Canada
@RST Signal Report Sent 599
@RRST Signal Report Received 599
@PWR Transmit Power 50W
@STX Numeric Sequence # 0134
@STS String Sequence Exchange Sent
@MYGRID Station QTH Grid FN03jq
@QSONAME QSO's First Name John
@BAND QSO Band 30M
@FREQUENCY QSO Frequency 10.110
@UTC Current Time UTC 10:12:09
@UTS Current Time UTC (Short) 1012

To customize the keyer macros, edit cwmacros.dat In the downloaded Sample Files folder, place it in ~/Documents/MLDX_Logs/ and reopen the Keyer window. Make sure you save the file as Plain Text not Rich Text. Blank lines in the file will generate separator lines in the menus.

Rotor Panel

The Rotor check box displays/controls the connection status of the rotor controller. The circular slider allows you to manually control the rotor heading. Normally you would use the Beam button or the Log Menu Goto Beam Heading and Goto Reverse Heading menu items to rotate the beam to the calculated heading of the last station lookup. You may also type in a beam heading and press return. The actual Bearing is displayed as well (Not supported by all rotor controllers).

To configure the rotor controller you must select the serial port it is connected on, the baud rate and number of stop bits that it is expecting (check the controller manual for this information), the controller type (ie hy-gain DCU-1 Pathfinder) and the command delay.

A number of third party rotor controllers use the DCU-1 protocol for communication, check your controller's user manual for the driver, baud rate and stop bit settings.

The Auto Rotate Beam check box will rotate the beam automatically, short path to the location of the lookup station when you double-click on a spot in the DXClusters/Spots panel or perform any manual look up. The bearing calculation accuracy depends on the accuracy of your latitude and longitude entered in the Station Prefs and the accuracy of the geo-location data returned by your look up.

The Auto Rotate Short Path check box will auto rotate short path if checked or long path if un-checked.

The Auto Rotate Band check boxes will enable or disable auto rotate for specific bands.

The Bearing Menu item under the MacLoggerDX Menu activates a Bearing Display HUD which will display the lookup bearing (white) as well as the actual rotor bearing (green) if your rotor controller supports read-back. The rotor read-back bearing (if available) will also display as a green line on the 2D and 3D maps.

Rotor Controllers supporting read-back:

If you are having problems with the connection Please enable the Debug Log check box in the Rotor Prefs Panel, Show Debug Log from the File menu and drag the highlited file from the Finder onto an email to us as well as a screen shot of your Rotor Prefs.
Note: Prior to Version 5.52 debug log text can be found in the Console Application.

Note: <command> <shift> 4 then pick your corners, and the screen shot is placed on your desktop.