@springfield/ham-radio-utils 1.0.0

package/dist/utils/band-plan.d.ts

@@ -0,0 +1,24 @@
+import { SpectrumBand } from '@springfield/ham-radio-api';
+interface LicenseClass {
+    id: string;
+    name: string;
+}
+export declare class BandPlan {
+    private bands;
+    private licenseClasses;
+    constructor();
+    /**
+     * Finds the spectrum band that contains the given frequency
+     * @param frequency The frequency in Hz to find the band for
+     * @returns The spectrum band containing the frequency, or undefined if no band contains it
+     */
+    findBandByFrequency(frequency: number): SpectrumBand | undefined;
+    /**
+     * Finds a license class by its ID
+     * @param id The ID of the license class to find
+     * @returns The license class with the given ID, or undefined if not found
+     */
+    findPrivilegeById(id: string): LicenseClass | undefined;
+}
+export {};
+//# sourceMappingURL=band-plan.d.ts.map

package/dist/utils/band-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"band-plan.d.ts","sourceRoot":"","sources":["../../src/utils/band-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI1D,UAAU,YAAY;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,cAAc,CAA4B;;IAOlD;;;;OAIG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIhE;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;CAGxD"}

package/dist/utils/band-plan.js

@@ -0,0 +1,27 @@
+import bandsData from '../db/bands.json' with { type: 'json' };
+import licenseClassesData from '../db/license-classes.json' with { type: 'json' };
+export class BandPlan {
+    bands;
+    licenseClasses;
+    constructor() {
+        this.bands = bandsData;
+        this.licenseClasses = new Map(licenseClassesData.map((licenseClass) => [licenseClass.id, licenseClass]));
+    }
+    /**
+     * Finds the spectrum band that contains the given frequency
+     * @param frequency The frequency in Hz to find the band for
+     * @returns The spectrum band containing the frequency, or undefined if no band contains it
+     */
+    findBandByFrequency(frequency) {
+        return this.bands.find((band) => frequency >= band.lowerFrequency && frequency <= band.upperFrequency);
+    }
+    /**
+     * Finds a license class by its ID
+     * @param id The ID of the license class to find
+     * @returns The license class with the given ID, or undefined if not found
+     */
+    findPrivilegeById(id) {
+        return this.licenseClasses.get(id);
+    }
+}
+//# sourceMappingURL=band-plan.js.map

package/dist/utils/band-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"band-plan.js","sourceRoot":"","sources":["../../src/utils/band-plan.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,kBAAkB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC/D,OAAO,kBAAkB,MAAM,4BAA4B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAOlF,MAAM,OAAO,QAAQ;IACX,KAAK,CAAiB;IACtB,cAAc,CAA4B;IAElD;QACE,IAAI,CAAC,KAAK,GAAG,SAA2B,CAAC;QACzC,IAAI,CAAC,cAAc,GAAG,IAAI,GAAG,CAAE,kBAAqC,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/H,CAAC;IAED;;;;OAIG;IACH,mBAAmB,CAAC,SAAiB;QACnC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,IAAI,IAAI,CAAC,cAAc,IAAI,SAAS,IAAI,IAAI,CAAC,cAAc,CAAC,CAAC;IACzG,CAAC;IAED;;;;OAIG;IACH,iBAAiB,CAAC,EAAU;QAC1B,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;CACF","sourcesContent":["import { SpectrumBand } from '@springfield/ham-radio-api';\nimport bandsData from '../db/bands.json' with { type: 'json' };\nimport licenseClassesData from '../db/license-classes.json' with { type: 'json' };\n\ninterface LicenseClass {\n  id: string;\n  name: string;\n}\n\nexport class BandPlan {\n  private bands: SpectrumBand[];\n  private licenseClasses: Map<string, LicenseClass>;\n\n  constructor() {\n    this.bands = bandsData as SpectrumBand[];\n    this.licenseClasses = new Map((licenseClassesData as LicenseClass[]).map((licenseClass) => [licenseClass.id, licenseClass]));\n  }\n\n  /**\n   * Finds the spectrum band that contains the given frequency\n   * @param frequency The frequency in Hz to find the band for\n   * @returns The spectrum band containing the frequency, or undefined if no band contains it\n   */\n  findBandByFrequency(frequency: number): SpectrumBand | undefined {\n    return this.bands.find((band) => frequency >= band.lowerFrequency && frequency <= band.upperFrequency);\n  }\n\n  /**\n   * Finds a license class by its ID\n   * @param id The ID of the license class to find\n   * @returns The license class with the given ID, or undefined if not found\n   */\n  findPrivilegeById(id: string): LicenseClass | undefined {\n    return this.licenseClasses.get(id);\n  }\n}\n"]}

