企业官网建设流程全解析

1. 开发环境与工程搭建

1.1 为什么AC700会跳到Codesys

拿到汇川AC700系列的第一天，大多数人会和我一样，下意识去找汇川自家的编程软件。结果发现，这玩意儿根本不是一个传统意义上的“汇川全家桶”，它的开发环境叫Codesys，准确说是基于Codesys内核深度定制的平台。很多做过H系列、H1U系列的老工程师，第一次打开这个界面都会愣一下——软件不对了，指令不对了，连变量声明的方式都不一样了。

这里得把底层的逻辑说清楚。Codesys本身就是工控圈里非常成熟的IEC 61131-3编程环境，全球大量PLC品牌（包括很多欧洲老牌）都直接拿它做内核，自己只做硬件驱动和工艺插件。汇川把AC系列、AM系列这些中型PLC架在Codesys上，等于直接继承了整个Codesys生态：五类标准编程语言、第三方库、可视化、OPC UA、EtherCAT主站能力。这在运动控制、视觉联动、工厂信息化这些场景里优势非常明显，但也意味着你不能拿老经验硬套，得先学会跟Codesys“对话”。

这篇文章就围绕AC700系列，把基础指令逐类拆开，从建工程到位逻辑、定时器计数器，再到数据转换、MODBUS和EtherCAT通信，最后把我在现场踩过的坑一并列出来。适合同样刚转Codesys的PLC工程师、设备维护人员和想入工控门的学生，如果你已经会三菱或者西门子，那看这篇文章上手会非常快。

1.2 软件安装、版本匹配和在线连接

先用最简单的方式描述安装这件事：去Codesys官网申请一个账号，下载Codesys Development System V3.5的安装包；或者去汇川官网的软件下载中心，找AC700系列对应的编程软件安装包。两种方式都可以，第二种更省事，因为汇川在安装包层面会把自己设备的描述文件、库文件都预装好，省得你后面满世界找东西。

安装过程没什么玄学，一路Next就行。但有一件事容易被忽略，AC700系列对Codesys的版本有对应关系，不同批次、不同固件版本的控制器，要求的最低Codesys版本不一样。我碰到过同事拿着最新版Codesys去连一台老固件的AC700，结果设备扫描死活找不到，折腾半天最后换回对应的旧版本，一次就连上了。所以装完软件先别急着写程序，看一眼控制器固件版本，再确认一下你的软件版本在支持列表里，这能省掉后面一大堆莫名其妙的问题。

连PLC也是个容易卡住的点。AC700系列的连接方式一般是以太网为主，面板上或者端子上有网口，默认IP印在机身标签上，常见的是192.168.1.x网段。连接步骤是在Codesys里新建工程后，在“设备”树中选中控制器，右键扫描网络，或者双击打开“通讯设置”再点扫描。如果你已经把电脑网卡IP改到了同一网段还是扫不到，大概率是Windows防火墙拦了Codesys网关，把Codesys Gateway Service的入站规则放行就可以了。

这个连接原理值得多说一句：Codesys的在线通讯不靠PLC直接响应当前软件，中间夹了一个叫“网关”的本地服务。它负责把开发电脑上的请求转发到PLC内部的通讯进程，所以网关服务异常、防火墙拦截、PLC处于STOP状态或另一个工程师占用了连接，都可能导致“扫描不到设备”。排查顺序建议是：网线物理通断→电脑IP和PLC同一网段→防火墙→网关服务状态→PLC是否被其他人占用。

很多新人在这个阶段就会失去耐心，觉得“这软件怎么这么难伺候”。实际上只要理解了“电脑—网关—PLC”这条链路，后面所有连接问题都能按这个思路一节一节排查。

2. 基础指令的知识骨架与思维切换

2.1 从继电接触器图到IEC 61131-3的语言

做PLC的人都有个共同记忆，最早接触的编程方式就是梯形图，画起来和继电器回路很像，线圈、触点、自锁、互锁，思路完全是从电气图搬过来的。三菱、西门子的软件里，就算你用梯形图，逻辑也是按扫描周期逐行执行的，但汇川AC700这套Codesys环境有一个显著不同，它把“任务”这个概念放到了台面上。任务决定程序什么时候执行、以多快的周期执行，而工程里可以同时有多个任务，分别跑不同优先级的功能块。

