icom-wlan-node 0.4.0 → 0.5.0

package/README.md

@@ -306,6 +306,8 @@ The library exposes common CI‑V operations as friendly methods. Addresses are
 - `scope: IcomScopeService` — Standalone scope service object that can be reused with other CI‑V transport paths in the future
 - `enableScope() => Promise<void>` — Send the minimal command sequence to enable basic scope output
 - `disableScope() => Promise<void>` — Send the minimal command sequence to disable scope output
+- `readScopeSpan(options?: QueryOptions & { receiver?: 0 | 1 }) => Promise<{ receiver: 0 | 1; spanHz: number } | null>` — Read current scope span
+- `setScopeSpan(spanHz: number, options?: { receiver?: 0 | 1 }) => Promise<void>` — Set scope span using CI‑V `0x27 0x15`
 - `waitForScopeFrame(options?: QueryOptions) => Promise<IcomScopeFrame | null>` — Wait for the next complete scope frame
 
 `IcomScopeFrame` shape:
@@ -328,7 +330,7 @@ interface IcomScopeFrame {
 
 Current implementation notes:
 
-- Currently implements only the basic on/off controls and `0x27 00 00` scope data capture
+- Currently implements basic on/off controls, `0x27 0x15` span read/write, and `0x27 00 00` scope data capture
 - The parsing layer is decoupled from the UDP session layer and only depends on complete CI‑V frames
 - Frequency fields are currently parsed with `freqLen=5` by default
 - LAN aggregate waterfall payload splitting is not implemented yet; standard segment input is supported

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, TunerStatusReading, LevelReading } 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, IcomScopeSpanInfo } from '../types';
 import { IcomCiv } from './IcomCiv';
 import { IcomAudio } from './IcomAudio';
 import { IcomScopeService } from '../scope/IcomScopeService';
@@ -77,6 +77,12 @@ export declare class IcomControl {
     sendCiv(data: Buffer): void;
     enableScope(): Promise<void>;
     disableScope(): Promise<void>;
+    readScopeSpan(options?: QueryOptions & {
+        receiver?: 0 | 1;
+    }): Promise<IcomScopeSpanInfo | null>;
+    setScopeSpan(spanHz: number, options?: {
+        receiver?: 0 | 1;
+    }): Promise<void>;
     waitForScopeFrame(options?: QueryOptions): Promise<import("../types").IcomScopeFrame | null>;
     /**
      * Set PTT (Push-To-Talk) state

package/dist/rig/IcomControl.js

@@ -47,6 +47,7 @@ const bcd_1 = require("../utils/bcd");
 const errors_1 = require("../utils/errors");
 const smeter_1 = require("../utils/smeter");
 const IcomScopeCommands_1 = require("../scope/IcomScopeCommands");
+const IcomScopeParser_1 = require("../scope/IcomScopeParser");
 const IcomScopeService_1 = require("../scope/IcomScopeService");
 class IcomControl {
     constructor(options) {
@@ -527,6 +528,28 @@ class IcomControl {
         this.sendCiv(IcomScopeCommands_1.IcomScopeCommands.setScopeDataOutput(ctrAddr, rigAddr, false));
         this.sendCiv(IcomScopeCommands_1.IcomScopeCommands.setScopeDisplay(ctrAddr, rigAddr, false));
     }
+    async readScopeSpan(options) {
+        const timeoutMs = options?.timeout ?? 3000;
+        const receiver = options?.receiver ?? 0;
+        const ctrAddr = IcomConstants_1.DEFAULT_CONTROLLER_ADDR;
+        const rigAddr = this.civ.civAddress & 0xff;
+        const req = IcomScopeCommands_1.IcomScopeCommands.readScopeSpan(ctrAddr, rigAddr, receiver);
+        const resp = await this.waitForCivFrame((frame) => IcomControl.matchCommandFrame(frame, 0x27, [0x15, receiver], ctrAddr, rigAddr), timeoutMs, () => this.sendCiv(req));
+        if (!resp || resp.length < 13) {
+            return null;
+        }
+        const spanHz = (0, IcomScopeParser_1.parseIcomBcdFreqLE)(resp.subarray(7, 12));
+        return {
+            receiver,
+            spanHz,
+        };
+    }
+    async setScopeSpan(spanHz, options) {
+        const receiver = options?.receiver ?? 0;
+        const ctrAddr = IcomConstants_1.DEFAULT_CONTROLLER_ADDR;
+        const rigAddr = this.civ.civAddress & 0xff;
+        this.sendCiv(IcomScopeCommands_1.IcomScopeCommands.setScopeSpan(ctrAddr, rigAddr, spanHz, receiver));
+    }
     async waitForScopeFrame(options) {
         const timeoutMs = options?.timeout ?? 3000;
         return this.scope.waitForScopeFrame(timeoutMs);

package/dist/scope/IcomScopeCommands.d.ts

@@ -1,4 +1,7 @@
 export declare const IcomScopeCommands: {
     setScopeDataOutput(ctrAddr: number, rigAddr: number, enabled: boolean): Buffer;
     setScopeDisplay(ctrAddr: number, rigAddr: number, enabled: boolean): Buffer;
+    readScopeSpan(ctrAddr: number, rigAddr: number, receiver?: 0 | 1): Buffer;
+    setScopeSpan(ctrAddr: number, rigAddr: number, spanHz: number, receiver?: 0 | 1): Buffer;
+    encodeScopeSpanHz(spanHz: number): Buffer;
 };

package/dist/scope/IcomScopeCommands.js

@@ -11,5 +11,27 @@ exports.IcomScopeCommands = {
         return Buffer.from([
             0xfe, 0xfe, rigAddr & 0xff, ctrAddr & 0xff, 0x27, 0x10, enabled ? 0x01 : 0x00, 0xfd
         ]);
+    },
+    readScopeSpan(ctrAddr, rigAddr, receiver = 0) {
+        return Buffer.from([
+            0xfe, 0xfe, rigAddr & 0xff, ctrAddr & 0xff, 0x27, 0x15, receiver & 0xff, 0xfd
+        ]);
+    },
+    setScopeSpan(ctrAddr, rigAddr, spanHz, receiver = 0) {
+        const bytes = exports.IcomScopeCommands.encodeScopeSpanHz(spanHz);
+        return Buffer.from([
+            0xfe, 0xfe, rigAddr & 0xff, ctrAddr & 0xff, 0x27, 0x15, receiver & 0xff, ...bytes, 0xfd
+        ]);
+    },
+    encodeScopeSpanHz(spanHz) {
+        const safeSpanHz = Math.max(0, Math.round(spanHz));
+        const out = Buffer.alloc(5);
+        let remaining = safeSpanHz;
+        for (let i = 0; i < out.length; i++) {
+            const twoDigits = remaining % 100;
+            out[i] = ((((twoDigits / 10) | 0) & 0x0f) << 4) | (twoDigits % 10);
+            remaining = Math.floor(remaining / 100);
+        }
+        return out;
     }
 };

package/dist/types.d.ts

@@ -110,6 +110,10 @@ export interface IcomScopeFrame {
     rawCivPayloads: Buffer[];
     transport: IcomScopeTransport;
 }
+export interface IcomScopeSpanInfo {
+    receiver: 0 | 1;
+    spanHz: number;
+}
 /**
  * Result of a meter reading operation (SWR, ALC, etc.)
  * @deprecated Use specific types like SwrReading, AlcReading instead

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "icom-wlan-node",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Icom WLAN (CI‑V, audio) protocol implementation for Node.js/TypeScript.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",