package/dist/utils/bcd-to-number.d.ts

@@ -0,0 +1,2 @@
+export declare function bcdToNumber(data: Uint8Array, offset?: number, length?: number): number;
+//# sourceMappingURL=bcd-to-number.d.ts.map

package/dist/utils/bcd-to-number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bcd-to-number.d.ts","sourceRoot":"","sources":["../../src/utils/bcd-to-number.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAStF"}

package/dist/utils/bcd-to-number.js

@@ -0,0 +1,9 @@
+export function bcdToNumber(data, offset, length) {
+    let bcd = 0;
+    const size = length ?? data.length;
+    for (let i = offset ?? 0; i < size; i++) {
+        bcd |= data[i] << (8 * i);
+    }
+    return parseInt(bcd.toString(16), 10) * 10;
+}
+//# sourceMappingURL=bcd-to-number.js.map

package/dist/utils/bcd-to-number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bcd-to-number.js","sourceRoot":"","sources":["../../src/utils/bcd-to-number.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,IAAgB,EAAE,MAAe,EAAE,MAAe;IAC5E,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,MAAM,IAAI,GAAG,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;IAEnC,KAAK,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC;AAC7C,CAAC","sourcesContent":["export function bcdToNumber(data: Uint8Array, offset?: number, length?: number): number {\n  let bcd = 0;\n  const size = length ?? data.length;\n\n  for (let i = offset ?? 0; i < size; i++) {\n    bcd |= data[i] << (8 * i);\n  }\n\n  return parseInt(bcd.toString(16), 10) * 10;\n}\n"]}

package/dist/utils/frequency-display.d.ts

@@ -0,0 +1,3 @@
+import { Frequency, SpectrumBand } from '@springfield/ham-radio-api';
+export declare function frequencyDisplay(frequency: Frequency, band: SpectrumBand): string;
+//# sourceMappingURL=frequency-display.d.ts.map

package/dist/utils/frequency-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frequency-display.d.ts","sourceRoot":"","sources":["../../src/utils/frequency-display.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAErE,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAGjF"}

package/dist/utils/frequency-display.js

@@ -0,0 +1,5 @@
+export function frequencyDisplay(frequency, band) {
+    const frequencyDisplay = frequency / band.frequencyDisplayBaseMultiplier;
+    return frequencyDisplay.toFixed(band.frequencyDisplayNumberDecimals);
+}
+//# sourceMappingURL=frequency-display.js.map

package/dist/utils/frequency-display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frequency-display.js","sourceRoot":"","sources":["../../src/utils/frequency-display.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAAC,SAAoB,EAAE,IAAkB;IACvE,MAAM,gBAAgB,GAAG,SAAS,GAAG,IAAI,CAAC,8BAA8B,CAAC;IACzE,OAAO,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;AACvE,CAAC","sourcesContent":["import { Frequency, SpectrumBand } from '@springfield/ham-radio-api';\n\nexport function frequencyDisplay(frequency: Frequency, band: SpectrumBand): string {\n  const frequencyDisplay = frequency / band.frequencyDisplayBaseMultiplier;\n  return frequencyDisplay.toFixed(band.frequencyDisplayNumberDecimals);\n}\n"]}