这意味着基础指令不再是“死记指令表”，而是要先理解程序运行机制。一个典型的AC700工程里，你会看到“任务配置”下面有若干个周期性任务，比如MainTask周期1ms、CyclicTask周期10ms，每个任务下面挂不同的程序组织单元（POU）。你在梯形图里画的每一行逻辑，最终都会落到某个任务里，由这个任务的周期来驱动。这个思路一旦建立，后面做运动控制和高速模拟量处理时，就不会犯“把所有东西堆在一个循环里”的错。

IEC 61131-3定义了五种语言：指令表IL、结构化文本ST、梯形图LD、功能块图FBD、顺序功能图SFC。AC700系列全部支持，而且允许不同POU用不同语言，再在任务里互相调用。实际项目里，逻辑简单、维护人员偏电气背景的场合用梯形图，运算复杂、数据处理多的场合用ST，流程明显、分步骤控制用SFC。语言从来不是束缚，你完全可以把ST当成一种“能直接操控硬件寄存器的类C语言”来用。

2.2 位逻辑、边沿、置位复位的使用要点

基础指令最核心的一类就是位逻辑。触点（常开、常闭）、线圈、置位S、复位R、取反，这些在梯形图里非常直观。但有几个在Codesys里特别容易出错的细节，我一个个说。

第一个是常闭触点的处理。很多从三菱转过来的人，会把常闭触点理解成“逻辑取反”。在扫描执行时这种理解问题不大，但是在程序里的某个线圈只在条件满足一个扫描周期就立即复位时，常闭触点和置位复位之间的配合就容易产生怪逻辑。我的建议是：凡是需要保持状态的地方，优先写S/R（置位/复位）而不是用线圈自锁。这样逻辑短、直观，也不容易被后面的人改乱。

第二个是边沿检测。Codesys里提供了R_TRIG（上升沿）和F_TRIG（下降沿）功能块，使用时要声明两个变量：一个是功能块实例，一个是输出变量。重点来了，R_TRIG检测的是“上一次扫描的值到这一次扫描的值”之间是否发生跳变，所以功能块实例必须能被重复调用，这就意味着你不能把R_TRIG放在一个IF分支里，只在某一次扫描时执行。如果这样写，功能块内部的上一状态不会被持续刷新，边沿就永远触发不了。正确做法是每次任务周期都无条件调用它，然后把输出接到你的逻辑里。

第三个是位操作和字节/字操作的混用。AC700里你可以用变量名.0这种形式访问某个BOOL位，代码写起来很方便，但调试起来要小心。如果一个字节里多个位分别代表不同的报警信号，在梯形图里用点位符连线没问题，可一旦要传到触摸屏或上位机，必须清楚位的排列顺序是LOW位在前还是HIGH位在前，这个后面讲通信时还会再碰到。

2.3 定时器、计数器家族和它们的坑

定时器这块，Codesys提供的TON（延时接通）、TOF（延时断开）、TP（脉冲）和RTC（实时时钟）是基础指令里的重头戏。绝大部分控制逻辑都离不开定时。

我见过很多初级工程师写延时断开，直接用TON再取反输出，结果DEBUG时发现输出闪了一下又变了。这是因为TON的输出在定时未完成时是FALSE，一旦时间到就变TRUE，你把它取反，那就是说前面的状态要么TRUE要么FALSE，合在一起看起来像“闪了一下”。这里真正要做的是想清楚时序：延时断开TOF的逻辑是输入有信号时输出立刻为TRUE，输入断开后输出再保持一段时间；它和“TON取反”在语义上不是一回事。建议把这三个定时器的真值表画在纸上，逻辑就清楚了。

计数器常用的有CTU（加计数）、CTD（减计数）、CTUD（加减计数）。使用时注意CV当前值和PV预设值的数据类型通常是INT或DINT，别混着用。如果计数的来源是编码器脉冲，频率很高，建议把计数任务挂到专门的快速任务里，并且用DINT足够大的范围，避免溢出。

