ISO 23704-4标准解读:用UML构建机床信息模型实战指南
1. 从一份标准文档说起:为什么机械行业也需要UML
第一次拿到 ISO 23704-4-2026 这份标准的目录时,我脑子里冒出的第一个念头是:机械行业的标准化文档,怎么跟软件工程里的 UML 扯上关系了?干过机床电气设计和数控系统集成的人都知道,传统机械领域的标准文档基本是两种画风——要么是密密麻麻的表格加参数,要么是机械制图式的二维剖视图。突然看到一份用统一建模语言(UML)来表述的行业标准,确实会让人愣一下。
但仔细翻完这份标准的框架之后,我理解了它的用意。ISO 23704 系列本身针对的是智能机床的数据模型与信息交互,到了第 4 部分,重点落在“用 UML 表示”这件事上。说白了,就是要把机床这个物理实体、它的控制逻辑、它的数据接口、它和上层系统之间的交互关系,用一套软件行业已经验证了几十年的可视化建模语言统一描述出来。这样一来,做数控系统的、做上位机软件的、做产线集成的、做数字孪生的,大家看的是同一套图,说的是同一种“语言”。
这件事的价值在哪儿?我举个实际场景。以前做一条柔性加工线,机床厂商给的接口文档是一套说法,PLC 集成商理解的逻辑是另一套,MES 那边要的数据结构又是第三套。三方对接的时候,光是对齐“主轴状态”这个字段到底包含哪些子状态,就能来回扯上好几轮邮件。如果一开始就有一份用 UML 类图定义好的信息模型,每个类有哪些属性、属性是什么类型、类与类之间是什么关系,全都画得清清楚楚,对接成本会直线下降。
这份标准适合谁来参考?我梳理了一下,大致是这几类人:做机床数控系统开发的工程师、做工业软件和 MES/SCADA 的开发者、做产线自动化集成的技术人员、搞数字孪生和工业互联网平台的产品经理,以及机械专业里需要跟软件团队协作的系统架构师。哪怕你暂时不直接用到这份标准的全文,理解它背后的建模思路,对日常做设备数据采集、接口定义、系统集成都有实打实的帮助。
接下来我不打算逐条翻译标准原文,那没意义。我想做的是把这份标准里最核心的建模思路拆开,结合 UML 的几种关键图型,讲清楚它在机械行业里到底怎么用、用的时候要注意什么、我踩过哪些坑。文章会比较长,但每一段都是我实际做项目时验证过的东西。
2. 核心思路拆解:为什么是UML,而不是表格或XML
2.1 机械行业信息建模的三条老路及其局限
在 UML 被引入之前,机械行业描述设备和数据模型,主要靠三条路子。第一条是参数表格,比如一份机床规格书,把行程、转速、功率、精度等参数列成表。这种方式直观,但只能描述静态属性,描述不了“机床在加工过程中主轴状态如何随进给轴联动而变化”这种动态行为。第二条是接口协议文档,比如定义一堆寄存器地址和报文格式,这种方式偏底层,可读性差,而且一旦设备型号变了,地址映射就得重写。第三条是XML Schema 或 JSON Schema,这是近些年工业互联网兴起后常用的方式,用结构化文本定义数据模型。它比表格强,能表达嵌套和类型,但有个问题:Schema 文件是给机器读的,人读起来费劲,尤其是当模型有几十个类、上百个属性的时候,光靠读 XSD 文件很难在脑子里建立起整体结构。
这三条路子的共同短板是:缺乏对“关系”和“行为”的统一可视化表达。而机床作为智能装备,它的价值恰恰在于各部件之间的协同关系,以及加工过程中的状态迁移。这正是 UML 的强项。
2.2 UML在机械信息模型中的四个核心图型
ISO 23704-4 这份标准并没有把 UML 的十几种图全用上,而是聚焦在四类最实用的图型上。我按实际使用频率从高到低排一下。
类图(Class Diagram) 是绝对的核心。它用来定义机床信息模型中的实体类,比如“机床”“主轴”“进给轴”“刀具”“工件”“加工任务”等。每个类有属性(如主轴的最高转速、当前转速、温度)和操作(如启动、停止、换刀)。类与类之间有 association(关联)、aggregation(聚合)、composition(组合)、inheritance(继承)等关系。标准里特别强调用组合关系来表达“机床包含主轴、进给轴、刀库”这种整体-部分结构,因为主轴不能脱离机床独立存在,用实心菱形的组合关系最准确。
状态机图(State Machine Diagram) 用来描述机床或部件的状态迁移。比如主轴的状态可以定义为“停止”“加速中”“匀速运行”“减速中”“故障”五个状态,状态之间的迁移条件是什么,迁移时触发什么动作。这个图在实际开发中极其有用,因为很多设备对接的 bug 就出在状态定义不一致上——你说“运行”,我说“Ready”,他说“Active”,最后数据对不上。
序列图(Sequence Diagram) 用来描述一次完整交互的时间顺序。比如“上位机下发加工任务”这个场景,序列图会画出:MES 系统发送任务指令 → 机床控制器接收并校验 → 控制器返回确认 → 控制器启动加工 → 加工完成后上报结果。每个步骤谁发给谁、发什么消息、有没有同步等待,一目了然。做接口联调的时候,这张图就是最好的沟通工具。
用例图(Use Case Diagram) 相对宏观,用来界定系统的功能边界。比如“操作员”“维护工程师”“MES系统”分别是哪些用例的参与者,机床系统对外提供哪些功能。这个图在项目初期定义需求范围时特别管用,能避免后期无休止的需求蔓延。
2.3 为什么不用纯文本Schema替代UML
有人可能会问:既然最终数据交换还是要落到 JSON 或 XML 上,为什么不直接定义 Schema,非要先画 UML?我的理解是,UML 解决的是“人和人之间的共识”问题,Schema 解决的是“机器和机器之间的传输”问题。两者不是替代关系,而是上下游关系。先用 UML 把模型讨论清楚、达成一致,再从 UML 模型自动或半自动地生成 Schema,这才是标准推荐的路径。ISO 23704-4 里也提到了模型驱动架构(MDA)的思路:UML 模型是平台无关模型(PIM),通过转换规则生成特定平台的模型(PSM),最后生成代码或 Schema。
从实操角度看,直接写 Schema 最大的问题是过早陷入细节。你还在讨论“刀具寿命”这个属性该不该放在刀具类里,就已经开始纠结字段名用驼峰还是下划线了。而用 UML 类图讨论时,你可以先画一个框写上“刀具”,列出几个核心属性,把关系理清楚,细节可以后面再补。这种“先结构后细节”的工作方式,在复杂系统建模里效率高得多。
3. 核心细节解析:类图、状态机图与序列图的实操要点
3.1 类图建模:从机床物理结构到信息类的映射
画机床的类图,第一步不是打开建模工具,而是拿一张白纸,把机床的物理组成列出来。以一台典型的立式加工中心为例,物理上包含:床身、立柱、主轴、刀库、工作台、进给轴(X/Y/Z)、冷却系统、润滑系统、排屑系统、数控系统、操作面板。这些物理部件哪些需要建模成独立的类,哪些可以作为属性挂在父类上,是有讲究的。
我的经验是:如果一个部件有独立的状态、独立的数据采集点、或者需要被单独控制,就建一个类。比如主轴,它有转速、温度、振动、负载等多个采集点,有启动/停止/定向等控制操作,必须独立成类。而床身,它主要是结构支撑,没有动态数据,最多作为一个属性记录型号,不需要单独建类。
标准里推荐用组合关系来表达机床与核心部件的关系。在 UML 类图中,组合关系用实心菱形表示,菱形在“整体”那一端。比如“机床”和“主轴”之间是组合关系,意味着主轴的生命周期由机床管理,机床销毁了,主轴对象也就不存在了。而“机床”和“刀具”之间通常是聚合关系(空心菱形),因为刀具可以从机床上卸下来,装到另一台机床上,生命周期不绑定。
属性定义是类图里最容易出问题的地方。我见过太多项目在属性命名和类型上不统一,导致后期数据映射时各种转换。ISO 23704-4 建议遵循几个原则:属性名用英文名词或名词短语,采用大驼峰或小驼峰(标准里推荐小驼峰);每个属性必须标注数据类型,比如 spindleSpeed: float、spindleState: SpindleStateEnum;对于枚举类型,要单独定义一个枚举类,把可能的值列全。比如主轴状态枚举,不能只写“运行/停止”,要把“待机”“加速”“减速”“报警”“维护”都列进去。
还有一个细节:单位。机械行业的属性值几乎都带单位,转速是 rpm,温度是摄氏度,位置是毫米。标准建议在属性名或注释中明确单位,比如 spindleSpeedRpm: float 或者用注释标注 unit: rpm。我个人的做法是在属性名里带上单位缩写,虽然看起来啰嗦,但能避免很多低级错误。曾经有个项目因为转速单位没统一,一边按 rpm 传,一边按 rad/s 解析,结果主轴直接飙到危险转速,幸好急停及时。
3.2 状态机图:把“设备状态”这件事说清楚
状态机图是我认为这份标准里最有实操价值的部分。设备状态定义不清,是工业数据采集和系统对接中最常见的坑。我经历过一个项目,机床厂商说主轴状态有“运行”和“停止”两种,但实际加工中还有“定向”“换刀”“预热”等状态,结果上位机显示的主轴状态永远只有两种,操作员根本没法判断机床到底在干什么。
用状态机图来定义,就能避免这个问题。画状态机图的关键是穷举状态和明确迁移条件。以主轴为例,我通常会定义这几个状态:Idle(空闲)、Accelerating(加速中)、Running(匀速运行)、Decelerating(减速中)、Orienting(定向中)、Fault(故障)。迁移条件包括:收到启动指令且当前在 Idle → 迁移到 Accelerating;转速达到设定值 → 迁移到 Running;收到停止指令 → 迁移到 Decelerating;转速降到零 → 迁移到 Idle;收到定向指令 → 迁移到 Orienting;任何状态下检测到报警信号 → 迁移到 Fault。
这里有个容易忽略的点:初始状态和终止状态。状态机图必须有一个初始状态(实心圆点),但不一定有终止状态,因为机床通常是循环运行的。标准里建议对每个状态定义“进入动作”和“退出动作”,比如进入 Running 状态时开始记录运行时长,退出时停止计时并累加。这些动作定义清楚了,做数据采集时就知道在哪个状态切换点去触发数据上报。
还有一个实操技巧:状态编码。状态机图是给人看的,但程序里需要数字或字符串编码。我习惯在状态机图旁边附一张状态编码表,把每个状态映射到一个整数或字符串,比如 Idle=0, Accelerating=1, Running=2……这样开发人员直接照着表写代码,不会出现“这个状态到底用 1 还是 2”的争论。
3.3 序列图:接口联调的“剧本”
序列图在标准里被用来描述机床与外部系统之间的交互流程。我把它比作接口联调的“剧本”——谁先说话、谁后说话、说什么、等不等回复,全画出来。画序列图的时候,有几个关键要素必须明确。
生命线:每个参与交互的对象画一条垂直虚线,顶部是对象名。比如“MES系统”“机床控制器”“主轴驱动”“刀库控制器”。生命线之间的水平箭头表示消息传递,实线箭头是同步消息(发送方等待回复),虚线箭头是异步消息(发送方不等待)。
激活条:生命线上的窄矩形,表示对象正在执行操作的时间段。这个细节很多人忽略,但它能直观看出哪个环节耗时最长。比如机床控制器接收任务后,要依次校验刀具、校验程序、校验工件坐标系,这三个校验是串行还是并行,激活条一画就清楚了。
消息编号:标准建议给消息加编号,比如 1.0、1.1、1.2,表示嵌套调用关系。1.0 是 MES 发送任务,1.1 是控制器校验刀具,1.2 是控制器校验程序。这样在看图的时候,能清楚知道哪些步骤是顺序执行,哪些是条件分支。
我实际用序列图最大的收获是:它逼着你在写代码之前把异常流程想清楚。正常流程好画,但“刀具校验失败怎么办”“程序语法错误怎么办”“通信超时怎么办”,这些异常分支如果不画出来,开发时很容易漏掉。标准里建议对每个可能失败的消息,都画一条 alt 组合片段,列出成功和失败两种路径。虽然画的时候麻烦,但联调时能省下大量排查时间。
4. 实操过程:从零搭建一份机床UML信息模型
4.1 工具选型与建模环境准备
工欲善其事,必先利其器。画 UML 图,工具选择直接影响效率。我这些年用过不少工具,大致分三类。
专业建模工具:比如 Enterprise Architect、MagicDraw、Papyrus。这类工具功能全,支持 UML 2.5 全部图型,能生成代码和文档,适合大型项目。缺点是学习曲线陡,正版价格不低。如果团队规模大、模型复杂,值得投入。
轻量绘图工具:比如 draw.io、PlantUML、Mermaid。draw.io 免费、上手快,适合画中小规模的图。PlantUML 和 Mermaid 是文本化建模,用代码描述图,版本管理方便,适合习惯用 Git 的团队。缺点是复杂图型的表达能力有限,比如 PlantUML 画状态机图就不如专业工具灵活。
在线协作工具:比如 Lucidchart、ProcessOn。适合分布式团队协作,多人同时编辑,评论和版本历史完善。缺点是数据在云端,有些企业对数据安全有要求,需要评估。
我个人的推荐是:中小项目用 draw.io 或 PlantUML 起步,大项目上 Enterprise Architect。如果团队已经在用 Git 管理代码,PlantUML 是很好的选择,因为 .puml 文件可以跟代码一起版本管理,每次修改都有记录,diff 也看得清楚。
建模环境准备好之后,建议先建一个包结构。标准里推荐按领域划分包,比如 MachineModel 包放机床本体相关的类,ToolModel 包放刀具相关的类,ProcessModel 包放加工过程相关的类。包结构清晰了,后面找类、改类都方便。
4.2 第一步:定义核心类与属性
假设我们要为一台立式加工中心建模。第一步是定义核心类。我通常会从这几个类开始:MachineTool(机床)、Spindle(主轴)、FeedAxis(进给轴)、ToolMagazine(刀库)、Tool(刀具)、Workpiece(工件)、NCProgram(数控程序)、MachiningTask(加工任务)。
以 Spindle 类为例,属性定义如下:
操作定义:
这里有个细节:start 操作的参数是目标转速,而不是直接设定当前转速。因为主轴从静止到目标转速有一个加速过程,当前转速是状态机图里 Accelerating 状态下的动态值,不能直接赋值。这个区分在建模时就要明确,否则开发人员可能直接写 currentSpeed = targetSpeed,忽略了加速过程。
SpindleStateEnum 枚举类的定义:
4.3 第二步:梳理类之间的关系
类定义好之后,接下来梳理关系。MachineTool 和 Spindle 是组合关系,因为主轴是机床的固有组成部分。MachineTool 和 ToolMagazine 也是组合关系。ToolMagazine 和 Tool 是聚合关系,因为刀具可以装卸。MachineTool 和 NCProgram 是关联关系,机床可以加载多个程序,但程序不隶属于某一台机床。
在 UML 类图中,关系的表示方式如下:
| 关系类型 | 符号 | 含义 | 机床建模示例 |
|---|---|---|---|
| 关联 | 实线 | 两个类之间有连接 | 机床与数控程序 |
| 聚合 | 空心菱形 | 整体-部分,部分可独立 | 刀库与刀具 |
| 组合 | 实心菱形 | 整体-部分,部分不可独立 | 机床与主轴 |
| 继承 | 空心三角箭头 | 子类继承父类 | 加工中心继承机床基类 |
| 依赖 | 虚线箭头 | 一个类使用另一个类 | 加工任务依赖刀具 |
多重性也要标注清楚。比如一台机床有多个进给轴(通常是 3 个或 5 个),在 MachineTool 端标注 1,在 FeedAxis 端标注 3..5。一个刀库有多个刀位,ToolMagazine 端标 1,Tool 端标 0..*(刀位可能为空)。
4.4 第三步:用状态机图定义动态行为
类图是静态的,状态机图是动态的。以 Spindle 为例,画状态机图的步骤如下。
先画初始状态(实心圆点),用一条箭头指向 IDLE 状态。然后从 IDLE 出发,画一条箭头指向 ACCELERATING,箭头上的标签写触发事件 start(targetSpeed) 和约束条件 [targetSpeed > 0]。从 ACCELERATING 到 RUNNING 的迁移条件是 [currentSpeed >= targetSpeed * 0.95],意思是当前转速达到目标转速的 95% 以上就算进入匀速运行。从 RUNNING 到 DECELERATING 的触发事件是 stop()。从 DECELERATING 到 IDLE 的条件是 [currentSpeed == 0]。
故障迁移要特别处理。从任何状态出发,只要收到 alarmSignal 事件,就迁移到 FAULT 状态。在 UML 状态机图中,可以用一个从 FAULT 状态出发的“历史状态”伪状态,或者简单地在每个状态上画一条指向 FAULT 的箭头。标准里推荐用“入口点”或“出口点”来简化这种全局迁移。
状态机图里还要定义进入动作和退出动作。比如进入 RUNNING 状态时执行 startTimer(),退出时执行 stopTimer() 并累加运行时长。这些动作在图上用 entry/ 和 exit/ 标注。
4.5 第四步:用序列图描述一次完整加工交互
假设场景是:MES 系统下发一个加工任务给机床,机床完成加工后上报结果。序列图的参与者包括:MES、MachineController(机床控制器)、Spindle、ToolMagazine、FeedAxis。
消息序列如下:
- MES → MachineController:
sendTask(taskId, programId, workpieceId) - MachineController → ToolMagazine:
checkTool(requiredToolId) - ToolMagazine → MachineController:
toolAvailable(true/false) - MachineController → MachineController:
validateProgram(programId) - MachineController → MES:
taskAccepted(taskId) - MachineController → Spindle:
start(targetSpeed) - MachineController → FeedAxis:
moveTo(startPosition) - MachineController → MES:
machiningStarted(taskId) - (加工过程省略)
- MachineController → MES:
machiningCompleted(taskId, result)
在序列图中,第 2 到第 4 步可以用一个 alt 组合片段包起来,表示“如果刀具可用且程序有效”则继续,否则返回错误。这个 alt 片段就是异常处理逻辑的可视化表达。
4.6 第五步:从UML模型生成数据Schema
UML 模型画好之后,最终要落到数据交换上。标准里推荐用模型转换工具,从类图生成 JSON Schema 或 XML Schema。如果没有工具,手工转换也可以,但要注意几个映射规则。
类映射为 Schema 中的对象类型,属性映射为字段,数据类型映射要对应。比如 UML 的 float 映射为 JSON 的 number,String 映射为 string,枚举映射为 enum。组合关系映射为嵌套对象,聚合关系映射为数组或引用。
以 Spindle 类为例,生成的 JSON Schema 大致如下:
这里有个经验:必填字段不要设太多。我见过一些 Schema 把几乎所有字段都标为 required,结果设备刚上电时很多字段还没有值,数据上报直接失败。标准里建议只把标识字段和状态字段设为必填,其他测量值可以选填,等设备运行稳定后再逐步补全。
5. 常见问题与排查技巧实录
5.1 类图建模中的典型错误
错误一:把物理连接当成关联关系。有人画类图时,把“主轴电缆连接到驱动器”也画成一条关联线。这是混淆了物理连接和信息关系。类图描述的是信息模型,不是电气接线图。主轴和驱动器之间如果有数据交互,应该用序列图或通信图来描述,而不是在类图里画一条线。
错误二:属性类型不明确。比如 spindleSpeed 不写类型,或者写 number 这种模糊类型。标准要求明确到 float、int、String、boolean 或自定义枚举。类型不明确,生成 Schema 时就会出问题。
错误三:关系方向搞反。组合关系的菱形永远在“整体”那一端。我见过有人把菱形画在“部分”那一端,意思完全反了。记住一句话:菱形跟着整体走。
错误四:多重性缺失。一台机床有几个主轴?一个刀库有几个刀位?这些数量关系不标清楚,开发人员只能猜。标准建议所有关联、聚合、组合关系都标注多重性。
5.2 状态机图的常见坑
坑一:状态定义太粗。只定义“运行”和“停止”,忽略了中间过渡状态。结果是数据采集时状态跳变,上位机显示闪烁。解决办法是穷举所有可观测的状态,包括过渡态。
坑二:迁移条件不完整。比如从 ACCELERATING 到 RUNNING 的条件只写了“转速达到目标值”,没考虑“加速超时”的情况。如果主轴因为负载过大一直加速不上去,状态机就卡在 ACCELERATING 出不来了。标准建议对每个迁移都考虑超时分支。
坑三:忘记定义初始状态。状态机图必须有且只有一个初始状态。没有初始状态,程序启动时不知道从哪个状态开始。
坑四:状态编码不统一。图上写的是 RUNNING,程序里用的是 2,数据库里存的是 "run"。三处不一致,数据对不上。解决办法是建一张状态编码对照表,所有地方都引用这张表。
5.3 序列图与接口联调的排查清单
序列图画得再好,联调时还是会遇到问题。我整理了一份排查清单,按出现频率排序。
| 问题现象 | 可能原因 | 排查方法 |
|---|---|---|
| 消息发送后无响应 | 同步消息超时设置过短 | 检查超时参数,适当延长 |
| 响应顺序错乱 | 异步消息未加序号 | 给消息加编号,确认执行顺序 |
| 状态不一致 | 状态机图与代码实现不符 | 对照状态机图逐状态检查 |
| 数据字段缺失 | Schema必填字段过多 | 减少必填字段,增加默认值 |
| 通信中断 | 生命线对象未正确初始化 | 检查对象创建和销毁时机 |
5.4 独家避坑技巧
技巧一:先画序列图,再画类图。很多人习惯先画类图,但类图容易陷入细节。我的做法是先画序列图,把交互流程理清楚,从消息中提取出需要的类和属性,再回头画类图。这样画出来的类图更贴近实际需求,不会出现“建了一堆用不上的类”的情况。
技巧二:用颜色区分状态。在状态机图里,用不同颜色标注正常状态、过渡状态和故障状态。比如绿色表示正常运行,黄色表示过渡,红色表示故障。这样看图的时候一眼就能抓住重点。
技巧三:给每个类加一个“版本”属性。信息模型会随着设备升级而变化,加一个 modelVersion 属性,记录当前模型版本。数据对接时先校验版本号,版本不匹配就拒绝或转换,避免新旧模型混用导致的数据错乱。
技巧四:保留建模过程中的中间版本。UML 模型不是一次成型的,中间会有多次修改。用 Git 管理模型文件,每次修改都提交,这样出问题可以回溯到之前的版本。PlantUML 和 draw.io 都支持文本格式存储,很适合做版本管理。
技巧五:模型评审要拉上开发和运维。建模不是架构师一个人的事。画完类图和状态机图后,一定要拉上开发人员和现场运维一起评审。开发人员会关注属性类型和接口实现,运维人员会关注状态定义是否符合实际操作习惯。我经历过一次评审,运维师傅指出“主轴定向”在实际操作中分“定向中”和“定向完成”两个状态,我们原来只定义了一个,后来补上之后,操作员反馈界面显示准确多了。
6. 从标准到落地:一份可复用的建模检查表
6.1 类图检查项
在完成类图后,逐项核对以下内容。类名是否用单数名词、是否见名知义;属性是否都有明确数据类型;枚举类是否单独定义且值域完整;关系类型是否准确(组合 vs 聚合 vs 关联);多重性是否标注;是否避免了循环依赖;包结构是否按领域划分;是否有版本属性。
6.2 状态机图检查项
初始状态是否唯一;状态是否穷举了所有可观测情况;迁移条件是否包含正常和异常分支;是否有超时迁移;进入/退出动作是否定义;状态编码是否与程序一致;是否有全局故障迁移;状态机是否可达(没有孤立状态)。
6.3 序列图检查项
参与者是否完整;消息顺序是否合理;同步/异步是否区分;是否有异常分支(alt片段);消息编号是否清晰;生命线激活条是否反映实际执行时间;是否有超时处理;是否与状态机图一致。
6.4 模型到Schema的映射检查项
类是否映射为对象;属性类型是否一一对应;枚举是否映射为enum;组合关系是否映射为嵌套对象;聚合关系是否映射为数组;必填字段是否最小化;是否包含版本字段;是否包含时间戳字段。
这份检查表是我在实际项目中逐步积累的,每次建模完成后过一遍,能提前发现大部分问题。尤其是状态机图和序列图的一致性检查,很多对接问题都是因为这两张图对不上导致的。
7. 我个人的一些实操体会
做机床信息建模这些年,最大的感受是:UML 不是画给领导看的,是画给开发和运维用的。如果画出来的图开发看不懂、运维用不上,那还不如不画。ISO 23704-4 这份标准的价值,不在于它规定了多少种图型,而在于它提供了一套让机械、电气、软件、运维各方都能参与的沟通框架。
我现在的习惯是,每接手一个新设备或新产线,先花半天时间画三张图:一张类图理清数据结构,一张状态机图定义设备状态,一张序列图描述核心交互。这三张图不用画得多漂亮,但必须准确。画完之后拉上相关方过一遍,把分歧解决在纸面上,而不是留到联调现场。
还有一个体会是:模型要跟着设备走。设备升级了、加了新传感器、改了控制逻辑,模型就要同步更新。我见过太多项目,模型还是三年前建的,设备已经改了两代,结果数据对接全靠打补丁。所以我现在要求团队,每次设备变更必须同步更新 UML 模型,模型文件和设备文档放在一起管理。
最后分享一个小技巧:如果你觉得 UML 太重,可以从状态机图开始。因为设备状态定义是投入产出比最高的一件事。把状态定义清楚了,数据采集、界面显示、报警处理都会顺畅很多。类图和序列图可以后面慢慢补,但状态机图值得第一时间画。