package/dist/utils/memory-channel-utils.d.ts

@@ -0,0 +1,2 @@
+export declare function formatChannel(channelNumber: number, data: Uint8Array): string;
+//# sourceMappingURL=memory-channel-utils.d.ts.map

package/dist/utils/memory-channel-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-channel-utils.d.ts","sourceRoot":"","sources":["../../src/utils/memory-channel-utils.ts"],"names":[],"mappings":"AAGA,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAE7E"}

package/dist/utils/memory-channel-utils.js

@@ -0,0 +1,6 @@
+import { sprintf } from 'sprintf-js';
+import { toHexWords } from './to-hex-words.js';
+export function formatChannel(channelNumber, data) {
+    return sprintf('%2d : %s', channelNumber, toHexWords(data));
+}
+//# sourceMappingURL=memory-channel-utils.js.map

package/dist/utils/memory-channel-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-channel-utils.js","sourceRoot":"","sources":["../../src/utils/memory-channel-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,UAAU,aAAa,CAAC,aAAqB,EAAE,IAAgB;IACnE,OAAO,OAAO,CAAC,UAAU,EAAE,aAAa,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9D,CAAC","sourcesContent":["import { sprintf } from 'sprintf-js';\nimport { toHexWords } from './to-hex-words.js';\n\nexport function formatChannel(channelNumber: number, data: Uint8Array): string {\n  return sprintf('%2d : %s', channelNumber, toHexWords(data));\n}\n"]}

package/dist/utils/memory-segment-utils.d.ts

@@ -0,0 +1,3 @@
+import { RadioMemorySegment } from '@springfield/ham-radio-api';
+export declare function formatSegment(segment: RadioMemorySegment): string;
+//# sourceMappingURL=memory-segment-utils.d.ts.map

package/dist/utils/memory-segment-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-segment-utils.d.ts","sourceRoot":"","sources":["../../src/utils/memory-segment-utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,wBAAgB,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAEjE"}

package/dist/utils/memory-segment-utils.js

@@ -0,0 +1,6 @@
+import { sprintf } from 'sprintf-js';
+import { toHexWords } from './to-hex-words.js';
+export function formatSegment(segment) {
+    return sprintf('%04X : %s', segment.startAddress, toHexWords(segment.data));
+}
+//# sourceMappingURL=memory-segment-utils.js.map

package/dist/utils/memory-segment-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-segment-utils.js","sourceRoot":"","sources":["../../src/utils/memory-segment-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,MAAM,UAAU,aAAa,CAAC,OAA2B;IACvD,OAAO,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,YAAY,EAAE,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9E,CAAC","sourcesContent":["import { sprintf } from 'sprintf-js';\nimport { toHexWords } from './to-hex-words.js';\nimport { RadioMemorySegment } from '@springfield/ham-radio-api';\n\nexport function formatSegment(segment: RadioMemorySegment): string {\n  return sprintf('%04X : %s', segment.startAddress, toHexWords(segment.data));\n}\n"]}

package/dist/utils/number-to-bcd.d.ts

@@ -0,0 +1,2 @@
+export declare function numberToBcd(value: number): Uint8Array;
+//# sourceMappingURL=number-to-bcd.d.ts.map

package/dist/utils/number-to-bcd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-to-bcd.d.ts","sourceRoot":"","sources":["../../src/utils/number-to-bcd.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAcrD"}

package/dist/utils/number-to-bcd.js

@@ -0,0 +1,12 @@
+export function numberToBcd(value) {
+    const digits = value.toString(10);
+    const numberOfBytes = Math.ceil(digits.length / 2.0);
+    const data = new Uint8Array(numberOfBytes);
+    let bcd = parseInt(digits, 16);
+    for (let i = 0; i < numberOfBytes; i++) {
+        data[i] = bcd & 0xff;
+        bcd >>= 8;
+    }
+    return data;
+}
+//# sourceMappingURL=number-to-bcd.js.map