另外说一个非常典型的坑：定时器/计数器功能块的输入输出，在梯形图里直接接BOOL变量或者数变量是没问题的，但如果你在ST里调用TON，必须同步做一些数据类型的检查。TON的IN引脚是BOOL，PT引脚是TIME，这两个搞错了编译都过不去。TIME的写法是T#5s、T#100ms这种，新人经常把5000直接填进去，结果定时器瞬间动作，因为5000被当成5000毫秒微秒级别的极短时间。记住：TIME是带单位的时间字面量，不是数值。

3. 从零搭一个基础逻辑：自锁、延时、旋转角度动画

3.1 电机启保停与故障复位

与其干讲指令，不如直接过一遍实际案例。假设你要做一个电机启动停止控制，有启动按钮、停止按钮、故障信号、运行输出。

在AC700里新建一个POU，语言选择LD梯形图，代码结构和三菱差不多，但要注意一点：在Codesys里线圈的输出变量一般定义为全局变量或POU内的VAR_OUTPUT，不要直接在梯形图里写一个地址，那样可读性差且维护困难。

逻辑很简单：

• 启动按钮常开触点（START）和运行输出（RUN）的常开触点并联，形成自锁；
• 停止按钮用常闭触点串在回路里；
• 故障信号用常闭触点串在回路里，故障时直接断开；
• 输出接RUN。

如果你用ST写，同样逻辑是：

RUN := (START OR RUN) AND NOT STOP AND NOT FAULT;

这段代码和梯形图严格等价。但实际使用中我强烈建议把“故障”做成独立复位逻辑，而不是简单串一个常闭触点。因为故障信号往往需要保持，电机停了之后故障触点还保持闭合，你不复位它，再次按启动就无效。所以更合理的写法是：

IF NOT RESET THEN FAULT_LATCH := FAULT_RAW; END_IF RUN := (START OR RUN) AND NOT STOP AND NOT FAULT_LATCH;

这段逻辑的好处是：故障来了，RUN断开；按下复位按钮后，故障锁存被清掉，才能重新启动。这种锁存方式，在真实设备上比单纯串联常闭触点可靠得多。

3.2 定时器在设备启停中的时序控制

很多设备启动过程中需要先开冷却、再开油泵、最后才给主轴使能。这种顺序控制如果用ST写，最直观的是用几个TON搭“接力棒”。

// 启动顺序控制 bCooling := bStart; // 冷却立刻启动 TON_Oil(IN := bCooling AND NOT bStop, PT := T#3S); bOilPump := TON_Oil.Q; // 3秒后油泵启动 TON_Spindle(IN := bOilPump AND NOT bStop, PT := T#5S); bSpindle := TON_Spindle.Q; // 再过5秒主轴使能

这样写逻辑清晰，每个设备都有自己独立的延时条件，不会出现“多个定时器共用一个启动信号，然后一停全停”的混乱。停止时也一样，推荐做一个对称的停止时序：主轴先停、3秒后油泵停、再2秒后冷却停。这种顺序控制在机械设备里非常普遍，也是定时器最典型的应用场景。

3.3 从编码器读数到旋转角度可视化

热词里有个“codesys中旋转角度动化”，其实是指用Codesys自带的可视化（Visualization）功能做旋转动画，这在设备状态监控界面里很常见，比如显示一个指针角度、搅拌叶片位置、转台方向。

要实现旋转动画，前提是你已经拿到了一个角度值。如果电机或转台带编码器，那么角度来源就是编码器计数。AC700配合汇川伺服时，伺服驱动器的位置反馈可以通过EtherCAT或总线映射到PLC变量里，通常是一个INT或DINT类型的脉冲计数值。把脉冲计数值折算成角度，最简单的公式是：

rAngle := (LREAL_TO_REAL(diCount) / LREAL_TO_REAL(udiResolution)) * 360.0;

这里的diCount是当前脉冲数或相对零点脉冲数，udiResolution是编码器每圈分辨率。以汇川MS1H4系列伺服为例，默认编码器线数是262144（即2的18次方），表示电机转一圈，位置反馈有262144个脉冲单位。用count除以分辨率再乘以360，就是当前角度。

如果角度只用于显示，建议在程序里规范化到0~360度范围内，避免指针转了好几圈后数值越来越大：

