HamLib Configuration Guide
This guide will help you configure Hamlib radio control in Cloudlog Aurora to enable automatic frequency and mode tracking, as well as remote radio control from Cloudlog.
What is Hamlib?
Hamlib (HAM Radio Library) is a collection of libraries and utilities that provide a standardized interface to control amateur radio transceivers. Cloudlog Aurora uses Hamlib's rigctl
utility to communicate with your radio via its CAT (Computer Aided Transceiver) interface.
What you can do with Hamlib in Cloudlog Aurora:
- Automatically track frequency and mode changes
- Send frequency/mode to Cloudlog in real-time
- Remote radio control from Cloudlog web interface
- Synchronize frequency with FLDigi (optional)
- Support for multiple radios simultaneously
Prerequisites
Before configuring Hamlib, ensure you have:
- A supported radio with CAT control capability
- CAT interface connection:
- USB cable (most modern radios)
- Serial (RS-232) cable with USB adapter
- Network connection (for some newer radios)
- Radio's CAT driver installed (if required)
- Cloudlog account with API access configured
Installing Hamlib
Step 1: Download Hamlib
Visit the official Hamlib downloads page:
- Windows: https://sourceforge.net/projects/hamlib/files/hamlib/
- Or download the latest release from: https://github.com/Hamlib/Hamlib/releases
Download the appropriate package:
- For 64-bit Windows:
hamlib-w64-x.x.x.zip
- For 32-bit Windows:
hamlib-w32-x.x.x.zip
- For 64-bit Windows:
Step 2: Extract Hamlib
Extract the downloaded ZIP file to a permanent location
- Recommended:
C:\Ham Radio\Hamlib\
- Important: Do not extract to a temporary folder or Downloads
- Recommended:
Inside the extracted folder, locate the
bin
directory- The
rigctl.exe
file should be in this folder - Example path:
C:\Ham Radio\Hamlib\bin\rigctl.exe
- The
Step 3: Note the Path
Write down or copy the full path to rigctl.exe
- you'll need this for Cloudlog Aurora configuration.
Example paths:
C:\Ham Radio\Hamlib\bin\rigctl.exe
Finding Your Radio Model Number
Hamlib identifies each radio by a numeric model ID. You need to find your radio's ID number.
Method 1: Using the Hamlib Website
- Visit Hamlib Supported Radios
- Search for your radio manufacturer and model
- Note the Model ID number (example: Yaesu FT-991A =
1035
)
Method 2: Using rigctl Command
- Open Command Prompt (Windows Key + R, type
cmd
, press Enter) - Navigate to the Hamlib bin directory:
cd "C:\Ham Radio\Hamlib\bin"
- List all supported radios:
rigctl.exe --list
- Search the output for your radio manufacturer and model
- The number before the radio name is the Model ID
Method 3: Common Radio Model IDs
Here are some popular radios and their Hamlib Model IDs:
Manufacturer | Model | Hamlib ID |
---|---|---|
Yaesu | ||
FT-991A | 1035 | |
FT-891 | 1041 | |
FT-817 | 120 | |
FT-818 | 1049 | |
FT-897 | 122 | |
FT-857 | 121 | |
FT-950 | 1019 | |
FTDX-10 | 1045 | |
FTDX-101D/MP | 1043 | |
Icom | ||
IC-705 | 3085 | |
IC-7300 | 3073 | |
IC-7610 | 3081 | |
IC-9700 | 3076 | |
IC-7100 | 3070 | |
Kenwood | ||
TS-2000 | 2014 | |
TS-590S/SG | 2033 | |
TS-890S | 2042 | |
Elecraft | ||
K3/K3S | 2029 | |
KX3 | 2043 | |
Xiegu | ||
G90 | 3085 | |
X6100 | 1044 | |
Dummy Rig | ||
(for testing) | 1 |
Note: Model IDs can change between Hamlib versions. Always verify using rigctl --list
with your installed version.
Configuring Cloudlog Aurora
Step 1: Open Settings
- Launch Cloudlog Aurora
- Click File → Settings from the menu
Step 2: Configure Hamlib Path
- In the Settings window, locate the Hamlib section
- Click the Browse button next to "rigctl Path"
- Navigate to and select
rigctl.exe
(e.g.,C:\Ham Radio\Hamlib\bin\rigctl.exe
) - The path should now appear in the text box
Step 3: Enable Radio Control
- Check the box "Enable Radio Control"
- Click Save to apply the settings
Step 4: Configure COM Port (If Applicable)
If your radio uses a serial/USB CAT connection:
Identify your radio's COM port:
- Open Device Manager (Windows Key + X → Device Manager)
- Expand Ports (COM & LPT)
- Look for your radio or USB-to-Serial adapter
- Note the COM port number (e.g.,
COM3
,COM5
, etc.)
Note the baud rate from your radio's manual
- Common baud rates:
4800
,9600
,19200
,38400
,57600
,115200
- Example: Yaesu FT-991A uses
38400
- Common baud rates:
Adding Radios
Once Hamlib is configured, you can add radios to monitor and control.
Step 1: Open Radio Settings
- In Cloudlog Aurora, click Radio → Radio Settings from the menu
- The Radio Configuration window will open
Step 2: Configure Your First Radio
Fill in the following fields:
Custom Radio Name:
- Enter a unique, descriptive name for this radio configuration
- Important: This name must be unique within Cloudlog Aurora but does not need to match any Cloudlog station settings
- Example:
Main Shack Radio
,Mobile Rig
,Portable Station
Hamlib Radio ID:
- Enter the model number you found earlier
- Example:
1035
for Yaesu FT-991A - Example:
3073
for Icom IC-7300 - Example:
1
for testing with Dummy Rig
Com Port:
- Enter the COM port from Device Manager
- Example:
COM3
,COM5
- Format: Always use uppercase
COM
followed by the number
Baud Rate:
- Enter the baud rate from your radio's manual
- Example:
38400
,9600
,115200
- Must match your radio's CAT settings
Enable FLDigi Integration (Optional):
- Check this box if you want to synchronize with FLDigi
- Cloudlog Aurora will send frequency changes to FLDigi
- FLDigi must be running with XML-RPC enabled (port 7362)
Step 3: Save and Test
- Click Add Radio to save the configuration
- The radio will appear in the list
- Click Close to return to the main window
Step 4: Verify in Main Window
In the main Cloudlog Aurora window, locate the Radio List section
Your radio should appear with:
- A checkbox to enable/disable polling
- Radio name
- Current frequency
- Current mode
The checkbox should be checked by default (polling enabled)
Adding Multiple Radios
Repeat the above steps for each radio you want to monitor. Cloudlog Aurora supports multiple radios simultaneously, each with independent polling settings.
Example Multi-Radio Setup:
Radio 1: Main Station (IC-7300, COM3, 19200 baud, 500ms poll)
Radio 2: Mobile Rig (FT-991A, COM5, 38400 baud, 1000ms poll)
Radio 3: Remote Station (TS-890S, COM7, 57600 baud, 500ms poll)
Testing Your Configuration
Basic Connection Test
- Turn on your radio and ensure CAT control is enabled
- Verify the radio appears in Device Manager (COM port is active)
- Check Cloudlog Aurora's Radio List:
- Frequency should update when you change your radio's frequency
- Mode should update when you change your radio's mode
Manual Test with rigctl
If automatic polling isn't working, test rigctl manually:
Open Command Prompt
Navigate to Hamlib bin directory:
cd "C:\Ham Radio\Hamlib\bin"
Test reading frequency:
rigctl.exe -m 1035 -r COM3 -s 38400 f
- Replace
1035
with your radio's model ID - Replace
COM3
with your COM port - Replace
38400
with your baud rate - Should return the current frequency in Hz
- Replace
Test reading mode:
rigctl.exe -m 1035 -r COM3 -s 38400 m
- Should return the current mode (e.g.,
USB
,LSB
,FM
)
- Should return the current mode (e.g.,
If these commands work, your setup is correct
Testing Remote Commands (Advanced)
Once configured, you can test remote radio control from Cloudlog:
- Log in to your Cloudlog web interface
- Navigate to the station where you configured the radio name
- Use Cloudlog's radio control features to:
- Change frequency
- Change mode
- Commands are queued and executed by Cloudlog Aurora every 1 second
Troubleshooting
Radio Not Appearing in List
Possible Causes:
- Radio control not enabled in Settings
- Radio was added but window wasn't refreshed
- Configuration file issue
Solutions:
- Close and reopen Cloudlog Aurora
- Check Settings → Enable Radio Control is checked
- Go to Radio → Radio Settings to verify radio was saved
Frequency Shows "N/A"
Possible Causes:
- COM port incorrect or in use by another program
- Baud rate doesn't match radio settings
- Radio's CAT interface not enabled
- Hamlib model ID incorrect
- Cable issue
Solutions:
Verify COM port:
- Check Device Manager for correct port
- Close other programs using the radio (logging software, SDR, etc.)
Check baud rate:
- Consult your radio's manual for correct CAT baud rate
- Some radios allow you to change CAT baud rate in menu settings
Enable CAT on radio:
- Check your radio's menu for CAT/Computer settings
- Ensure CAT is enabled and baud rate is set
Verify Hamlib model:
- Run
rigctl --list
to confirm model number - Try a closely related model if yours isn't working
- Run
Check cable:
- Ensure cable is properly connected
- Try a different USB port
- Test with manufacturer's CAT control software
"Unable to open Radio" Error
Possible Causes:
- COM port in use by another application
- COM port doesn't exist
- Insufficient permissions
Solutions:
Close other programs that might be using the COM port:
- Other logging software
- SDR software
- Manufacturer's control software
Verify COM port in Device Manager:
- If COM port has a yellow warning icon, update drivers
- Reconnect USB cable if COM port disappeared
Run Cloudlog Aurora as Administrator (right-click → Run as administrator)
Remote Commands Not Working
Possible Causes:
- Radio name doesn't match Cloudlog station profile
- Cloudlog API not configured
- Commands are queued but radio is offline
Solutions:
Verify radio name match:
- In Cloudlog: Settings → Station Profiles → Note exact radio name
- In Aurora: Radio Settings → Custom Radio Name must match exactly
- Names are case-sensitive
Check Cloudlog API:
- Settings → Cloudlog URL must include trailing slash
- Settings → API Key must be valid
Check Aurora console output:
- Shows command processing and errors
- Look for "[RadioCommands]" messages
FLDigi Integration Not Working
Possible Causes:
- FLDigi not running
- XML-RPC not enabled in FLDigi
- Port conflict
Solutions:
Start FLDigi before enabling integration
Enable XML-RPC in FLDigi:
- FLDigi menu: Configure → Misc → Web Server
- Check "Enable XML-RPC Server"
- Port should be
7362
- Click Save/Close
Verify port:
- Default port is 7362
- Ensure no other program is using this port
Dummy Rig (Model 1) for Testing
If you want to test without a real radio:
- Use Hamlib Model ID:
1
- No COM port needed
- No baud rate needed
- Dummy rig simulates a radio for testing purposes
Configuration Example:
- Radio Name:
Test Radio
- Hamlib ID:
1
- COM Port:
COM1
(won't be used) - Baud Rate:
9600
(won't be used)
Advanced Features
Multiple Radio Monitoring
You can monitor multiple radios simultaneously:
- Each radio must have a unique COM port
- Each radio must have a unique name matching Cloudlog
- All radios poll independently at their configured intervals
- Enable/disable polling per radio using the checkbox in the main window
Example Multi-Station Setup:
Station A:
- Radio: Main IC-7300 (COM3)
- Radio: Secondary FT-991A (COM5)
Station B:
- Radio: Mobile FT-891 (COM7)
Context Menu Options
Right-click on any radio in the Radio List to:
- Enable Polling: Start monitoring frequency/mode
- Disable Polling: Stop monitoring (saves CPU)
- Useful for temporarily disabling radios without removing configuration
Configuration File Location
Radio configurations are stored in:
C:\Users\[YourUsername]\Documents\radiosettings.json
This file contains:
- Radio names
- Model IDs
- COM ports
- Baud rates
- Poll times
- FLDigi settings
- Polling enabled/disabled state
You can:
- Edit this file manually (not recommended)
- Copy it to another computer
- Back it up for safekeeping
Tips and Best Practices
1. Match Radio Names Exactly
- Radio names in Aurora must exactly match Cloudlog station profile names
- Case-sensitive: "Main Radio" ≠ "main radio"
- Spaces matter: "Main Radio" ≠ "MainRadio"
3. Use Descriptive Radio Names
- Good: "Shack IC-7300", "Mobile FT-991A", "Portable QRP"
- Avoid: "Radio1", "Rig", "Test"
4. Test One Radio First
- Configure and test one radio before adding multiple
- Verify frequency/mode updates work
- Then add additional radios
5. Keep Hamlib Updated
- Newer Hamlib versions support more radios
- Check for updates periodically
- Download from Hamlib GitHub Releases
6. Monitor Console Output
- Console shows detailed logging
- Useful for debugging connection issues
- Look for error messages
7. Disable Polling When Not Operating
- Uncheck radios in Radio List when not in use
- Saves CPU resources
- Prevents COM port conflicts with other software