package/dist/utils/number-to-bcd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-to-bcd.js","sourceRoot":"","sources":["../../src/utils/number-to-bcd.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAClC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAErD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,aAAa,CAAC,CAAC;IAE3C,IAAI,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAE/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC;QACrB,GAAG,KAAK,CAAC,CAAC;IACZ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["export function numberToBcd(value: number): Uint8Array {\n  const digits = value.toString(10);\n  const numberOfBytes = Math.ceil(digits.length / 2.0);\n\n  const data = new Uint8Array(numberOfBytes);\n\n  let bcd = parseInt(digits, 16);\n\n  for (let i = 0; i < numberOfBytes; i++) {\n    data[i] = bcd & 0xff;\n    bcd >>= 8;\n  }\n\n  return data;\n}\n"]}

package/dist/utils/to-hex-words.d.ts

@@ -0,0 +1,2 @@
+export declare function toHexWords(data: Uint8Array): string;
+//# sourceMappingURL=to-hex-words.d.ts.map

package/dist/utils/to-hex-words.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-hex-words.d.ts","sourceRoot":"","sources":["../../src/utils/to-hex-words.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAanD"}

package/dist/utils/to-hex-words.js

@@ -0,0 +1,12 @@
+export function toHexWords(data) {
+    const hexData = Buffer.from(data).toString('hex');
+    let formattedData = '';
+    for (let i = 0; i < hexData.length; i += 4) {
+        if (i != 0) {
+            formattedData += ' ';
+        }
+        formattedData += hexData.substring(i, i + 4);
+    }
+    return formattedData;
+}
+//# sourceMappingURL=to-hex-words.js.map

package/dist/utils/to-hex-words.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-hex-words.js","sourceRoot":"","sources":["../../src/utils/to-hex-words.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,IAAgB;IACzC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,IAAI,aAAa,GAAG,EAAE,CAAC;IAEvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACX,aAAa,IAAI,GAAG,CAAC;QACvB,CAAC;QAED,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC","sourcesContent":["export function toHexWords(data: Uint8Array): string {\n  const hexData = Buffer.from(data).toString('hex');\n  let formattedData = '';\n\n  for (let i = 0; i < hexData.length; i += 4) {\n    if (i != 0) {\n      formattedData += ' ';\n    }\n\n    formattedData += hexData.substring(i, i + 4);\n  }\n\n  return formattedData;\n}\n"]}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@springfield/ham-radio-utils",
+  "version": "1.0.0",
+  "author": "Bryan Hunt",
+  "packageManager": "yarn@4.9.1",
+  "readme": "README.md",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "src/",
+    "dist/"
+  ],
+  "scripts": {
+    "build": "tsc && cp src/db/* dist/db/",
+    "commitlint": "commitlint --edit",
+    "release": "semantic-release",
+    "prepare": "husky"
+  },
+  "release": {
+    "branches": [
+      "main",
+      {
+        "name": "beta",
+        "prerelease": true
+      }
+    ],
+    "plugins": [
+      [
+        "@semantic-release/commit-analyzer",
+        {
+          "preset": "conventionalcommits"
+        }
+      ],
+      [
+        "@semantic-release/release-notes-generator",
+        {
+          "preset": "conventionalcommits"
+        }
+      ],
+      "@semantic-release/changelog",
+      "semantic-release-yarn",
+      "@semantic-release/gitlab",
+      "@semantic-release/git"
+    ]
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@springfield/ham-radio-api": "^12.0.1",
+    "fishery": "^2.3.1",
+    "loglayer": "^6.4.2",
+    "sprintf-js": "^1.1.3"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "19.8.1",
+    "@commitlint/config-conventional": "19.8.1",
+    "@semantic-release/changelog": "6.0.3",
+    "@semantic-release/git": "10.0.1",
+    "@semantic-release/gitlab": "13.2.5",
+    "@types/sprintf-js": "1.1.4",
+    "husky": "9.1.7",
+    "semantic-release": "23.1.1",
+    "semantic-release-yarn": "3.0.2",
+    "typescript": "5.8.3"
+  }
+}