rAngleDisplay := rAngle - TRUNC(rAngle / 360.0) * 360.0;

写完后打开可视化界面，拖一个“圆形”或“图片”元素，在元素的“旋转”属性里绑定rAngleDisplay变量，设置旋转中心和旋转方向即可。有几个细节值得注意：

• 旋转中心默认是元素左上角，需要手动设置为中心点；
• 方向正负要看编码器计数方向和机械安装方向，反了就直接在公式后面加负号；
• 可视化里的刷新率默认可能只有50ms级别，高速转动时会有显示滞后，但不影响实际控制，只是监控显示而已。

编码器分辨率这块，有人会问：驱动器里看到的262144这个数值能不能改？我的建议是原则上不要改。那是电机绝对编码器的硬件精度，强行改成别的数值，PLC侧算出来的角度和实际机械位置就会对不上，还会影响电子齿轮比和定位精度。除非你明确知道后端负载和减速比需要重新标定，否则保持默认。

4. 数据类型的转换与通信实操

4.1 DWORD转REAL的位模式陷阱

工控里最常见的一类头疼问题，就是32位数据在内存里的表示方式。热词里有个“汇川AM系列DWORD怎么转REAL”，这个问题在AC700上同样会遇到，而且问得非常典型。

先说结论：DWORD转REAL不是把整数“转成”小数，而是把同样的一组二进制位，重新解释成IEEE 754浮点数。比如某个设备通过MODBUS返回了两个寄存器，里面装的是16#3F800000，如果你把它当成DWORD，那就是整数；但如果你知道协议约定这个数据是REAL类型，那16#3F800000在IEEE 754里就是1.0。这两个值天差地别，硬转必然出错。

在Codesys里做位模式转换，最实用的办法有三个，我按推荐顺序排：

第一个是使用联合体。Codesys支持在DUT里定义UNION：

TYPE U_DWORD_REAL : UNION dwValue : DWORD; rValue : REAL; END_UNION END_TYPE

程序里这样用：

varTemp : U_DWORD_REAL; varTemp.dwValue := 16#3F800000; rResult := varTemp.rValue; // rResult = 1.0

这个方式直观、高效，不会产生中间拷贝，是我最常用的方案。

第二个是用指针。如果你不想建联合体，用ADR和指针也可以：

pReal : POINTER TO REAL; pReal := ADR(dwInput); rResult := pReal^;

这段代码先把DWORD变量的地址取出来，再按REAL类型解引用，本质上是同一段内存换了一种解释方式。运行效率极高，几乎没有额外开销。但要小心指针悬空，必须在指针赋值后确认不是NULL再解引用。

第三个是用Codesys标准库自带的转换函数，比如REAL_TO_DWORD和DWORD_TO_REAL这样的反向转换函数，在某些版本里也存在DWORD_TO_REAL这种按位转换的函数。但各版本支持情况略有不一，而且可读性不如联合体直观。建议项目里统一用联合体模式，团队维护时都不会看错。

4.2 MODBUS RTU和485通讯的数据高低位问题

再来说一个几乎每个用汇川PLC的人都会碰到的问题：MODBUS RTU通讯里，32位数据的高低位顺序。热词里“200smart与汇川伺服485通讯程序”说的就是这个场景——第三方PLC通过485串联接汇川伺服或变频器。

MODBUS RTU里面，一个16位保持寄存器是最小单位，要传32位数据（REAL或DINT），就得占两个寄存器。问题来了，不同设备对“哪个寄存器是高字，哪个寄存器是低字”的定义不一样。比如数据1.0的IEEE754表示是0x3F800000，有的设备先发0x3F80（高字），再发0x0000（低字），这叫大端字序；有的设备反过来先发0x0000再发0x3F80，这叫小端字序。如果你按错顺序组装，解析出来的浮点数会非常离谱，比如变成3.9999998E-39这种天文数字或者干脆是0。

处理办法其实很简单，定义一个“字交换”功能块：

