@springfield/ham-radio-api 17.0.0 → 17.2.0

package/dist/index.d.ts

@@ -18,6 +18,7 @@ export * from "./radio/driver.js";
 export * from "./radio/driver-provider.js";
 export * from "./radio/id.js";
 export * from "./radio/memory-config.js";
+export * from "./radio/memory-map.js";
 export * from "./radio/memory-segment.js";
 export * from "./radio/memory.js";
 export * from "./radio/module.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,oBAAoB,CAAC;AAEnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,oBAAoB,CAAC;AAEnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -18,6 +18,7 @@ export * from "./radio/driver.js";
 export * from "./radio/driver-provider.js";
 export * from "./radio/id.js";
 export * from "./radio/memory-config.js";
+export * from "./radio/memory-map.js";
 export * from "./radio/memory-segment.js";
 export * from "./radio/memory.js";
 export * from "./radio/module.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,oBAAoB,CAAC;AAEnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,0CAA0C,CAAC;AACzD,cAAc,+BAA+B,CAAC;AAE9C,cAAc,oBAAoB,CAAC;AAEnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AAEtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC"}

package/dist/radio/memory-map.d.ts

@@ -0,0 +1,170 @@
+/**
+ * JSON memory-map DSL: describes how radio EEPROM bytes map to settings
+ * without a radio-specific TypeScript decoder.
+ *
+ * Addresses are radio EEPROM addresses (not Chirp image offsets).
+ */
+/** Scalar JSON values stored in decoded settings. */
+export type RadioSettingScalar = string | number | boolean | null;
+/** Nested settings object produced by decode / consumed by encode. */
+export type RadioSettingValue = RadioSettingScalar | RadioSettingValue[] | {
+    [key: string]: RadioSettingValue;
+};
+/** UI widget hint for schema-driven forms. */
+export type RadioMemoryMapWidget = "integer" | "select" | "switch" | "text" | "number";
+/**
+ * Decoded tone value for UV-5R-style tone words (before RadioTone binding).
+ */
+export type RadioMemoryMapToneValue = {
+    mode: "none";
+} | {
+    mode: "ctcss";
+    value: number;
+} | {
+    mode: "dcs";
+    code: number;
+    polarity: "N" | "R";
+};
+/** How a field's raw bits/bytes become a setting value. */
+export type RadioMemoryMapValueKind = {
+    kind: "integer";
+    min?: number;
+    max?: number;
+} | {
+    kind: "boolean";
+} | {
+    kind: "enum";
+    values: string[];
+} | {
+    kind: "ascii";
+    length: number;
+} | {
+    kind: "digits";
+    /** Number of decimal digit bytes. */
+    length: number;
+    /**
+     * Scale applied after parsing digits as a decimal integer.
+     * VFO frequency uses 10 (Hz/10 stored as 8 digits).
+     * Offset uses 1000 (kHz stored as 6 digits → Hz).
+     */
+    scale?: number;
+} | {
+    kind: "dtmf";
+    length: number;
+    /** Character set indexed by byte value; 0xFF terminates. */
+    charset?: string;
+} | {
+    kind: "bbcd";
+    /** Number of packed BCD bytes (Chirp bbcd). */
+    length: number;
+} | {
+    /**
+     * Chirp lbcd: little-endian integer whose hex digits are the decimal
+     * frequency digits (Hz / scale). UV-5R channel freqs use length 4, scale 10.
+     */
+    kind: "lbcd";
+    length: number;
+    /** Multiplier after interpreting hex-as-decimal (default 10 → Hz). */
+    scale?: number;
+} | {
+    /**
+     * UV-5R-style tone word (typically ul16):
+     * - 0 / 0xFFFF → none
+     * - >= ctcssMin → CTCSS (raw = Hz * 10)
+     * - else DCS index into `values` (1-based); reverseOffset adds R polarity
+     */
+    kind: "tone";
+    /** Ordered DCS codes (Chirp UV5R_DTCS). */
+    values: number[];
+    /** Minimum raw value treated as CTCSS (Chirp uses 0x0258). */
+    ctcssMin?: number;
+    /** Added to DCS index for reverse polarity (Chirp uses 0x69). */
+    reverseOffset?: number;
+};
+/** UI metadata for a non-reserved field. */
+export interface RadioMemoryMapFieldUi {
+    group: string;
+    label: string;
+    widget: RadioMemoryMapWidget;
+    description?: string;
+    /** Defaults to true. Set false for firmware / read-only messages. */
+    writable?: boolean;
+}
+/**
+ * One field in a sequential struct.
+ * Bitfields pack into the current byte MSB-first (Chirp-style).
+ */
+export interface RadioMemoryMapField {
+    id: string;
+    /**
+     * Storage type:
+     * - u8 / u16: whole bytes (u16 is little-endian, Chirp ul16)
+     * - bits: bitfield of `width` bits within the current byte (MSB-first)
+     * - char: ASCII byte (length via value.kind ascii or count)
+     */
+    type: "u8" | "u16" | "bits" | "char";
+    /** Bit width when type is bits. */
+    width?: number;
+    /** When true, skip decode/encode for this padding field. */
+    reserved?: boolean;
+    value?: RadioMemoryMapValueKind;
+    ui?: RadioMemoryMapFieldUi;
+}
+/**
+ * When the first byte of a repeated struct instance equals `equals`,
+ * the slot is treated as empty (Chirp: RX freq first byte 0xFF).
+ */
+export interface RadioMemoryMapEmptyWhen {
+    equals: number;
+}
+/**
+ * A named struct at a radio EEPROM seek address.
+ * Fields are laid out sequentially from `seek`.
+ */
+export interface RadioMemoryMapStruct {
+    id: string;
+    /** Radio EEPROM start address (number or hex string such as "0x0E20"). */
+    seek: number | string;
+    fields: RadioMemoryMapField[];
+    /**
+     * Repeat this struct `count` times with `stride` bytes between entries.
+     * Used for channel tables and PTT-ID code tables.
+     */
+    count?: number;
+    stride?: number;
+    /** Occupancy rule for repeated structs (e.g. empty channel slots). */
+    emptyWhen?: RadioMemoryMapEmptyWhen;
+    /**
+     * When encoding, fill missing/null instances with 0xFF for `stride` bytes
+     * (Chirp-like channel clear). Defaults to false.
+     */
+    clearEmpty?: boolean;
+}
+/**
+ * Maps decoded struct fields onto portable RadioChannel fields.
+ * Remaining record fields become RadioProgrammedChannel.settings.
+ */
+export interface RadioMemoryMapChannelBindings {
+    /** Struct id of the channel record array. */
+    records: string;
+    /** Optional parallel name table struct id. */
+    names?: string;
+    /** Field id within the names struct (default "name"). */
+    nameField?: string;
+    receiveFrequency: string;
+    transmitFrequency: string;
+    receiveTone: string;
+    transmitTone: string;
+}
+/**
+ * Complete memory-map definition for a radio model's settings and channels.
+ */
+export interface RadioMemoryMap {
+    /** Optional map version for tooling. */
+    version?: string;
+    description?: string;
+    structs: RadioMemoryMapStruct[];
+    /** Optional projection from channel structs into RadioProgram.channels. */
+    channelBindings?: RadioMemoryMapChannelBindings;
+}
+//# sourceMappingURL=memory-map.d.ts.map