package/src/db/bands.json

@@ -0,0 +1,149 @@
+[
+  {
+    "id": "d1a5c7e8-3f9b-4a6c-8d2e-1b3f7a9c5e8d",
+    "name": "160 Meter",
+    "wavelength": 160,
+    "lowerFrequency": 1800000000,
+    "upperFrequency": 2000000000,
+    "frequencyDisplayBaseMultiplier": 1000000,
+    "frequencyDisplayNumberDecimals": 3,
+    "privileges": [
+      "b7c9d9e4-5f0a-4f2d-9c2d-1e3b8e7a8b5f",
+      "f3a6c1d2-8e7f-4a5b-9d3e-2c4a9b6e7f8d",
+      "d6e8f7a2-3b4c-5d9e-1f2a-8c3b7e4a9f6d"
+    ]
+  },
+  {
+    "id": "e3b7a9c5-d1a5-4f8d-2e1b-c7e83f9b6a4c",
+    "name": "80 Meter",
+    "wavelength": 80,
+    "lowerFrequency": 3500000000,
+    "upperFrequency": 4000000000,
+    "frequencyDisplayBaseMultiplier": 1000000,
+    "frequencyDisplayNumberDecimals": 3,
+    "privileges": [
+      "b7c9d9e4-5f0a-4f2d-9c2d-1e3b8e7a8b5f",
+      "f3a6c1d2-8e7f-4a5b-9d3e-2c4a9b6e7f8d",
+      "d6e8f7a2-3b4c-5d9e-1f2a-8c3b7e4a9f6d"
+    ]
+  },
+  {
+    "id": "f0a4c5e8-d1b3-c7e83f9b-a6c8-d2e1b9c5f7ea",
+    "name": "60 Meter",
+    "wavelength": 60,
+    "lowerFrequency": 5332000,
+    "upperFrequency": 5405000,
+    "frequencyDisplayBaseMultiplier": 1000,
+    "frequencyDisplayNumberDecimals": 1,
+    "privileges": [
+      "f3a6c1d2-8e7f-4a5b-9d3e-2c4a9b6e7f8d",
+      "d6e8f7a2-3b4c-5d9e-1f2a-8c3b7e4a9f6d"
+    ],
+    "channels": [
+      {
+        "name": "Channel 1",
+        "frequency": 5332
+      },
+      {
+        "name": "Channel 2",
+        "frequency": 5348
+      },
+      {
+        "name": "Channel 3",
+        "frequency": 5358.5
+      },
+      {
+        "name": "Channel 4",
+        "frequency": 5373
+      },
+      {
+        "name": "Channel 5",
+        "frequency": 5405
+      }
+    ]
+  },
+  {
+    "id": "c5ea-f0a4-d1b39-c7ec83fa-a6cd82eb19cf",
+    "name": "40 Meter",
+    "wavelength": 40,
+    "lowerFrequency": 7000000000,
+    "upperFrequency": 7300000000,
+    "frequencyDisplayBaseMultiplier": 1000000,
+    "frequencyDisplayNumberDecimals": 3,
+    "privileges": [
+      "b7c9d9e4-5f0a-4f2d-9c2d-1e3b8e7a8b5f",
+      "f3a6c1d2-8e7f-4a5b-9d3e-2c4a9b6e7f8d",
+      "d6e8f7a2-3b4c-5d9e-1f2a-8c3b7e4a9f6d"
+    ]
+  },
+  {
+    "id": "fa83ec-d12ab39-c75ea-a46cd82eb19cf",
+    "name": "20 Meter",
+    "wavelength": 20,
+    "lowerFrequency": 14000000000,
+    "upperFrequency": 14350000000,
+    "frequencyDisplayBaseMultiplier": 1000000,
+    "frequencyDisplayNumberDecimals": 3,
+    "privileges": [
+      "f3a6c1d2-8e7f-4a5b-9d3e-2c4a9b6e7f8d",
+      "d6e8f7a2-3b4c-5d9e-1f2a-8c3b7e4a9f6d"
+    ]
+  },
+  {
+    "id": "a1b2c3d4-e5f6-7g8h-9i0j-k1l2m3n4o5p6",
+    "name": "15 Meter",
+    "wavelength": 15,
+    "lowerFrequency": 21000000,
+    "upperFrequency": 21450000,
+    "frequencyDisplayBaseMultiplier": 1000,
+    "frequencyDisplayNumberDecimals": 0,
+    "privileges": [
+      "b7c9d9e4-5f0a-4f2d-9c2d-1e3b8e7a8b5f",
+      "f3a6c1d2-8e7f-4a5b-9d3e-2c4a9b6e7f8d",
+      "d6e8f7a2-3b4c-5d9e-1f2a-8c3b7e4a9f6d",
+      "a2c4b6f8-7e9d-3f5b-1c2a-9e7f8d3b6a4c"
+    ]
+  },
+  {
+    "id": "p6o5n4m3-l2k1-j0i9-h8g7-f6e5-d4c3b2a1",
+    "name": "10 Meter",
+    "wavelength": 10,
+    "lowerFrequency": 28000000,
+    "upperFrequency": 29700000,
+    "frequencyDisplayBaseMultiplier": 1000,
+    "frequencyDisplayNumberDecimals": 0,
+    "privileges": [
+      "b7c9d9e4-5f0a-4f2d-9c2d-1e3b8e7a8b5f",
+      "f3a6c1d2-8e7f-4a5b-9d3e-2c4a9b6e7f8d",
+      "d6e8f7a2-3b4c-5d9e-1f2a-8c3b7e4a9f6d"
+    ]
+  },
+  {
+    "id": "z1y2x3w4-v5u6-t7s8-r9q0-p1o2n3m4l5k6",
+    "name": "2 Meter",
+    "wavelength": 2,
+    "lowerFrequency": 144000000,
+    "upperFrequency": 148000000,
+    "frequencyDisplayBaseMultiplier": 1000,
+    "frequencyDisplayNumberDecimals": 0,
+    "privileges": [
+      "b7c9d9e4-5f0a-4f2d-9c2d-1e3b8e7a8b5f",
+      "f3a6c1d2-8e7f-4a5b-9d3e-2c4a9b6e7f8d",
+      "d6e8f7a2-3b4c-5d9e-1f2a-8c3b7e4a9f6d"
+    ]
+  },
+  {
+    "id": "k6l5m4n3-o2p1-q0r9-s8t7-u6v5-w4x3y2z1",
+    "name": "70 Centimeter",
+    "wavelength": 0.7,
+    "lowerFrequency": 420000000,
+    "upperFrequency": 450000000,
+    "frequencyDisplayBaseMultiplier": 1000,
+    "frequencyDisplayNumberDecimals": 0,
+    "privileges": [
+      "b7c9d9e4-5f0a-4f2d-9c2d-1e3b8e7a8b5f",
+      "f3a6c1d2-8e7f-4a5b-9d3e-2c4a9b6e7f8d",
+      "d6e8f7a2-3b4c-5d9e-1f2a-8c3b7e4a9f6d"
+    ]
+  }
+]

