收银机打不出小票、仓库电子秤读数进不了单据——这类问题会把原本顺畅的业务拖回手工。Odoo 19 的 IoT 体系把物理设备接到 POS、库存、制造、质量等应用,使硬件通信不再依赖浏览器本地插件。
下文按公开技术文章常见结构(IoT 作用 → 驱动 → 双向通信 → 故障 → 升级 → 自定义 → FAQ)完整展开,并结合中国门店/仓库落地习惯补充验收与降级,可作为Odoo用户手册 / 中文帮助中的 IoT 专章使用。选题参考:How to Connect Hardware Devices to Odoo 19 Using IoT。
一、Odoo IoT 系统做什么
IoT 是 Odoo 与硬件之间的桥。Odoo 19 支持 IoT Box 与 Windows 虚拟 IoT。设备可通过 USB、蓝牙、串口或网络接入(视硬件而定)。
常见可集成设备包括:
- 小票/收据打印机
- 条码扫描枪
- 支付终端
- 称重与计量设备
- 客显
- 摄像头及其他受支持设备
这样 Odoo 与硬件的连接不再依赖浏览器本身,换电脑、换浏览器也不至于整条链路失效。
二、硬件驱动如何工作
驱动负责与具体设备通信。IoT 架构用接口(interface)发现已连接设备,用驱动(driver)与单个设备会话。
例如:某驱动专门处理受支持的小票打印机、扫码枪或计量设备。设备被发现后,对应接口与驱动将其提供给 Odoo 及业务应用。
对定制硬件,模块中可提供 iot_handlers(或同类 handlers 目录)放置自定义驱动与接口。
三、Odoo 与硬件的双向通信
通信是双向的:Odoo 可向设备下发指令,设备也可把数据回传 Odoo。
典型 POS 出票链路:
Odoo POS → IoT 系统 → 小票打印机
典型称重:
电子秤 → 驱动 → IoT → 单据数量字段
排障时先分清是下发失败还是回传失败,避免一上来重装整套 Odoo。
四、常见 IoT 硬件问题
- 硬件不受支持
- 设备安装/接线不正确
- USB 或网络连通故障
- 驱动或接口异常
- IoT 软件版本不兼容
- 固件与硬件不匹配
- 网络/防火墙限制
设备识别不到时,优先按上表逐项排查,再考虑自定义开发。
五、更新 IoT 驱动
驱动与 IoT 系统需要及时更新以保持硬件兼容。Odoo 更新 IoT 时通常也会更新驱动与 handler。
IoT 系统支持按需升级驱动,常用于修复兼容问题。但升级后必须用真实单据回归:连打小票、连续扫码、称重写入,确认无回归缺陷后再全店推广。
六、自定义硬件集成
若设备默认不受支持,可能需要自定义驱动/接口。开发前先查 Odoo 支持列表与厂商通信协议(串口协议、DLL、网络 API 等)。
自定义集成必须纳入变更管理:固件、IoT 软件或 Odoo 小版本变化都可能影响兼容性,要有版本锁定与回滚包。
七、中国现场补充:选型、组网、降级、验收
- 选型:试点可用 Windows 虚拟 IoT;量产门店优先 IoT Box,减少“收银机关机=全店不能打票”。
- 组网:IoT 与 Odoo 同生产 VLAN,禁访客 Wi‑Fi;NTP 同步;放行 HTTPS/WebSocket。
- 降级:备用键盘楔扫码、系统 USB 直打、称重手工录入双人复核;班组长能独立切换。
- 验收:连续 50 次扫码错码率 < 0.5%;连打 30 张小票无卡死;断网恢复可重连;降级演练通过并写入项目纪要。
八、小结
硬件驱动是 Odoo 与物理设备之间的关键连接。通过 IoT,POS/库存/制造/质量等应用可稳定使用打印机、扫码枪、支付终端、秤等设备,并把硬件通信与主应用进程解耦。配置与维护到位,才能把“能演示”变成“能值班”。
九、常见问题 FAQ
Q:IoT 用来连接什么?
连接受支持的打印机、扫码枪、支付设备、秤等,使业务应用能读写硬件。
Q:硬件驱动的作用?
管理 IoT 与某一类设备之间的通信细节。
Q:能否接自定义硬件?
可以。默认不支持时,可通过自定义驱动/接口扩展,但必须压测与版本管理。
中国Odoo网原创中文改写|保留原文技术要点并补充国内实操。Odoo用户手册 · 中文文档 · 中文帮助 · 实操。