package/dist/radio/memory-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-map.d.ts","sourceRoot":"","sources":["../../src/radio/memory-map.ts"],"names":[],"mappings":"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"}

package/dist/radio/memory-map.js

@@ -0,0 +1,8 @@
+/**
+ * JSON memory-map DSL: describes how radio EEPROM bytes map to settings
+ * without a radio-specific TypeScript decoder.
+ *
+ * Addresses are radio EEPROM addresses (not Chirp image offsets).
+ */
+export {};
+//# sourceMappingURL=memory-map.js.map

package/dist/radio/memory-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-map.js","sourceRoot":"","sources":["../../src/radio/memory-map.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/radio/radio.d.ts

@@ -1,5 +1,6 @@
 import type { RadioId } from "./id.js";
 import type { RadioMemoryConfig } from "./memory-config.js";
+import type { RadioMemoryMap } from "./memory-map.js";
 import type { RadioProtocolStep } from "./protocol.js";
 import type { RadioSchema } from "./schema.js";
 import type { RadioSerialConfig } from "./serial-config.js";
@@ -12,5 +13,12 @@ export interface Radio {
     serialConfig: RadioSerialConfig;
     readMemory: RadioProtocolStep[];
     writeMemory: RadioProtocolStep[];
+    /**
+     * Optional JSON memory-map for radio-wide settings decode/encode.
+     * May be an inline map or a path/$ref resolved by the registry/module.
+     */
+    memoryMap?: RadioMemoryMap | {
+        $ref: string;
+    };
 }
 //# sourceMappingURL=radio.d.ts.map

