百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 热门文章 > 正文

node-hid:开创 Node 访问 USB & Bluetooth HID 先河?

bigegpt 2024-09-01 15:16 6 浏览

大家好,很高兴又见面了,我是"高级前端进阶",由我带着大家一起关注前端前沿、深入前端底层技术,大家一起进步,也欢迎大家关注、点赞、收藏、转发!

什么是 node-hid

node-hid 用于从 Node.js 访问 USB 和蓝牙 HID 设备。

node-hid 目前支持 Node.js v10 及更高版本,当然开发者依然可以使用旧版本。 一般来说,node-hid 会尝试为最常见的平台、Node 和 Electron 版本提供预构建的本机库二进制文件。

node-hid 支持的平台、架构和 Node 版本如下:

  • Windows x86 (32-bit)
  • Windows x64 (64-bit)
  • Mac OSX 10.9+
  • Linux x64
  • Linux x86
  • Linux ARM / Raspberry Pi / Various SBC
  • Linux ARM64 / Various SBC
  • Linux MIPSel
  • Linux PPC64

当然,node-hid 也尽力去做到跨平台,感兴趣的开发可以持续保持关注。

目前 node-hid 在Github上通过 MIT 协议开源,有 1.4k 的star、20.3k 的项目依赖量,妥妥的前端优质开源项目。

如何使用 node-hid

列举设备

以下示例列出所有连接的 HID 设备:

var HID = require('node-hid');
var devices = await HID.devicesAsync();

devices 包含一组对象,每个对象对应每个可用的 HID 设备,比如:供应商 ID 和产品 ID,其唯一标识设备以及打开特定设备所需的路径。

await HID.devicesAsync();
{ vendorId: 10168,
    productId: 493,
    path: 'IOService:/AppleACPIPl...HIDDevice@14210000,0',
    serialNumber: '20002E8C',
    manufacturer: 'ThingM',
    product: 'blink(1) mk2',
    release: 2,
    interface: -1,
    usagePage: 65280,
    usage: 1 },
  { vendorId: 1452,
    productId: 610,
    path: 'IOService:/AppleACPIPl...Keyboard@14400000,0',
    serialNumber: '',
    manufacturer: 'Apple Inc.',
    product: 'Apple Internal Keyboard / Trackpad',
    release: 549,
    interface: -1,
    usagePage: 1,
    usage: 6 },
    <and more>

打开设备

在读取或写入设备之前,必须将其打开。使用先前调用 HID.devices() 返回的列表中的路径:

var device = new HID.HID(path);

或打开与 VID/PID 对匹配的第一个设备:

var device = new HID.HID(vid, pid);

device 变量包含设备的句柄,如果打开设备时发生错误,则会抛出异常。

node-hid 设备是一个 EventEmitter, 虽然与 Readable 和 Writable 流共享一些方法名称和使用模式,但不是流,并且语义有所不同。 例如,device.write 不接受编码或回调参数,并且 device.pause 不执行与 Read.pause 相同的操作,也没有管道方法。

从设备列表中选择设备

如果需要过滤 HID.devices() 列表,可以使用标准 Javascript 数组技术:

var devices = HID.devices();
var deviceInfo = devices.find(function (d) {
  var isTeensy = d.vendorId === 0x16c0 && d.productId === 0x0486;
  return isTeensy && d.usagePage === 0xffab && d.usage === 0x200;
});
if (deviceInfo) {
  var device = new HID.HID(deviceInfo.path);
  // ... use device
}

还可以通过传递 VID 和 PID 来查找目标设备:

//return all the devices that match specified VID and PID
var devices = HID.devices(0x16c0, 0x0486);

从设备读取数据

要接收 FEATURE 报告,可以使用 device.getFeatureReport()。 要接收 INPUT 报告,可以使用 device.on("data",...)。node-hid 是一个 EventEmitter,从设备读取是通过注册“data”事件处理程序来执行:

device.on('data', function (data) {});

还可以通过如下方式侦听错误:

device.on('error', function (err) {});

要获取 FEATURE 信息可以如下设置:

var buf = device.getFeatureReport(reportId, reportLength);

需要注意的几个点:

  • 通过 device.on("data") 读取是异步的
  • 通过 device.getFeatureReport() 的读取是同步的
  • 要删除事件处理程序,请使用 device.close() 关闭设备
  • 当还没有数据处理程序或不存在数据处理程序时,根本不会读取数据,没有缓冲区。

写入设备

要发送 FEATURE 报告,可以使用 device.sendFeatureReport()。而发送 OUTPUT 报告,可以使用 device.write()。

所有写入都是同步的。

ReportId 是发送到 device.sendFeatureReport() 或 device.write() 的数组的第一个字节,这意味着该数组应该比报告大一个字节。 如果设备不使用编号报告,请将第一个字节设置为 0x00。

