knxd连接USB KNX接口实战udev规则与5类适配器配置手把手清单【免费下载链接】knxd项目地址: https://gitcode.com/gh_mirrors/kn/knxdknxd是一个运行在 Linux 上的 KNX 接口网关/路由守护进程能连接几乎所有已知的 KNX 硬件接口包括 USB 直连适配器、串口模块和 IP 网关。本文手把手带你搞定 knxd 连接 USB KNX 接口最容易卡住的一环——udev 规则并给出 5 类 KNX USB 适配器的完整配置清单让新手也能一次点亮总线。 为什么 udev 规则是绕不开的第一步把 KNX USB 适配器插进电脑后Linux 通常会把设备文件如/dev/ttyACM0或/dev/usb/...分配给root用户而 knxd 以普通用户knxd身份运行于是出现两个经典问题❌ 权限不足knxd 打不开设备文件❌ 设备歧义再插一个同类串口设备时knxd 连错设备。udev 规则一次性解决两个问题把设备所有者改成 knxd并创建一个稳定的软链接如/dev/knx1、/dev/ttyKNX1。knxd 官方内置了一份 udev 规则文件 systemd/knxd.udev安装时会被放到系统 udev 规则目录覆盖绝大多数品牌适配器通用规则说明见 contrib/udev/README.md通过 udev 规则KNX 设备会获得 knxd 用户的访问权限knxd 进程因此无需 root 即可读写设备这也与 systemd 服务文件配套使用。⚠️ 官方文件的开头就强调不要直接修改它升级会被覆盖而要新建自己的规则文件例如/etc/udev/rules.d/70-your-knxd.rules。 快速安装 knxd从源码构建三步走git clone https://gitcode.com/gh_mirrors/kn/knxd cd knxd sh bootstrap.sh ./configure --enable-usb # 开启 USB 适配器支持 make -j$(nproc) sudo make installDebian/Ubuntu 用户请注意官方打包已迁移到debian分支按 README 提示先git checkout debian。systemd 环境下守护进程配置在/etc/knxd.conf模板可参考 systemd/knxd.confknxd 用户由 sysusers 自动创建见 systemd/sysusers.d/knxd.conf。 udev 规则怎么写两种标准句式句式一串口类设备TPUART/TUL 等——建软链接核心思路先用udevadm查出设备的 USB 路径再把SYMLINKOWNER写进规则# 第1步查看设备属性找到 ATTRS{manufacturer}busware.de 那一块 udevadm info --attribute-walk /sys/bus/usb/drivers/cdc_acm/*/tty/ttyACM0输出中的KERNELSxxxxxxxx就是 USB 路径每台机器不同。然后写入规则文件ACTIONadd, SUBSYSTEMtty, ATTRS{idVendor}03eb, ATTRS{idProduct}204b, KERNELSxxxxxxxx, SYMLINKknx1, OWNERknxd接着验证udevadm test /sys/bus/usb/drivers/cdc_acm/*/tty/ttyACM0 ls -lL /dev/knx1 # 应显示 knxd 属主句式二USB HID 类设备标准 KNX USB 接口——只改属主这类设备通过/dev/usb/XXX/YYY访问只需要改属主。用lsusb查到厂商/产品 ID 后ACTIONadd, SUBSYSTEMusb, ENV{DEVTYPE}usb_device, ATTRS{idVendor}0e77, ATTRS{idProduct}0103, OWNERknxd官方 systemd/knxd.udev 已内置约 20 个品牌的规则包括SchlapsPartner、Siemens导轨/嵌入式、Weinzierl多款、InstaGira/Jung/Merten/Hager/Berker/Feller、Busch-Jaeger、ABB STOTZ-KONTAKT、Tapko UIM-KNX、MDT SCN-USBR、SATEL、Züblin、Vimar。如果你的设备不在列表里加一条规则并向项目提交补丁即可。 5类 KNX USB 适配器配置清单#适配器类型驱动典型设备文件关键 udev 句式1USB HID 标准接口usb/dev/usb/X/Y只改 OWNER2TPUART / TUL 串口tpuart/dev/ttyKNX1SYMLINK OWNER3FT1.2 老式串口ft12/dev/ttyXXXSYMLINK OWNER4FT1.2-CEMI 串口ft12cemi/dev/ttyXXXSYMLINK OWNER5NCN5120 芯片ncn5120/dev/ttyXXXSYMLINK OWNER各驱动的完整参数说明见配置文件格式文档 doc/inifile.rst。类型1USB HID 接口usb 驱动——最省事这类接口走 HID 协议好处是插到 Windows 上无需驱动就能开 ETS。knxd 的usb驱动会自动发现设备并自动识别 EMI1/EMI2/CEMI 协议版本通常不需要任何选项配置里写driver usb即可。单个适配器零配置靠内置 udev 规则获得权限多个适配器需要用busdevice选项指定注意官方警告重启后总线/设备号可能变化不确定设备号运行findknxusb工具源码见 src/usb/findknxusb.cpp它会列出所有可用的 KNX USB 设备地址。类型2TPUART / TUL 串口适配器tpuart 驱动TUL 等模块表现为 CDC-ACM 串口/dev/ttyACM0必须走句式一。按上文三步做完后配置里写[B.tpuart] driver tpuart device /dev/knx1 baudrate 19200device默认就是 udev 软链接/dev/ttyKNX1所以udev 规则是必需的不是可选项。第二个 TPUART 就照葫芦画瓢用ttyACM1→knx2。 老坑提醒规则里的KERNELS与 USB 端口绑定换端口后必须更新规则——这是官方有意为之的设计。类型3FT1.2 老式串口适配器ft12 驱动FT1.2 是较老的串口接口把 EMI1 协议封装在串口帧里默认波特率 19200。配置示例[B.ft12] driver ft12 device /dev/ttyUSB0 baudrate 19200同样先加 udev 软链接规则。还支持send-timeout默认 0.3 秒、send-retries等重传参数。类型4FT1.2-CEMI 串口适配器ft12cemi 驱动新一代串口接口CEMI 封装默认波特率 19200选项与 ft12 基本一致只是把驱动名换成ft12cemi[B.ft12cemi] driver ft12cemi device /dev/ttyKNX1 baudrate 19200类型5NCN5120 芯片适配器ncn5120 驱动NCN5120 是与 TPUART2 大部分兼容的 KNX 接口芯片用法与 tpuart 相同唯一区别是默认波特率 38400[B.ncn5120] driver ncn5120 device /dev/knx1 baudrate 38400加餐树莓派 HAT 版 TPUART树莓派上用板载串口跑 TPUART HATudev 规则更简单systemd/knxd.udev 中已有注释模板Pi 3KERNELttyAMA0Pi 4KERNELS107d001000.serialPi 5KERNELS1f00030000.serial。⚠️ Pi 2/3 需先禁用内核串口控制台编辑/boot/cmdline.txt去掉consolettyAMA0Pi 3 还需在/boot/config.txt加dtoverlaypi3-disable-bt并systemctl disable hciuart否则硬件串口被蓝牙占用、传输不稳。 knxd.ini 完整配置示例把所有连接写进/etc/knxd.ini格式见 doc/inifile.rst下面是一个USB HID 接口 systemd 服务的典型配置[main] addr 7.0.1 client-addrs 7.0.2:8 connections server,B.usb systemd systemd [B.usb] driver usb [server] server ets_router [systemd] error-level fatal要点addr是 knxd 自己在总线上的地址必填client-addrs是分配给客户端的地址段如7.0.2:8表示 7.0.2~7.0.9使用 server 功能时必填老版本命令行参数可用/usr/lib/knxd_args自动转换成本 ini 格式。✅ 验证连接成功的 3 个命令ls -lL /dev/knx1或对应设备——确认属主是knxdsudo systemctl restart knxd—— 干净重启守护进程journalctl -u knxd --since 2 min ago—— 看日志确认驱动初始化成功、无权限错误。 需要深入排错时给启动参数加-f9 -t1023可开启详尽日志提示见 systemd/knxd.conf。 常见问题排查连接失败的快速修复症状大概率原因修复动作打开设备无权限没写 udev 规则 / 规则未生效按句式补 OWNER重新插拔设备KERNELS匹配不上换了 USB 端口重跑udevadm info --attribute-walk更新规则多适配器连错设备USB HID 类未指定地址用busdevice选项或findknxusb定位编程模式报错缺少 single 过滤驱动前加-B single重启后设备号变了USB HID 编号漂移改用固定 USB 口或重新指定 bus/device 上手自检清单已创建knxd用户守护进程非 root 运行udev 规则文件放在/etc/udev/rules.d/70-*.rules不改官方文件udevadm test通过后设备属主为 knxdini 中addr、client-addrs、connections三项齐备波特率与硬件一致tpuart 19200 / ncn5120 38400journalctl日志中无权限/超时错误按这份清单走完你的 USB KNX 接口就能稳定接入 knxd 了。遇到未收录的适配器型号加一条 udev 规则并提交补丁让后来者开箱即用——这正是 knxd 社区维护 systemd/knxd.udev 设备清单的方式。【免费下载链接】knxd项目地址: https://gitcode.com/gh_mirrors/kn/knxd创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考