package/dist/radio/radio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"radio.d.ts","sourceRoot":"","sources":["../../src/radio/radio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,WAAW,CAAC;IAC5B,YAAY,EAAE,iBAAiB,CAAC;IAChC,YAAY,EAAE,iBAAiB,CAAC;IAChC,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,WAAW,EAAE,iBAAiB,EAAE,CAAC;CAClC"}
+{"version":3,"file":"radio.d.ts","sourceRoot":"","sources":["../../src/radio/radio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,WAAW,CAAC;IAC5B,YAAY,EAAE,iBAAiB,CAAC;IAChC,YAAY,EAAE,iBAAiB,CAAC;IAChC,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,cAAc,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C"}

package/dist/radio/settings.d.ts

@@ -1,4 +1,11 @@
-export interface RadioSettings {
-    [setting: string]: string | number | boolean;
-}
+import type { RadioSettingValue } from "./memory-map.js";
+/**
+ * Decoded radio-wide settings.
+ *
+ * Values may be nested objects (struct id → fields) or arrays (repeated structs).
+ * Channel-specific settings may still use a flat map of primitives.
+ */
+export type RadioSettings = {
+    [setting: string]: RadioSettingValue;
+};
 //# sourceMappingURL=settings.d.ts.map

package/dist/radio/settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/radio/settings.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC9C"}
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/radio/settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAAC;CACtC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@springfield/ham-radio-api",
-  "version": "17.0.0",
+  "version": "17.2.0",
   "author": "Bryan Hunt",
   "files": [
     "dist/",

package/src/index.ts

@@ -20,6 +20,7 @@ export * from "./radio/driver.js";
 export * from "./radio/driver-provider.js";
 export * from "./radio/id.js";
 export * from "./radio/memory-config.js";
+export * from "./radio/memory-map.js";
 export * from "./radio/memory-segment.js";
 export * from "./radio/memory.js";
 export * from "./radio/module.js";

package/src/radio/memory-map.ts

@@ -0,0 +1,169 @@
+/**
+ * JSON memory-map DSL: describes how radio EEPROM bytes map to settings
+ * without a radio-specific TypeScript decoder.
+ *
+ * Addresses are radio EEPROM addresses (not Chirp image offsets).
+ */
+
+/** Scalar JSON values stored in decoded settings. */
+export type RadioSettingScalar = string | number | boolean | null;
+
+/** Nested settings object produced by decode / consumed by encode. */
+export type RadioSettingValue = RadioSettingScalar | RadioSettingValue[] | { [key: string]: RadioSettingValue };
+
+/** UI widget hint for schema-driven forms. */
+export type RadioMemoryMapWidget = "integer" | "select" | "switch" | "text" | "number";
+
+/**
+ * Decoded tone value for UV-5R-style tone words (before RadioTone binding).
+ */
+export type RadioMemoryMapToneValue =
+  | { mode: "none" }
+  | { mode: "ctcss"; value: number }
+  | { mode: "dcs"; code: number; polarity: "N" | "R" };
+
+/** How a field's raw bits/bytes become a setting value. */
+export type RadioMemoryMapValueKind =
+  | { kind: "integer"; min?: number; max?: number }
+  | { kind: "boolean" }
+  | { kind: "enum"; values: string[] }
+  | { kind: "ascii"; length: number }
+  | {
+      kind: "digits";
+      /** Number of decimal digit bytes. */
+      length: number;
+      /**
+       * Scale applied after parsing digits as a decimal integer.
+       * VFO frequency uses 10 (Hz/10 stored as 8 digits).
+       * Offset uses 1000 (kHz stored as 6 digits → Hz).
+       */
+      scale?: number;
+    }
+  | {
+      kind: "dtmf";
+      length: number;
+      /** Character set indexed by byte value; 0xFF terminates. */
+      charset?: string;
+    }
+  | {
+      kind: "bbcd";
+      /** Number of packed BCD bytes (Chirp bbcd). */
+      length: number;
+    }
+  | {
+      /**
+       * Chirp lbcd: little-endian integer whose hex digits are the decimal
+       * frequency digits (Hz / scale). UV-5R channel freqs use length 4, scale 10.
+       */
+      kind: "lbcd";
+      length: number;
+      /** Multiplier after interpreting hex-as-decimal (default 10 → Hz). */
+      scale?: number;
+    }
+  | {
+      /**
+       * UV-5R-style tone word (typically ul16):
+       * - 0 / 0xFFFF → none
+       * - >= ctcssMin → CTCSS (raw = Hz * 10)
+       * - else DCS index into `values` (1-based); reverseOffset adds R polarity
+       */
+      kind: "tone";
+      /** Ordered DCS codes (Chirp UV5R_DTCS). */
+      values: number[];
+      /** Minimum raw value treated as CTCSS (Chirp uses 0x0258). */
+      ctcssMin?: number;
+      /** Added to DCS index for reverse polarity (Chirp uses 0x69). */
+      reverseOffset?: number;
+    };
+
+/** UI metadata for a non-reserved field. */
+export interface RadioMemoryMapFieldUi {
+  group: string;
+  label: string;
+  widget: RadioMemoryMapWidget;
+  description?: string;
+  /** Defaults to true. Set false for firmware / read-only messages. */
+  writable?: boolean;
+}
+
+/**
+ * One field in a sequential struct.
+ * Bitfields pack into the current byte MSB-first (Chirp-style).
+ */
+export interface RadioMemoryMapField {
+  id: string;
+  /**
+   * Storage type:
+   * - u8 / u16: whole bytes (u16 is little-endian, Chirp ul16)
+   * - bits: bitfield of `width` bits within the current byte (MSB-first)
+   * - char: ASCII byte (length via value.kind ascii or count)
+   */
+  type: "u8" | "u16" | "bits" | "char";
+  /** Bit width when type is bits. */
+  width?: number;
+  /** When true, skip decode/encode for this padding field. */
+  reserved?: boolean;
+  value?: RadioMemoryMapValueKind;
+  ui?: RadioMemoryMapFieldUi;
+}
+
+/**
+ * When the first byte of a repeated struct instance equals `equals`,
+ * the slot is treated as empty (Chirp: RX freq first byte 0xFF).
+ */
+export interface RadioMemoryMapEmptyWhen {
+  equals: number;
+}
+
+/**
+ * A named struct at a radio EEPROM seek address.
+ * Fields are laid out sequentially from `seek`.
+ */
+export interface RadioMemoryMapStruct {
+  id: string;
+  /** Radio EEPROM start address (number or hex string such as "0x0E20"). */
+  seek: number | string;
+  fields: RadioMemoryMapField[];
+  /**
+   * Repeat this struct `count` times with `stride` bytes between entries.
+   * Used for channel tables and PTT-ID code tables.
+   */
+  count?: number;
+  stride?: number;
+  /** Occupancy rule for repeated structs (e.g. empty channel slots). */
+  emptyWhen?: RadioMemoryMapEmptyWhen;
+  /**
+   * When encoding, fill missing/null instances with 0xFF for `stride` bytes
+   * (Chirp-like channel clear). Defaults to false.
+   */
+  clearEmpty?: boolean;
+}
+
+/**
+ * Maps decoded struct fields onto portable RadioChannel fields.
+ * Remaining record fields become RadioProgrammedChannel.settings.
+ */
+export interface RadioMemoryMapChannelBindings {
+  /** Struct id of the channel record array. */
+  records: string;
+  /** Optional parallel name table struct id. */
+  names?: string;
+  /** Field id within the names struct (default "name"). */
+  nameField?: string;
+  receiveFrequency: string;
+  transmitFrequency: string;
+  receiveTone: string;
+  transmitTone: string;
+}
+
+/**
+ * Complete memory-map definition for a radio model's settings and channels.
+ */
+export interface RadioMemoryMap {
+  /** Optional map version for tooling. */
+  version?: string;
+  description?: string;
+  structs: RadioMemoryMapStruct[];
+  /** Optional projection from channel structs into RadioProgram.channels. */
+  channelBindings?: RadioMemoryMapChannelBindings;
+}

package/src/radio/radio.ts

@@ -1,5 +1,6 @@
 import type { RadioId } from "./id.js";
 import type { RadioMemoryConfig } from "./memory-config.js";
+import type { RadioMemoryMap } from "./memory-map.js";
 import type { RadioProtocolStep } from "./protocol.js";
 import type { RadioSchema } from "./schema.js";
 import type { RadioSerialConfig } from "./serial-config.js";
@@ -13,4 +14,9 @@ export interface Radio {
   serialConfig: RadioSerialConfig;
   readMemory: RadioProtocolStep[];
   writeMemory: RadioProtocolStep[];
+  /**
+   * Optional JSON memory-map for radio-wide settings decode/encode.
+   * May be an inline map or a path/$ref resolved by the registry/module.
+   */
+  memoryMap?: RadioMemoryMap | { $ref: string };
 }

package/src/radio/settings.ts

@@ -1,3 +1,11 @@
-export interface RadioSettings {
-  [setting: string]: string | number | boolean;
-}
+import type { RadioSettingValue } from "./memory-map.js";
+
+/**
+ * Decoded radio-wide settings.
+ *
+ * Values may be nested objects (struct id → fields) or arrays (repeated structs).
+ * Channel-specific settings may still use a flat map of primitives.
+ */
+export type RadioSettings = {
+  [setting: string]: RadioSettingValue;
+};