smithtek-mako-rf 3.3.3 → 3.4.0

package/UPSTREAM.md

@@ -0,0 +1,3 @@
+# Package history
+
+This package continues smithtek-mako-rf by Smithtek, licensed GPL-3.0-only. The original Mako RF nodes remain included. Version 3.4.0 adds PassPort Connect for V-net projects alongside those nodes. Existing node identifiers are preserved so saved flows remain compatible.

package/bus-engine.js

@@ -80,7 +80,7 @@ module.exports = function createEngine(ModbusRTU) {
     if (state.client && state.client._makoRetiring) await retire(state);
     if (state.client && state.client.isOpen) return;
     if (state.client) await retire(state);
-    const path = cfg.serialPort;
+    const path = cfg.serialPort && await operation(state,'USB detection',5000,() => require('./usb-discovery').resolve(cfg.serialPort,state));
     if (!path) throw error('No serial port configured', 'ECONFIG');
     const owner = owners.get(path);
     if (owner && owner !== state) throw error('Serial port already owned by another Mako bus: ' + path, 'EPORTBUSY');
@@ -204,7 +204,7 @@ module.exports = function createEngine(ModbusRTU) {
     const cooldown = bounded(state.cfg.offlineCooldown_s,0,0,300);
     // After the first failed retry group, one probe is enough to discover a
     // returning device. Do not monopolize the bus with another retry group.
-    const tries = offline && cooldown > 0 && item.req.mode === 'read' ? 1 : Math.floor(bounded(state.cfg.retries, 2, 0, 10)) + 1;
+    const tries = offline && cooldown > 0 && item.req.mode === 'read' ? 1 : Math.floor(bounded(item.retries == null ? state.cfg.retries : item.retries, 2, 0, 10)) + 1;
     let result, lastErr;
     for (let attempt = 1; attempt <= tries && !state.closing && !item.node._makoClosed; attempt++) {
       try {

package/channel-map.mjs

@@ -0,0 +1,54 @@
+const hasOwn=(o,k)=>Object.prototype.hasOwnProperty.call(o,k);
+// Shared by the V-net exporter and the local Node-RED node. No transport dependencies.
+export const widths={float32:2,int32:2,uint32:2,int16:1,uint16:1,boolean:1};
+export function identity(map){return 'passport-link-v1:'+JSON.stringify([map.unitId,map.channels.map(c=>[c.kind,c.index,c.name,c.dataType,c.address,c.slot,!!c.pulseOnWrite,c.pulseMs||250])]);}
+export function validateMap(map){
+ if(!map||map.schema!=='smithtek.passport-channels'||map.version!==1||!Number.isInteger(map.unitId)||map.unitId<1||map.unitId>247||!Array.isArray(map.channels)||map.channels.length<1||map.channels.length>64)throw Error('Invalid PassPort channel mapping');
+ const names=new Set(),slots=new Set(),used=new Set(),indices={analog:0,switches:0};
+ for(const c of map.channels){
+  if(!['analog','switches'].includes(c.kind)||c.index!==indices[c.kind]++||typeof c.name!=='string'||!c.name.trim()||c.name.length>40||names.has(c.name)||['__proto__','constructor','prototype'].includes(c.name)||!Number.isInteger(c.slot)||c.slot<0||c.slot>63||slots.has(c.slot)||!hasOwn(widths,c.dataType)||(c.kind==='switches')!==(c.dataType==='boolean')||!Number.isInteger(c.address)||c.address<0||c.address+widths[c.dataType]>65536)throw Error('Invalid channel name, order, type or address');
+  if(c.pulseOnWrite&&(c.kind!=='switches'||!Number.isInteger(c.pulseMs)||c.pulseMs<1||c.pulseMs>1000))throw Error('Invalid Digital pulse settings');
+  names.add(c.name);slots.add(c.slot);for(let i=0;i<widths[c.dataType];i++){const key=c.kind+':'+(c.address+i);if(used.has(key))throw Error('Overlapping channel addresses');used.add(key);}
+ }
+ if(map.mappingId!==identity(map))throw Error('Mapping identity does not match its channels');return map;
+}
+export function createMap(unitId,rows){const indices={analog:0,switches:0};const map={schema:'smithtek.passport-channels',version:1,unitId,channels:rows.map(r=>{const kind=r.area==='coil'?'switches':'analog';return {kind,index:indices[kind]++,name:r.name.trim(),slot:r.slot,address:r.address,dataType:kind==='switches'?'boolean':r.dataType||'float32',...(r.pulseOnWrite?{pulseOnWrite:true,pulseMs:r.pulseMs??250}:{})};})};map.mappingId=identity(map);return validateMap(map);}
+export function encode(c,value){
+ if(c.dataType==='boolean'){if(value===true||value===1)return [true];if(value===false||value===0)return [false];throw Error(c.name+': use TRUE/FALSE or 1/0');}
+ const limits={int16:[-32768,32767],uint16:[0,65535],int32:[-2147483648,2147483647],uint32:[0,4294967295],float32:[-3.4028234663852886e38,3.4028234663852886e38]};
+ if(typeof value!=='number'||!Number.isFinite(value)||value<limits[c.dataType][0]||value>limits[c.dataType][1]||(c.dataType!=='float32'&&!Number.isInteger(value)))throw Error(c.name+': value does not fit '+c.dataType);
+ if(widths[c.dataType]===1)return [value&65535];const b=new DataView(new ArrayBuffer(4));if(c.dataType==='float32')b.setFloat32(0,value);else if(c.dataType==='int32')b.setInt32(0,value);else b.setUint32(0,value);return [b.getUint16(2),b.getUint16(0)];
+}
+export function decode(c,values){if(c.dataType==='boolean'){if(![true,false,0,1].includes(values[0]))throw Error('Invalid Digital reply');return !!values[0];}if(values.length!==widths[c.dataType]||values.some(v=>!Number.isInteger(v)||v<0||v>65535))throw Error('Invalid Analog reply');if(widths[c.dataType]===1)return c.dataType==='int16'&&values[0]>32767?values[0]-65536:values[0];const b=new DataView(new ArrayBuffer(4));b.setUint16(0,values[1]);b.setUint16(2,values[0]);const v=c.dataType==='float32'?b.getFloat32(0):c.dataType==='int32'?b.getInt32(0):b.getUint32(0);if(!Number.isFinite(v))throw Error('Non-finite Analog reply');return v;}
+export function groups(map){validateMap(map);const result=[];for(const kind of ['analog','switches']){let g;for(const c of map.channels.filter(c=>c.kind===kind).sort((a,b)=>a.address-b.address)){if(!g||c.address!==g.end||c.address+widths[c.dataType]-g.address>32){g={kind,address:c.address,end:c.address,channels:[]};result.push(g);}g.channels.push(c);g.end+=widths[c.dataType];}}return result;}
+export function plan(map,mode,payload){const all=groups(map);if(!['read','write'].includes(mode))throw Error('Choose Read or Write');let encoded;
+ if(mode==='write'){
+  if(!payload||typeof payload!=='object'||Array.isArray(payload)||payload.mappingId!==map.mappingId)throw Error('Write needs the matching mappingId and analog and/or switches arrays');
+  if(Object.keys(payload).some(k=>!['mappingId','analog','switches'].includes(k)))throw Error('Unknown channel array');
+  encoded=new Map();let provided=false;
+  for(const kind of ['analog','switches'])if(hasOwn(payload,kind)){provided=true;const channels=map.channels.filter(c=>c.kind===kind);if(!Array.isArray(payload[kind])||payload[kind].length!==channels.length)throw Error(kind+' array must contain exactly '+channels.length+' values');for(const c of channels)encoded.set(c.slot,encode(c,payload[kind][c.index]));}
+  if(!provided||!encoded.size)throw Error('Provide at least one non-empty channel array');
+ }
+ return all.filter(g=>mode==='read'||hasOwn(payload,g.kind)).map(g=>({group:g,req:{mode,unitid:map.unitId,fc:mode==='read'?(g.kind==='switches'?1:3):(g.kind==='switches'?15:16),address:g.address,...(mode==='read'?{quantity:g.end-g.address}:{value:g.channels.flatMap(c=>encoded.get(c.slot))})}}));
+}
+export function emptyResult(map){return {mappingId:map.mappingId,analog:[],switches:[]};}
+export function applyRead(result,group,data){
+ const expected=group.end-group.address;
+ // Coil replies are packed into whole bytes. modbus-serial expands the last
+ // byte too, so unused trailing bits are valid but are not mapped channels.
+ const padded=group.kind==='switches'?Math.ceil(expected/8)*8:expected;
+ if(!Array.isArray(data)||(data.length!==expected&&data.length!==padded))throw Error('Incomplete channel reply: expected '+expected+' '+(group.kind==='switches'?'digital values':'registers')+', received '+(Array.isArray(data)?data.length:'no data'));
+for(const c of group.channels)result[c.kind][c.index]=decode(c,data.slice(c.address-group.address,c.address-group.address+widths[c.dataType]));return result;}
+
+export function namedValues(map,result){return Object.fromEntries(map.channels.map(c=>[c.name,result[c.kind][c.index]]));}
+// Resolve only supplied names. Never fill omitted channels with stale/default values.
+export function planNamed(map,values){
+ validateMap(map);if(!values||typeof values!=='object'||Array.isArray(values)||!Object.keys(values).length)throw Error('Provide a named channel object');
+ const selected=new Map();for(const name of Object.keys(values)){const c=map.channels.find(c=>c.name===name);if(!c)throw Error('Unknown channel: '+name);selected.set(c.slot,encode(c,values[name]));}
+ const ops=[];for(const kind of ['analog','switches']){let op;for(const c of map.channels.filter(c=>c.kind===kind&&selected.has(c.slot)).sort((a,b)=>a.address-b.address)){
+  const v=selected.get(c.slot);if(!op||c.address!==op.req.address+op.req.value.length||op.req.value.length+v.length>32){op={req:{mode:'write',unitid:map.unitId,fc:kind==='switches'?15:16,address:c.address,value:[]}};ops.push(op);}op.req.value.push(...v);
+ }}return ops;
+}
+
+export function planSingle(map,name,value){validateMap(map);if(typeof name!=='string'||!map.channels.some(c=>c.name===name))throw Error('Choose a channel from this node table');return planNamed(map,{[name]:value});}
+export function prefixValues(values,prefix){const label=String(prefix==null?'':prefix).trim();return Object.fromEntries(Object.entries(values).map(([name,value])=>[label?label+' '+name:name,value]));}

package/channel-transform.js

@@ -0,0 +1,12 @@
+'use strict';
+const range=require('./range-scaling');
+const ops={'*':(v,n)=>v*n,'/':(v,n)=>v/n,'+':(v,n)=>v+n,'-':(v,n)=>v-n,'>':(v,n)=>v>n,'<':(v,n)=>v<n,'==':(v,n)=>v===n,'!=':(v,n)=>v!==n,'%':(v,n)=>v%n,'<<':(v,n)=>v<<n,'>>':(v,n)=>v>>n,'>>>':(v,n)=>v>>>n};
+function prepare(c){const mode=c.scaleMode||'none';if(mode==='none')return v=>v;if(c.kind==='switches')throw Error(c.name+': scaling needs an Analog channel');
+ if(mode==='range'){range.endpoints(c);return v=>range.scale(v,c);}
+ if(mode!=='math')throw Error('Unknown scaling mode');const text=String(c.scale??'').trim();let op,n;if(text!==''&&Number.isFinite(Number(text))&&!/^[+-]/.test(text)){op='*';n=Number(text);}else{const m=text.match(/^([*\/+\-]|>>>|>>|<<|==|!=|>|<|%)\s*(-?\d+(?:\.\d+)?)$/);if(m){op=m[1];n=Number(m[2]);}}
+ if(!ops[op]||!Number.isFinite(n)||((op==='/'||op==='%')&&n===0))throw Error(c.name+': invalid math expression');
+ return v=>{const result=ops[op](v,n);if(typeof result==='number'&&!Number.isFinite(result))throw Error(c.name+': math result is not finite');return result;};
+}
+function converters(map){return map.channels.map(c=>({name:c.name,apply:prepare(c)}));}
+function apply(values,converters){return Object.fromEntries(converters.map(c=>[c.name,c.apply(values[c.name])]));}
+module.exports={converters,apply};

package/package.json

@@ -1,14 +1,17 @@
 {
   "name": "smithtek-mako-rf",
-  "version": "3.3.3",
-  "description": "Smithtek dedicated node for communicating with the Mako PLC over RS485 or RF",
+  "version": "3.4.0",
+  "description": "Smithtek Mako RF and PassPort Connect nodes for Mako and Solaris readings and controls",
   "keywords": [
     "node-red",
     "smithtek",
     "modbus",
     "rtu",
     "rs485",
-    "lora"
+    "lora",
+    "passport-connect",
+    "mako",
+    "solaris"
   ],
   "license": "GPL-3.0-only",
   "author": "Smithtek",
@@ -24,5 +27,21 @@
   },
   "engines": {
     "node": ">=14"
-  }
+  },
+  "files": [
+    "smithtek-mako-rf.js",
+    "smithtek-mako-rf.html",
+    "bus-engine.js",
+    "usb-discovery.js",
+    "range-scaling.js",
+    "passport-link-node.js",
+    "channel-map.mjs",
+    "icon.png",
+    "icons",
+    "README.md",
+    "UPSTREAM.md",
+    "channel-transform.js",
+    "PASSPORT-CONNECT.md",
+    "MAKO-RF.md"
+  ]
 }

package/passport-link-node.js

@@ -0,0 +1,33 @@
+'use strict';
+module.exports=function(RED,engine){
+ const mapping=import('./channel-map.mjs'),transform=require('./channel-transform');
+ function PassPortLink(config){
+  RED.nodes.createNode(this,config);const node=this,states=new Set();node._makoClosed=false;let tail=Promise.resolve(),pending=0;
+  node.on('input',(msg,send,done)=>{
+   send=send||node.send.bind(node);done=done||function(err){if(err)node.error(err,msg);};
+   if(pending>=16){done(Error('PassPort Connect queue full'));return;}pending++;
+   const input=RED.util.cloneMessage(msg);
+   const run=async()=>{let completed=0,total=0,writing=false;
+    try{
+     const m=await mapping;if(node._makoClosed)throw Object.assign(Error('Node closed'),{code:'ECANCELLED'});
+     const map=m.validateMap(typeof config.mapping==='string'?JSON.parse(config.mapping):config.mapping);
+     const converters=config.mode==='write'?null:transform.converters(map);
+     const operations=config.mode==='write'&&config.inputMode==='single'?m.planSingle(map,config.writeChannel,input.payload):config.mode==='write'&&config.inputMode==='named'?m.planNamed(map,input.payload):m.plan(map,config.mode||'read',input.payload);total=operations.length;writing=config.mode==='write';
+     const bus=RED.nodes.getNode(config.bus);if(!bus||!bus._makoState)throw Error('Choose a PassPort connection');states.add(bus._makoState);
+     const payload=m.emptyResult(map);node.status({fill:'blue',shape:'dot',text:writing?'Writing channels':'Reading channels'});
+     for(const operation of operations){
+      if(node._makoClosed)throw Object.assign(Error('Node closed'),{code:'ECANCELLED'});
+      const res=await new Promise((resolve,reject)=>engine.enqueue(bus._makoState,{node,req:operation.req,...(writing?{retries:0}:{}),complete:(err,value)=>err?reject(err):resolve(value)}));
+      if(!writing)m.applyRead(payload,operation.group,res&&res.data);completed++;
+     }
+     if(node._makoClosed)throw Object.assign(Error('Node closed'),{code:'ECANCELLED'});
+     const output={...input,payload:writing?input.payload:m.prefixValues(transform.apply(m.namedValues(map,payload),converters),config.prefix),...(!writing?{channels:payload,ts:Date.now()}:{}),passport:{ok:true,source:config.bus+':'+map.unitId,unitId:map.unitId,mode:config.mode||'read',completed,total}};
+     send([output,null]);node.status({fill:'green',shape:'dot',text:'ID '+map.unitId+' complete'});done();
+    }catch(err){if(!node._makoClosed){node.status({fill:'red',shape:'ring',text:err.message});send([null,{...input,payload:{ok:false,error:err.message,completed,total,writeMayHaveApplied:writing&&total>0},passport:{ok:false}}]);}done(err);}
+   };
+   tail=tail.then(run,run).finally(()=>{pending--;});
+  });
+  node.on('close',(_removed,done)=>{node._makoClosed=true;states.forEach(state=>engine.detach(state,node));tail.finally(()=>{node.status({});done();});});
+ }
+ RED.nodes.registerType('smithtek-passport-link',PassPortLink);
+};

package/smithtek-mako-rf.html

@@ -339,7 +339,7 @@
       rssiGuardMs: { value: 10, validate: RED.validators.number() },
       rssiTimeoutMs: { value: 100, validate: RED.validators.number() },
 
-      // Dropdown only: RS485-1 (/dev/ttyAMA0), RS485-2 (/dev/ttyAMA1), RF (/dev/ttyAMA2)
+      // Keep imported USB/by-id paths editable as well as the built-in ports.
       serialPort: { value: "/dev/ttyAMA2", required: true },
 
       baudRate: { value: 9600, required: true, validate: RED.validators.number() },
@@ -356,6 +356,25 @@
       return this.busName || "smithtek mako rf";
     },
     oneditprepare: function () {
+      const select = $("#node-config-input-serialPort"), saved = this.serialPort || "/dev/ttyAMA2";
+      const builtins = ['/dev/ttyAMA2','/dev/ttyAMA0','/dev/ttyAMA1','usb:auto'];
+      if (!builtins.includes(saved)) $('<option>').val(saved).text('USB · saved device').appendTo(select);
+      select.val(saved);
+      const refresh = function () {
+        const current = select.val();
+        $('#st-usb-status').text('Checking USB connections…');
+        $.getJSON('smithtek-passport/usb').done(function(devices) {
+          select.find('option[data-detected]').remove();
+          devices.forEach(function(device) {
+            if (select.find('option').toArray().some(function(o){return o.value===device.value;})) return;
+            $('<option>').val(device.value).text(device.label).attr('data-detected','true').appendTo(select);
+          });
+          select.val(current);
+          $('#st-usb-status').text(devices.length ? 'USB devices found. Choose your device if more than one is connected.' : 'No USB devices found. Check power and the data cable.');
+        }).fail(function() { $('#st-usb-status').text('Unable to check USB connections. Try Refresh USB again.'); });
+      };
+      $('#st-usb-refresh').on('click',function(e){e.preventDefault();refresh();});
+      refresh();
       updateSerialUiForChannel();
       $("#node-config-input-serialPort").on("change", updateSerialUiForChannel);
     }
@@ -445,10 +464,14 @@
   <div class="form-row">
     <label for="node-config-input-serialPort"><i class="fa fa-plug"></i> Channel</label>
     <select id="node-config-input-serialPort" style="width:260px;">
+      <option value="/dev/ttyAMA2">RF</option>
       <option value="/dev/ttyAMA0">RS485-1</option>
       <option value="/dev/ttyAMA1">RS485-2</option>
-      <option value="/dev/ttyAMA2">RF</option>
+      <option value="usb:auto">USB · Auto detect</option>
     </select>
+    <button type="button" id="st-usb-refresh" class="red-ui-button">Refresh USB</button>
+    <p id="st-usb-status" class="form-tips"></p>
+    <p class="form-tips">Connect your Mako before using USB. Auto detect requires exactly one USB serial device. If several are connected, select yours. Match the PLC communication speed and format.</p>
   </div>
 
   <div class="form-row" id="st-row-baudRate">
@@ -488,7 +511,7 @@
       <label for="node-config-input-rssiGuardMs"><i class="fa fa-clock-o"></i> RSSI guard (ms)</label>
       <input type="number" id="node-config-input-rssiGuardMs" min="0" style="width:140px;">
       <span style="margin-left:8px; font-size:12px; color:#888;">
-        (The RSSI guard is the time between the Modbus poll and the RSSI read from the LoRa module 5 to 10ms is ideal)
+        (Older RF nodes only: pause before checking signal strength. Keep the default unless advised otherwise.)
       </span>
     </div>
 
@@ -496,7 +519,7 @@
       <label for="node-config-input-rssiTimeoutMs"><i class="fa fa-hourglass-end"></i> RSSI timeout (ms)</label>
       <input type="number" id="node-config-input-rssiTimeoutMs" min="10" style="width:140px;">
       <span style="margin-left:8px; font-size:12px; color:#888;">
-        (The RSSI timeout is how long the module will be givien to respond with the RSSI)
+        (Older RF nodes only: how long to wait for signal strength. PassPort Connect does not use this reading.)
       </span>
     </div>
 
@@ -507,7 +530,7 @@
     <label for="node-config-input-timeout_s"><i class="fa fa-clock-o"></i> Timeout (seconds)</label>
     <input type="number" id="node-config-input-timeout_s" style="width:140px;">
     <span style="margin-left:8px; font-size:12px; color:#888;">
-      (This is your modbus response timeout, set high to ensure you capture slow Mako responses)
+      (How long to wait for a reply. A longer wait also delays the next message if a PLC is offline.)
     </span>
   </div>
 
@@ -515,7 +538,7 @@
     <label for="node-config-input-retries"><i class="fa fa-repeat"></i> Retries</label>
     <input type="number" id="node-config-input-retries" style="width:140px;">
     <span style="margin-left:8px; font-size:12px; color:#888;">
-      (Retry will attempt to poll the same device multiple times before it timesout. Ideal for modbus writes)
+      (Extra attempts after a failed read. PassPort Connect commands are not automatically repeated.)
     </span>
   </div>
 
@@ -523,18 +546,18 @@
     <label for="node-config-input-gap_s"><i class="fa fa-arrows-h"></i> Gap (seconds)</label>
     <input type="number" id="node-config-input-gap_s" step="0.1" min="0" style="width:140px;">
     <span style="margin-left:8px; font-size:12px; color:#888;">
-      (The gap is the time between each poll, When a device has finished responded the gap will wait then start the next poll)
+      (A short pause between messages. Keep the default to start.)
     </span>
   </div>
   <div class="form-tips">
-    Select a channel. RF is for the LoRa long range radio RTU coms.
+    Choose RF for wireless, RS485 for a wired connection, or USB for a connected Mako.
   </div>
   <div class="form-row">
     <label for="node-config-input-maxQueue"><i class="fa fa-list"></i> Max queue</label>
     <input type="number" id="node-config-input-maxQueue" min="1" style="width:140px;">
   </div>
   <div class="form-tips">
-    Requests wait in order. Each request finishes or exhausts its timeout retries before the next starts. New requests are reported as failed if the queue is full.
+    Messages take turns. Max queue is the waiting-list limit. If it fills up, slow down your repeating reads.
   </div>
 
 
@@ -678,7 +701,7 @@
 <script type="text/markdown" data-help-name="smithtek-mako-rf">
 Smithtek Mako RF / RS485.
 
-Read mode outputs decoded JSON in msg.payload using the Decoder map rows. Digital points (coils, discrete inputs and register bits) output numeric 1 for on and 0 for off.
+Read mode outputs decoded JSON in msg.payload using the Decoder map rows. Numeric readings are rounded to at most six decimal places after Math or Range scaling, and remain numbers. Digital points (coils, discrete inputs and register bits) output numeric 1 for on and 0 for off.
 Raw modbus response is kept in msg.modbus.raw.
 
 Prefix adds text and one space before each decoder name. Leave blank to preserve names.
@@ -689,3 +712,137 @@ Failed requests output a named numeric alarm on output 1, for example {"b1 RF ID
 
 Each numeric decoder row starts compact with None (unchanged). Choose Math or Range to show the inline settings and enable scaling. Selecting None hides both controls and disables both calculations, while retaining the entered settings. Range maps input low/high to output low/high using a straight line; for example 4–20 maps to 0–100, with 12 mapping to 50. Use raw register endpoints, not assumed electrical units. Input endpoints must differ. Reversed ranges and negative/decimal endpoints are supported. Clamp optionally limits output to the configured range. Existing rows without a scaling mode retain their Math expression.
 </script>
+
+<script type="text/javascript">
+(function(){
+ const typeLabels={float32:'Float',uint32:'32-bit unsigned',int32:'32-bit signed',int16:'16-bit signed',uint16:'16-bit unsigned',boolean:'TRUE / FALSE'};
+ const width={float32:2,int32:2,uint32:2,int16:1,uint16:1,boolean:1};
+ function collect(){const channels=[],indices={analog:0,switches:0};$('#pl-rows tr').each(function(i){const tr=$(this),get=k=>tr.find('[data-field="'+k+'"]').val(),kind=get('kind');channels.push({...(tr.data('channel')||{}),slot:i,index:indices[kind]++,kind,name:get('name').trim(),dataType:kind==='switches'?'boolean':get('dataType'),address:Number(get('address')),pulseOnWrite:kind==='switches'&&!!(tr.data('channel')||{}).pulseOnWrite,scaleMode:kind==='switches'?'none':get('scaleMode'),scale:get('scale'),inputLow:get('inputLow'),inputHigh:get('inputHigh'),outputLow:get('outputLow'),outputHigh:get('outputHigh'),rangeCollapsed:!!tr.data('rangeCollapsed'),clampRange:tr.find('[data-field="clampRange"]').prop('checked')});});const map={schema:'smithtek.passport-channels',version:1,unitId:Number($('#pl-unit').val()),channels};map.mappingId='passport-link-v1:'+JSON.stringify([map.unitId,channels.map(c=>[c.kind,c.index,c.name,c.dataType,c.address,c.slot,!!c.pulseOnWrite,c.pulseMs||250])]);return map;}
+ function modeUi(){const write=$('#node-input-mode').val()==='write';$('.pl-write-only').toggle(write);$('.pl-read-only').toggle(!write);$('.pl-single-only').toggle(write&&$('#node-input-inputMode').val()==='single');$('.pl-table tr').each(function(){$(this).children().eq(4).toggle(!write);});}
+ function sync(){const map=collect();const choose=$('#node-input-writeChannel'),selected=choose.val()||choose.data('selected')||'';choose.empty().append($('<option>').val('').text('Choose channel…'));map.channels.forEach(c=>choose.append($('<option>').val(c.name).text(c.name+' · '+(typeLabels[c.dataType]||c.dataType))));if(selected&&!map.channels.some(c=>c.name===selected))choose.append($('<option>').val(selected).text(selected+' (not in table)'));choose.val(selected);modeUi();$('#node-input-mapping').val(JSON.stringify(map)).trigger('change');$('#pl-count').text(map.channels.length+' / 64 channels');$('#pl-add').prop('disabled',map.channels.length>=64);}
+ function row(c){const tr=$('<tr>').data('rangeCollapsed',!!c.rangeCollapsed).data('channel',c).appendTo('#pl-rows');function field(key,type,value){return $('<input>').attr({type:type||'text','data-field':key,'aria-label':key}).val(value??'');}function select(key,options,value){const el=$('<select>').attr({'data-field':key,'aria-label':key});options.forEach(o=>$('<option>').val(o[0]).text(o[1]).appendTo(el));return el.val(value);}
+ const name=field('name','text',c.name).attr('maxlength',40),kind=select('kind',[['analog','Analog'],['switches','Digital']],c.kind),type=select('dataType',Object.entries(typeLabels),c.dataType),address=field('address','number',c.address).attr({min:0,max:65535,step:1}),mode=select('scaleMode',[['none','None'],['math','Math'],['range','Range']],c.scaleMode||'none'),math=field('scale','text',c.scale).attr('placeholder','/100 or +5'),range=$('<div class="pl-range">');
+ for(const [key,label] of [['inputLow','Input low'],['inputHigh','Input high'],['outputLow','Output low'],['outputHigh','Output high']])$('<label>').text(label).append(field(key,'number',c[key]).attr('step','any')).appendTo(range);
+ $('<label>').text('Clamp ').append(field('clampRange','checkbox','').prop('checked',!!c.clampRange)).appendTo(range);
+ const toggle=$('<button type="button" class="red-ui-button">').on('click',()=>{tr.data('rangeCollapsed',!tr.data('rangeCollapsed'));visibility();sync();});
+ for(const control of [name,kind,type,address])$('<td>').append(control).appendTo(tr);$('<td>').append($('<div style="display:flex;gap:5px;align-items:center">').append(mode,toggle),math,range).appendTo(tr);
+ const buttons=$('<td>');for(const [label,action] of [['↑',()=>{tr.prev().before(tr);sync();}],['↓',()=>{tr.next().after(tr);sync();}],['×',()=>{tr.remove();sync();}]])$('<button type="button" class="red-ui-button">').text(label).attr('aria-label',label==='×'?'Remove channel':label==='↑'?'Move channel up':'Move channel down').on('click',action).appendTo(buttons);buttons.appendTo(tr);
+ function visibility(){const sw=kind.val()==='switches';if(sw){type.val('boolean');mode.val('none');}else if(type.val()==='boolean')type.val('float32');type.prop('disabled',sw);mode.prop('disabled',sw);math.toggle(mode.val()==='math');const isRange=mode.val()==='range',collapsed=!!tr.data('rangeCollapsed');range.toggle(isRange&&!collapsed);toggle.toggle(isRange).text(collapsed?'Show range':'Hide range').attr('aria-expanded',String(!collapsed)).css({whiteSpace:'nowrap',flexShrink:0});}
+ mode.on('change',()=>{if(mode.val()==='range')tr.data('rangeCollapsed',false);});
+ kind.on('change',()=>{const others=collect().channels.filter((_,i)=>i!==tr.index()).filter(c=>c.kind===kind.val());address.val(others.reduce((end,c)=>Math.max(end,c.address+(width[c.dataType]||1)),0));});
+ tr.on('input change','input,select',()=>{visibility();sync();});visibility();
+ }
+ function valid(value){try{const m=typeof value==='string'?JSON.parse(value):value;if(!m||!Number.isInteger(m.unitId)||m.unitId<1||m.unitId>247||!m.channels.length||m.channels.length>64)return false;const names=new Set(),used=new Set();return m.channels.every(c=>{if(!c.name||names.has(c.name)||['__proto__','constructor','prototype'].includes(c.name)||!width[c.dataType]||!Number.isInteger(c.address)||c.address<0||c.address+width[c.dataType]>65536)return false;names.add(c.name);for(let i=0;i<width[c.dataType];i++){const k=c.kind+':'+(c.address+i);if(used.has(k))return false;used.add(k);}if(c.scaleMode==='range'){const vals=['inputLow','inputHigh','outputLow','outputHigh'].map(k=>c[k]);if(vals.some(v=>v===''||!Number.isFinite(Number(v)))||Number(vals[0])===Number(vals[1]))return false;}if(c.scaleMode==='math'){const s=String(c.scale||'').trim();if(!s||(!Number.isFinite(Number(s))&&!/^([*\/+\-]|>>>|>>|<<|==|!=|>|<|%)\s*(-?\d+(?:\.\d+)?)$/.test(s))||/^[/%%]\s*-?0(?:\.0+)?$/.test(s))return false;}return true;});}catch(e){return false;}}
+ RED.nodes.registerType('smithtek-passport-link',{
+ category:'Smithtek',paletteLabel:'PassPort Connect',color:'#6D6D6D',defaults:{prefix:{value:''},writeChannel:{value:'',validate:function(v){if(this.mode!=='write'||this.inputMode!=='single')return true;try{return JSON.parse(this.mapping).channels.some(c=>c.name===v);}catch(e){return false;}}},name:{value:''},bus:{value:'',type:'smithtek-mako-rf-bus',required:true},mode:{value:'read',required:true},inputMode:{value:'single'},mapping:{value:'',required:true,validate:valid}},inputs:1,outputs:2,icon:'passport-connect-cropped.png',label:function(){return this.name||'PassPort Connect';},outputLabels:['Named data / write confirmed','Error'],
+ oneditprepare:function(){$('#node-input-writeChannel').data('selected',this.writeChannel||'').on('change',function(){$(this).data('selected',$(this).val());});$('#node-input-mode,#node-input-inputMode').on('change',modeUi);$('#node-input-inputMode').val(this.inputMode||'arrays');let map;try{map=typeof this.mapping==='string'?JSON.parse(this.mapping):this.mapping;}catch(e){}$('#pl-unit').val(map?.unitId||1);$('#pl-rows').empty();(map?.channels||[]).forEach(row);$('#pl-unit').on('input change',sync);$('#pl-add').on('click',function(){const channels=collect().channels,kind=$('#pl-add-kind').val(),label=kind==='switches'?'Digital':'Analog';let address=0;channels.filter(c=>c.kind===kind).forEach(c=>address=Math.max(address,c.address+width[c.dataType]));let i=1;while(channels.some(c=>c.name===label+' '+i))i++;row({name:label+' '+i,kind,dataType:kind==='switches'?'boolean':'float32',address});sync();});sync();},oneditsave:function(){sync();this.mapping=$('#node-input-mapping').val();}
+ });
+})();
+</script>
+<style>
+.pl-table{width:100%;border-collapse:collapse}.pl-table td,.pl-table th{padding:5px;text-align:left;vertical-align:top}.pl-table input,.pl-table select{width:100%;min-width:75px}.pl-table td:first-child{min-width:140px}.pl-table td:last-child{white-space:nowrap}.pl-table td:last-child button{padding:0 6px}.pl-range{display:grid;grid-template-columns:1fr 1fr;gap:5px;min-width:220px}.pl-range label{font-size:11px;margin:0!important;width:auto!important}.pl-range input[type=checkbox]{width:auto;min-width:0}.pl-table [data-field=scale]{margin-top:5px}
+</style>
+<script type="text/html" data-template-name="smithtek-passport-link">
+ <div class="form-row"><label for="node-input-name">Name</label><input id="node-input-name" type="text"></div>
+ <div class="form-row"><label for="node-input-bus">Connection</label><input id="node-input-bus"></div>
+ <div class="form-row"><label for="node-input-mode">Action</label><select id="node-input-mode"><option value="read">Read channels</option><option value="write">Write channels</option></select></div>
+ <div class="form-row pl-write-only"><label for="node-input-inputMode">Write input</label><select id="node-input-inputMode"><option value="single">Single channel</option><option value="arrays">Mapped arrays</option><option value="named">Named values</option></select></div>
+ <div class="form-row pl-single-only"><label for="node-input-writeChannel">Write channel</label><select id="node-input-writeChannel"></select></div>
+ <div class="form-row pl-read-only"><label for="node-input-prefix">Prefix</label><input id="node-input-prefix" type="text" placeholder="e.g. North Mako"></div>
+ <div class="form-row"><label for="pl-unit">Unit ID</label><input id="pl-unit" type="number" min="1" max="247"></div>
+ <input id="node-input-mapping" type="hidden">
+ <p><b>Separate Read and Write nodes:</b> copy and paste your complete Read node, then change the copy’s Action to Write. This copies the whole table. Choose the row you want to control. Later changes to one node do not update the other.</p>
+ <p class="pl-write-only"><b>Single channel:</b> select Pump, then inject a Boolean true/false into msg.payload; select a setpoint and inject a number. Only that channel is written. <b>Named values:</b> send {"Pump":true,"Setpoint":25}; only supplied names are written. Names are case-sensitive and use the table names without the read Prefix. <b>Mapped arrays:</b> send matching mappingId plus Analog and/or Digital arrays (JSON keys analog and switches) in table order. These are ordered values, not named objects.</p>
+ <p class="pl-read-only"><b>Prefix:</b> helps you label readings. North Mako plus Level appears as "North Mako Level". Commands still use the original row name, Level.</p>
+
+ <div style="overflow:auto"><table class="pl-table"><thead><tr><th>Name</th><th>Data type</th><th>Value type</th><th>Address</th><th>Read scaling</th><th>Order / remove</th></tr></thead><tbody id="pl-rows"></tbody></table></div>
+ <p><select id="pl-add-kind" aria-label="New channel kind" style="width:120px"><option value="analog">Analog</option><option value="switches">Digital</option></select> <button id="pl-add" type="button" class="red-ui-button">Add channel</button> <span id="pl-count"></span></p>
+ <p>Keep this table matched to the PLC. Moving a row does not change its address. Changes here do not change the PLC program. Export again from V-net after changing the PLC table.</p>
+ <p>Math and Range change named read values. Arrays in msg.channels keep the original values. Write inputs use device units; scaling is not applied to commands. Update matching nodes after changing the table.</p>
+</script>
+<script type="text/html" data-help-name="smithtek-passport-link">
+<p>PassPort Connect (PPC) is Smithtek’s proprietary communication link between PassPort, Mako and Solaris. It lets your PassPort read measurements and send commands to a Mako or Solaris. For example, you can check a tank level, change a setting or start a pump.</p>
+<p>The smithtek-mako-rf package includes two communication nodes. Original Mako RF is for basic Modbus reads and writes. PassPort Connect is for the matching PassPort Connect table in V-NET2. Choose PassPort Connect for this guide; the two nodes use different message formats.</p>
+<p>In V-NET2, use the PassPort Connect logic block to choose the readings and controls you want to share. Export from that logic block to create matching Read and Write nodes in Node-RED. Read means “tell me the values”; Write means “change this value”.</p>
+<h3>Setup</h3><ol><li>In V-NET2, click New project in the top toolbar. Enter a project name, choose Mako or Solaris, then create the project. Save any existing work you want to keep.</li><li>In the logic-block library on the right of V-NET2, open Communication and click PassPort Connect. Read the introduction, then click Add PassPort Connect to place the logic block on your diagram.</li><li>Click the PassPort Connect logic block on your V-NET2 diagram. In its Properties panel on the left, enter a Unit ID from 1 to 247. Give every PLC sharing a PassPort connection a different Unit ID. Set Connections to the number of communication links this logic block will use.</li><li>In that same Properties panel, click Edit Analog &amp; Digital table. Add a row for each reading or control, enter a clear name such as Tank level or Pump start, and choose its value type and starting value. Click Apply table to save the table to the logic block.</li><li>On the V-NET2 diagram, wire each measurement to its named input on the left of the PassPort Connect logic block. Wire each control from its named output on the right to the equipment output or logic block it should operate.</li><li>Select the PassPort Connect logic block again. In its left-hand Properties panel, click PassPort Connect · export nodes. This opens the connection and export window.</li><li>In that window, under Match the connections, choose the communication port used on your Mako or Solaris and the port used on your PassPort. For example, choose RF on both sides for radio, or Solaris RS485 and PassPort RS485-1 for a wired link. Open Review or change settings before export and check the settings for your chosen connection.</li><li>In the same window, click Export read &amp; write nodes. Choose a filename and folder, then save. V-NET2 creates the Node-RED JSON file and adds any missing Send and Receive wires to the selected PLC port on your diagram. Existing wires are kept. Apply settings is available if you want to save these connection choices without exporting a file.</li><li>Back in V-NET2, save the project using Save in the toolbar. When ready, use Build program to build and upload it to the selected PLC. The export file alone does not update the PLC. If using RF, also set the PassPort radio to match the PLC.</li><li>In Node-RED, open the flow page where you want the nodes. Open the menu, choose Import, select the JSON file saved by V-NET2 and choose Current flow. Click Import and place the Read and Write nodes on that page. Do not paste this JSON into an existing node’s settings.</li><li>In Node-RED, double-click each imported node to check its Action, Unit ID and Connection. Add an Inject node before Read and connect a Debug node to each output. Leave Inject once after startup and Repeat off for this first test. Click Deploy, then press the Inject button to read the PLC.</li></ol>
+<h3>1 · Choose your connection</h3>
+<dl><dt>RF · Mako or Solaris</dt><dd>Choose RF at both ends. Match the frequency, range and Network ID on the PLC and PassPort. If you use an encryption key, match that too.</dd><dt>RS485 · Mako</dt><dd>Choose RS485-1 or RS485-2 on the Mako and the wired port you are using on PassPort. Connect A to A and B to B. Match the baud rate and serial format at both ends.</dd><dt>RS485 · Solaris</dt><dd>Choose RS485 for Solaris and RS485-1 or RS485-2 for PassPort. Connect A to A and B to B. Set the Solaris serial switch to RS485. It uses the shared Monitor / RS485 Send and Receive pins. Match the baud rate and serial format at both ends.</dd><dt>USB · Mako</dt><dd>Connect the Mako USB socket above RS485-1 to a PassPort USB slot with the specified USB-A to USB-A data cable. Choose USB in V-NET2. This uses the Mako Monitor Send and Receive pins. In Node-RED, USB · Auto detect finds a single connected USB serial device. If several are connected, use Refresh USB and choose your device in Connection.</dd></dl>
+<p>USB detection runs on the PassPort, where the cable is plugged in. It finds available USB connections; it cannot prove that a device is a Mako. Confirm the selected device and Unit ID with a test read before sending commands. With several devices connected, choose the right one rather than letting the software guess.</p>
+<p>If no USB device is found, check power and the data cable, then refresh the list. Devices with a unique identity can be found again if their connection number changes. If a device has no unique identity, check the selection again after unplugging or restarting.</p>
+<p>Solaris has one shared Monitor / RS485 port. In your V-NET2 diagram, if a sensor logic block already uses that port, choose RF for the PassPort Connect logic block. The same Send port cannot be connected to both the sensor logic block and the PassPort Connect logic block.</p>
+<p>Changing the export settings does not change the PassPort radio. Set that separately. Short range and Long range are radio settings, not promises about how far a signal will travel.</p>
+<p>Keep the selected connection for PassPort messages. Do not also send ordinary Monitor text over it: mixed messages can stop readings and commands from working.</p>
+<h3>2 · Make your channel table</h3>
+<dl><dt>Float</dt><dd>A 32-bit floating-point number, such as 12.5 volts. Stores about seven significant digits. Large whole numbers can round: 123456789 becomes 123456792. Choose 32-bit unsigned or 32-bit signed when you need that whole number exactly.</dd><dt>16-bit signed</dt><dd>Whole numbers from −32768 to 32767.</dd><dt>16-bit unsigned</dt><dd>Whole numbers from 0 to 65535.</dd><dt>32-bit signed</dt><dd>Whole numbers from −2147483648 to 2147483647.</dd><dt>32-bit unsigned</dt><dd>Whole numbers from 0 to 4294967295.</dd><dt>Digital</dt><dd>On or off: true or false. Use this for switches and simple controls.</dd></dl>
+<p>An Analog row holds a number. A Digital row holds on or off. Mako supports up to 64 rows; Solaris supports up to 16, with space also needed for the rest of your program.</p>
+<p>Use a different name for each row, up to 40 characters. Capital letters matter: Pump and pump are different names. The editor will tell you if a name cannot be used.</p>
+<p>V-NET2 works out the table addresses for you. An address is simply where a value is kept. Leave these alone when using an exported table.</p>
+<p>Keep the PLC table and both Node-RED tables the same. After changing a table in V-NET2, upload the changed PLC program and export fresh nodes. Replace the old nodes so you do not accidentally read or send commands twice.</p>
+<p>Starting values apply when the PLC starts. They do not make Node-RED send a command. A signal wired into a row on the left can keep replacing a command sent from PassPort. Leave that input unwired for a remote-only control.</p>
+<p>Use a separate feedback row when you need to know what actually happened. A Pump start command and a Pump running sensor tell you different things.</p>
+<h3>3 · Read your measurements</h3>
+<p>A Read node waits until another node asks it to work. Connect an Inject node to its input and press the Inject button. Each press reads the whole table. The value inside the Inject message does not choose a channel.</p>
+<p>To start, leave Repeat and Inject once after startup off. After a successful test, you can set Inject to repeat. Allow enough time for one reading to finish before asking again.</p>
+<p>Connect a Debug node to the first output to see successful readings. Values are listed by their table names in msg.payload. For example, {&quot;Level&quot;:12.5,&quot;Pump&quot;:false} means the level is 12.5 and the Pump value is off.</p>
+<p>The second output reports problems. If part of a read fails, the node reports an error instead of sending an incomplete set of readings.</p>
+<p>The PLC may need several requests to return a table. Values are collected one after another, so they are not all measured at exactly the same moment.</p>
+<p>Prefix helps you tell PLCs apart. Enter North Mako and a row called Level appears as North Mako Level in the readings. The row name used for commands is still Level.</p>
+<p>For more detailed flows, msg.ts records when Node-RED finished the read. It is not the time the PLC measured each value. msg.channels holds the original, unscaled numbers and on/off values; msg.passport holds the result and progress details. Most everyday flows only need msg.payload.</p>
+<h3>4 · Send a command</h3>
+<dl><dt>Single channel · easiest</dt><dd>Choose the row in Write channel. Send a number for Analog, or Boolean true / false for Digital. Only that row changes.</dd><dt>Named values</dt><dd>Send a JSON object such as {&quot;Pump&quot;:true,&quot;Setpoint&quot;:25}. Only the named rows change. Use the exact table names, without a read Prefix.</dd><dt>Mapped arrays · advanced</dt><dd>Use this only if your flow already works with lists of values. Send the matching mappingId and the full Analog or Digital list in table order. The Digital list is called switches.</dd></dl>
+<p>Open the Write node, choose Single channel, then choose the row you want to control. Exported writers initially select the first row, so always check this before connecting commands.</p>
+<p>In Inject, choose number for a numeric setting or Boolean for an on/off command. Do not choose string: the text “true” is not the same as the Boolean value true. For several named values, choose JSON.</p>
+<p>Analog commands must fit the row type. Whole-number rows need whole numbers. Digital accepts true and false, or 1 and 0. Send an ordinary number even for a 32-bit row; the node handles its size.</p>
+<p>The first output confirms that the PLC answered the command. It does not prove a motor turned or a valve moved. Read a feedback sensor to check the equipment.</p>
+<p>Commands are not automatically repeated after a failed reply. A PLC can receive a command even when its reply is lost. Check the equipment or read it back before repeating a start, reset or pulse command.</p>
+<p>If you change several values together and a later part fails, earlier values may already have changed. Read the values back before deciding what to send next.</p>
+<p>Do not connect Read straight into Write. That can turn every repeat reading into another command. Make separate buttons or control logic for the changes you intend.</p>
+<p>For advanced list-based flows, move the unscaled msg.channels object into msg.payload before using it as a Mapped arrays command. A one-Analog, one-Digital table could use {&quot;mappingId&quot;:&quot;the matching table ID&quot;,&quot;analog&quot;:[25],&quot;switches&quot;:[true]}. Keep each supplied list complete and in order. The table ID checks the message against the node; it does not check which program was uploaded to the PLC.</p>
+<h3>5 · Short pulses, remote resets and lost communication</h3>
+<p>Pulse on write works like a quick button press. Turn it on for a Digital row in V-NET2. A command turns the output on briefly, then it turns off by itself. The default is 250 milliseconds, or a quarter of a second. You can choose 1 to 1000 milliseconds.</p>
+<p>This is useful for remote resets or restarts. For example, connect a Reset pulse to the reset input of the equipment logic you want to restart. Connect it to the PLC Reset input only when you intend to restart the whole PLC. A PLC restart interrupts communication, so its reply may be lost.</p>
+<p>Each accepted write triggers a pulse, even a repeated value or false. Send one true command for each intended press. Do not send a second false command to release it: that would trigger another pulse. Another command during a pulse extends it. Reading the row does not trigger it.</p>
+<p>Pulse settings belong to the PLC program. Save and upload after changing them, then export matching nodes.</p>
+<p>The communications watchdog is a way for your program to notice missing messages. Set Timeout to the number of seconds it should wait. Zero turns it off.</p>
+<p>If no valid communication arrives for that whole time, Watchdog sends false once. It waits another full timeout before checking for recovery. It sends true once when recent communication has returned, or waits and checks again if it has not. It sends no startup command.</p>
+<p>Choose the response by wiring Watchdog into your program. It does not stop a pump or clear other values by itself. Use regular reads if you rely on them to keep communication active; manual clicks leave gaps between messages.</p>
+<h3>6 · Copy a node and adjust how readings look</h3>
+<p>A useful tip: copy and paste your complete Read node, then change the copy’s Action to Write. This copies the entire channel table and connection settings, so you do not have to work out the table again. Choose Single channel and select the row you want to control before using it.</p>
+<p>The copy is independent. Later edits to one node do not change the other. Keep both tables matched to the uploaded PLC program.</p>
+<p>Scaling changes how a reading is displayed. For example, Math /100 turns 1250 into 12.5. None leaves it unchanged. Math allows one simple operation, such as *2, /100, +5 or -7. Do not enter a long formula.</p>
+<p>Range converts between two scales. For example, Input low 4 and Input high 20, with Output low 0 and Output high 100, turns a 4–20 reading into 0–100. Clamp keeps the displayed result inside that range. Without Clamp, readings outside the input range can produce results below or above the output range.</p>
+<p>Hide range only folds the settings away; it does not turn scaling off. Choose None to stop scaling. Scaling is for Analog rows.</p>
+<p>Scaling and Prefix change named readings only. They do not change the PLC or commands. If /100 displays a stored value of 1250 as 12.5, a Write command still needs 1250 to request that original value.</p>
+<p>You normally do not need to edit addresses. If you do, they must match the PLC. Moving rows in Node-RED does not change their addresses. Exporting again from V-NET2 uses the V-NET2 table and does not keep separate edits made in Node-RED.</p>
+<h3>7 · Sharing a connection and avoiding delays</h3>
+<p>PLCs using the same PassPort RF or wired port share one Connection setting. Select that existing Connection in each Read and Write node. Give each PLC its own Unit ID.</p>
+<p>Think of the connection as a single lane: messages take turns. A long table or a PLC that does not answer can hold up the next message, including a command.</p>
+<p>Timeout is how long PassPort waits for an answer. Read retries is how many extra times it tries a failed read. The exported defaults wait up to 8 seconds and allow 2 extra read attempts. Commands do not use these extra attempts.</p>
+<p>A queue is a waiting list of messages. If you ask for readings too quickly, the list grows and replies get late. Slow down the Inject repeat rate and remove duplicate triggers if this happens.</p>
+<p>Each Read or Write node can have up to 16 waiting messages. The shared connection also has a limit. Use a Catch node to show queue-full errors, as well as Debug on the second output for other problems.</p>
+<p>Start with one PLC and manual reads. Add regular reads and other PLCs gradually, checking how long replies take. Signal conditions and the amount of information affect the speed.</p>
+<p>Signal-strength options used by the older RF node do not add a signal-strength reading to PassPort Connect.</p>
+<h3>8 · If something is not working</h3>
+<dl><dt>Unknown node after import</dt><dd>Check that PassPort Connect is available in your Node-RED palette. If it is missing, ask your installer to update PassPort Connect.</dd><dt>No reading after Deploy</dt><dd>Press the Inject button. Deploy saves the flow; it does not ask for a reading.</dd><dt>No answer or timeout</dt><dd>Check power, cables, Unit ID and matching communication settings. Confirm you uploaded the intended PLC program. For USB, refresh the detected-device list and confirm your selection.</dd><dt>Numbers look wrong</dt><dd>Compare the table and value types with V-NET2. Check whether scaling has changed the displayed number.</dd><dt>A command is rejected</dt><dd>Check the selected row, spelling and value type. If using lists, check they match the whole current table.</dd><dt>A command changes back immediately</dt><dd>Look for a local signal or other logic that keeps writing to that row.</dd><dt>A command reports an error</dt><dd>Check the equipment and read the value back. The command may have arrived even if its reply did not.</dd><dt>Replies are slow or the queue is full</dt><dd>Read less often. Remove duplicate Inject timers and make sure nodes sharing a port use the same Connection.</dd></dl>
+<p>Connect Debug to the second output to see the error message. Add a Catch node for errors such as a full waiting list. Both can report the same problem, so avoid making two automatic responses to one fault.</p>
+<p>The error details can show how many parts completed and whether a command may already have reached the PLC. Use that information before trying again.</p>
+<p>A green completed status means the last request worked. It does not prove the PLC is still connected now. A screen showing old readings should also show when they were last updated.</p>
+<p>Before using a new setup unattended, test the readings, commands and loss-of-communication response on your equipment.</p>
+<h3>9 · Export and import into Node-RED</h3>
+<p>In V-NET2, click the PassPort Connect logic block on your diagram. In the left-hand Properties panel, click PassPort Connect · export nodes. Choose the connections in the window that opens, then click Export read &amp; write nodes and save the JSON file.</p>
+<p>In Node-RED, open the flow page you want to use. Open the menu and choose Import. Select the JSON file saved by V-NET2, choose Current flow, click Import and place the nodes. This adds complete Read and Write nodes with your table. It does not create a new flow tab.</p>
+<p>You can also copy the contents of that JSON file and paste them into the text box in the Node-RED Import window. You must still click Import. Do not paste the complete file into a Read or Write node’s settings.</p>
+<p>In Node-RED, double-click each imported node. Check Unit ID and Connection. If that PassPort port is already in use, choose the existing Connection. Click Done, add your Inject buttons and Debug nodes, then click Deploy.</p>
+<p>The other button in the V-NET2 logic block’s Properties panel is Export connection setup JSON. It saves a reference copy of your table and settings. It does not create Node-RED nodes and cannot be imported as a flow or pasted into a node. Use PassPort Connect · export nodes when you want the Read and Write nodes.</p>
+<p>Neither export uploads the PLC program or changes the PassPort radio. Save and upload the PLC project from V-NET2 separately.</p>
+<p>If PassPort Connect is missing from the Node-RED palette, ask your installer to add or update it.</p>
+<p>Older projects using the ordinary Modbus logic block still have their separate single-node export. Farming quick templates use the PassPort Connect logic block and export the complete Read and Write pair.</p>
+<h3>10 · Try it: battery reading and a relay command</h3>
+<p>Create a test project for your PLC. Add PassPort Connect with Unit ID 7 and one connection. Add Battery as a Float Analog row, and TestRelay as a normal Digital row with Pulse on write off.</p>
+<p>Wire Battery Voltage to Battery on the left. Wire TestRelay on the right to a spare Mako output or Solaris relay. Leave TestRelay on the left unwired. Use an output whose connected equipment is suitable for your test.</p>
+<p>In PassPort Connect, choose RF or an available RS485 connection and match the settings. Export the Read and Write nodes. Save and upload the PLC program when ready.</p>
+<p>In Node-RED, import into Current flow. Connect Inject to Read and Debug to both outputs. Deploy and press Inject. The result should include a Battery number and TestRelay as true or false.</p>
+<p>Open Write, choose Single channel and select TestRelay. Do not leave Battery selected. Make one Inject with Boolean true and another with Boolean false. Leave automatic startup and Repeat off. Wire both to Write, Deploy, and test each button.</p>
+<p>Check the relay itself or a feedback sensor, as well as the reply. For an Analog setpoint later, select that row and send a number in the original units.</p>
+<p>For a ready-wired farm project, open Farmers quick templates. Choose the picture, enter a unique Unit ID and the required sensor settings, then choose Load &amp; export Node-RED. The project uses PassPort Connect, includes battery voltage and exports the complete Read and Write pair onto your current flow.</p>
+</script>

package/smithtek-mako-rf.js

@@ -3,8 +3,14 @@ module.exports = function (RED) {
   "use strict";
 
   const ModbusRTU = require("modbus-serial");
+
   const rangeScaling = require('./range-scaling');
 
+  if (RED.httpAdmin) RED.httpAdmin.get('/smithtek-passport/usb', RED.auth.needsPermission('smithtek-mako-rf-bus.read'), async (req,res) => {
+    try { res.json(await require('./usb-discovery').choices()); }
+    catch (err) { res.status(503).json({error:'Unable to check USB connections. Check the PassPort and try again.'}); }
+  });
+
 function toNum(v, fallback) {
     const n = Number(v);
     return Number.isFinite(n) ? n : fallback;
@@ -308,6 +314,8 @@ function toNum(v, fallback) {
       // Digital points are numeric at the output boundary. Keep the internal
       // boolean until here so saved math/masks cannot change a bit into another value.
       if (typeof val === 'boolean') val = val ? 1 : 0;
+      // Round final readings, including Math/Range results, without stringifying them.
+      if (typeof val === 'number' && Number.isFinite(val)) val = Number(val.toFixed(6)) || 0;
       setObjectProperty(decoded, name, val, "=>", prefix);
     }
 
@@ -315,6 +323,7 @@ function toNum(v, fallback) {
   }
 
   const engine = require('./bus-engine')(ModbusRTU);
+  require('./passport-link-node')(RED,engine);
 
   function SmithtekMakoRfBusConfig(config) {
     RED.nodes.createNode(this, config);

package/usb-discovery.js

@@ -0,0 +1,20 @@
+'use strict';
+// Enumerate connections only; never probe or send commands to identify a PLC.
+const usbPorts = ports => ports.filter(p => /^\/dev\/(ttyUSB|ttyACM)\d+$/.test(p.path) || (p.vendorId && p.productId && !/^\/dev\/ttyAMA/.test(p.path)));
+const identity = p => p.serialNumber ? 'usb:id:' + encodeURIComponent(JSON.stringify([p.vendorId || '', p.productId || '', p.serialNumber])) : p.path;
+async function list() { return usbPorts(await require('serialport').SerialPort.list()); }
+async function choices(enumerate = list) {
+  const ports = await enumerate();
+  return ports.map((p,i) => ({value:identity(p),label:'USB '+(i+1)+(p.manufacturer?' · '+p.manufacturer:'')+(p.serialNumber?' · '+p.serialNumber:' · no unique ID')}));
+}
+async function resolve(selection, state, enumerate = list) {
+  if (!selection.startsWith('usb:')) return selection;
+  const ports = await enumerate();
+  const key = state.usbIdentity || selection;
+  const matches = key === 'usb:auto' ? ports : ports.filter(p => identity(p) === key);
+  if (matches.length !== 1) throw Object.assign(new Error(matches.length ? 'Several USB devices found. Choose your device in Connection.' : 'USB device not found. Check its power and cable, then refresh USB.'), {code:'ECONFIG'});
+  // Keep the first device for reconnects within this connection's lifetime.
+  state.usbIdentity = identity(matches[0]);
+  return matches[0].path;
+}
+module.exports = {usbPorts,identity,list,choices,resolve};