简介面向西门子TIA博途自动化程序生成场景的C#源码工程适合需要在PLC/HMI项目中借助Openness API批量生成、维护程序的自动化工程师或二次开发人员。资源包共272个文件约5.48MB主要包含44个cs源码、34个xml配置、19个dll依赖、6个xslt模板及14个csv数据文件另有工程解决方案sln和项目文件能支撑从代码编译、项目配置到模板转换的完整开发流程。已有1436人学习下载。内容聚焦如何用C#调用Openness API读写博途项目、自动生成PLC程序段落并配合Excel数据驱动方式提升批量处理效率压缩包内还包含运行缓存、图标资源和调试信息便于直接打开工程查看实现细节。对希望减少重复组态、建立自动化工程流程的博途使用者来说这份源码具有较强的参考与复用价值。 用了六年博途最烦的不是接线图而是面对几百个结构相似、参数不同的设备块手动拖FC、填DB。每个项目少说一周多的话半个月全耗在重复劳动上。后来在西门子文档里看到“TIA Portal Openness”这个接口试着跑通第一个示例之后彻底回不去了现在标准化设备的程序块基本靠它批量生成一分钟能建完以前半个工作日的工作量。这篇就聊聊怎么用Openness API在博途里自动生成程序从环境、对象模型到实际可跑的代码都会讲到适合做标准化设备的电气工程师、自动化集成商也适合刚接触博途二次开发的人参考。1. 为什么要把博途程序“写”成代码而不是拖块1.1 重复劳动的痛点做设备集成这行项目多了以后你会发现绝大部分PLC程序不是“设计”出来的而是“套用”出来的。A设备和B设备除了工艺参数不同程序结构基本一致FC的引脚、DB的变量、报警文本、M区映射全是一个套路。可在博途界面里手动创建这些块每一步都很折腾右键新建块、改名称、去属性里填编号再进LAD/FBD编辑器里一点一点画网络。一个中型项目光这些操作就得三四天而且手一抖编号写错编译还不报错到现场才能发现。Openness API就是博途开放给自动化工程师的接口它本质上是一组.NET类库挂在Siemens.Engineering命名空间下。你能用它启动博途、打开项目、创建块、读写变量、改属性、编译下载相当于把人手能做的项目操作全部脚本化。在博途界面上拖一小时的工作量用代码也许就是几个循环的事情。1.2 什么场景下收益最大先说结论不是所有项目都值得用Openness。如果一年只做两三台单机设备手动拖块就行写脚本的时间比省下的时间还长。真正适合的场景有三类第一类是有标准模板的OEM设备厂设备型号固定每次项目只改参数代码批量套模板非常合适。第二类是大型产线项目几十台相同功能站需要统一程序文本和变量命名规范手动改容易漏。第三类是程序审查场景用Openness把全项目的块结构、变量列表导出成Excel比人肉截图高效得多。我自己用得最多的就是前两类在一个模板工程里定义好标准FC骨架然后用C#循环修改引脚和内部逻辑生成几十个实例块一键编译、一致性检查、保存。以前三天的工作现在半天搞定还能顺带输出一份变量清单给上位机组态用。2. 环境准备没装对代码写得再好也白搭2.1 版本匹配是第一大坑Openness API最让人头疼的是版本强绑定。每个博途版本的Openness DLL都不一样V15的DLL不能打开V18的项目反过来也不行。网上经常看到有人拿V15的示例工程去改V18的项目一编译就报“类型不匹配”其实根本不是代码问题是DLL版本没对上。我的建议是先确认现场用的博途版本再装对应的Visual Studio和.NET Framework。下面是我实测过的组合博途版本Openness DLL位置推荐开发环境V15.1/V16C:\Program Files\Siemens\Automation\Portal V15_1\PublicAPI\...VS2017.NET Framework 4.7.2V17/V18C:\Program Files\Siemens\Automation\Portal V17\PublicAPI\...VS2022.NET Framework 4.8V19/V20/V21同上版本号替换VS2022.NET Framework 4.8或.NET 6/8看接口写代码时不用手动去文件浏览器里找DLL直接在VS里右键项目引用添加程序集引用指向上面那个PublicAPI文件夹就行。这里有个小坑工程引用DLL后生成的EXE拿到别的机器上跑不起来因为目标机器没装同样版本的博途。所以Openness方案只能部署在装有博途的工程师站上。2.2 安装Openness组件很多人装博途时根本没注意“TIA Portal Openness”这个可选组件装完之后找不到PublicAPI文件夹才来查。在西门子安装向导里选产品时展开“TIA Portal”下方的选项会看到“TIA Portal Openness”必须手动勾选。装完确认一下这个路径C:\Program Files\Siemens\Automation\Portal V18\PublicAPI\Siemens.Engineering.dll文件存在说明组件装好了。如果不存在重新运行安装程序选择修改功能补装不用整个卸载重装。顺便提两个热搜里常问的安装问题。一个是“博途软件能安装在D盘吗”实际是博途主程序允许自定义安装路径但很多公共组件和.NET程序集还是会写到C盘Program Files或ProgramData下Openness的PublicAPI也会跟着博途所在盘走。我自己建议系统盘空间够的话就别折腾路径博途对路径支持不稳定项目路径带中文或特殊字符时后续会有一堆怪问题。另一个是“博途V17的驱动必须安装吗”如果只做开发不涉及专门工艺模块驱动不是必须的但Openness生成程序后下载到PLC时目标PLC型号的固件支持包必须装否则下载会报固件不兼容。2.3 最小环境验证在写复杂逻辑之前先用控制台应用跑通“打开项目-读PLC名称-关闭”的流程。VS里新建控制台项目.NET Framework添加Siemens.Engineering.dll引用然后以管理员权限运行。整个流程能通说明环境没有问题了。using System; using Siemens.Engineering; using Siemens.Engineering.SW; class Program { static void Main(string[] args) { // 启动博途进程带GUI界面 using (TiaPortal tiaPortal new TiaPortal(TiaPortalMode.ProcessWithGui)) { // 打开工程文件注意用绝对路径 Project project tiaPortal.Projects.Open(D:\Projects\DemoProject.ap18); // 遍历工程下的设备找到PLC软件对象 foreach (Device device in project.Devices) { foreach (DeviceItem item in device.DeviceItems) { if (item.GetType().IsSubclassOf(typeof(PlcSoftware))) { PlcSoftware plc (PlcSoftware)item; Console.WriteLine(PLC设备: device.Name); Console.WriteLine(软件名称: plc.Name); } } } project.Save(); project.Close(); } Console.WriteLine(完成); Console.ReadKey(); } }这段代码如果正确打印出PLC软件路径说明环境、DLL引用、权限都没问题了。这里需要特别提醒TiaPortal对象必须用using或者手动Dispose否则即使工程关了后台还会残留博途进程反复调试几次机器就会被拖垮。3. 核心对象模型先搞懂对象树再写代码3.1 Openness里的对象关系用过博途都知道项目里是一棵巨大的树项目下挂PLC、HMI、驱动设备PLC下挂程序块、变量表、数据类型、工艺对象。Openness的对象模型基本复刻了这棵树最关键的几个类TiaPortal博途进程的句柄程序一切操作的入口Project打开的工程文件Device挂在工程下的设备比如S7-1200/1500DeviceItem设备下的子对象比如PLC的软件目录、硬件配置PlcSoftwarePLC软件树ProgramBlocks、TagTable都在它下面PlcBlock程序块的基类OB、FC、FB、DB都继承自它PlcTag、PlcTagTable变量和变量表写代码时你只需记住一条主线TiaPortal → Project → PlcSoftware → ProgramBlocks / PlcTagTable → 具体块 / 变量表。对象树操作就是一路用GetChildren()或者通过设备里的Group导航路径和你在博途左侧面板看到的目录关系一一对应。3.2 连接博途的两种方式Openness连接博途进程有两种方式差别在启动方式和适用场景。进程外Out-of-process在C#程序里new TiaPortal(TiaPortalMode.ProcessWithGui)启动一个独立的博途进程这个进程完全受程序控制退出时一并关闭。适合脚本化批量处理比如夜里跑批任务不需要人看着界面。进程内In-process用TiaPortal.GetProcess()拿到当前已经打开的博途进程句柄“连接”到正在运行的实例上。适合人工辅助场景工程师在博途界面开着项目再用Windows程序做批量操作两边同步看。两种模式代码差异不大我自己常用ProcessWithGui因为能直观看到博途界面状态万一起异常还能看出卡在哪一步。但要注意不管哪种方式调用程序必须以管理员权限运行否则第一个OpenProject就会报权限异常。3.3 理解块和程序段的关系创建块的逻辑不复杂但有一个概念要理清楚块PlcBlock本身是个容器真正执行逻辑的是块里面的Network程序段或者更准确地说是程序段里的指令文本。Openness里操作块逻辑普遍的做法是用IPlcBlock接口通过Networks集合创建Network再用AddText写入STL指令。你可以把Network理解为代码编辑区里一行一行指令的容器LAD/FBD视图下的网络底层保存的仍然是结构化文本。4. 实战一键生成OB1、FC和DB块4.1 创建程序块的核心代码创建程序块的套路固定先定位目标集合对象再调用CreateBlock创建块并传入块类型和名称最后设置属性。下面以Siemens.Engineering.SW.Blocks命名空间举例代码是V18环境下实测可用的。using Siemens.Engineering.SW.Blocks; ... // plc 是上一节拿到的 PlcSoftware 对象 PlcBlockComposition blockGroups plc.ProgramBlocks; // 创建OB1组织块 PlcBlock ob1 blockGroups.CreateBlock(PlcBlockType.OB, OB1); // 创建FC1函数 PlcBlock fc1 blockGroups.CreateBlock(PlcBlockType.FC, FC1); // 创建DB1数据块 PlcBlock db1 blockGroups.CreateBlock(PlcBlockType.DB, DB1);三行代码相当于在博途界面右键“添加新块”三次。但光有块壳子不够工程里真正干活的是块里面的逻辑。用Openness给块加程序段最常用的方式是操作STL文本因为FC/FB/OB内部用STL文本写入最直接、最稳符号地址和注释都能写进去。给FC1加一段“把MW0的值赋给MW2再自加1”的逻辑这样操作// 获取块的接口 IPlcBlock fcInterface fc1.GetInterface(); // 在块里创建一个Network并写入STL语句 var network fcInterface.Networks.CreateNetwork(Network 1, 启动自加); network.AddText(L MW 0\r\nT MW 2\r\nL 1\r\nI\r\nT MW 0);这段STL是简化写法实际项目要按TIA支持的指令语法写。注意Network的名称和注释要作为参数传进去否则生成的块没有注释后期调试很痛苦。加上Network之后再设置常用块属性方便追溯维护。fcInterface.SetAttribute(Title, 电机控制逻辑); fcInterface.SetAttribute(Comment, 自动生成示例); fcInterface.SetAttribute(Version, 1.0.0);4.2 批量生成变量表变量表也是Openness自动化的核心需求。做批量项目时变量名、地址、数据类型都是同一套模板只是数量不同。用代码创建变量表非常直接using Siemens.Engineering.SW.Tags; ... PlcTagTableGroup tagTableGroup plc.TagTableGroup; PlcTagTable table tagTableGroup.CreateTagTable(电机参数表); // 添加变量参数分别是名称、数据类型、地址、注释 table.Tags.CreateTag(电机1电流, Real, MD10, 电机1实际电流); table.Tags.CreateTag(电机1状态, Word, MW20, 状态字);这段代码等价于在博途变量表里手动添加两行。批量场景下你完全可以通过读取Excel或CSV清单循环调用CreateTag一次性生成几百个变量。再配合上文生成FC/DB的逻辑整套标准化程序就能直接产出。4.3 编译、保存和一致性检查生成完块之后不能直接拿去用必须先编译。Openness里编译调用PlcSoftware的Compile()方法返回对象里带错误数量和错误列表。这里有个容易忽略的点Openness的编译只在内存中操作必须手动Save()否则关闭程序后所有改动全部丢失。var result plc.Compile(); if (result.State CompilerResultState.Success) { Console.WriteLine(编译通过); project.Save(); } else { foreach (var msg in result.Messages) { Console.WriteLine(msg.Description); } }编译结果State有四种Success、Warning、Error、Information。只要不出现Error一般不影响后续保存和下载。但出现Warning时最好查一下原因比如“块未完全下载会导致运行不一致”这类警告到现场往往就是隐患。编译完之后还可以用ProgramBlocks的CheckConsistency()做一致性检查但实际项目中Compile的返回结果基本够用。4.4 下载到PLC生成程序的最终目的是把块下载到PLC里。Openness的下载接口在PlcSoftware下一层用Download()方法需要先拿到在线连接对象。简单场景下这样处理DeviceItem deviceItem plc.DeviceItem; IOnlineAccess online deviceItem.GetServiceIOnlineAccess(); online.Connect(); online.Download(); online.Disconnect();下载环节坑比较多比如CPU处于STOP还是RUN、密码保护、在线离线差异检查等。如果你只是做程序生成建议自动下载留到现场联调时人工点按钮Openness单独负责生成和编译这样能避开很多无法预料的在线问题。5. 常见问题与排查技巧实录5.1 Openness启动和连接失败最常见报错是“TiaPortal.GetProcess()找不到目标进程”或者“无法创建TiaPortal对象”。原因基本锁死在三个方向博途版本和DLL版本不一致调用程序没以管理员身份运行博途的Openness组件没安装第三个最隐蔽因为博途界面能正常用但PublicAPI文件夹里就是没有Siemens.Engineering.dll。确认方式就一条到安装目录下找PublicAPI找不到就补装组件。这个检查应该放在写任何代码之前。我第一次用Openness就卡在这白白排查了一天环境变量。还有一个常见问题启动Openness时博途会弹出安全提示要求确认外部程序访问。这个提示有时在后台被窗口遮挡程序看起来像卡死其实是在等确认。解决办法是启动程序时将博途窗口置于前台或者设置项目关闭方式为TiaPortalCloseMode.WithoutSaving减少卡住的概率。5.2 字符串值已经为0但触摸屏还显示旧字符热搜里有个问题很典型“博途字符串里面的值已经为0但是触摸屏为什么还是显示原来的字符”。这种情况在自动化项目里经常出现尤其用Openness自动生成程序、批量改字符串变量之后。先说结论PLC侧字符串值变成0有两种情况。一是字符串长度被置为0表示空字符串二是字符串数据起始字节变成0但触摸屏显示的是上一次通讯缓存。HMI和PLC的字符串通讯走数据块地址映射很多时候触摸屏为了减少变量通讯量启用了“仅在变化时更新”或按周期批量刷新PLC侧虽然已经改成空但HMI的数据区还没收到新值画面上就一直保留旧文本。排查这个问题按三步走先在PLC侧监控所有字符串变量确认确实是空值而不是0x20空格填充。再到HMI变量表里检查字符串映射地址确认变量长度和PLC字符串定义长度一致。长度不匹配是显示旧值的高频原因HMI只读到了前几个字节或者没读到长度字节。最后看HMI连接设置里的更新周期如果是“手动”模式需要在画面上触发一次变量强制刷新否则旧值永远留在屏幕里。如果用Openness生成字符串变量还要注意一点TIA里的字符串类型默认是String不是C语言的char数组。创建变量时应该显式写成String不要用Array[0..9] of Char否则HMI端解析不出来折腾半天也查不到原因。5.3 卸载和安装相关的问题热搜里“博途怎么卸载干净”、“博途安装无法更改安装路径”这类问题我在装Openness环境时也踩过。博途和Windows系统绑定很深卸载不干净容易导致后续重装版本后Openness组件异常。想省心的话卸载博途时用控制面板的程序卸载按顺序把Siemens相关组件逐个卸掉再手动删除C:\Program Files\Siemens和C:\ProgramData\Siemens目录最后清理注册表项然后再装新版本。驱动那块前面提过如果只做开发驱动不是必须的。但Openness生成程序后连PLC下载时目标PLC型号的固件支持包必须装否则下载会报固件不兼容。所以建议至少把S7-1200/1500对应的驱动和支持包都装上一劳永逸。5.4 路径和权限的隐藏问题用Openness自动生成程序时项目路径不能乱给。我遇到最奇葩的问题是工程放桌面路径里带中文用户名结果博途打开工程直接报错。为了避免这种问题项目路径全部用纯英文放在盘符根部目录比如D:\TiaProjects\DemoProject.ap18。工程文件名也避免特殊字符括号、空格、井号都会让Openness解析异常排查起来很费时间。权限上除了程序本身用管理员运行还有一个隐藏权限点如果博途是以普通用户安装的而控制台程序用管理员运行两个进程的权限上下文不一致打开工程时可能报“访问被拒绝”。我的做法是安装博途时就用管理员账户开发调试也用同一个账户避免跨用户访问项目文件。6. 一点个人体会写了几年Openness最大的感受是入门其实不难难的是把它融入工程流程。第一个自动生成程序跑通的时候你会觉得这玩意儿没什么高深但真正好用起来还要解决模板数据从哪来、变量规范怎么定、编译后的错误提示怎么归类这些周边问题。我的建议是先找一个重复性最强的环节比如从Excel批量生成变量表把这个地方自动化跑顺了再逐步扩展到生成FC/DB、导入程序逻辑。步子别迈太大一次只自动化一个小环节效果最好。最后分享一个小技巧Openness生成块时顺便在块注释里写入“Generated by Openness script禁止手动修改”的字样后期维护能少很多误会。因为这些块长得一模一样同事分不清哪些是生成的哪些是手写的改错一个就全乱套。加一个标识至少让人知道这文件有脚本在管改之前先来找你对一下能省掉不少麻烦。本文还有配套的精品资源点击获取