Serialport.js 连接 web 和硬件设备编程

Serialport 简介

想象这样一个世界,在那里你能用 JavaScript 代码控制榨汁机,灯,安防系统,甚至机器人。嗯,是机器人!你会不会觉得很新奇以致兴奋?

Serialport 库(也称 Node-Serialport,基于 Node),为低级串口编码提供必要的 steam 接口,以控制 Arduino 芯片组,X10 接口,Zigbee 无线技术,公路路标,LCD 显示屏,收银抽屉,电机控制器,传感器,叉车,调制解调器,无人机,数控机床,绘图仪器,自动贩卖机,基于 ccTalk 协议的投币设备,SMS 网关,RFID 扫描器等等非常多设备。如果你手中有一块能够异步收发消息的硬件设备(我们姑且这样说),那么这个物理世界将成为你的掌中玩物。

Serialport 为 JavaScript 开发者打开了硬件开发之门。它是一个比编写固件更好的方案!

获取到 USB 串口路径

PC 机一般会带有 2 ~ 4 个 USB 插口, 以下称 port 口。不同的操作系统,获取到的串口信息不同。

欲了解 port 口信息,可以在命令行工具中输入命令:serialport-list

Mac OSX 的 port 口为:

{
  comName: '/dev/tty.usbmodem1421',
  manufacturer: 'Arduino (www.arduino.cc)'
}

Linux 的 port 口为:

{
  comName: '/dev/ttyACM0',
  manufacturer: 'Arduino (www.arduino.cc)'
}

Windows 的 port 口为:

{
  comName: 'COM3',
  manufacturer: 'Arduino LLC (www.arduino.cc)'
}

其中, comName 字段,指的就是 USB 串口的路径。该路径是 SerialPort 实例化的依据。

获取串口列表SerialPort.list([callback]) ⇒ Promise

因历史版本的缘故,该接口支持两种形式调用,推荐 v6.0.0 版本的 promise 方式:

// v4.0.7 的 callback 形式
SerialPort.list((error, ports) => console.log(ports))

// v6.0.0 的 promise 形式
SerialPort.list().then(ports => console.log(ports))

创建一个 SerialPort 对象

创建 SerialPort 对象new SerialPort(path, [options], [openCallback])

有了 port 口路径,就可以创建一个 port 口实例,并建立连接。

let port = new SerialPort('/dev/tty.usbmodem1421');

该实例化是首先产生一个 port 实例,然后再尝试建立连接的。即实例化过程中有一个异步操作,实例化完成了,连接的结果可能还没有返回。

连接建立成功,就会触发 open 事件——事件稍后再解说。

合并以上两步的代码,就是:

import SerialPort from serialport;

SerialPort.list().then( ports => {
    // 假设选择第一个串口实例化
    let path = ports[0].comName;
    let myPort = new SerialPort(path);
})
.catch(err => console.log(err))

绑定事件监听

当获取到了 SerialPort 的实例对象 myPort 后,就可以进行事件监听了。

// 当连接建立时
myPort.on('open', callback);

// 当接收到数据时
myPort.on('data', callback);

// 当出现错误时
myPort.on('error', callback);

事件监听,主要用来在合适的时间点发送数据,以及处理接收到来自串口的数据信息。

值得注意的是,很多错误来自:因串口路径不对导致的连接错误(但此时实例对象已存在)、串口被占用锁定时仍尝试连接的错误。

向串口写入数据

向串口写入数据serialPort.write(data, [encoding], [callback]) ⇒ boolean

实例创建完,并且正确建立连接后,就可以向串口写数据了。数据会经串口发送至与 PC 连接的硬件设备,比如 Arduino 板,或者 Raspberry Pi 板等等。

// 直接写入字符串
myPort.write('hello world', (err) => {
    if (err) return console.log('write Error: ', err.message);
})

// 写入 Buffer
myPort.write(Buffer.from('hello world'), callback)

写入数据完毕,就会调用上述回调。

若写数据出错——可能因为数据非法或断开了连接等原因——同样会调用上述回调,只不过有些错误情况下,可能 err 参数不存在。但是 error 事件一定会被触发。

连接未建立,即 open 事件未被触发,若此前就写入数据,写操作会被阻塞,直到建立连接之后再执行。

串口每次传输数据是有一定长度限制的。一个数据包写完,才会开始写下一个数据包;若一条数据太长,会被切分成多个包,依次写入。写完后会立即调用 drain 方法表示本条数据已写完,drain 意为排干了拥塞的数据。

一些安装 trouble

这里主要是 serialport 一些安装不成功的问题,包括 Windows 系统,Electron (跨平台的框架),一些 Linux 发行版以及 Raspberry Pi 板,都有可能发生一些安装的麻烦。 难以一一呈现,需耐心 Google~

文末彩蛋

如开篇说说,Serialport 是基于 Node 的一个 JS 库,那么上述代码需要在 Node 环境中运行,也就是我们日常的命令行。但如果想直接在浏览器中使用,还有一段距离。

所以,为更好的服务于 web 开发,这里有一款本人封装的 npm 工具——sensorium-server,只需在命令行中开启此工具,就可以轻松搭建一个从 HTML 页面到硬件设备的连接通道,这样就可以在 Browser 中轻松的调试硬件了。

    原文作者:Jeremy_young
    原文地址: https://segmentfault.com/a/1190000011638237
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