跳至内容

Odoo 19 IoT:把扫码枪、秤与打印机接入业务单据

Odoo用户手册·中文文档|对照 IoT 原文结构的完整实操(IoT Box/虚拟IoT/驱动/FAQ)
2025年10月18日
Odoo 19 IoT:把扫码枪、秤与打印机接入业务单据

收银机打不出小票、仓库电子秤读数进不了单据——这类问题会把原本顺畅的业务拖回手工。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 BoxWindows 虚拟 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 小版本变化都可能影响兼容性,要有版本锁定与回滚包。

七、中国现场补充:选型、组网、降级、验收

  1. 选型:试点可用 Windows 虚拟 IoT;量产门店优先 IoT Box,减少“收银机关机=全店不能打票”。
  2. 组网:IoT 与 Odoo 同生产 VLAN,禁访客 Wi‑Fi;NTP 同步;放行 HTTPS/WebSocket。
  3. 降级:备用键盘楔扫码、系统 USB 直打、称重手工录入双人复核;班组长能独立切换。
  4. 验收:连续 50 次扫码错码率 < 0.5%;连打 30 张小票无卡死;断网恢复可重连;降级演练通过并写入项目纪要。

八、小结

硬件驱动是 Odoo 与物理设备之间的关键连接。通过 IoT,POS/库存/制造/质量等应用可稳定使用打印机、扫码枪、支付终端、秤等设备,并把硬件通信与主应用进程解耦。配置与维护到位,才能把“能演示”变成“能值班”。

九、常见问题 FAQ

Q:IoT 用来连接什么?
连接受支持的打印机、扫码枪、支付设备、秤等,使业务应用能读写硬件。

Q:硬件驱动的作用?
管理 IoT 与某一类设备之间的通信细节。

Q:能否接自定义硬件?
可以。默认不支持时,可通过自定义驱动/接口扩展,但必须压测与版本管理。

中国Odoo网原创中文改写|保留原文技术要点并补充国内实操。Odoo用户手册 · 中文文档 · 中文帮助 · 实操。

Odoo 19 IoT:把扫码枪、秤与打印机接入业务单据
2025年10月18日
存档