Java读取DYMO S100 USB秤数据适用包及Pipe error报错解决

更优依赖选型 #

比多年未更新的官方usb4java更适配需求的依赖如下：

• hid4java：当前维护活跃度最高的Java HID外设访问库，基于最新版libusb 1.0.x封装，Mac/Windows/Linux全平台原生依赖自动加载，无需手动安装系统驱动，不需要开发者手动处理接口声明、端点配置等底层逻辑，直接按HID报告规则读取数据即可，后续打包为JAR对接FileMaker Pro Java插件的适配成本极低。
• 若需使用通用USB库，可选择usb4java的社区维护分支，相比官方停更版本修复了大量Mac系统下的权限、设备枚举类bug。

usb4java现有代码问题与修正方案 #

当前报Pipe Error、读不到有效数据的核心原因不是ByteBuffer配置，而是全链路传输逻辑、参数配置存在错误，具体问题和修正方法如下：

现存错误点 #

1. 设备配置参数无效：LibUsb.setConfiguration(handle, 0)传入0代表设备未配置状态，DYMO S100默认生效配置为1，参数错误会导致所有后续传输请求被设备拒绝。
2. 传输类型选择错误：DYMO S100的称重数据通过HID中断输入端点返回，并非通过控制传输（controlTransfer）下发请求获取。当前控制传输的bRequest、wValue、wIndex参数全为0，属于无效请求，设备直接返回管道错误。
3. 资源生命周期逻辑错误：listDevices方法中匹配到设备后直接return，提前执行了LibUsb.freeDeviceList和LibUsb.exit(context)，后续打开设备时libusb上下文已被销毁，Mac系统下会触发隐性权限、访问异常。
4. 缓冲区操作错误：读操作前主动向Direct ByteBuffer写入1-8的测试字节，且未调用flip重置缓冲区指针，即使读到有效数据也会被预填充内容覆盖。
5. 缺少Mac系统必要的驱动解绑步骤：Mac系统默认占用HID设备接口，直接claim接口会与系统驱动冲突，需先解绑内核驱动才能正常读取数据。

修正方案 #

1. 将libusb Context的生命周期提升至main方法全局，不要在设备枚举阶段提前销毁上下文、释放设备列表，待设备完全关闭后再统一回收资源。
2. setConfiguration传入参数1，claim接口前先调用LibUsb.detachKernelDriver解绑系统默认占用的驱动。
3. 放弃控制传输，改用同步中断传输读取固定端点0x81（DYMO S100中断输入端点地址，最高位为1代表输入方向）的数据，缓冲区分配6字节即可，不要提前写入测试数据。
4. 按照DYMO S100的HID报告规则解析返回的6字节数据，即可得到有效称重值。
   核心修正代码如下：

// 全局维护context，禁止提前销毁
Context context = new Context();
LibUsb.init(context);
// 改造listDevices方法，传入全局context，方法内不执行exit、freeDeviceList操作
Device dymoScale = listDevices(context, Vendor_ID, Product_ID);
DeviceHandle handle = new DeviceHandle();
LibUsb.open(dymoScale, handle);
// 解绑Mac系统默认HID驱动
LibUsb.detachKernelDriver(handle, 0);
// 正确传入配置值1
LibUsb.setConfiguration(handle, 1);
LibUsb.claimInterface(handle, 0);

ByteBuffer buffer = ByteBuffer.allocateDirect(6);
// 禁止向读缓冲区预填充测试数据
int transfered = LibUsb.interruptTransfer(
        handle,
        (byte)0x81, // DYMO S100固定中断输入端点地址
        buffer,
        1000 // 读取超时1秒
);
if (transfered < 0) {
    throw new LibUsbException("Interrupt transfer failed", transfered);
}
// 切换缓冲区为读模式
buffer.flip();
byte[] report = new byte[6];
buffer.get(report);
// 解析称重数据
byte weighStatus = report[1]; // 0x01=称重稳定 0x02=超重 0x03=空载 0x05=数值计算中
byte unit = report[2]; // 0x0B=克 0x02=盎司 0x0C=磅
int rawWeight = (report[4] & 0xFF) << 8 | (report[3] & 0xFF);
double actualWeight = rawWeight / 10.0;
// 后续可根据状态、单位做业务转换，再导入FileMaker Pro

Mac环境额外配置 #

第一次运行代码时，需要给IDE、运行JAR的终端开启「辅助功能」「完全磁盘访问」权限，否则会出现接口声明成功但读不到数据的问题。

内容的提问来源于stack exchange，提问作者Collin Short