package/src/db/license-classes.json

@@ -0,0 +1,22 @@
+[
+  {
+    "id": "b7c9d9e4-5f0a-4f2d-9c2d-1e3b8e7a8b5f",
+    "name": "Technician"
+  },
+  {
+    "id": "f3a6c1d2-8e7f-4a5b-9d3e-2c4a9b6e7f8d",
+    "name": "General"
+  },
+  {
+    "id": "d6e8f7a2-3b4c-5d9e-1f2a-8c3b7e4a9f6d",
+    "name": "Amateur Extra"
+  },
+  {
+    "id": "a2c4b6f8-7e9d-3f5b-1c2a-9e7f8d3b6a4c",
+    "name": "Advanced (Grandfathered)"
+  },
+  {
+    "id": "e7f9d3b6-a2c4-5f1a-8c3b-6f8d2a4b9e7f",
+    "name": "Novice (Grandfathered)"
+  }
+]

package/src/index.ts

@@ -0,0 +1,12 @@
+export * from './memory/segmented-memory.js';
+
+export * from './test-utils/radio-channel-factory.js';
+export * from './test-utils/radio-programmed-channel-factory.js';
+
+export * from './utils/bcd-to-number.js';
+export * from './utils/band-plan.js';
+export * from './utils/frequency-display.js';
+export * from './utils/memory-channel-utils.js';
+export * from './utils/memory-segment-utils.js';
+export * from './utils/number-to-bcd.js';
+export * from './utils/to-hex-words.js';

