@meri-imperiumi/signalk-meshtastic 1.0.0 → 1.1.1

package/README.md

@@ -5,7 +5,7 @@ This plugin enables vessels running [Signal K](https://signalk.org) to interact
 
 If desired, telemetry and position information can also be shared between multiple Meshtastic-using vessels, making it effectively a "pseudo-AIS" system.
 
-![Basic Meshtastic communications](./doc/meshtastic-bequia.png)
+![Basic Meshtastic communications](https://github.com/meri-imperiumi/signalk-meshtastic/raw/main/doc/meshtastic-bequia.png)
 
 Being a mesh network, there is no need for external telecommunications infrastructure or monthly payments. This means communication between Meshtastic devices onboard and on shore can work just as well in the Finnish Archipelago Sea as in the Tuamotus. In more densely populated places communications may benefit from other Meshtastic users relaying the messages, making it possible to communicate with the boat across a city.
 
@@ -21,13 +21,15 @@ Many different kinds of Meshtastic devices are available, from basic microcontro
 > - Boat Node rebroadcasts the message.
 > - Parents’ node, unable to hear the kids directly, receives it through Boat Node.
 
+There's also an [introduction to signalk-meshtastic](https://signalk.org/2025/signalk-meshtastic/) on the Signal K website.
+
 ## Status
 
 In production use on several boats.
 
 ## Features
 
-* Connect to a Meshtastic node
+* Connect to a Meshtastic node via HTTP, TCP, or Serial
   * Keep a persistent database of all seen Meshtastic nodes
 * Update Meshtastic node position from Signal K GNSS position
 * Send Signal K alerts as Meshtastic text messages to crew
@@ -48,7 +50,8 @@ In production use on several boats.
 ## Requirements
 
 * This plugin running inside your Signal K installation
-* One [Meshtastic device](https://meshtastic.org/docs/hardware/devices/) running and connected to the same network (typically boat WiFi) as Signal K. This should be an [ESP32 based](https://meshtastic.org/docs/hardware/devices/heltec-automation/lora32/?heltec=v3) device for WiFi connectivity
+* One [Meshtastic device](https://meshtastic.org/docs/hardware/devices/) running and connected to the same network (typically boat WiFi) as Signal K. This should be an [ESP32 based](https://meshtastic.org/docs/hardware/devices/heltec-automation/lora32/?heltec=v3) device for WiFi connectivity.<br>
+  If using Serial connection, it can also be a nRF52 device
 * At least one additional Meshtastic device for the crew ashore. [Seeed T1000-e](https://meshtastic.org/docs/hardware/devices/seeed-studio/sensecap/card-tracker/) is a great option, but any battery-powered Meshtastic device will work. Having a device for each crew member is even better. In busy areas these should be set to [`CLIENT_MUTE` role](https://meshtastic.org/blog/choosing-the-right-device-role/)
 * Optionally, a Meshtastic GPS tracker device installed in the dinghy
 * Optionally, a [Meshtastic mast-top repeater](https://www.printables.com/model/1396221-meshtastic-boat-module-masthead) for greatly increased communications range
@@ -66,13 +69,13 @@ LoRa is line-of-sight communications quite similarly to VHF. Communications rang
 * Wait for some minutes for the plugin to see nearby Meshtastic nodes
 * Configure plugin and set appropriate roles for the crew and dinghy tracker Meshtastic devices
 
-![](./doc/config-crew-role.png)
+![](https://github.com/meri-imperiumi/signalk-meshtastic/raw/main/doc/config-crew-role.png)
 
 ## Telemetry sent to Meshtastic
 
 If enabled, your "boat node" will transmit the following telemetry to Meshtastic. This enables tracking various important metrics about your boat also remotely. They are visible in the device details in your Meshtastic app:
 
-![](./doc/telemetry.png)
+![](https://github.com/meri-imperiumi/signalk-meshtastic/raw/main/doc/telemetry.png)
 
 Metrics used:
 
@@ -88,5 +91,10 @@ Metrics used:
 
 ## Changes
 
+* 1.1.1 (2025-09-18)
+  - Fixed empty response text message to digital switching actions
+  - Added support for the proposed Signal K MOB position specification
+* 1.1.0 (2025-09-11)
+  - Added support for Serial transport with the Meshtastic device
 * 1.0.0 (2025-09-11)
   - Initial release with HTTP and TCP transports

package/package.json

@@ -1,10 +1,18 @@
 {
   "name": "@meri-imperiumi/signalk-meshtastic",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "Signal K plugin for interfacing with the Meshtastic LoRa mesh network",
   "scripts": {
     "test": "eslint ."
   },
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/meri-imperiumi/signalk-meshtastic.git"
+  },
+  "bugs": {
+    "url": "https://github.com/meri-imperiumi/signalk-meshtastic/issues"
+  },
+  "homepage": "https://github.com/meri-imperiumi/signalk-meshtastic#readme",
   "keywords": [
     "meshtastic",
     "signalk-node-server-plugin",
@@ -22,7 +30,8 @@
     "@bufbuild/protobuf": "^2.6.0",
     "@meshtastic/core": "^2.6.7",
     "@meshtastic/transport-http": "^0.2.5",
-    "@meshtastic/transport-node": "^0.0.2"
+    "@meshtastic/transport-node": "^0.0.2",
+    "@meshtastic/transport-node-serial": "^0.0.2"
   },
   "devDependencies": {
     "eslint": "^8.57.1",

package/plugin/commands/switching.js

@@ -24,8 +24,6 @@ module.exports = {
           return;
         }
         resolve();
-        device.sendText(res.message, msg.from, true, false)
-          .catch((e) => app.error(`Failed to send message: ${e.message}`));
       });
     })
       .then(() => device.sendText(`OK, ${light} is ${switching[2]}`, msg.from, true, false));

package/plugin/index.js

@@ -9,6 +9,7 @@ const { vesselIcon } = require('./waypoint');
 let MeshDevice;
 let TransportHTTP;
 let TransportNode;
+let TransportNodeSerial;
 let create;
 let toBinary;
 let Protobuf;
@@ -221,6 +222,10 @@ module.exports = (app) => {
     })
     .then((lib) => {
       TransportNode = lib.TransportNode;
+      return import('@meshtastic/transport-node-serial');
+    })
+    .then((lib) => {
+      TransportNodeSerial = lib.TransportNodeSerial;
       return import('@bufbuild/protobuf');
     })
     .then((lib) => {
@@ -490,6 +495,9 @@ module.exports = (app) => {
         if (settings.device && settings.device.transport === 'http') {
           return TransportHTTP.create(settings.device.address);
         }
+        if (settings.device && settings.device.transport === 'serial') {
+          return TransportNodeSerial.create(settings.device.address);
+        }
         return TransportNode.create(settings.device.address);
       })
       .then((transport) => {
@@ -831,18 +839,36 @@ module.exports = (app) => {
                     .catch((e) => app.error(`Failed to send alert: ${e.message}`));
                   if (v.path.indexOf('notifications.mob.') === 0) {
                     // This is a notification about a MOB beacon, create waypoint
-                    const mmsi = v.path.split('.').at(-1);
-                    const mobVessel = app.signalk.root.vessels[`vessels.urn:mrn:imo:mmsi:${mmsi}`];
-                    if (!mobVessel || !mobVessel.navigation.position) {
+                    let mobPosition;
+                    let mmsi = 9712234567;
+                    let mobVessel = {
+                      name: 'MOB beacon',
+                      mmsi,
+                    };
+                    if (v.value.data && v.value.data.position) {
+                      // There is a proposal to include position in the notification
+                      mobPosition = v.value.data.position;
+                      if (v.value.data.mmsi) {
+                        mobVessel.mmsi = mmsi;
+                      }
+                    } else {
+                      // See if the MOB can be found from Signal K tree
+                      mmsi = v.path.split('.').at(-1);
+                      mobVessel = app.signalk.root.vessels[`vessels.urn:mrn:imo:mmsi:${mmsi}`];
+                      if (mobVessel && mobVessel.navigation.position) {
+                        mobPosition = mobVessel.navigation.position;
+                      }
+                    }
+                    if (!mobPosition) {
                       return;
                     }
                     const setWaypointMessage = create(Protobuf.Mesh.WaypointSchema, {
                       id: mmsi,
-                      latitudeI: Math.floor(mobVessel.navigation.position.value.latitude / 1e-7),
-                      longitudeI: Math.floor(mobVessel.navigation.position.value.longitude / 1e-7),
+                      latitudeI: Math.floor(mobPosition.latitude / 1e-7),
+                      longitudeI: Math.floor(mobPosition.longitude / 1e-7),
                       expire: Math.floor((new Date().getTime() / 1000) + (1 * 60 * 60)),
-                      name: mobVessel.name || `Beacon ${mmsi}`,
-                      description: `AIS beacon ${mmsi}`,
+                      name: mobVessel.name || `Beacon ${mobVessel.mmsi}`,
+                      description: `MOB beacon ${mobVessel.mmsi}`,
                       icon: vesselIcon(mobVessel),
                     });
                     device.sendWaypoint(setWaypointMessage, 'broadcast', 0)
@@ -941,6 +967,10 @@ module.exports = (app) => {
                   const: 'http',
                   title: 'HTTP (nodes connected to same network, typically ESP32)',
                 },
+                {
+                  const: 'serial',
+                  title: 'Serial port (use full path to serial device as "address")',
+                },
               ],
             },
             address: {