5、FUXA ODBC 配置与实战

手把手教你用开源 HMI 工具 FUXA 对接 MySQL、PostgreSQL、SQL Server,实现报警记录、生产报表、工单同步等高级功能!


在工业自动化项目中,你是否遇到过这些场景?

  • 想把 PLC 的报警信息自动存到数据库,方便后期分析?
  • 需要从 MES 系统读取当日工单,并在 HMI 上显示?
  • 希望操作员点击"保存"按钮,就把产品批次写入 SQL Server?
  • 但又不想花大价钱买商业 SCADA 的历史数据库模块?

好消息是------开源 HMI 工具 FUXA 完全可以做到!

通过 ODBC 接口 ,FUXA 能轻松连接 MySQL、PostgreSQL、SQL Server 等主流数据库,实现数据双向交互。今天,我们就来从零开始,一步步配置并实战应用。


🔧 一、为什么选 FUXA + ODBC?

FUXA 是一个基于 Web 的开源 SCADA/HMI 框架,支持 Modbus、S7、OPC UA 等工业协议。而它的 ODBC 功能,让你能:

  • 将实时数据持久化存储
  • 查询历史记录生成报表
  • 与企业 ERP/MES 系统集成
  • 构建完整的"边缘采集 + 中心存储"架构

最关键的是:完全免费、开源、可私有部署!


🐳 二、最快上手方式:用 Docker 一键启动

如果你只是想快速测试,强烈推荐使用官方 Docker 镜像------已内置所有常用 ODBC 驱动!

复制代码
docker run -d -p 1881:1881 --name fuxa frangoteam/fuxa:latest

访问 http://你的IP:1881,即可打开 FUXA 编辑器。

✅ 无需安装驱动,开箱即用!

💡 提示:生产环境建议挂载配置卷,避免重启丢失工程。


⚙️ 三、本地部署?手动安装 ODBC 驱动也不难!

如果你在 Ubuntu/Debian 上用 NPM 安装 FUXA,则需手动配置驱动。

第一步:安装基础依赖
复制代码
sudo apt update
sudo apt install -y unixodbc unixodbc-dev
第二步:下载 FUXA 官方驱动包

前往 GitHub 仓库的 odbc 目录,下载:

  • install_odbc_drivers.sh
  • odbcinst.ini
第三步:运行安装脚本
复制代码
chmod +x install_odbc_drivers.sh
sudo ./install_odbc_drivers.sh
sudo cp odbcinst.ini /etc/odbcinst.ini

完成后,执行 odbcinst -q -d,应能看到:

复制代码
[MySQL]
[PostgreSQL]
[ODBC Driver 17 for SQL Server]

✅ 驱动就绪!


🌐 四、两种连接方式:DSN vs 连接字符串

方式 1:配置 DSN(适合固定部署)

编辑 /etc/odbc.ini:

复制代码
[my-mysql-db]
Driver = MySQL
Server = 192.168.1.50
Database = factory_db
User = scada
Password = your_password
Port = 3306

测试连接:

复制代码
isql my-mysql-db
方式 2:直接用连接字符串(推荐!灵活迁移)

在 FUXA 设备配置中填写:

复制代码
DRIVER=PostgreSQL Unicode;SERVER=10.0.0.10;PORT=5432;DATABASE=plant;UID=scada;PWD=pass;

✅ 优点:不依赖服务器配置,工程可移植性强。


🖥️ 五、在 FUXA 中添加 ODBC 设备

  1. 打开 FUXA 编辑器 → Devices → + Add Device
  2. 类型选择 ODBC
  3. Name 填 myDB(后续脚本中引用)
  4. Connection 填 DSN 名或完整连接串
  5. 保存!

💻 六、实战代码:读写数据库就这么简单!

场景 1:每秒读取最新报警
复制代码
// Server Script
setInterval(async () => {
  const db = await $getDevice('myDB', true);
  const alarms = await db.pool.query(
    'SELECT * FROM alarms WHERE resolved = false ORDER BY time DESC'
  );
  $setTag($getTagId('activeAlarms'), JSON.stringify(alarms));
}, 1000);
场景 2:点击按钮保存产品信息
复制代码
// 边沿检测,防止重复触发
let lastClick = false;
setInterval(async () => {
  const clicked = $getTag($getTagId('btnSave'));
  const name = $getTag($getTagId('productName'));

  if (clicked && !lastClick) {
    const db = await $getDevice('myDB', true);
    await db.pool.query(
      'INSERT INTO products (name, created_at) VALUES (?, NOW())',
      [name]
    );
  }
  lastClick = clicked;
}, 100);
场景 3:前端表格展示历史数据
  • Server 脚本定时拉取数据并存入 Tag
  • Client 脚本解析 JSON 并绑定到 Table 控件
  • 用户看到动态刷新的生产报表!
步骤 1:Server 脚本定时拉取数据

位置:View 编辑器 → 右侧 "Script" 标签 → 切换到 Server 选项卡

复制代码
// === Server Script: 定时从数据库拉取数据并更新 Tag ===