package/src/memory/segmented-memory.ts

@@ -0,0 +1,52 @@
+import { RadioMemorySegment } from '@springfield/ham-radio-api';
+
+export class RadioSegmentedMemory {
+  private segments: Map<number, RadioMemorySegment>;
+
+  constructor(segments?: RadioMemorySegment[]) {
+    this.segments = new Map();
+
+    if (segments != undefined) {
+      for (const segment of segments) {
+        this.segments.set(segment.startAddress, segment);
+      }
+    }
+  }
+
+  public addSegment(segment: RadioMemorySegment): void {
+    this.segments.set(segment.startAddress, segment);
+  }
+
+  public getSegments(): IterableIterator<RadioMemorySegment> {
+    return this.segments.values();
+  }
+
+  public getSegment(startAddress: number): RadioMemorySegment | undefined {
+    return this.segments.get(startAddress);
+  }
+
+  public segmentCount(): number {
+    return this.segments.size;
+  }
+
+  public findSegment(address: number): RadioMemorySegment | undefined {
+    const iterator = this.segments.values();
+    let result = iterator.next();
+
+    while (!result.done) {
+      const segment = result.value;
+
+      if (segment.startAddress <= address && segment.startAddress + segment.length > address) {
+        return segment;
+      }
+
+      result = iterator.next();
+    }
+
+    return undefined;
+  }
+
+  public toArray(): RadioMemorySegment[] {
+    return Array.from(this.segments.values());
+  }
+}

package/src/test-utils/radio-channel-factory.ts

@@ -0,0 +1,17 @@
+import { CTCSS, Frequency, RadioChannel, RadioChannelId, RadioToneType } from '@springfield/ham-radio-api';
+import { Factory } from 'fishery';
+
+export function getRandomCTCSS(): CTCSS {
+  const values = Object.values(CTCSS); // Get all values from the enum
+  const randomIndex = Math.floor(Math.random() * values.length); // Generate a random index
+  return values[randomIndex] as CTCSS; // Return the randomly selected value
+}
+
+export const radioChannelFactory = Factory.define<RadioChannel>(({ sequence }) => ({
+  id: RadioChannelId(sequence.toString()),
+  name: `c-${sequence}`,
+  transmitFrequency: Frequency(144000),
+  receiveFrequency: Frequency(144000),
+  transmitTone: { type: RadioToneType.CTCSS, tone: getRandomCTCSS() },
+  receiveTone: { type: RadioToneType.CTCSS, tone: getRandomCTCSS() },
+}));

package/src/test-utils/radio-programmed-channel-factory.ts

@@ -0,0 +1,8 @@
+import { RadioProgrammedChannel } from '@springfield/ham-radio-api';
+import { Factory } from 'fishery';
+import { radioChannelFactory } from './radio-channel-factory.js';
+
+export const radioProgrammedChannelFactory = Factory.define<RadioProgrammedChannel>(({ sequence }) => ({
+  channelNumber: sequence,
+  radioChannel: radioChannelFactory.build(),
+}));

package/src/utils/band-plan.ts

