signalk-ais-navionics-converter 1.0.2 → 1.0.3

package/ais-encoder.js

@@ -1,15 +1,26 @@
 class AISEncoder {
-  static encode6bit(val) {
+  constructor(app) { this.app = app; }
+
+  stateMap = {
+        'motoring': 0, 'anchored': 1, 'not under command': 2, 'restricted manouverability': 3,
+        'constrained by draft': 4, 'moored': 5, 'aground': 6, 'fishing': 7,
+        'sailing': 8, 'hazardous material high speed': 9, 'hazardous material wing in ground': 10,
+        'power-driven vessel towing astern': 11, 'power-driven vessel pushing ahead': 12,
+        'reserved': 13, 'ais-sart': 14, 'undefined': 15, 'default':15
+  };
+
+  encode6bit(val) {
     if (val < 0 || val > 63) throw new Error("6-bit out of range: " + val);
     return val <= 39 ? String.fromCharCode(val + 48) : String.fromCharCode(val + 56);
   }
 
-  static toTwosComplement(value, bits) {
-    if (value < 0) value = (1 << bits) + value;
-    return value;
+  toTwosComplement(value, bits) {
+    let max = 1 << bits;
+    if (value < 0) value = max + value;
+    return value.toString(2).padStart(bits, "0");
   }
 
-  static textToSixBit(str, length) {
+  textToSixBit(str, length) {
     const table = '@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_ !"#$%&\'()*+,-./0123456789:;<=>?';
     let bits = '';
     str = str || '';
@@ -22,13 +33,13 @@ class AISEncoder {
     return bits;
   }
 
-  static callsignToSixBit(callsign) {
+  callsignToSixBit(callsign) {
     callsign = (callsign || '').trim().toUpperCase();
     const padded = callsign.padEnd(7, '@').substring(0, 7);
     return this.textToSixBit(padded, 7);
   }
 
-  static bitsToPayload(bits) {
+  bitsToPayload(bits) {
     let payload = '';
     while (bits.length % 6 !== 0) {
       bits += '0';
@@ -42,16 +53,229 @@ class AISEncoder {
     return payload;
   }
 
-  static calculateChecksum(nmea) {
+  calculateChecksum(nmea) {
     let cs = 0;
     for (let i = 1; i < nmea.length; i++) cs ^= nmea.charCodeAt(i);
     return cs.toString(16).toUpperCase().padStart(2, '0');
   }
 
-  static createPositionReport(vessel, config) {
+   parseETAToUTC(etaString) {
+    if (!etaString) return null;
+
+    // Ungültige Platzhalter abfangen
+    if (
+      etaString.startsWith("00-00") ||
+      etaString.startsWith("0000-00-00")
+    ) {
+      return null;
+    }
+
+    // 1️⃣ Vollständiges ISO-8601
+    if (/^\d{4}-\d{2}-\d{2}T/.test(etaString)) {
+      const d = new Date(etaString);
+      return isNaN(d) ? null : d;
+    }
+
+    // 2️⃣ AIS-Kurzformat: MM-DDTHH:mmZ
+    const m = etaString.match(/^(\d{2})-(\d{2})T(\d{2}):(\d{2})Z$/);
+    if (m) {
+      const [, month, day, hour, minute] = m.map(Number);
+
+      const now = new Date();
+      let year = now.getUTCFullYear();
+
+      let candidate = new Date(Date.UTC(year, month - 1, day, hour, minute));
+
+      // ETA ist immer zukünftig → ggf. nächstes Jahr
+      if (candidate < now) {
+        candidate = new Date(Date.UTC(year + 1, month - 1, day, hour, minute));
+      }
+
+      return candidate;
+    }
+
+    return null;
+  }
+
+encodeNameTo6bit(name) {
+  // Offizielle AIS 6-Bit Tabelle nach ITU-R M.1371:
+  // 0=@, 1=A, ... 26=Z, 27=[, 28=\, 29=], 30=^, 31=_,
+  // 32=Space, 33=!, 34=", ..., 48-57=0-9, 63=?
+  const AIS_CHARS = "@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_ !\"#$%&'()*+,-./0123456789:;<=>?";
+
+  let n = (name || "").toUpperCase().slice(0, 20).padEnd(20, " ");
+
+  let bits = "";
+  for (let i = 0; i < n.length; i++) {
+    const ch = n[i];
+    let idx = AIS_CHARS.indexOf(ch);
+    if (idx < 0) idx = 32; // unbekannt → Space (nicht '@')
+    bits += idx.toString(2).padStart(6, "0");
+  }
+  return bits; // 20 * 6 = 120 Bit
+}
+
+computeAisSogCog(sogValue, sogUnits, cogValue, cogUnits, headingValue, headingUnits, minAlarmSOG = 0.2) {
+
+  //
+  // --- SOG ---
+  //
+  let sogKn = Number(sogValue) || 0;
+
+  if (!(sogUnits && sogUnits.toLowerCase().includes("kn"))) {
+    sogKn = sogKn * 1.94384;
+  }
+
+  if (sogKn < minAlarmSOG) {
+    sogKn = 0;
+  }
+
+  let sog10;
+  if (!Number.isFinite(sogKn) || sogKn <= 0) {
+    sog10 = 1023; // 1023 wäre "not available", aber du nutzt 0 → bleibt so
+  } else {
+    sog10 = Math.round(sogKn * 10);
+    if (sog10 > 1022) sog10 = 1022;
+  }
+
+  //
+  // --- COG ---
+  //
+  let cog10 = 3600; // AIS: 3600 = not available
+
+  if (sogKn >= minAlarmSOG && Number.isFinite(cogValue)) {
+    let cogDeg;
+
+    if (cogUnits) {
+      const u = cogUnits.toLowerCase();
+      if (u.includes("rad")) {
+        cogDeg = cogValue * 180 / Math.PI;
+      } else if (u.includes("deg")) {
+        cogDeg = cogValue;
+      } else {
+        cogDeg = Math.abs(cogValue) <= 2 * Math.PI
+          ? cogValue * 180 / Math.PI
+          : cogValue;
+      }
+    } else {
+      cogDeg = Math.abs(cogValue) <= 2 * Math.PI
+        ? cogValue * 180 / Math.PI
+        : cogValue;
+    }
+
+    cogDeg = ((cogDeg % 360) + 360) % 360;
+
+    cog10 = Math.round(cogDeg * 10);
+    if (cog10 > 3599) cog10 = 3599;
+  }
+
+  //
+  // --- HEADING ---
+  //
+  // AIS: 511 = not available
+  let headingInt = 511;
+
+  // Heading nur gültig, wenn SOG > 0 UND COG gültig
+  if (sogKn >= minAlarmSOG && cog10 !== 3600 && Number.isFinite(headingValue)) {
+
+    let headingDeg;
+
+    if (headingUnits) {
+      const u = headingUnits.toLowerCase();
+      if (u.includes("rad")) {
+        headingDeg = headingValue * 180 / Math.PI;
+      } else if (u.includes("deg")) {
+        headingDeg = headingValue;
+      } else {
+        headingDeg = Math.abs(headingValue) <= 2 * Math.PI
+          ? headingValue * 180 / Math.PI
+          : headingValue;
+      }
+    } else {
+      headingDeg = Math.abs(headingValue) <= 2 * Math.PI
+        ? headingValue * 180 / Math.PI
+        : headingValue;
+    }
+
+    headingDeg = ((headingDeg % 360) + 360) % 360;
+
+    headingInt = Math.round(headingDeg);
+    if (headingInt > 359) headingInt = 359;
+  }
+
+  return { sog10, cog10, headingInt };
+}
+
+
+computeAisRot(rateValue, rateUnits) {
+  // AIS default: ROT not available
+  let rot = -128; // standard -128 (unavailable)
+
+  // Kein Wert → fertig
+  if (typeof rateValue !== "number" || !Number.isFinite(rateValue)) {
+    return rot;
+  }
+
+  let rate = rateValue;
+
+  //
+  // 1. Einheit erkennen und nach °/min umrechnen
+  //
+  if (rateUnits) {
+    const u = rateUnits.toLowerCase();
+
+    if (u.includes("rad/s")) {
+      // rad/s → deg/min
+      rate = rate * (180 / Math.PI) * 60;
+
+    } else if (u.includes("deg/s")) {
+      // deg/s → deg/min
+      rate = rate * 60;
+
+    } else if (u.includes("deg/min")) {
+      // schon korrekt
+
+    } else {
+      // unbekannte Einheit → heuristisch rad/s
+      if (Math.abs(rate) < 10) {
+        rate = rate * (180 / Math.PI) * 60;
+      }
+    }
+
+  } else {
+    // Keine Units → heuristisch rad/s
+    if (Math.abs(rate) < 10) {
+      rate = rate * (180 / Math.PI) * 60;
+    }
+  }
+
+  //
+  // 2. Physikalische Begrenzung nach AIS (±708°/min)
+  //
+  if (rate > 708) rate = 708;
+  if (rate < -708) rate = -708;
+
+  //
+  // 3. AIS‑ROT‑Formel (ITU‑R M.1371)
+  //
+  if (rate !== 0) {
+    const sign = rate < 0 ? -1 : 1;
+    rot = Math.round(sign * 4.733 * Math.sqrt(Math.abs(rate)));
+
+    // 4. Begrenzung auf AIS‑Integer‑Range
+    if (rot > 126) rot = 126;
+    if (rot < -126) rot = -126;
+  }
+
+  return rot;
+}
+
+  
+  createPositionReportType1(vessel, config) {
+    // Type 1 - Position Report Class A
     try {
       const mmsi = parseInt(vessel.mmsi);
-      if (!mmsi || mmsi === 0) return null;
+        if (!mmsi || mmsi === 0) return null;
 
       const nav = vessel.navigation || {};
       const pos = nav.position?.value || nav.position || {};
@@ -59,54 +283,59 @@ class AISEncoder {
       const longitude = pos.longitude;
       if (latitude === undefined || longitude === undefined) return null;
 
-      const state = nav.state?.value || '';
+      const rawState = nav.state?.value;
       let navStatus = 15;
-      const stateMap = {
-        'motoring': 0, 'anchored': 1, 'not under command': 2, 'restricted maneuverability': 3,
-        'constrained by draft': 4, 'moored': 5, 'aground': 6, 'fishing': 7,
-        'sailing': 8, 'hazardous material high speed': 9, 'hazardous material wing in ground': 10,
-        'power-driven vessel towing astern': 11, 'power-driven vessel pushing ahead': 12,
-        'reserved': 13, 'ais-sart': 14, 'undefined': 15
-      };
-      if (state && stateMap[state] !== undefined) navStatus = stateMap[state];
+      if (typeof rawState === "number" && Number.isFinite(rawState)) {
+        navStatus = rawState;
+      } else if (typeof rawState === "string") {
+        const key = rawState.toLowerCase();
+        if (this.stateMap[key] !== undefined) {
+          navStatus = this.stateMap[key];
+        } else if (key !== "" && key !== "undefined" && key !== "default") {
+          this.app.error(`Unknown navigation status: ${rawState}`);
+        }
 
-      const timestamp = 60;
+      } else if (rawState !== undefined && rawState !== null) {
+        this.app.error(`Invalid navigation state type: ${rawState}`);
+      }
+
+      // const timestamp = 60;
+      const isoTime = pos.timestamp;
+      let timestamp = 60; // default "not available"
+      if (isoTime && nav?.speedOverGround) {
+        // die Berechnung nur machen, wenn SOG > 0 ist, weil Navionics sonst TCPA berechnet
+        const date = new Date(isoTime);
+        const ageMs = Date.now() - date.getTime();
+        if (ageMs <= 60000) {
+          // nur wenn die Meldung jünger als 60 Sekunden ist
+          timestamp = date.getUTCSeconds(); // 0–59
+        }
+      }
+      
       const raim = 0;
       const maneuver = 0;
       
-      const rateOfTurn = nav.rateOfTurn?.value || 0;
-      let rot = -128;
-      if (rateOfTurn !== 0) {
-        rot = Math.round(rateOfTurn * 4.733 * Math.sqrt(Math.abs(rateOfTurn)));
-        rot = Math.max(-126, Math.min(126, rot));
-      }
+      const rot = this.computeAisRot(nav.rateOfTurn?.value, nav.rateOfTurn?.meta?.units)
+     
+      const lon = Math.round(longitude * 600000);
+      const lat = Math.round(latitude * 600000);
       
-      const sog = nav.speedOverGround?.value || nav.speedOverGround || 0;
-      const cog = nav.courseOverGroundTrue?.value || nav.courseOverGroundTrue || 0;
-      const heading = nav.headingTrue?.value || nav.headingTrue || 0;
+      // --- SOG + COG --- (sog10/10===SOG in kn, cog10/10===COG in °)
+      const sogField = nav?.speedOverGround;
+      const cogField = nav?.courseOverGroundTrue;
+      const headingField = nav?.headingTrue;
 
-      let sogValue = typeof sog === 'number' ? sog : 0;
-      if (sogValue < config.minAlarmSOG) sogValue = 0;
+      const { sog10, cog10, headingInt } = this.computeAisSogCog(
+        sogField?.value ?? 0,
+        sogField?.meta?.units ?? null,
+        cogField?.value ?? null,
+        cogField?.meta?.units ?? null,
+        headingField?.value ?? null,
+        headingField?.meta?.units ?? null,
+        config.minAlarmSOG
+      );
 
-      const cogValue = typeof cog === 'object' ? 0 : (typeof cog === 'number' ? cog : 0);
-      const headingValue = typeof heading === 'object' ? 0 : (typeof heading === 'number' ? heading : 0);
 
-      const lon = Math.round(longitude * 600000);
-      const lat = Math.round(latitude * 600000);
-      
-      const sogKnots = sogValue * 1.94384;
-      const sog10 = Math.round(sogKnots * 10);
-      
-      const cogDegrees = cogValue * 180 / Math.PI;
-      let cog10;
-      if (sogKnots < config.minAlarmSOG) {
-        cog10 = 0; // or 3600 to indicate not available
-      } else {
-        cog10 = Math.round(cogDegrees * 10);
-      }
-      
-      const headingDegrees = headingValue * 180 / Math.PI;
-      const headingInt = Math.round(headingDegrees);
 
       let bits = '';
       bits += (1).toString(2).padStart(6, '0');
@@ -128,12 +357,154 @@ class AISEncoder {
 
       return this.bitsToPayload(bits);
     } catch (error) {
-      console.error('Error creating position report:', error);
+      this.app.error('Error creating position report:', error);
+      return null;
+    }
+  }
+
+  createPositionReportType19(vessel, config) {
+    // Type 19 - Extended Class B Equipment Position Report
+    try {
+      const mmsi = parseInt(vessel.mmsi, 10);
+      if (!mmsi || mmsi === 0) return null;
+
+      const nav = vessel.navigation || {};
+      const posObj = nav.position || {};
+      const pos = posObj.value || posObj || {};
+      const latitude = pos.latitude;
+      const longitude = pos.longitude;
+      if (typeof latitude !== "number" || typeof longitude !== "number") return null;
+
+      // Zeitstempel (UTC-Sekunden, nur wenn Position <= 60s alt)
+      const isoTime = posObj.timestamp || pos.timestamp;
+      let timestamp = 60; // 60 = not available
+      if (isoTime && nav?.speedOverGround) {
+        // die Berechnung nur machen, wenn SOG > 0 ist, weil Navionics sonst TCPA berechnet
+        const date = new Date(isoTime);
+        const ageMs = Date.now() - date.getTime();
+        if (ageMs <= 60000) {
+          timestamp = date.getUTCSeconds(); // 0–59
+        }
+      }
+
+      // RAIM
+      const raimFlag = 0; // 0 = RAIM not in use
+
+      // --- SOG + COG --- (sog10/10===SOG in kn, cog10/10===COG in °)
+      const sogField = nav?.speedOverGround;
+      const cogField = nav?.courseOverGroundTrue;
+      const headingField = nav?.headingTrue;
+
+      const { sog10, cog10, headingInt } = this.computeAisSogCog(
+        sogField?.value ?? 0,
+        sogField?.meta?.units ?? null,
+        cogField?.value ?? null,
+        cogField?.meta?.units ?? null,
+        headingField?.value ?? null,
+        headingField?.meta?.units ?? null,
+        config.minAlarmSOG
+      );
+
+
+
+
+      // --- Position in 1/10000 Minuten ---
+      let lon = Math.round(longitude * 600000); // deg → 1/10000'
+      let lat = Math.round(latitude * 600000);
+
+      // Gültigkeitsbereiche (AIS spezifiziert):
+      // Lon: -180..180 → -108000000..108000000
+      // Lat: -90..90   → -54000000..54000000
+      const lonUnavailable = (lon < -108000000 || lon > 108000000);
+      const latUnavailable = (lat < -54000000 || lat > 54000000);
+      if (lonUnavailable) lon = 0x6791AC0; // 181° * 600000 → not available (eigentlich: 0x6791AC0)
+      if (latUnavailable) lat = 0x3412140; // 91° * 600000 → not available
+
+      // --- Design / Dimensionen ---
+      const design = vessel.design || {};
+      const length = design.length?.value?.overall || 0;
+      const beam = design.beam?.value || 0;
+
+      const ais = vessel.sensors?.ais || {};
+      const fromBow = ais.fromBow?.value || 0;
+      const fromCenter = ais.fromCenter?.value || 0;
+
+      const toBow = Math.max(0, Math.round(fromBow));
+      const toStern = Math.max(0, Math.round(Math.max(0, length - fromBow)));
+      const toPort = Math.max(0, Math.round(Math.max(0, beam / 2 - fromCenter)));
+      const toStarboard = Math.max(0, Math.round(Math.max(0, beam / 2 + fromCenter)));
+
+      // --- Ship type ---
+      const shipType = design.aisShipType?.value?.id || 0;
+
+      // --- EPFD ---
+      let epfd = 0; // 0 = undefined
+      const positionSource = posObj.$source || "";
+      const srcLower = positionSource.toLowerCase();
+      if (srcLower.includes("gps")) epfd = 1;
+      else if (srcLower.includes("glonass")) epfd = 2;
+      else if (srcLower.includes("galileo")) epfd = 3;
+
+      // --- Name ---
+      const name = vessel.name || "";
+      const nameBits = this.encodeNameTo6bit(name); // 120 Bit
+
+      // --- DTE & Assigned Mode ---
+      const dte = 0;          // 0 = available
+      const assignedMode = 0; // 0 = autonomous/continuous
+
+      // --- Jetzt Bitstring exakt nach Type-19-Spezifikation aufbauen ---
+
+      let bits = "";
+
+      bits += (19).toString(2).padStart(6, "0");     // 01 Message ID
+      bits += (0).toString(2).padStart(2, "0");      // 02 Repeat
+      bits += mmsi.toString(2).padStart(30, "0");    // 03 MMSI
+
+      bits += (0).toString(2).padStart(8, "0");      // 04 Reserved (8 Bit)
+
+      bits += sog10.toString(2).padStart(10, "0");   // 05 SOG
+      bits += "0";                                   // 06 Position Accuracy (0 = low)
+
+      bits += this.toTwosComplement(lon, 28).toString(2).padStart(28, "0"); // 07 Longitude
+      bits += this.toTwosComplement(lat, 27).toString(2).padStart(27, "0"); // 08 Latitude
+
+      bits += cog10.toString(2).padStart(12, "0");  // 09 COG
+      bits += headingInt.toString(2).padStart(9, "0"); // 10 True Heading
+      bits += timestamp.toString(2).padStart(6, "0");  // 11 Timestamp
+
+      bits += (0).toString(2).padStart(4, "0");     // 12 Reserved (Regional)
+
+      bits += nameBits;                             // 13 Name (120 Bit)
+
+      bits += shipType.toString(2).padStart(8, "0");  // 14 Ship Type
+
+      bits += toBow.toString(2).padStart(9, "0");      // 15 A
+      bits += toStern.toString(2).padStart(9, "0");    // 15 B
+      bits += toPort.toString(2).padStart(6, "0");     // 15 C
+      bits += toStarboard.toString(2).padStart(6, "0");// 15 D
+
+      bits += epfd.toString(2).padStart(4, "0");    // 16 EPFD
+
+      bits += (raimFlag ? "1" : "0");               // 17 RAIM
+      bits += dte.toString(2).padStart(1, "0");     // 18 DTE
+      bits += assignedMode.toString(2).padStart(1, "0"); // 18 Mode flag
+
+      bits += (0).toString(2).padStart(4, "0");     // 19 Spare
+
+      if (bits.length !== 312) {
+        this.app.warn("AIS Type 19 bit length is not 312:", bits.length);
+        return null;
+      }
+
+      return this.bitsToPayload(bits);
+    } catch (err) {
+      this.app.error("Error creating type 19:", err);
       return null;
     }
   }
 
-  static createStaticVoyage(vessel) {
+  createStaticVoyage(vessel) {
     try {
       const mmsi = parseInt(vessel.mmsi);
       if (!mmsi || mmsi === 0) return null;
@@ -144,7 +515,18 @@ class AISEncoder {
       const draft = design.draft?.value?.maximum || 0;
       const shipType = design.aisShipType?.value?.id || 0;
       
-      const imo = parseInt(vessel.imo) || 0;
+      // IMO-Nummer extrahieren - verschiedene mögliche Quellen
+      let imo = 0;
+      if (vessel.registrations?.imo) {
+        // IMO aus registrations
+        const imoStr = vessel.registrations.imo.toString().replace(/[^\d]/g, '');
+        imo = parseInt(imoStr) || 0;
+      } else if (vessel.imo) {
+        // Direkt als vessel.imo
+        const imoStr = vessel.imo.toString().replace(/[^\d]/g, '');
+        imo = parseInt(imoStr) || 0;
+      }
+      
       const aisVersion = 0;
       
       const ais = vessel.sensors?.ais || {};
@@ -164,17 +546,20 @@ class AISEncoder {
       else if (positionSource.includes('galileo')) epfd = 3;
 
       const destination = vessel.navigation?.destination?.commonName?.value || '';
-      const etaString = vessel.navigation?.courseGreatCircle?.activeRoute?.estimatedTimeOfArrival?.value || '';
-      
+      const etaString =
+        vessel.navigation?.courseGreatCircle?.activeRoute?.estimatedTimeOfArrival?.value ??
+        vessel.navigation?.destination?.eta?.value ??
+        '';
+
       let etaMonth = 0, etaDay = 0, etaHour = 24, etaMinute = 60;
-      if (etaString && etaString !== '00-00T00:00Z' && etaString !== '00-00T24:60Z') {
-        const etaMatch = etaString.match(/(\d+)-(\d+)T(\d+):(\d+)/);
-        if (etaMatch) {
-          etaMonth = parseInt(etaMatch[1]) || 0;
-          etaDay = parseInt(etaMatch[2]) || 0;
-          etaHour = parseInt(etaMatch[3]) || 24;
-          etaMinute = parseInt(etaMatch[4]) || 60;
-        }
+
+      const etaDate = this.parseETAToUTC(etaString);
+
+      if (etaDate) {
+        etaMonth  = etaDate.getUTCMonth() + 1;
+        etaDay    = etaDate.getUTCDate();
+        etaHour   = etaDate.getUTCHours();
+        etaMinute = etaDate.getUTCMinutes();
       }
       
       const draughtDecimeters = Math.round(draft * 10);
@@ -186,7 +571,7 @@ class AISEncoder {
       bits += mmsi.toString(2).padStart(30,'0');
       bits += aisVersion.toString(2).padStart(2,'0');
       bits += imo.toString(2).padStart(30,'0');
-      bits += this.callsignToSixBit(vessel.callSign ?? '');
+      bits += this.callsignToSixBit(vessel.callsign ?? '');
       bits += this.textToSixBit(vessel.name ?? '', 20);
       bits += shipType.toString(2).padStart(8,'0');
       bits += toBow.toString(2).padStart(9,'0');
@@ -202,15 +587,107 @@ class AISEncoder {
       bits += this.textToSixBit(destination, 20);
       bits += dte.toString(2);
       bits += '0';
-
       return this.bitsToPayload(bits);
     } catch(err) {
-      console.error('Error creating type5:', err);
+      this.app.error('Error creating type5:', err);
       return null;
     }
   }
 
-  static createNMEASentence(payload, fragmentCount=1, fragmentNum=1, messageId=null, channel='B') {
+  createStaticVoyageType24(vessel) {
+  try {
+    const mmsi = parseInt(vessel.mmsi);
+    if (!mmsi || mmsi === 0) return null;
+
+    const design = vessel.design || {};
+    const length = design.length?.value?.overall || 0;
+    const beam = design.beam?.value || 0;
+
+    const ais = vessel.sensors?.ais || {};
+    const fromBow = ais.fromBow?.value || 0;
+    const fromCenter = ais.fromCenter?.value || 0;
+
+    const toBow = Math.round(fromBow);
+    const toStern = Math.round(Math.max(0, length - fromBow));
+    const toPort = Math.round(Math.max(0, beam / 2 - fromCenter));
+    const toStarboard = Math.round(Math.max(0, beam / 2 + fromCenter));
+
+    const shipType = design.aisShipType?.value?.id || 0;
+
+    //
+    // -------------------------
+    // PART A (Name)
+    // -------------------------
+    //
+    let bitsA = "";
+    bitsA += (24).toString(2).padStart(6, "0");  // type
+    bitsA += (0).toString(2).padStart(2, "0");   // repeat
+    bitsA += mmsi.toString(2).padStart(30, "0"); // mmsi
+    bitsA += (0).toString(2).padStart(2, "0");   // part A
+
+    // 20 six-bit chars = 120 bits
+    bitsA += this.textToSixBit(vessel.name ?? "", 20);
+
+    // Spare (optional, many devices omit it)
+    bitsA = bitsA.padEnd(168, "0"); // valid length for Part A
+
+    //
+    // -------------------------
+    // PART B (ShipType, Vendor, Callsign, Dimensions)
+    // -------------------------
+    //
+    let bitsB = "";
+    bitsB += (24).toString(2).padStart(6, "0");
+    bitsB += (0).toString(2).padStart(2, "0");
+    bitsB += mmsi.toString(2).padStart(30, "0");
+    bitsB += (1).toString(2).padStart(2, "0"); // part B
+
+    // 40–47: Ship Type
+    bitsB += shipType.toString(2).padStart(8, "0");
+
+    // 48–65: Vendor ID (3 × 6-bit chars)
+    bitsB += this.textToSixBit("", 3); // leave empty
+
+    // 66–69: Unit Model Code (4 bits)
+    bitsB += "0000";
+
+    // 70–89: Serial Number (20 bits)
+    bitsB += "00000000000000000000";
+
+    // 90–131: Callsign (7 × 6-bit chars = 42 bits)
+    bitsB += this.textToSixBit(vessel.callsign ?? "", 7);
+
+    // 132–140: To Bow (9 bits)
+    bitsB += toBow.toString(2).padStart(9, "0");
+
+    // 141–149: To Stern (9 bits)
+    bitsB += toStern.toString(2).padStart(9, "0");
+
+    // 150–155: To Port (6 bits)
+    bitsB += toPort.toString(2).padStart(6, "0");
+
+    // 156–161: To Starboard (6 bits)
+    bitsB += toStarboard.toString(2).padStart(6, "0");
+
+    // 162–167: Spare (6 bits)
+    bitsB += "000000";
+
+    // Ensure correct length
+    bitsB = bitsB.padEnd(168, "0");
+
+    return {
+      partA: this.bitsToPayload(bitsA),
+      partB: this.bitsToPayload(bitsB)
+    };
+
+  } catch (err) {
+    this.app.error("Error creating type24:", err);
+    return null;
+  }
+}
+
+
+  createNMEASentence(payload, fragmentCount=1, fragmentNum=1, messageId=null, channel='B') {
     const msgId = messageId !== null ? messageId.toString() : '';
     const fillBits = (6 - (payload.length*6)%6)%6;
     const sentence = `AIVDM,${fragmentCount},${fragmentNum},${msgId},${channel},${payload},${fillBits}`;