device.write([0x00, 0x01, 0x01, 0x05, 0xff, 0xff]);
device.sendFeatureReport([0x01, 'c', 0, 0xff, 0x33, 0x00, 70, 0, 0]);

需要注意的是:

  • 必须发送所选 OUTPUT 或 FEATURE 的确切字节数。
  • device.write() 和 device.sendFeatureReport() 都返回写入的字节数 + 1。
  • 对于使用报告 ID 的设备,要 write() 或 sendFeatureReport() 的数组的第一个字节必须是报告 ID。

参考资料

https://github.com/node-hid/node-hid#node-hid---access-usb-hid-devices-from-nodejs

https://www.youtube.com/watch?v=eggQgjk3qjc

相关推荐

LangChain4j如何自定义文档转换器实现数据清洗?

LangChain4j提供了3种RAG(Retrieval-AugmentedGeneration,检索增强生成)实现,我们通常在原生或高级的RAG实现中,要对数据进行清洗,也就是将外接...

Java 8 Stream API 详解(java stream.)

Java8StreamAPI详解一、概述在Java8中,StreamAPI是一个重要的新特性。它为处理集合(如List、Set等)中的元素提供了一种高效且富有表现力的方式。Str...

Java修炼终极指南:185 使用 Stream 过滤嵌套集合

这是面试中的一个经典问题,通常从一个模型开始,如下所示(我们假设集合是一个List):publicclassAuthor{privatefinalStringname;pri...

java8的stream使用小示例(java stream())

据JetBrains发布的2021年开发者生态系统调查,Java8在java使用的版本中仍然是当前最流行的版本。72%的专业开发人员使用Java8作为其在java开发中主要编程语言版本。现...

Node.js Stream - 实战篇(node.js in action)

本文转自“美团点评技术团队”http://tech.meituan.com/stream-in-action.html背景前面两篇(基础篇和进阶篇)主要介绍流的基本用法和原理,本篇从应用的角度,介...

Java Stream:集合处理的api(java 集合操作)

JavaStream流:高效集合处理的函数式编程利器一、什么是JavaStream?Java8引入的StreamAPI是一套用于处理集合数据的流式编程接口,通过函数式风格(无副作用的...

去除 List 中的重复元素,你知道几种实现方法?

去除List中重复元素,这在实际编程或面试中经常遇到,每个人都有习惯的写法吧,这里抛砖引玉,汇总了一些实现方案,开拓思路。准备数据假设数组中有10个数据,可能有重复,需要将重复的数据从数组中去掉。pu...

Java开发者必看!Stream流式编程10个爆款技巧,让你代码优雅飞起

为什么你的Java代码总像拧巴的麻绳?掌握这10个Stream实战技巧,代码效率与优雅度将产生质的飞跃。以下案例均来自真实电商系统场景,带你感受流式编程的降维打击!一、过滤与映射组合拳(Filter...

leetcode每日一题之存在重复元素(存在重复元素 iii)

题:给定一个整数数组,判断是否存在重复元素。如果存在一值在数组中出现至少两次,函数返回true。如果数组中每个元素都不相同,则返回false。比如:输入:[1,2,3,1]输出:true...

告别for循环!揭秘Stream API如何让你的代码简洁度提升300%

一、当传统循环遇上现代需求真实场景复现:某电商平台需要处理10万条订单数据,要求:筛选出金额>500的订单提取用户ID并去重统计VIP用户数量传统实现方案://常规写法Set<Long...

Java中List去重的N种方法:从基础到优雅

Java中List去重的N种方法:从基础到优雅在日常的Java开发中,我们经常会遇到需要对List集合去重的情况。无论是为了清理重复的数据,还是为了优化算法性能,掌握多种去重方式都是一项非常实用的技能...

Java Stream流没用过?常用高频方法

概念Stream流是Java8添加的以一种链式调用的方法处理数据,主要侧重于计算。具有以下相关特点代码简洁链式调用Stream常用方法1.将数组变为当作List操作String[]strArr=...

核医学专业名词索引(M-R)(核医学重点归纳)

M吗啡(morphia)埋藏式心律转复除颤器(implantablecardioverterdefibrillator,ICD)麦角骨化醇(VD2,calciferol)脉冲堆积(pulsepi...

CodeMeter 新版发布(codesigner下载)

威步于2022年8月4日发布CodeMeter7.50及CodeMeter软件保护套装11.10,以下为新版内容。CodeMeterRuntime7.50StreamingSIMDExten...

世界上最小的五轴铣床Pocket NC(最小的五轴加工中心)

PocketNC,由MIT学生研制,还有说法是这款产品的设计者是来自美国蒙大拿州的一对极客夫妻。目前主要有两款产品:PocketNCV2-50,9000美元;PocketNCV2-10,60...