emqx/ek-can

EK-CAN - 基于eKuiper的边缘轻量级CAN总线数据分析软件

https://img.shields.io/badge/Slack-EMQ-39AE85?logo=slack](https://slack-invite.emqx.io/) https://img.shields.io/***/931086341838622751?label=***&logo=]([] https://img.shields.io/badge/Follow-EMQ-1DA1F2?logo=]([] https://img.shields.io/badge/Subscribe-EMQ-FF0000?logo=]([]

概述

EK-CAN是基于eKuiper的边缘轻量级CAN总线数据分析软件。LF Edge eKuiper是一款运行在资源受限边缘设备上的IoT流处理引擎，提供SQL或图形化规则能力。EK-CAN在此基础上扩展了CAN总线相关功能，可实时处理CAN数据。

核心功能

• CAN数据源：支持通过socketCAN接口读取CAN总线原始数据
• 数据解析：
  • can格式：单帧CAN数据解析，需指定DBC文件映射为物理信号
  • canjson格式：批量CAN帧的JSON数据解析，支持DBC文件映射
• 流处理能力：继承eKuiper的过滤、转换、聚合等实时分析功能

使用场景

• 边缘设备上的CAN总线数据实时分析
• 汽车、工业设备等CAN网络的数据处理与转发
• 结合MQTT等协议实现CAN数据的跨系统传输

配置说明

直接运行镜像

需在Linux环境启用socketCAN：

bash
# 共享主机网络访问CAN接口
docker run -d --name ekuiper --network host -e CAN__DEFAULT__ADDRESS="can0" -e MQTT_SOURCE__DEFAULT__SERVER="tcp://127.0.0.1:9081" emqx/ek-can:$tag

# 非主机网络模式
docker run -p 9081:9081 -d --name ekuiper -e CAN__DEFAULT__ADDRESS="can0" -e MQTT_SOURCE__DEFAULT__SERVER="$MQTT_BROKER" emqx/ek-can:$tag

Docker Compose示例（含Manager UI）

yaml
version: '3.4'
services:
  ekuiper:
    image: emqx/ek-can:latest
    container_name: ekuiper_can
    network_mode: host # 需访问主机CAN接口时启用
    restart: unless-stopped
    volumes:
      - kuiper_data:/kuiper/data
      # - /opt/dbc:/kuiper/dbc # 挂载自定义DBC文件
    environment:
      MQTT_SOURCE__DEFAULT__SERVER: "tcp://127.0.0.1:1883"
      CAN__DEFAULT__ADDRESS: "can0"
  
  manager:
    image: emqx/ekuiper-manager:1.9.3
    container_name: manager_can
    ports:
      - "9082:9082"
    restart: unless-stopped
    environment:
      DEFAULT_EKUIPER_ENDPOINT: "http://192.168.x.x:9081" # 替换为eKuiper服务地址
volumes:
  kuiper_data:

快速开始步骤

1. 配置CAN接口：使用真实硬件或虚拟接口（vcan模块）
2. 创建CAN流：通过REST API或Manager UI定义流（指定TYPE="can"和FORMAT="can"）
3. 创建分析规则：编写SQL规则处理CAN数据，输出到MQTT等目标
4. 测试验证：发送CAN数据并查看处理结果

联系我们

如需支持，请访问EMQ官方联系页面。

有用链接

• eKuiper官方文档
• CAN总线技术指南
• https://www.emqx.io/

许可条款

本软件为评估版，仅可用于内部测试目的，不得用于商业生产环境。详细条款请参考镜像内的许可文档。