Control an Icom IC-7610 transceiver over USB/LAN. Get/set frequency, mode, power, S-meter, SWR. CW keying and beacon mode. Remote power on/off.
---
name: icom-7610
description: Control an Icom IC-7610 transceiver over USB/LAN. Get/set frequency, mode, power, S-meter, SWR. CW keying and beacon mode. Remote power on/off.
metadata: {"openclaw":{"emoji":"๐ป","homepage":"https://clawhub.ai/morozsm/icom-7610","requires":{"bins":["rigctl","curl","python3"]},"install":[{"id":"hamlib","kind":"brew","formula":"hamlib","bins":["rigctl"],"label":"Install Hamlib (rigctl)"}]}}
---
# Icom IC-7610
## Prerequisites
- **Hamlib** (rigctl): `brew install hamlib`
- **curl**: usually pre-installed
- **python3**: usually pre-installed
- **pyserial** (only for serial power on): `pip3 install pyserial`
- **wfview** (optional, for LAN control): [wfview.org/download](https://wfview.org/download)
## Configuration
Station config in `.env` (not in git). On first install: `cp .env.example .env`.
### Environment Variables
| Variable | Default | Description |
|----------|---------|-------------|
| `CALLSIGN` | *(required for CW/beacon)* | Your callsign |
| `SERIAL_PORT` | `/dev/cu.usbserial-11320` | CI-V USB serial port |
| `BAUD_RATE` | `19200` | Serial baud rate (โ ๏ธ not 115200!) |
| `HAMLIB_MODEL` | `3078` | Hamlib model ID for IC-7610 |
| `FLRIG_URL` | `http://127.0.0.1:12345/RPC2` | flrig XML-RPC endpoint |
| `RIGCTLD_ADDR` | `127.0.0.1:4533` | rigctld TCP address (wfview/hamlib) |
| `MAX_POWER_W` | `50` | Hard power limit in watts |
```bash
source "$(dirname "$0")/.env" 2>/dev/null || true
PORT="${SERIAL_PORT:-/dev/cu.usbserial-11320}"
BAUD="${BAUD_RATE:-19200}"
MODEL="${HAMLIB_MODEL:-3078}"
FLRIG="${FLRIG_URL:-http://127.0.0.1:12345/RPC2}"
RIGCTLD="${RIGCTLD_ADDR:-127.0.0.1:4533}"
MAX_POWER="${MAX_POWER_W:-50}"
```
### RFPOWER Scale
rigctl uses **0.0โ1.0** where 1.0 = 100 W. So: `RFPOWER = watts / 100`.
5 W = `0.05`, 50 W = `0.50`. โ ๏ธ `L RFPOWER 5` = 500 W equivalent, NOT 5 watts!
flrig uses watts directly: `rig.set_power 50` = 50 W.
## Connecting
Three connection methods, in priority order. **Auto-detect logic:**
```bash
# 1. Check rigctld (wfview LAN or standalone hamlib rigctld)
if rigctl -m 2 -r "$RIGCTLD" f >/dev/null 2>&1; then
CONN="rigctld"
# 2. Check flrig
elif curl -s --connect-timeout 2 --max-time 3 -X POST "$FLRIG" \
-H "Content-Type: text/xml" \
-d '<?xml version="1.0"?><methodCall><methodName>rig.get_vfoA</methodName></methodCall>' \
| grep -q '<value>'; then
CONN="flrig"
# 3. Fall back to direct serial
else
CONN="serial"
fi
```
### rigctld โ LAN via wfview (recommended) or standalone hamlib daemon
Connects to IC-7610 over network via wfview (UDP) or a running `rigctld` daemon.
**Full control:** freq, mode, power, S-meter, SWR, CW keying, power on/off.
```bash
rigctl -m 2 -r "$RIGCTLD" <cmd>
# Read: f m l RFPOWER l SWR
# Write: F 14074000 M USB 3000 L RFPOWER 0.50
# CW: b "CQ CQ DE YOURCALL K"
# Power: set_powerstat 0 (off) set_powerstat 1 (on)
```
Setup: wfview โ Settings โ Enable LAN โ connect to radio IP โ Enable RigCtld (port 4533).
โ ๏ธ Note: `M` (set mode) may hang waiting for ack from wfview rigctld โ command still executes.
Use a timeout wrapper or send as fire-and-forget when needed.
**Advantages over serial:**
- No USB cable needed โ Ethernet only
- Power on works with simple `set_powerstat 1` (no raw CI-V / pyserial needed)
- Multiple programs can share the radio via wfview (rigctld + virtual serial port)
- Longer distance (Ethernet 100m vs USB 5m)
### rigctl serial (direct USB, full control incl. CW and power on/off)
```bash
rigctl -m $MODEL -r "$PORT" -s $BAUD <cmd>
# Read: f (freq) m (mode+BW) l RFPOWER l SWR
# Write: F 14074000 M USB 3000 L RFPOWER 0.50
# CW: b "CQ CQ DE YOURCALL K"
# Quick: f m l RFPOWER โ freq, mode, BW, power in one call
```
โ ๏ธ Baud **19200** (not 115200!). Always wrap: `timeout 10 rigctl ...`
โ ๏ธ Port busy while flrig runs. Close flrig for CW/power on-off.
### flrig XML-RPC
```bash
call_flrig() {
curl -s --connect-timeout 3 --max-time 5 -X POST "$FLRIG" \
-H "Content-Type: text/xml" \
-d "<?xml version=\"1.0\"?><methodCall><methodName>$1</methodName><params>$2</params></methodCall>" | \
grep -o '<value>[^<]*</value>' | head -1 | sed 's/<[^>]*>//g'
}
# Read: call_flrig rig.get_vfoA / rig.get_modeA / rig.get_power / rig.get_Sunits / rig.get_SWR
# Write: call_flrig rig.set_vfoA '<param><value><double>14074000</double></value></param>'
# call_flrig rig.set_modeA '<param><value><string>USB</string></value></param>'
# call_flrig rig.set_power '<param><value><double>50</double></value></param>'
```
## Remote Power On/Off
Requires: rear POWER switch ON + **MENU โ SET โ Network โ Power OFF Setting = Standby/Shutdown**.
### Via rigctld (wfview LAN) โ simplest
```bash
rigctl -m 2 -r "$RIGCTLD" set_powerstat 0 # off
rigctl -m 2 -r "$RIGCTLD" set_powerstat 1 # on โ works! wfview handles it
```
### Via serial โ power off works, power on needs raw CI-V
**Off:** `rigctl -m $MODEL -r "$PORT" -s $BAUD set_powerstat 0`
**On:** rigctl `set_powerstat 1` DOES NOT WORK via serial (rig_open fails in standby). Use raw CI-V:
```bash
python3 -c "
import serial, time
ser = serial.Serial('$PORT', $BAUD, timeout=2)
ser.reset_input_buffer()
ser.write(bytes([0xFE,0xFE,0x98,0xE0,0x18,0x01,0xFD]))
time.sleep(1); resp = ser.read(100); ser.close()
print('Power ON: OK' if 0xFB in resp else 'FAIL')
"
```
Wait **7โ10 sec** after power on before sending commands. "Command rejected" during boot is normal.
## CW & Beacon
Works via both rigctld (LAN) and direct serial.
```bash
# Via rigctld (LAN):
rigctl -m 2 -r "$RIGCTLD" b "CQ CQ CQ DE $CALLSIGN $CALLSIGN K"
# Via serial:
rigctl -m $MODEL -r "$PORT" -s $BAUD b "CQ CQ CQ DE $CALLSIGN $CALLSIGN K"
# Beacon loop (works with either connection)
for i in $(seq 1 $REPEATS); do
rigctl -m 2 -r "$RIGCTLD" b "VVV DE $CALLSIGN VVV DE $CALLSIGN"
[ $i -lt $REPEATS ] && sleep $INTERVAL
done
```
Radio setting for CW: MENU โ SET โ Connectors โ USB Keying (CW) โ **RTS**
## Safety Rules
### Pre-TX checklist (MANDATORY before every transmission)
1. Operator confirmation received
2. Frequency within amateur band (1.8โ2.0, 3.5โ4.0, 7.0โ7.3, 10.1โ10.15, 14.0โ14.35, 18.068โ18.168, 21.0โ21.45, 24.89โ24.99, 28.0โ29.7 MHz)
3. Mode matches band segment (no phone below CW/data boundary)
4. Power โค $MAX_POWER_W (default 50 W); above โ extra confirmation
5. SWR โค 3.0 if available; >3.0 โ REFUSE (antenna problem)
### No confirmation needed
Reading freq/mode/S-meter/SWR, switching VFO, changing freq/mode, power on/off.
### Always require confirmation
PTT, CW keying, beacon, power > $MAX_POWER_W. Any RF transmission.
### Auto-refuse (even with confirmation)
Transmit outside amateur bands. Transmit with SWR > 3.0.
### Beacon regulatory (FCC)
Remote operation legal (ยง97.109d). Unattended beacon only 28.2โ28.3, 50.06โ50.08+ MHz. Below 28 MHz โ operator must be on comms.
## Reference
Full documentation in `references/FULL-REFERENCE.md` โ consult when needed:
- Complete flrig XML-RPC method list (30+ methods)
- CI-V protocol reference (commands, modes, addressing)
- Error recovery table (common errors + fixes)
- Shell helper functions (freq_valid, set_power_safe, rig_retry, preflight, quick_status)
- Radio menu settings (Network, CI-V, Connectors)
- Compatibility notes for other Icom transceivers
- US Amateur Band Plan table (detailed, with CW/Data/Phone segments)
don't have the plugin yet? install it then click "run inline in claude" again.