逻辑编程（DDC 图形化编程）

逻辑编程是新版上位机工具里的一种拖方块编程方式：从功能块库里把「取温度 → 比较 → 控制」这样的方块拖到画布上、连起来，点「下发设备」，程序就存在设备里自动运行。不用记指令、不用写代码，适合暖通空调、风机水泵、简单联动这一类控制需求。

它和梯形图、Lua 脚本、DTU 配置式编程是并列的四种编程方式，可以只用其中一种，也可以混着用：

	DTU 配置式	逻辑编程（本板块）	梯形图	Lua 脚本
上手难度	最低，勾选填表	低，拖方块	中，要懂指令	最高，要会编程
适合场景	采集第三方仪表、上云、串口透传	楼宇自控 / DDC 类控制、简单联动	逻辑控制、设备替换（FX 系列）	复杂计算、通信、上云
编辑入口	上位机设备详情页 → DTU 功能	上位机「逻辑编程」按钮	上位机「编辑器」	上位机「编辑器」
与其他方式的关系	同时运行、互不干扰	与其余三种同时运行、互不干扰	—	—

什么时候选逻辑编程

• 不熟悉 PLC 指令，想用「积木」的方式搭控制逻辑
• 做暖通空调（风机盘管、空调机组）、给排水这一类项目，需要 PI 调节、焓值 / 露点这类暖通专业计算
• 已经用梯形图或 Lua 写了程序，想再加一段自动控制逻辑，又不想动现有程序

只是要把第三方仪表的数据采上来、或者把寄存器送到云端，不用逻辑编程 —— 用 DTU 配置式编程，勾选填表即可，连方块都不用拖。

支持的设备

「逻辑编程」按钮只在支持逻辑编程的设备详情页出现，且设备软件版本要达到门槛。 完整那张「设备 + 硬件版本号 + 需要的设备软件版本」的表只在 1.1 打开逻辑编程编辑器 放一份（改口径只改那里）。 版本不够时按钮直接不显示，先升级固件；其他型号暂不支持逻辑编程。

章节导航

进阶核心：第四章 自定义功能块

自带块解决通用需求，而**「自定义功能块」能把您自己的专用算法 / 工艺诀窍封成一个块，加密码后交付给客户复用**——客户拖出来填几个参数就能用，却看不到内部源码。这是用逻辑编程实现复杂功能、形成差异化交付的关键能力，首次使用建议按 4.1 概览 → 4.2 手把手 的顺序操作。

章节	内容
1.1 打开逻辑编程编辑器	入口在哪、编辑器界面怎么用
1.2 第一个逻辑程序	从内置示例开始，10 分钟跑通一遍
2.0 功能块速查总表	全部自带功能块一页列全：叫什么、有什么端口、下发成什么，找块先来这里
2.1 程序类功能块	主循环、定时循环、条件判断、赋值
2.2 数据类功能块	读寄存器、常量、系统时钟、通信变量
2.3 逻辑类功能块	与或非、比较、沿触发、定时器、启停
2.4 计算类功能块	算术、限值、线性变换、取位合并、累计时间
2.5 HVAC 暖通功能块	PI 控制、焓值 / 露点 / 湿球温度计算
2.6 显示模块	做屏幕页面（由屏读取渲染，设备只保存程序）
3.1 下发与设备端运行	程序怎么存到设备、怎么跑、怎么改
3.2 常见问题	数量限制速查、报错说明、排错
4.1 自定义功能块（概览）	第四章·核心：把专属工艺封成自己的块，可加密交付给客户
4.2 手把手做第一个块	10 分钟从零做出一个能用的自定义块
4.3 Lua 接口与编写详解	I 表、返回值、state 记忆、编写约定与常用片段
4.4 加密、导出分享与块管理	加密保护算法、导出块文件、客户导入使用、块管理
4.5 实战案例集	累计、限幅、线性标定、PI 调节、多输出等可照抄案例
4.6 自定义块常见问题	制作、Lua、拖用、加密交付各环节排错

每个自带功能块还有一页自己的详解（共 35 页，形如 blocks/ddc-timer.html）：块面参数、连线端子、下发成什么操作、示例与常见问题。 从 2.0 功能块速查总表 的「详解」列点进去，或用侧边栏「功能块详解」那一组直接挑。 上面 2.1～2.6 现在只作本章导览（每块一行链到它自己的页），用法正文都在块页里。