// 每 2000 毫秒(2秒)执行一次
setInterval(async () => {
  try {
    // 1. 获取已配置的 ODBC 设备(名称需与 Devices 中一致)
    const db = await $getDevice('myProductionDB', true); // ← 替换为你自己的设备名!

    // 2. 执行 SQL 查询(以 PostgreSQL 为例)
    // 注意:PostgreSQL 表名区分大小写,建议加双引号
    const result = await db.pool.query(`
      SELECT 
        "id",
        "product_name" AS name,
        "output_qty" AS qty,
        "shift",
        TO_CHAR("log_time", 'YYYY-MM-DD HH24:MI:SS') AS time
      FROM "production_log"
      ORDER BY "log_time" DESC
      LIMIT 50
    `);

    // 3. 将结果转为 JSON 字符串,存入 Tag
    const jsonData = JSON.stringify(result);
    $setTag($getTagId('productionTableData'), jsonData);

    // 可选:打印日志(在 FUXA 后台 Console 查看)
    console.log(`[DB] Fetched ${result.length} records`);

  } catch (error) {
    console.error('[DB ERROR]', error.message || error);
    // 即使出错,也可清空表格或显示错误提示
    $setTag($getTagId('productionTableData'), '[]');
  }
}, 2000);

🔧 你需要修改的地方:

  • 'myProductionDB' → 替换为你在 Devices 中创建的 ODBC 设备名称
  • SQL 语句 → 根据你的实际表结构调整字段名和表名
步骤 2:Client 脚本绑定到 Table 控件

位置:View 编辑器 → "Script" 标签 → 切换到 Client 选项卡

复制代码
// === Client Script: 监听 Tag 变化,更新前端表格 ===

// 监听 productionTableData 的变化
$watch($getTagId('productionTableData'), (newValue) => {
  if (!newValue || newValue === '[]') {
    // 数据为空时清空表格
    const emptyTable = { columns: [], rows: [] };
    $invokeObject('productionTable', 'setTableAndData', emptyTable);
    return;
  }

  try {
    // 解析 JSON 数据
    const rows = JSON.parse(newValue);

    // 定义表格列(必须与 SQL 查询的 AS 别名一致)
    const columns = [
      { id: 'id', label: 'ID', width: 60 },
      { id: 'name', label: '产品名称', width: 120 },
      { id: 'qty', label: '产量', width: 80 },
      { id: 'shift', label: '班次', width: 80 },
      { id: 'time', label: '时间', width: 160 }
    ];

    // 构造表格数据对象
    const tableData = {
      columns: columns,
      rows: rows
    };

    // 调用 Table 控件的方法更新内容
    $invokeObject('productionTable', 'setTableAndData', tableData);

  } catch (e) {
    console.error('Failed to parse table data:', e);
    // 可选:显示错误提示
    alert('表格数据解析失败,请检查数据库返回格式');
  }
});

✅ 关键点:

  • 使用 $watch 监听 Tag 变化,自动响应更新
  • columns.id 必须与 SQL 中的字段别名(AS)完全一致
  • $invokeObject('productionTable', ...) 中的 ID 必须与 Table 控件 ID 一致

⚠️ 七、避坑指南:这些细节你必须知道

|-----------------|-----------------------------|
| 问题 | 解决方案 |
| MySQL 连不上 | 加 SSLMODE=DISABLED (测试环境) |
| PostgreSQL 表名报错 | 用双引号:"Customer" |
| 脚本改了没生效 | 重启 FUXA 服务 |
| 密码明文不安全 | 用环境变量或加密 Tag |
| 高频写入卡顿 | 降低轮询频率,启用连接池 |


🚀 八、不止于数据库:FUXA 的更多可能

  • 结合 Node-RED 做数据清洗
  • 用 WebSocket 推送实时变化
  • 部署在 树莓派 上做边缘 HMI
  • 对接 阿里云/华为云 IoT 平台

FUXA 不只是一个 HMI,更是你构建 低成本工业智能系统 的核心引擎!


📣 结语

开源的力量,正在改变工业软件的格局。

FUXA + ODBC,让你用 零成本 实现过去万元级 SCADA 才有的数据库功能。

🔗 项目地址:https://github.com/frangoteam/FUXA

📘 官方 Wiki:https://github.com/frangoteam/FUXA/wiki/HowTo-ODBC

如果你觉得有用,欢迎点赞、转发,或在评论区留下你的应用场景!

相关推荐
乐讯通物联网服务商2 天前
地下管网智能化监测:排水管网液位计联网难点与物联网卡落地方案
物联网·物联网卡·地下管网智能化监测
河北乐讯通物联网服务商2 天前
城市排水防涝智能化调度:调度终端联网痛点与物联网卡核心应用
物联网·物联网卡·城市排水防涝
TDengine (老段)2 天前
TDengine IDMP 功能点—数据接入
大数据·数据库·物联网·时序数据库·tdengine·涛思数据
zwd20052 天前
Manim 怎么放大画面的某一部分?
python·动画·可视化·manim·数学动画
隔窗听雨眠2 天前
净水机物联网平台的多模数据库落地实践
物联网·时序数据库·kwdb
闻缺陷则喜何志丹3 天前
可视化前端Web组态软件
前端·数字孪生·可视化·web组态·吾乐吾
数字新视界3 天前
机房动环监控系统在提升数据中心安全与效率中的创新应用
物联网·数据中心·数据中心基础设施管理·dcim管理系统·数据中心dcim
不脱发的程序猿3 天前
ESP32制作加热杯垫
嵌入式硬件·物联网·esp32·语音识别
数字新视界3 天前
数据中心DCIM管理系统助力提升机房管理效率与安全性
大数据·人工智能·物联网·信息与通信·动环监控系统
数字新视界4 天前
信创动环监控在机房环境管理中的智能化应用与实践分析
大数据·人工智能·物联网·信息与通信·动环监控系统