icom-wlan-node 0.2.6 → 0.2.7

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 } from '../types';
 import { IcomCiv } from './IcomCiv';
 import { IcomAudio } from './IcomAudio';
 export declare class IcomControl {
@@ -190,6 +190,25 @@ 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>;
     /**
      * Read squelch status (noise/signal gate state)
      * @param options - Query options (timeout in ms, default 3000)

package/dist/rig/IcomControl.js

@@ -811,6 +811,47 @@ 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));
+    }
     /**
      * Read squelch status (noise/signal gate state)
      * @param options - Query options (timeout in ms, default 3000)

package/dist/rig/IcomRigCommands.d.ts

@@ -21,4 +21,7 @@ export declare const IcomRigCommands: {
     getCompLevel(ctrAddr: number, rigAddr: number): Buffer;
     getVoltage(ctrAddr: number, rigAddr: number): Buffer;
     getCurrent(ctrAddr: number, rigAddr: 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,20 @@ exports.IcomRigCommands = {
     getCurrent(ctrAddr, rigAddr) {
         // FE FE [rig] [ctr] 0x15 0x16 FD
         return Buffer.from([0xfe, 0xfe, rigAddr & 0xff, ctrAddr & 0xff, 0x15, 0x16, 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

@@ -254,6 +254,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.2.7",
   "description": "Icom WLAN (CI‑V, audio) protocol implementation for Node.js/TypeScript.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",