icom-wlan-node 0.2.6 → 0.3.0

package/README.md

@@ -117,6 +117,7 @@ await rig.setPtt(false);
   - **Audio TX**: `setPtt(on: boolean)`, `sendAudioFloat32()`, `sendAudioPcm16()`
   - **Rig Control**: `setFrequency()`, `setMode()`, `setConnectorDataMode()`, `setConnectorWLanLevel()`
   - **Rig Query**: `readOperatingFrequency()`, `readOperatingMode()`, `readTransmitFrequency()`, `readTransceiverState()`, `readBandEdges()`
+  - **Antenna Tuner**: `readTunerStatus()`, `setTunerEnabled()`, `startManualTune()`
   - **Meters (RX)**: `readSquelchStatus()`, `readAudioSquelch()`, `readOvfStatus()`, `getLevelMeter()`
   - **Meters (TX)**: `readSWR()`, `readALC()`, `readPowerLevel()`, `readCompLevel()`
   - **Power Supply**: `readVoltage()`, `readCurrent()`
@@ -421,3 +422,29 @@ ICOM_IP=192.168.31.253 ICOM_PORT=50001 ICOM_USER=icom ICOM_PASS=icomicom npm tes
 ## License
 
 MIT
+#### Antenna Tuner (ATU)
+
+- `readTunerStatus(options?: QueryOptions) => Promise<{ raw: number; state: 'OFF'|'ON'|'TUNING' } | null>` — 读取天调状态（CI‑V 0x1A/0x00）
+- `setTunerEnabled(enabled: boolean) => Promise<void>` — 开启/关闭内置天调（CI‑V 0x1A/0x01 00/01）
+- `startManualTune() => Promise<void>` — 触发一次手动调谐（相当于 [TUNE] 键，CI‑V 0x1A/0x02/0x00）
+
+示例：
+
+```ts
+// 读取天调状态
+const atu = await rig.readTunerStatus({ timeout: 2000 });
+if (atu) console.log('ATU:', atu.state); // OFF / ON / TUNING
+
+// 启用内置天调
+await rig.setTunerEnabled(true);
+
+// 触发一次手动调谐
+await rig.startManualTune();
+
+// 可选：轮询状态直到结束
+let status;
+do {
+  await new Promise(r => setTimeout(r, 300));
+  status = await rig.readTunerStatus({ timeout: 1000 });
+} while (status && status.state === 'TUNING');
+```

package/dist/rig/IcomControl.d.ts

