rsba1-core

Pure Python implementation of the Icom RS-BA1 V2 protocol stack — control IC-705, IC-9700 and any CI-V transceiver over the network. No Icom binaries required.

What is this?

Icom's RS-BA1 software runs on Windows only and is closed-source. This project reverse-engineers the protocol and provides a pure Python replacement that runs anywhere Python runs.

Tested on: IC-705 (E2E verified 2026-08-18)

Quick Start

pip install rsba1-core

export RADIO_HOST=192.168.0.31
export RADIO_USER=linnan
export RADIO_PASSWORD=your_password

python -m rsba1.mcp read-freq
python -m rsba1.mcp set-freq 7074000

MCP Server (for AI Agents)

python -m rsba1.mcp   # starts MCP server on stdio

Available tools: read_freq, read_mode, read_smeter, set_freq, ptt, get_status

Architecture

Your AI Agent / CLI
        ↓
rsba1-core (pure Python)
        ↓
IC-705 RS-BA1 server (UDP 50001 + 50002)

Key: no Windows APIs, no Icom DLLs, Python 3.11+ only.

Feature Status

Feature	Status
CI-V read (freq/mode/smeter)	✅ E2E verified
CI-V write (set_freq)	✅ E2E verified
PTT	✅ E2E verified
Audio streaming (UDP 50003)	❌ Not implemented

Documentation

• docs/README.md — Bilingual (Chinese/English) full guide
• docs/MCP集成指南.md — MCP integration guide
• docs/真机验证报告.md — E2E verification report

License

MIT — see LICENSE and DISCLAIMER.md.