Changelog¶

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.3.0 — 2026-02-25¶

Audio streaming (Phase 3):
- AudioCodec enum: uLaw, PCM 8/16-bit, Opus 1ch/2ch
- JitterBuffer: reorder out-of-order packets, gap detection, overflow protection
- Full-duplex audio: simultaneous RX + TX
- start_audio() / stop_audio() convenience API
- Configurable audio_codec and audio_sample_rate on IcomRadio
Synchronous API (icom_lan.sync):
- Blocking IcomRadio wrapper with context manager
- Full API parity with async version
Radio model presets (icom_lan.radios):
- IC-7610 (0x98), IC-7300 (0x94), IC-705 (0xA4), IC-9700 (0xA2), IC-R8600 (0x96), IC-7851 (0x8E)
- get_civ_addr() helper function
Token renewal: background task every 60s (matches wfview protocol)
Auto-reconnect: watchdog + exponential backoff reconnect (opt-in)
- auto_reconnect, reconnect_delay, reconnect_max_delay, watchdog_timeout params

CLI tool (icom-lan) with commands: status, freq, mode, power, meter, ptt, cw, power-on, power-off, discover
VFO control: select_vfo(), vfo_equalize(), vfo_exchange(), set_split_mode()
RF controls: set_attenuator(), set_preamp()
CW keying: send_cw_text(), stop_cw_text() — with auto-chunking
Power control: power_control() for remote power on/off
Network discovery: broadcast-based autodiscovery of Icom radios
__main__.py for python -m icom_lan execution
JSON output option (--json) for CLI commands
Frequency parsing with k/m suffix (14.074m, 7074k)

Transport layer: async UDP connection with discovery handshake
Dual-port architecture: control port (50001) + CI-V port (50002)
Full authentication: login → token ack → conninfo exchange → status
CI-V commands: get/set_frequency(), get/set_mode(), get/set_power()
Meters: get_s_meter(), get_swr(), get_alc()
PTT: set_ptt(on/off)
Keep-alive: automatic ping loop (500ms) and retransmit handling
Sequence tracking: gap detection and retransmit requests
Context manager: async with IcomRadio(...) as radio:
Custom exceptions: ConnectionError, AuthenticationError, CommandError, TimeoutError
Type annotations: full py.typed marker
151 unit tests with mocked transport (no hardware required)
Integration tests for IC-7610