FUNCTION_BLOCK FB_SwapWord VAR_INPUT dwInput : DWORD; END_VAR VAR_OUTPUT dwOutput : DWORD; END_VAR VAR wHigh : WORD; wLow : WORD; END_VAR wHigh := WORD_OF_DWORD(dwInput, 0); wLow := WORD_OF_DWORD(dwInput, 1); dwOutput := DWORD_OF_WORD(wLow, 0) OR DWORD_OF_WORD(wHigh, 1);

这段代码把DWORD里的高16位和低16位互换。接收方如果发现解析出来的数据不对，首先尝试加一个这样的交换，90%的问题都能解决。更彻底的办法是直接做字符串查看原始字节序，但那需要在上位机或调试器里核查，不如先在PLC里做字交换试试。

另外还要注意：串口参数。汇川伺服的485通讯常见配置是9600或38400波特率，8数据位、1停止位、无校验或偶校验，具体看驱动器面板和手册。通讯之前必须把从站地址、波特率、数据格式和PLC侧配置成完全一致，否则连帧都收发不通。很多人配置好了指令却收不到响应，先查串口参数，而不是冲进程序里排查MODBUS帧逻辑。

4.3 梯形图导出XML和其他调试辅助功能

Codesys工程本身是以XML为基础存储结构的，你现在用的梯形图、ST代码，内部都是XML格式。如果你需要做版本对比、自动审查或者把梯形图转成文档给别人看，可以直接使用Codesys的“导出”功能，把POU导出成XML文件。这个XML可以很方便地被脚本或其他工具解析，配合Git做版本管理时尤其好用。唯一需要提醒的是，导出XML之前先编译一遍，否则导出的可能是最后一次编译通过的内容，而不是你最近修改后的逻辑。

在线调试方面，Codesys提供了非常强大的跟踪功能。右键变量选择“写入”“强制”都可以在线修改值，但“强制”比“写入”更霸道：强制之后PLC不再理会程序对这个变量的赋值，只有取消强制才恢复。现场调试时我一般先用“写入”尝试，不行再“强制”，防止把设备逼到危险状态。

5. EtherCAT主站配置与符号配置

5.1 EtherCAT主站怎么配才算顺

热词里“codesys control rte sl 如何配置ethercat主站”是一个高频问题。其实在AC700上做EtherCAT主站，流程已经相当成熟，你按下面步骤走基本不会出大问题：

第一步：在设备树里右键“Device”，添加“EtherCAT Master”设备。添加时注意选同步模式，常见的有SM模式和DC模式。如果设备对运动控制同步要求高，比如多轴联动、插补，推荐选DC分布式时钟模式，能保证各从站采样时序一致。

第二步：扫描从站。扫描前把网线接好，给伺服和IO从站上电，然后点击扫描按钮，Codesys会自动识别总线上的从站型号，并生成每个从站的描述节点。扫描成功后，每个从站会带出一组寄存器映射，这部分就叫“过程数据对象”或PDO映射。PDO映射决定每个周期主站和从站之间交换哪些数据，是控制字、状态字、目标速度还是实际位置，全在这里选。

第三步：对每个从站做地址分配。EtherCAT里每个从站点都有个站地址，扫描出来的默认地址可能和你的设备安装位置不对应，需要逐个检查、设置成实际节拍。这个地址和MODBUS从站地址不是一回事，别混。

第四步：在程序中访问PDO数据。配置完成后，你会在从站设备节点下面看到那些映射好的输入输出变量，直接在PLC_PRG里引用就行。运动控制中惯用做法是往“控制字”写16#0006使能、16#000F打开运行，从“状态字”里读取当前状态位。这些控制字和状态字的位定义可以在从站手册里查到，用代码时最好逐个位命名成可读性好的变量，不要直接写整数字面量，不然一个月后你自己都看不懂。

EtherCAT配置过程中最容易翻车的是ESI描述文件。某款从站设备在扫描时显示“无有效描述”，那多半是少装了它的设备描述文件。汇川官网可以下载对应型号的XML文件，把它导入到Codesys的“设备描述库”里，重新扫描就好了。

5.2 符号配置：HMI和上位机访问变量的钥匙

AC700在Codesys里，变量默认是“私有”的，外部设备不会直接看到。你要让触摸屏、上位机或者OPC UA客户端能访问PLC里面的变量，必须做“符号配置”，这个点很多人一开始根本不知道。

