Web Serial API binding for Node Serialport
npm install serialport-binding-webserialapiWeb Serial API binding for Node.js serialport
``ts
import SerialPort from '@serialport/stream';
import WSABinding from 'serialport-binding-webserialapi';
SerialPort.Binding = WSABinding;
SerialPort.list().then(portsList => {
console.log(JSON.stringify(portsList));
}, err => {
console.error(JSON.stringify(err));
});
`
This is a Node.js module available through the npm registry.
Before installing, download and install Node.js.
If this is a brand new project, make sure to create a package.json first with the npm init command.npm install
Installation is done using the command:
`bash`
$ npm install serialport-binding-webserialapi
As this module provides Web Serial API bindings for node.js serialport, applications using it will require @serialport/stream module installed as well. This is provided for You by Node.js dependency mechanism.
On 29th Dec 2020, Web Serial API is supported in modern Chromium based browsers, that is Chrome, Edge, Opera and of course Chromium.
* Chromium based browsers require enabling Experimental Web Platform Features
Chrome & Chromium: chrome://flags/#enable-experimental-web-platform-features
Opera:
Edge:
* On Linux, snap based Chromium installation requires connecting Chromium snap to USB mapped serial ports
* Enables to use Node.js serialport module based apps in browser almost directly
* Supports base read/write operations and setting/getting serial port flags
* Supports USB Vendor & Product ID based port selection limitation
Usage of Web Serial API is straightforward, as it does not expose new functionality, merely binds the well documented Node Serialport to the Web Serial API available in browsers. See the example below for usage and referenced documentation.
* Web Serial API - Draft Communit Group Report, Web Serial API reference
* Node Serialport - Documentation for the Serialport module
* update command is not implemented, as there is no support in Web Serial API for baud rate change for open portflush
* is not implemented, no specific function in Web Serial API; need to check if possible thru the underlying stream objectsdrain
* is not implemented, no specific function in Web Serial API; need to check if possible thru the underlying stream objects or write function Promise
* as of 1.0.3 release date, getPorts() in Web Serial API as implemented in Chromium does not return list of serial ports allowed by user, this means at every start of application user will have to select serial port in a popup shown by the browser
* tested only in Chromium 87.0.4280.88
* Web Serial API specification is a living document and it's implementation is experimental; things might break any moment
This is a very simple TypeScript example of a browser serial terminal application using jQuery, Serialport and Web Serial API
`ts
// very simple serial terminal
import $ from 'jquery';
import './vendor';
import SerialPort from '@serialport/stream';
import WSABinding from 'serialport-binding-webserialapi';
import stripAnsi from 'strip-ansi';
// terminal settings
// does not echo
var term_speed = 115200;
// serial port binding to Web Serial API
SerialPort.Binding = WSABinding;
// construct simple webpage
var myPort = undefined;
var actref = $(document.createElement("button"));
var twinref = $(document.createElement("textarea"));
var bref = $("body");
bref.html('');
bref.append(actref);
bref.append(twinref);
bref.children().css("display", "block").css("font-family", "monospace");
twinref.prop( "disabled", true );
twinref.attr("rows", "24");
twinref.attr("cols", "80");
actref.text('Start serial terminal');
var ta = $('textarea');
window.setInterval(() => {
var tal = ta.val().length;
ta.scrollTop(ta[0].scrollHeight);
ta[0].setSelectionRange(tal, tal);
}, 100);
// handle terminal startup - must be user initiated!
actref.click(() => {
myPort = new SerialPort('wsa://default', {
baudRate: term_speed,
autoOpen: true
});
myPort.on('data', data => {
for(var i = 0; i
ta.val(ta.val().slice(0,-1));
}
}
var re = /[\0-\x1F\x7F-\x9F\xAD]/;
ta.val(ta.val() + stripAnsi(data.toString()).replace(re,''));
});
myPort.on('open', () => {
ta.prop( "disabled", false );
ta.focus();
})
})
// handle terminal text input
function twrite(c:string) {
myPort.write(c, err => {
if (err) {
console.log('Error on write: ', err.message);
}
});
}
twinref.on('keydown', e => {
var tval = undefined;
if (e.which == 13) {
tval = "\r\n";
} else if (e.which == 8) {
tval = "\b";
} else if (e.which == 9) {
tval = "\t";
} else {
return;
}
twrite(tval);
e.preventDefault();
});
twinref.on('keyup', e => {
e.preventDefault();
});
twinref.on('keypress', e => {
twrite(String.fromCharCode(e.which));
e.preventDefault();
});
``
The original author is Marcin Galczynski