@@ -0,0 +1,36 @@
+import { SpectrumBand } from '@springfield/ham-radio-api';
+import bandsData from '../db/bands.json' with { type: 'json' };
+import licenseClassesData from '../db/license-classes.json' with { type: 'json' };
+
+interface LicenseClass {
+  id: string;
+  name: string;
+}
+
+export class BandPlan {
+  private bands: SpectrumBand[];
+  private licenseClasses: Map<string, LicenseClass>;
+
+  constructor() {
+    this.bands = bandsData as SpectrumBand[];
+    this.licenseClasses = new Map((licenseClassesData as LicenseClass[]).map((licenseClass) => [licenseClass.id, licenseClass]));
+  }
+
+  /**
+   * Finds the spectrum band that contains the given frequency
+   * @param frequency The frequency in Hz to find the band for
+   * @returns The spectrum band containing the frequency, or undefined if no band contains it
+   */
+  findBandByFrequency(frequency: number): SpectrumBand | undefined {
+    return this.bands.find((band) => frequency >= band.lowerFrequency && frequency <= band.upperFrequency);
+  }
+
+  /**
+   * Finds a license class by its ID
+   * @param id The ID of the license class to find
+   * @returns The license class with the given ID, or undefined if not found
+   */
+  findPrivilegeById(id: string): LicenseClass | undefined {
+    return this.licenseClasses.get(id);
+  }
+}

package/src/utils/bcd-to-number.ts

@@ -0,0 +1,10 @@
+export function bcdToNumber(data: Uint8Array, offset?: number, length?: number): number {
+  let bcd = 0;
+  const size = length ?? data.length;
+
+  for (let i = offset ?? 0; i < size; i++) {
+    bcd |= data[i] << (8 * i);
+  }
+
+  return parseInt(bcd.toString(16), 10) * 10;
+}

package/src/utils/frequency-display.ts

@@ -0,0 +1,6 @@
+import { Frequency, SpectrumBand } from '@springfield/ham-radio-api';
+
+export function frequencyDisplay(frequency: Frequency, band: SpectrumBand): string {
+  const frequencyDisplay = frequency / band.frequencyDisplayBaseMultiplier;
+  return frequencyDisplay.toFixed(band.frequencyDisplayNumberDecimals);
+}

package/src/utils/memory-channel-utils.ts

@@ -0,0 +1,6 @@
+import { sprintf } from 'sprintf-js';
+import { toHexWords } from './to-hex-words.js';
+
+export function formatChannel(channelNumber: number, data: Uint8Array): string {
+  return sprintf('%2d : %s', channelNumber, toHexWords(data));
+}

package/src/utils/memory-segment-utils.ts

@@ -0,0 +1,7 @@
+import { sprintf } from 'sprintf-js';
+import { toHexWords } from './to-hex-words.js';
+import { RadioMemorySegment } from '@springfield/ham-radio-api';
+
+export function formatSegment(segment: RadioMemorySegment): string {
+  return sprintf('%04X : %s', segment.startAddress, toHexWords(segment.data));
+}

package/src/utils/number-to-bcd.ts

@@ -0,0 +1,15 @@
+export function numberToBcd(value: number): Uint8Array {
+  const digits = value.toString(10);
+  const numberOfBytes = Math.ceil(digits.length / 2.0);
+
+  const data = new Uint8Array(numberOfBytes);
+
+  let bcd = parseInt(digits, 16);
+
+  for (let i = 0; i < numberOfBytes; i++) {
+    data[i] = bcd & 0xff;
+    bcd >>= 8;
+  }
+
+  return data;
+}

package/src/utils/to-hex-words.ts

@@ -0,0 +1,14 @@
+export function toHexWords(data: Uint8Array): string {
+  const hexData = Buffer.from(data).toString('hex');
+  let formattedData = '';
+
+  for (let i = 0; i < hexData.length; i += 4) {
+    if (i != 0) {
+      formattedData += ' ';
+    }
+
+    formattedData += hexData.substring(i, i + 4);
+  }
+
+  return formattedData;
+}