摘要：連接建立成功，就會觸發(fā)事件事件稍后再解說。當連接建立時當接收到數(shù)據(jù)時當出現(xiàn)錯誤時事件監(jiān)聽，主要用來在合適的時間點發(fā)送數(shù)據(jù)，以及處理接收到來自串口的數(shù)據(jù)信息。數(shù)據(jù)會經(jīng)串口發(fā)送至與連接的硬件設備，比如板，或者板等等。

想象這樣一個世界，在那里你能用 JavaScript 代碼控制榨汁機，燈，安防系統(tǒng)，甚至機器人。嗯，是機器人！你會不會覺得很新奇以致興奮？

Serialport 庫（也稱 Node-Serialport，基于 Node），為低級串口編碼提供必要的 steam 接口，以控制 Arduino 芯片組，X10 接口，Zigbee 無線技術，公路路標，LCD 顯示屏，收銀抽屜，電機控制器，傳感器，叉車，調(diào)制解調(diào)器，無人機，數(shù)控機床，繪圖儀器，自動販賣機，基于 ccTalk 協(xié)議的投幣設備，SMS 網(wǎng)關，RFID 掃描器等等非常多設備。如果你手中有一塊能夠異步收發(fā)消息的硬件設備（我們姑且這樣說），那么這個物理世界將成為你的掌中玩物。

Serialport 為 JavaScript 開發(fā)者打開了硬件開發(fā)之門。它是一個比編寫固件更好的方案！

PC 機一般會帶有 2 ~ 4 個 USB 插口， 以下稱 port 口。不同的操作系統(tǒng)，獲取到的串口信息不同。

欲了解 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 實例化的依據(jù)。

獲取串口列表：SerialPort.list([callback]) ? Promise

因歷史版本的緣故，該接口支持兩種形式調(diào)用，推薦 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))

創(chuàng)建 SerialPort 對象： new SerialPort(path, [options], [openCallback])

有了 port 口路徑，就可以創(chuàng)建一個 port 口實例，并建立連接。

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

該實例化是首先產(chǎn)生一個 port 實例，然后再嘗試建立連接的。即實例化過程中有一個異步操作，實例化完成了，連接的結果可能還沒有返回。

連接建立成功，就會觸發(fā) 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 后，就可以進行事件監(jiān)聽了。

// 當連接建立時
myPort.on("open", callback);

// 當接收到數(shù)據(jù)時
myPort.on("data", callback);

// 當出現(xiàn)錯誤時
myPort.on("error", callback);

事件監(jiān)聽，主要用來在合適的時間點發(fā)送數(shù)據(jù)，以及處理接收到來自串口的數(shù)據(jù)信息。

值得注意的是，很多錯誤來自：因串口路徑不對導致的連接錯誤（但此時實例對象已存在）、串口被占用鎖定時仍嘗試連接的錯誤。

向串口寫入數(shù)據(jù)：serialPort.write(data, [encoding], [callback]) ? boolean

實例創(chuàng)建完，并且正確建立連接后，就可以向串口寫數(shù)據(jù)了。數(shù)據(jù)會經(jīng)串口發(fā)送至與 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)

寫入數(shù)據(jù)完畢，就會調(diào)用上述回調(diào)。

若寫數(shù)據(jù)出錯——可能因為數(shù)據(jù)非法或斷開了連接等原因——同樣會調(diào)用上述回調(diào)，只不過有些錯誤情況下，可能 err 參數(shù)不存在。但是 error 事件一定會被觸發(fā)。

連接未建立，即 open 事件未被觸發(fā)，若此前就寫入數(shù)據(jù)，寫操作會被阻塞，直到建立連接之后再執(zhí)行。

串口每次傳輸數(shù)據(jù)是有一定長度限制的。一個數(shù)據(jù)包寫完，才會開始寫下一個數(shù)據(jù)包；若一條數(shù)據(jù)太長，會被切分成多個包，依次寫入。寫完后會立即調(diào)用 drain 方法表示本條數(shù)據(jù)已寫完，drain 意為排干了擁塞的數(shù)據(jù)。

這里主要是 serialport 一些安裝不成功的問題，包括 Windows 系統(tǒng)，Electron （跨平臺的框架），一些 Linux 發(fā)行版以及 Raspberry Pi 板，都有可能發(fā)生一些安裝的麻煩。 難以一一呈現(xiàn)，需耐心 Google~

如開篇說說，Serialport 是基于 Node 的一個 JS 庫，那么上述代碼需要在 Node 環(huán)境中運行，也就是我們?nèi)粘５拿钚?。但如果想直接在瀏覽器中使用，還有一段距離。

所以，為更好的服務于 web 開發(fā)，這里有一款本人封裝的 npm 工具——sensorium-server，只需在命令行中開啟此工具，就可以輕松搭建一個從 HTML 頁面到硬件設備的連接通道，這樣就可以在 Browser 中輕松的調(diào)試硬件了。