@@ -1,4 +1,4 @@
-import { IcomRigOptions, RigEventEmitter, IcomMode, ConnectorDataMode, SetModeOptions, QueryOptions, SwrReading, AlcReading, WlanLevelReading, LevelMeterReading, SquelchStatusReading, AudioSquelchReading, OvfStatusReading, PowerLevelReading, CompLevelReading, VoltageReading, CurrentReading, ConnectionState, ConnectionMonitorConfig, ConnectionPhase, ConnectionMetrics, DisconnectReason, DisconnectOptions } from '../types';
+import { IcomRigOptions, RigEventEmitter, IcomMode, ConnectorDataMode, SetModeOptions, QueryOptions, SwrReading, AlcReading, WlanLevelReading, LevelMeterReading, SquelchStatusReading, AudioSquelchReading, OvfStatusReading, PowerLevelReading, CompLevelReading, VoltageReading, CurrentReading, ConnectionState, ConnectionMonitorConfig, ConnectionPhase, ConnectionMetrics, DisconnectReason, DisconnectOptions, TunerStatusReading, LevelReading } from '../types';
 import { IcomCiv } from './IcomCiv';
 import { IcomAudio } from './IcomAudio';
 export declare class IcomControl {
@@ -190,6 +190,49 @@ export declare class IcomControl {
      * await rig.setConnectorDataMode('WLAN');
      */
     setConnectorDataMode(mode: ConnectorDataMode | number): Promise<void>;
+    /**
+     * ==============================
+     * Antenna Tuner (ATU) Operations
+     * ==============================
+     */
+    /**
+     * Read antenna tuner status (CI-V 0x1A/0x00)
+     * 00=OFF, 01=ON, 02=TUNING
+     */
+    readTunerStatus(options?: QueryOptions): Promise<TunerStatusReading | null>;
+    /**
+     * Enable or disable internal antenna tuner (CI-V 0x1A/0x01)
+     * @param enabled true to enable, false to disable
+     */
+    setTunerEnabled(enabled: boolean): Promise<void>;
+    /**
+     * Start a manual tuning cycle (same as [TUNE] key) (CI-V 0x1A/0x02/0x00)
+     */
+    startManualTune(): Promise<void>;
+    /** Get AF (audio output) gain. Returns 0.0–1.0, or null on timeout. */
+    getAFGain(options?: QueryOptions): Promise<LevelReading | null>;
+    /** Set AF (audio output) gain. Value 0.0–1.0. */
+    setAFGain(value: number): void;
+    /** Get squelch level. Returns 0.0–1.0, or null on timeout. */
+    getSQL(options?: QueryOptions): Promise<LevelReading | null>;
+    /** Set squelch level. Value 0.0–1.0. */
+    setSQL(value: number): void;
+    /** Get RF transmit power. Returns 0.0–1.0, or null on timeout. */
+    getRFPower(options?: QueryOptions): Promise<LevelReading | null>;
+    /** Set RF transmit power. Value 0.0–1.0. */
+    setRFPower(value: number): void;
+    /** Get microphone gain. Returns 0.0–1.0, or null on timeout. */
+    getMicGain(options?: QueryOptions): Promise<LevelReading | null>;
+    /** Set microphone gain. Value 0.0–1.0. */
+    setMicGain(value: number): void;
+    /** Get noise blanker level. 0.0 = off, >0.0 = on with strength. */
+    getNBLevel(options?: QueryOptions): Promise<LevelReading | null>;
+    /** Set noise blanker level. Value 0.0 (off) – 1.0. */
+    setNBLevel(value: number): void;
+    /** Get noise reduction level. 0.0 = off, >0.0 = on with strength. */
+    getNRLevel(options?: QueryOptions): Promise<LevelReading | null>;
+    /** Set noise reduction level. Value 0.0 (off) – 1.0. */
+    setNRLevel(value: number): void;
     /**
      * Read squelch status (noise/signal gate state)
      * @param options - Query options (timeout in ms, default 3000)
@@ -286,6 +329,17 @@ export declare class IcomControl {
     private processCivPayload;
     private waitForCivFrame;
     private static isMeterReply;
+    private static is0x14DataReply;
+    /**
+     * Read a 0x14 level value from the radio.
+     * Returns normalized value 0.0-1.0, or null on timeout/error.
+     */
+    private read0x14Level;
+    /**
+     * Write a 0x14 level value to the radio.
+     * @param value - Normalized value 0.0-1.0
+     */
+    private write0x14Level;
     private startMeterPolling;
     private stopMeterPolling;
     private onAudioData;

package/dist/rig/IcomControl.js

@@ -811,6 +811,116 @@ class IcomControl {
         const modeCode = typeof mode === 'string' ? (0, IcomConstants_1.getConnectorModeCode)(mode) : mode;
         this.sendCiv(IcomRigCommands_1.IcomRigCommands.setConnectorDataMode(ctrAddr, rigAddr, modeCode));
     }
+    /**
+     * ==============================
+     * Antenna Tuner (ATU) Operations
+     * ==============================
+     */
+    /**
+     * Read antenna tuner status (CI-V 0x1A/0x00)
+     * 00=OFF, 01=ON, 02=TUNING
+     */
+    async readTunerStatus(options) {
+        const timeoutMs = options?.timeout ?? 3000;
+        const ctrAddr = IcomConstants_1.DEFAULT_CONTROLLER_ADDR;
+        const rigAddr = this.civ.civAddress & 0xff;
+        const req = IcomRigCommands_1.IcomRigCommands.getTunerStatus(ctrAddr, rigAddr);
+        const resp = await this.waitForCivFrame((frame) => IcomControl.matchCommandFrame(frame, 0x1a, [0x00], ctrAddr, rigAddr), timeoutMs, () => this.sendCiv(req));
+        if (!resp)
+            return null;
+        // Expect FE FE [ctr] [rig] 0x1A 0x00 [status] FD
+        const raw = resp.length > 6 ? (resp[6] & 0xff) : undefined;
+        if (raw === undefined)
+            return null;
+        const state = raw === 0x00 ? 'OFF' : raw === 0x01 ? 'ON' : raw === 0x02 ? 'TUNING' : 'OFF';
+        return { raw, state };
+    }
+    /**
+     * Enable or disable internal antenna tuner (CI-V 0x1A/0x01)
+     * @param enabled true to enable, false to disable
+     */
+    async setTunerEnabled(enabled) {
+        const ctrAddr = IcomConstants_1.DEFAULT_CONTROLLER_ADDR;
+        const rigAddr = this.civ.civAddress & 0xff;
+        this.sendCiv(IcomRigCommands_1.IcomRigCommands.setTunerEnabled(ctrAddr, rigAddr, enabled));
+    }
+    /**
+     * Start a manual tuning cycle (same as [TUNE] key) (CI-V 0x1A/0x02/0x00)
+     */
+    async startManualTune() {
+        const ctrAddr = IcomConstants_1.DEFAULT_CONTROLLER_ADDR;
+        const rigAddr = this.civ.civAddress & 0xff;
+        this.sendCiv(IcomRigCommands_1.IcomRigCommands.startManualTune(ctrAddr, rigAddr));
+    }
+    // ============================================================================
+    // 0x14 Level API — AF Gain, SQL, RF Power, MIC Gain, NB Level, NR Level
+    // ============================================================================
+    /** Get AF (audio output) gain. Returns 0.0–1.0, or null on timeout. */
+    async getAFGain(options) {
+        const v = await this.read0x14Level(0x01, options);
+        if (v === null)
+            return null;
+        return { raw: Math.round(v * 255), normalized: v };
+    }
+    /** Set AF (audio output) gain. Value 0.0–1.0. */
+    setAFGain(value) {
+        this.write0x14Level(0x01, value);
+    }
+    /** Get squelch level. Returns 0.0–1.0, or null on timeout. */
+    async getSQL(options) {
+        const v = await this.read0x14Level(0x03, options);
+        if (v === null)
+            return null;
+        return { raw: Math.round(v * 255), normalized: v };
+    }
+    /** Set squelch level. Value 0.0–1.0. */
+    setSQL(value) {
+        this.write0x14Level(0x03, value);
+    }
+    /** Get RF transmit power. Returns 0.0–1.0, or null on timeout. */
+    async getRFPower(options) {
+        const v = await this.read0x14Level(0x0a, options);
+        if (v === null)
+            return null;
+        return { raw: Math.round(v * 255), normalized: v };
+    }
+    /** Set RF transmit power. Value 0.0–1.0. */
+    setRFPower(value) {
+        this.write0x14Level(0x0a, value);
+    }
+    /** Get microphone gain. Returns 0.0–1.0, or null on timeout. */
+    async getMicGain(options) {
+        const v = await this.read0x14Level(0x0f, options);
+        if (v === null)
+            return null;
+        return { raw: Math.round(v * 255), normalized: v };
+    }
+    /** Set microphone gain. Value 0.0–1.0. */
+    setMicGain(value) {
+        this.write0x14Level(0x0f, value);
+    }
+    /** Get noise blanker level. 0.0 = off, >0.0 = on with strength. */
+    async getNBLevel(options) {
+        const v = await this.read0x14Level(0x12, options);
+        if (v === null)
+            return null;
+        return { raw: Math.round(v * 255), normalized: v };
+    }
+    /** Set noise blanker level. Value 0.0 (off) – 1.0. */
+    setNBLevel(value) {
+        this.write0x14Level(0x12, value);
+    }
+    /** Get noise reduction level. 0.0 = off, >0.0 = on with strength. */
+    async getNRLevel(options) {
+        const v = await this.read0x14Level(0x13, options);
+        if (v === null)
+            return null;
+        return { raw: Math.round(v * 255), normalized: v };
+    }
+    /** Set noise reduction level. Value 0.0 (off) – 1.0. */
+    setNRLevel(value) {
+        this.write0x14Level(0x13, value);
+    }
     /**
      * Read squelch status (noise/signal gate state)
      * @param options - Query options (timeout in ms, default 3000)
@@ -1447,6 +1557,50 @@ class IcomControl {
             return false;
         return true;
     }
+    // Strict 0x14 data reply matcher: FE FE [ctr|00] [rig] 0x14 [sub] [bcd_hi] [bcd_lo] FD
+    static is0x14DataReply(frame, subcmd, ctrAddr, rigAddr) {
+        if (!(frame && frame.length >= 9))
+            return false;
+        if (frame[0] !== 0xfe || frame[1] !== 0xfe)
+            return false;
+        const addrCtrOk = frame[2] === (ctrAddr & 0xff) || frame[2] === 0x00;
+        const addrRigOk = frame[3] === (rigAddr & 0xff);
+        if (!addrCtrOk || !addrRigOk)
+            return false;
+        if (frame[4] !== 0x14)
+            return false;
+        if (frame[5] !== (subcmd & 0xff))
+            return false;
+        if (frame[frame.length - 1] !== 0xfd)
+            return false;
+        return true;
+    }
+    /**
+     * Read a 0x14 level value from the radio.
+     * Returns normalized value 0.0-1.0, or null on timeout/error.
+     */
+    async read0x14Level(subcmd, options) {
+        const timeoutMs = options?.timeout ?? 3000;
+        const ctrAddr = IcomConstants_1.DEFAULT_CONTROLLER_ADDR;
+        const rigAddr = this.civ.civAddress & 0xff;
+        const req = IcomRigCommands_1.IcomRigCommands.get0x14Level(ctrAddr, rigAddr, subcmd);
+        const resp = await this.waitForCivFrame((frame) => IcomControl.is0x14DataReply(frame, subcmd, ctrAddr, rigAddr), timeoutMs, () => this.sendCiv(req));
+        if (!resp || resp.length < 9)
+            return null;
+        const raw = (0, bcd_1.parseTwoByteBcd)(resp.subarray(6, 8));
+        return raw / 255;
+    }
+    /**
+     * Write a 0x14 level value to the radio.
+     * @param value - Normalized value 0.0-1.0
+     */
+    write0x14Level(subcmd, value) {
+        const ctrAddr = IcomConstants_1.DEFAULT_CONTROLLER_ADDR;
+        const rigAddr = this.civ.civAddress & 0xff;
+        const raw = Math.max(0, Math.min(255, Math.round(value * 255)));
+        const bcd = (0, bcd_1.intToTwoByteBcd)(raw);
+        this.sendCiv(IcomRigCommands_1.IcomRigCommands.set0x14Level(ctrAddr, rigAddr, subcmd, bcd[0], bcd[1]));
+    }
     // Start meter polling like Java (every 500ms when PTT is on)
     startMeterPolling() {
         this.stopMeterPolling();

package/dist/rig/IcomRigCommands.d.ts

@@ -21,4 +21,18 @@ export declare const IcomRigCommands: {
     getCompLevel(ctrAddr: number, rigAddr: number): Buffer;
     getVoltage(ctrAddr: number, rigAddr: number): Buffer;
     getCurrent(ctrAddr: number, rigAddr: number): Buffer;
+    /**
+     * Build a 0x14 level read query.
+     * Send this to request the current value; the radio responds with the same
+     * command byte + subcmd + 2-byte BCD data.
+     */
+    get0x14Level(ctrAddr: number, rigAddr: number, subcmd: number): Buffer;
+    /**
+     * Build a 0x14 level write command.
+     * @param rawValue - Integer 0-255 (use intToTwoByteBcd to encode)
+     */
+    set0x14Level(ctrAddr: number, rigAddr: number, subcmd: number, bcdHi: number, bcdLo: number): Buffer;
+    getTunerStatus(ctrAddr: number, rigAddr: number): Buffer;
+    setTunerEnabled(ctrAddr: number, rigAddr: number, on: boolean): Buffer;
+    startManualTune(ctrAddr: number, rigAddr: number): Buffer;
 };

package/dist/rig/IcomRigCommands.js

@@ -97,5 +97,40 @@ exports.IcomRigCommands = {
     getCurrent(ctrAddr, rigAddr) {
         // FE FE [rig] [ctr] 0x15 0x16 FD
         return Buffer.from([0xfe, 0xfe, rigAddr & 0xff, ctrAddr & 0xff, 0x15, 0x16, 0xfd]);
+    },
+    // =====================
+    // 0x14 Level Commands (read/write)
+    // =====================
+    /**
+     * Build a 0x14 level read query.
+     * Send this to request the current value; the radio responds with the same
+     * command byte + subcmd + 2-byte BCD data.
+     */
+    get0x14Level(ctrAddr, rigAddr, subcmd) {
+        // FE FE [rig] [ctr] 0x14 [subcmd] FD
+        return Buffer.from([0xfe, 0xfe, rigAddr & 0xff, ctrAddr & 0xff, 0x14, subcmd & 0xff, 0xfd]);
+    },
+    /**
+     * Build a 0x14 level write command.
+     * @param rawValue - Integer 0-255 (use intToTwoByteBcd to encode)
+     */
+    set0x14Level(ctrAddr, rigAddr, subcmd, bcdHi, bcdLo) {
+        // FE FE [rig] [ctr] 0x14 [subcmd] [bcd_hi] [bcd_lo] FD
+        return Buffer.from([0xfe, 0xfe, rigAddr & 0xff, ctrAddr & 0xff, 0x14, subcmd & 0xff, bcdHi & 0xff, bcdLo & 0xff, 0xfd]);
+    },
+    // =====================
+    // Antenna Tuner (ATU)
+    // =====================
+    getTunerStatus(ctrAddr, rigAddr) {
+        // FE FE [rig] [ctr] 0x1A 0x00 FD
+        return Buffer.from([0xfe, 0xfe, rigAddr & 0xff, ctrAddr & 0xff, 0x1a, 0x00, 0xfd]);
+    },
+    setTunerEnabled(ctrAddr, rigAddr, on) {
+        // FE FE [rig] [ctr] 0x1A 0x01 [00|01] FD
+        return Buffer.from([0xfe, 0xfe, rigAddr & 0xff, ctrAddr & 0xff, 0x1a, 0x01, on ? 0x01 : 0x00, 0xfd]);
+    },
+    startManualTune(ctrAddr, rigAddr) {
+        // FE FE [rig] [ctr] 0x1A 0x02 0x00 FD
+        return Buffer.from([0xfe, 0xfe, rigAddr & 0xff, ctrAddr & 0xff, 0x1a, 0x02, 0x00, 0xfd]);
     }
 };

package/dist/types.d.ts

@@ -96,6 +96,16 @@ export interface MeterReading {
      */
     success: boolean;
 }
+/**
+ * Result of a 0x14 level read operation.
+ * Covers AF Gain, SQL Level, RF Power, MIC Gain, NB Level, NR Level.
+ */
+export interface LevelReading {
+    /** Raw BCD-decoded integer value (0–255) */
+    raw: number;
+    /** Normalized value in range 0.0–1.0 */
+    normalized: number;
+}
 /**
  * SWR (Standing Wave Ratio) meter reading
  * Represents antenna impedance matching quality
@@ -254,6 +264,20 @@ export interface CurrentReading {
     /** Current in amperes */
     amps: number;
 }
+/**
+ * Antenna tuner state (IC-705 CI-V 0x1A/0x00)
+ * 00=OFF, 01=ON, 02=TUNING
+ */
+export type TunerState = 'OFF' | 'ON' | 'TUNING';
+/**
+ * Antenna tuner status reading
+ */
+export interface TunerStatusReading {
+    /** Raw status code (0x00, 0x01, 0x02) */
+    raw: number;
+    /** Parsed state name */
+    state: TunerState;
+}
 /**
  * Connection state enumeration
  * Represents the current state of a UDP session

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "icom-wlan-node",
-  "version": "0.2.6",
+  "version": "0.3.0",
   "description": "Icom WLAN (CI‑V, audio) protocol implementation for Node.js/TypeScript.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,7 +9,8 @@
     "clean": "rimraf dist",
     "test": "jest",
     "prepublishOnly": "npm run build",
-    "lint": "eslint ."
+    "lint": "eslint .",
+    "diagnose": "tsx scripts/diagnose.ts"
   },
   "keywords": ["icom", "civ", "cat", "udp", "hamradio", "wlan", "audio"],
   "author": "boybook",
@@ -22,10 +23,12 @@
   "devDependencies": {
     "@types/jest": "^29.5.12",
     "@types/node": "^20.10.6",
+    "commander": "^12.0.0",
     "eslint": "^8.57.0",
     "jest": "^29.7.0",
     "rimraf": "^5.0.5",
     "ts-jest": "^29.1.1",
+    "tsx": "^4.7.0",
     "typescript": "^5.4.5"
   }
 }

package/dist/demo.d.ts

@@ -1,12 +0,0 @@
-/**
- * Integration test against a real Icom WLAN radio.
- *
- * This test is skipped unless these env vars are present:
- *  - ICOM_IP: radio IP
- *  - ICOM_PORT: radio control UDP port (e.g., 50001)
- *  - ICOM_USER: username
- *  - ICOM_PASS: password
- * Optional:
- *  - ICOM_TEST_PTT=true to exercise PTT and short audio TX (be careful: this keys TX!)
- */
-export {};

package/dist/demo.js

@@ -1,329 +0,0 @@
-"use strict";
-/**
- * Integration test against a real Icom WLAN radio.
- *
- * This test is skipped unless these env vars are present:
- *  - ICOM_IP: radio IP
- *  - ICOM_PORT: radio control UDP port (e.g., 50001)
- *  - ICOM_USER: username
- *  - ICOM_PASS: password
- * Optional:
- *  - ICOM_TEST_PTT=true to exercise PTT and short audio TX (be careful: this keys TX!)
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-const _1 = require(".");
-const IcomRigCommands_1 = require("./rig/IcomRigCommands");
-const codec_1 = require("./utils/codec");
-async function test() {
-    const ip = process.env.ICOM_IP;
-    const port = parseInt(process.env.ICOM_PORT, 10);
-    const user = process.env.ICOM_USER;
-    const pass = process.env.ICOM_PASS;
-    const testPTT = process.env.ICOM_TEST_PTT === 'true';
-    const t0 = Date.now();
-    const stamp = () => `+${(Date.now() - t0).toString().padStart(4)}ms`;
-    const rig = new _1.IcomControl({ control: { ip, port }, userName: user, password: pass });
-    let gotLogin = false;
-    let gotStatus = false;
-    let gotCap = false;
-    let civCount = 0;
-    let audioCount = 0;
-    const wait = (cond, ms = 30000) => new Promise((resolve, reject) => {
-        const start = Date.now();
-        const t = setInterval(() => {
-            if (cond()) {
-                clearInterval(t);
-                resolve();
-            }
-            else if (Date.now() - start > ms) {
-                clearInterval(t);
-                reject(new Error('timeout'));
-            }
-        }, 100);
-    });
-    const sleep = (ms) => new Promise(r => setTimeout(r, ms));
-    const onLogin = (res) => {
-        console.log(stamp(), 'login event ok=', res.ok, 'error?', res.errorCode, 'conn=', res.connection);
-        gotLogin = res.ok;
-    };
-    const onStatus = (s) => {
-        console.log(stamp(), 'status civPort=', s.civPort, 'audioPort=', s.audioPort, 'authOK=', s.authOK, 'connected=', s.connected);
-        gotStatus = true;
-    };
-    const onCap = (c) => {
-        console.log(stamp(), 'capabilities civAddr=', c.civAddress, 'audioName=', c.audioName, 'supportTX=', c.supportTX);
-        gotCap = true;
-    };
-    const onCiv = (frame) => {
-        civCount++;
-        if (civCount <= 3)
-            console.log(stamp(), `CIV[${civCount}]`, (0, codec_1.hex)(frame.subarray(0, Math.min(16, frame.length))));
-    };
-    const onAudio = (p) => {
-        audioCount++;
-        if (audioCount % 10 === 0)
-            console.log(stamp(), `AUDIO[${audioCount}] len=`, p.pcm16.length);
-    };
-    rig.events.on('login', onLogin);
-    rig.events.on('status', onStatus);
-    rig.events.on('capabilities', onCap);
-    rig.events.on('civ', onCiv);
-    rig.events.on('audio', onAudio);
-    console.log(stamp(), 'connecting to', ip, port);
-    await rig.connect();
-    // Wait for login + status
-    console.log(stamp(), 'waiting login+status ...');
-    await wait(() => gotLogin && gotStatus, 20000);
-    console.log(stamp(), 'login+status OK');
-    // Expect at least capabilities soon
-    console.log(stamp(), 'waiting capabilities (0xA8) ...');
-    await wait(() => gotCap, 8000).catch(() => { console.log(stamp(), 'capabilities timeout (tolerated)'); });
-    // Ensure data mode and connector routing favor WLAN before CIV queries
-    console.log(stamp(), 'setMode USB-D (data) and route data to WLAN');
-    await rig.setMode('USB', { dataMode: true });
-    await rig.setConnectorDataMode('WLAN');
-    // Issue a CIV read operating frequency; expect some CIV traffic
-    const rigAddr = rig.civ.civAddress & 0xff;
-    const ctrAddr = 0xe0;
-    const readFreq = IcomRigCommands_1.IcomRigCommands.readOperatingFrequency(ctrAddr, rigAddr);
-    const civBefore = civCount;
-    rig.sendCiv(readFreq);
-    console.log(stamp(), 'sent CIV read frequency, waiting CIV traffic ...');
-    await wait(() => civCount > civBefore, 6000).catch(() => { });
-    // High-level: query frequency, set mode to USB-D (data), adjust frequency slightly and revert
-    const curHz = await rig.readOperatingFrequency({ timeout: 8000 });
-    if (curHz) {
-        console.log(stamp(), 'readOperatingFrequency =', curHz);
-        // Set data mode USB-D
-        console.log(stamp(), 'setMode USB-D');
-        await rig.setMode('USB', { dataMode: true });
-        // Route connector data to WLAN (best effort)
-        console.log(stamp(), 'setConnectorDataMode WLAN');
-        await rig.setConnectorDataMode('WLAN');
-        // Nudge frequency by +50 Hz then revert
-        const newHz = curHz + 50;
-        console.log(stamp(), 'setFrequency to', newHz);
-        await rig.setFrequency(newHz);
-        const backHz = await rig.readOperatingFrequency({ timeout: 4000 });
-        console.log(stamp(), 'verify freq after set =', backHz);
-        console.log(stamp(), 'revert frequency to', curHz);
-        await rig.setFrequency(curHz);
-    }
-    else {
-        console.log(stamp(), 'readOperatingFrequency returned null (tolerated)');
-    }
-    // ============================================================================
-    // API Demo: Demonstrate all available APIs and print their results
-    // ============================================================================
-    console.log('\n' + '='.repeat(80));
-    console.log(stamp(), '🎯 API DEMONSTRATION - Testing all available methods');
-    console.log('='.repeat(80) + '\n');
-    // 1. Mode APIs
-    console.log(stamp(), '📡 Testing Mode APIs:');
-    console.log(stamp(), '  → Setting mode to LSB (Lower Side Band)');
-    await rig.setMode('LSB');
-    await sleep(500);
-    console.log(stamp(), '  → Setting mode to USB (Upper Side Band)');
-    await rig.setMode('USB');
-    await sleep(500);
-    console.log(stamp(), '  → Setting mode to USB-D (Data mode for FT8)');
-    await rig.setMode('USB', { dataMode: true });
-    await sleep(500);
-    // 2. Frequency APIs
-    console.log(stamp(), '\n📻 Testing Frequency APIs:');
-    const currentFreq = await rig.readOperatingFrequency({ timeout: 3000 });
-    if (currentFreq) {
-        console.log(stamp(), `  ✓ Current frequency: ${(currentFreq / 1000000).toFixed(3)} MHz (${currentFreq} Hz)`);
-        // Test frequency change
-        const testFreq = 14074000; // FT8 on 20m
-        console.log(stamp(), `  → Setting frequency to ${(testFreq / 1000000).toFixed(3)} MHz`);
-        await rig.setFrequency(testFreq);
-        await sleep(500);
-        const verifyFreq = await rig.readOperatingFrequency({ timeout: 3000 });
-        if (verifyFreq) {
-            console.log(stamp(), `  ✓ Verified frequency: ${(verifyFreq / 1000000).toFixed(3)} MHz`);
-        }
-        // Restore original frequency
-        console.log(stamp(), `  → Restoring original frequency: ${(currentFreq / 1000000).toFixed(3)} MHz`);
-        await rig.setFrequency(currentFreq);
-        await sleep(500);
-    }
-    else {
-        console.log(stamp(), '  ✗ Failed to read current frequency');
-    }
-    // 3. Connector APIs
-    console.log(stamp(), '\n🔌 Testing Connector APIs:');
-    console.log(stamp(), '  → Setting connector data mode to WLAN');
-    await rig.setConnectorDataMode('WLAN');
-    await sleep(500);
-    const wlanLevel = await rig.getConnectorWLanLevel({ timeout: 2000 });
-    if (wlanLevel) {
-        console.log(stamp(), `  ✓ WLAN Level: ${wlanLevel.percent.toFixed(1)}% (raw=${wlanLevel.raw}/255)`);
-    }
-    else {
-        console.log(stamp(), '  ℹ WLAN Level: Not available (may not be supported on this radio)');
-    }
-    // Test setting WLAN level
-    console.log(stamp(), '  → Setting WLAN level to 128 (50%)');
-    await rig.setConnectorWLanLevel(128);
-    await sleep(500);
-    const newWlanLevel = await rig.getConnectorWLanLevel({ timeout: 2000 });
-    if (newWlanLevel) {
-        console.log(stamp(), `  ✓ New WLAN Level: ${newWlanLevel.percent.toFixed(1)}% (raw=${newWlanLevel.raw}/255)`);
-    }
-    // 4. Summary of RX-mode readings
-    console.log(stamp(), '\n📋 Summary of Current Radio State (RX mode):');
-    console.log(stamp(), '  ╔═══════════════════════════════════════════════════════╗');
-    if (currentFreq) {
-        console.log(stamp(), `  ║ Frequency: ${(currentFreq / 1000000).toFixed(3).padEnd(10)} MHz                         ║`);
-    }
-    console.log(stamp(), `  ║ Mode:      USB-D (Data mode)                          ║`);
-    console.log(stamp(), `  ║ Connector: WLAN                                       ║`);
-    if (newWlanLevel) {
-        console.log(stamp(), `  ║ WLAN Level: ${newWlanLevel.percent.toFixed(1).padEnd(5)}%                                    ║`);
-    }
-    console.log(stamp(), '  ╚═══════════════════════════════════════════════════════╝');
-    console.log(stamp(), '\n  ℹ️  Note: Meter readings (SWR/ALC) require TX mode - see PTT test below');
-    console.log('\n' + '='.repeat(80));
-    console.log(stamp(), '✅ API DEMONSTRATION COMPLETE (RX mode)');
-    console.log('='.repeat(80) + '\n');
-    // Expect to receive at least some audio frames if radio is streaming
-    console.log(stamp(), 'waiting audio frames ...');
-    await wait(() => audioCount > 0, 6000).catch(() => { });
-    // Try reading additional CIV info in RX mode
-    try {
-        const mode = await rig.readOperatingMode({ timeout: 1500 });
-        if (mode) {
-            const modeStr = mode.modeName ?? `0x${mode.mode.toString(16)}`;
-            const filStr = mode.filterName ?? (mode.filter !== undefined ? `FIL${mode.filter}` : '');
-            console.log(stamp(), `RX: Operating Mode = ${modeStr}${filStr ? `, ${filStr}` : ''}`);
-        }
-        else {
-            console.log(stamp(), 'RX: Operating Mode: Not available');
-        }
-    }
-    catch { }
-    try {
-        const edges = await rig.readBandEdges({ timeout: 1500 });
-        if (edges) {
-            console.log(stamp(), `RX: Band edges payload length: ${edges.length} bytes`);
-        }
-        else {
-            console.log(stamp(), 'RX: Band edges: Not available');
-        }
-    }
-    catch { }
-    // Optional: brief PTT + short audio TX (dangerous; keys TX)
-    if (testPTT && gotLogin && gotStatus) {
-        console.log('\n' + '='.repeat(80));
-        console.log(stamp(), '📡 PTT TEST & METER READINGS (TX MODE)');
-        console.log('='.repeat(80) + '\n');
-        // Ensure audio routing is set to WLAN before PTT
-        console.log(stamp(), '→ Setting connector data mode to WLAN before PTT');
-        await rig.setConnectorDataMode('WLAN');
-        console.log(stamp(), '→ PTT ON - Starting transmission');
-        await rig.setPtt(true);
-        // Wait a moment for TX to stabilize
-        await sleep(500);
-        // Generate all audio frames at once (10 seconds of 1 kHz tone)
-        const frames = 500; // 500 * 20ms = 10000ms = 10 seconds
-        const samplesPerFrame = 240;
-        const totalSamples = frames * samplesPerFrame;
-        const allAudio = new Float32Array(totalSamples);
-        // Generate 1 kHz tone for entire duration
-        for (let i = 0; i < totalSamples; i++) {
-            allAudio[i] = Math.sin(2 * Math.PI * 1000 * i / _1.AUDIO_RATE) * 0.2;
-        }
-        // Add all audio to queue at once with leading silence buffer
-        console.log(stamp(), '→ Enqueuing', frames, 'frames of audio (1kHz tone, 10 seconds)');
-        rig.sendAudioFloat32(allAudio, true); // true = add leading silence buffer
-        // ============================================================================
-        // 📊 Testing Meter APIs during TX
-        // ============================================================================
-        console.log(stamp(), '\n📊 Reading Meters during TX:');
-        // Also read TX-related CIV info
-        try {
-            const txHz = await rig.readTransmitFrequency({ timeout: 1500 });
-            if (txHz)
-                console.log(stamp(), `  TX Frequency: ${txHz} Hz`);
-            else
-                console.log(stamp(), '  TX Frequency: Not available');
-        }
-        catch { }
-        try {
-            const state = await rig.readTransceiverState({ timeout: 1500 });
-            if (state)
-                console.log(stamp(), `  Transceiver State: ${state}`);
-            else
-                console.log(stamp(), '  Transceiver State: Not available');
-        }
-        catch { }
-        // Read meters multiple times during transmission to get stable readings
-        const meterReadings = { swr: [], alc: [] };
-        for (let i = 0; i < 3; i++) {
-            await sleep(1000); // Wait 1 second between readings
-            console.log(stamp(), `  → Reading meters (${i + 1}/3)...`);
-            const swr = await rig.readSWR({ timeout: 2000 });
-            if (swr) {
-                meterReadings.swr.push(swr);
-                const swrStatus = swr.alert ? '⚠️  ALERT' : '✓ OK';
-                console.log(stamp(), `    SWR: ${swr.swr.toFixed(2)} (raw=${swr.raw}) ${swrStatus}`);
-            }
-            else {
-                console.log(stamp(), `    SWR: Not available`);
-            }
-            const alc = await rig.readALC({ timeout: 2000 });
-            if (alc) {
-                meterReadings.alc.push(alc);
-                const alcStatus = alc.alert ? '⚠️  ALERT' : '✓ OK';
-                console.log(stamp(), `    ALC: ${alc.percent.toFixed(1)}% (raw=${alc.raw}) ${alcStatus}`);
-            }
-            else {
-                console.log(stamp(), `    ALC: Not available`);
-            }
-        }
-        // Calculate and display average readings
-        if (meterReadings.swr.length > 0) {
-            const avgSwr = meterReadings.swr.reduce((sum, r) => sum + r.swr, 0) / meterReadings.swr.length;
-            const hasAlert = meterReadings.swr.some(r => r.alert);
-            console.log(stamp(), '\n  📈 Average SWR Reading:');
-            console.log(stamp(), `    - Average Value: ${avgSwr.toFixed(2)}`);
-            console.log(stamp(), `    - Status: ${hasAlert ? '⚠️  ALERT (High SWR detected!)' : '✓ OK'}`);
-            console.log(stamp(), `    - Assessment: ${avgSwr < 1.5 ? 'Excellent antenna match' : avgSwr < 2.0 ? 'Good antenna match' : 'Poor antenna match - check connections'}`);
-        }
-        if (meterReadings.alc.length > 0) {
-            const avgAlc = meterReadings.alc.reduce((sum, r) => sum + r.percent, 0) / meterReadings.alc.length;
-            const hasAlert = meterReadings.alc.some(r => r.alert);
-            console.log(stamp(), '\n  📈 Average ALC Reading:');
-            console.log(stamp(), `    - Average Level: ${avgAlc.toFixed(1)}%`);
-            console.log(stamp(), `    - Status: ${hasAlert ? '⚠️  ALERT (Over-driving!)' : '✓ OK'}`);
-            console.log(stamp(), `    - Assessment: ${avgAlc < 30 ? 'Low drive - increase audio level' : avgAlc < 70 ? 'Normal operating range' : 'High drive - reduce audio level'}`);
-        }
-        // Wait for remaining transmission to complete
-        const remainingTime = (frames * 21) - 3000; // Already waited 3 seconds for meter readings
-        if (remainingTime > 0) {
-            console.log(stamp(), `\n→ Waiting for transmission to complete (~${(remainingTime / 1000).toFixed(1)}s remaining)`);
-            await sleep(remainingTime);
-        }
-        await rig.setPtt(false);
-        console.log(stamp(), '\n→ PTT OFF - Transmission complete, trailing silence sent');
-        console.log('\n' + '='.repeat(80));
-        console.log(stamp(), '✅ PTT TEST & METER READINGS COMPLETE');
-        console.log('='.repeat(80) + '\n');
-        await sleep(1000);
-    }
-    // Clean up listeners to help jest exit
-    rig.events.off('login', onLogin);
-    rig.events.off('status', onStatus);
-    rig.events.off('capabilities', onCap);
-    rig.events.off('civ', onCiv);
-    rig.events.off('audio', onAudio);
-    console.log(stamp(), 'summary: civ=', civCount, 'audio=', audioCount);
-    console.log(stamp(), 'disconnecting...');
-    await rig.disconnect();
-    console.log(stamp(), 'disconnected');
-}
-test().then().catch(e => {
-    console.error('Test failed:', e);
-    process.exit(1);
-});