在工程树的Application节点下面，有个“符号配置”条目。双击打开后，你可以勾选哪些POU、哪些全局变量需要公开。关键的一项叫“支持 OPC UA”，勾上之后，启动PLC运行时，OPC UA服务端会把勾选过的变量发布出去，外部设备只要知道节点地址就能读写。访问权限也可以在这里设置，比如部分变量只读、部分变量允许写入，避免现场误操作。

实际项目里我习惯把所有HMI需要的变量集中放到一个全局变量表GVL中，然后统一勾选发布。这样做的好处有两个：一是符号配置界面简单清晰，不会在一堆内部临时变量里翻找；二是安全，你不希望上位机直接操作到的内部中间变量，天然就不会被发布出去。

调试通信问题时的思路也由此而来：如果上位机连不上PLC，先ping通IP，再确认上位机用的OPC UA客户端版本和PLC的OPC UA兼容性，最后查符号配置里对应变量是否勾选了“可访问”。大多数连接不上，都是这三步里某一步没做对。

5.3 数据库类库和第三方扩展

Codesys生态里有一种很有意思的能力：可以加载第三方库来扩展功能。比如“mysql的alongwu第三方库(codesys)”这个热词，说的是有人做了对接MySQL数据库的库，PLC可以把采集到的数据直接写入数据库，省掉上位机中转。基础指令阶段不要求你马上掌握这类高级玩法，但建议你了解一下库管理器（Library Manager）的位置：选中Application节点，右键就可以打开库管理器，加载你想用的库。

写第三方库对接数据库这类功能时，核心还是离不开基础的数据类型转换和组织能力。你从总线采集到的原始数据是INT、DWORD、REAL，要写库之前得把它们整理成结构体，再调用库函数写入。所以千万别小看基础指令，它们是整个工控大楼的地基，地基不稳，楼上盖得再高都危险。

6. 现场调试的常见问题与排查

这些坑大多是我实际调试时踩过多次的。尤其“扫描不到设备”和“MODBUS数据乱码”这两类，占了我过去一年现场问题的一半。养成一个习惯：改完程序先编译再下载，下载完先复位冷启动，启动后再看在线监控值。这一套流程能规避很多诡异问题。

关于在线监控，我再啰嗦一句。Codesys里的“登录”不等于“下载”。登录只是连接PLC并查看当前运行状态，下载才是把新程序写入PLC。如果只是改了程序还没下载，点击登录后你会发现画面还是PLC里跑的老程序，并不是你刚改的新逻辑，这是很多新人的认知盲区。

还有一个小技巧，在线监控时如果你只想看某几个关键变量的实时值，不要在一堆代码里翻，直接在视图菜单里打开“监视表达式”，把变量拖进去，相比在代码行里逐个看，效率高得多。现场被催着交活的时候，这个功能能让你保持清醒。

另外，程序注释这个东西，平时看着没什么用，等三个月后原设备出问题，你被叫过去维护时，就会感谢当初写注释的自己。Codesys里注释在行首用//，块注释用(* *)，梯形图里也可以给线圈和触头加上注释文字。我见过太多“没有一行注释的程序”，简直就是现场维护的噩梦。

关于代码规范，也提一个我自己的习惯：定时器和计数器功能块命名时带上工位或设备名，比如TON_SpindleCooling、CTU_PartCount，不要用Ton0、Ton1、Ctu0这种名字。变量的命名也是一样，启动按钮叫bStartButton，停止按钮叫bStopButton，一眼就知道是什么。群里的新手老爱问“为什么我的程序跑起来和想的不一样”，我看过他们的源码，一半以上问题出在变量名毫无语义，自己都分不清该用哪个。

最后再说一点心得：AC700这个平台，虽然是Codesys内核，但它和欧系PLC还有些细微差异，汇川在底层驱动和某些功能块上做了本地化封装。遇到问题不要只搜英文资料，去汇川官网的下载中心找对应手册、应用笔记，上面有很多针对性和本地化优化的内容，比网上到处拼凑的结论靠谱得多。工控这行，最快的成长路径从来不是你google能力多强，而是你能不能把每个报错、每个异常都当成一次学习机会，慢慢构建出自己的排查工具箱。