简介本资源是一套面向Android开发者的工业通信实战代码包聚焦于在PDA等移动终端上通过Modbus TCP协议与PLC设备进行稳定读写交互特别适合工控场景下需二次开发移动端HMI的工程师及学习嵌入式通信的新手。项目基于modbus4j.jar与seroUtils.jar实现16位寄存器读写并完整封装了浮点数转换与写入逻辑代码源自真实产线项目已亲测可用并规避常见连接超时、字节序错乱等坑点。压缩包共1076个文件含20个核心Java源码、129个class字节码、116个JSON配置、51个XML布局及26个JAR依赖另有APK安装包与调试资源整体大小为12.01MB。目前已有934人学习下载提供即插即用的PLC通信模块、清晰的目录分层含工具类、协议封装、UI交互三层结构以及可直接复用的异常处理与数据解析范例助力开发者快速集成Modbus功能到自有Android应用中。很多搞工控的老哥们一听到“Android连PLC”第一反应就是“这玩意儿能用吗稳定吗”。我的答案是能而且比你想象中简单。今天这篇就基于我最近做的一个项目完整拆解一下怎么在Android上用Modbus4j库去读写三菱、西门子等常见PLC的数据。先说清楚这篇文适合谁搞MES系统集成的、做设备点检APP的、或者纯粹想在产线上用手机/平板当临时HMI的朋友。只要你的PLC支持Modbus TCP协议现在主流PLC基本都支持或者加个网关模块就能支持这套方案就能跑通。文章不扯太多虚的直接把从环境搭建到读写寄存器的完整代码和踩坑记录都给你。1. 为什么我选择Modbus4j而不是自己造轮子在正式写代码之前得先说清楚一个事为什么偏偏是Modbus4j这个库。市面上Java读写Modbus的库其实不少比如jamod、modbuspal但我在对比测试了一圈之后最终留下了Modbus4j。原因很实际第一这个库对Modbus协议的实现非常完整。功能码覆盖了线圈读写01/05/15、离散量输入02、保持寄存器读写03/06/16、输入寄存器04基本覆盖了工控现场所有常见场景。像三菱FX系列读变频器频率这种需求本质就是读保持寄存器一个函数就搞定了。第二它内部把Modbus TCP 和 RTU都封装好了。虽然Android设备绝大多数场景下走TCP但保不齐你后面要加一个串口转WiFi的网关或者直接用USB转485去连老设备这时候RTU的支持就是刚需。第三基于Apache 2.0协议开源商用完全没问题不会有授权的坑。再说说为什么不建议自己写Modbus协议栈。Modbus TCP报文格式虽然不复杂——事务标识符、协议标识符、长度、单元标识符加起来就8个字节的MBAP头后面跟功能码和数据——但真正写起来你会发现坑全在细节里TCP粘包拆包怎么处理、超时重试机制怎么设计、异常码怎么解析、处理从站不响应的情况这些如果没有经过大量现场验证很容易出现“连得上但读不到数据”的灵异问题。工业现场讲的是稳定不是炫技。在选型这件事上我的建议是除非你有极其特殊的定制需求比如非标准协议变种否则不要自己写协议层直接用社区验证过的成熟库。2. 基础概念寄存器类型与Modbus4j的核心API动手写代码前脑袋里必须建立一个映射关系表。PC端做Modbus开发最怕的就是地址搞错到了Android上同样如此。2.1 Modbus协议里那四种基础数据类型数据类型功能码读功能码写常见用途线圈Coil0105单写/ 15批量写启停信号、开关状态离散输入Discrete Input02不支持写限位开关、按钮状态输入寄存器Input Register04不支持写模拟量采集传感器数值保持寄存器Holding Register0306单写/ 16批量写频率设定值、温度设定值、运行参数在工控界有一个历史遗留问题要注意PLC侧看到的地址比如40001和协议里的真实地址比如0不是一回事。Modbus协议经典的“5位数地址”规则里3xxxx对应输入寄存器4xxxx对应保持寄存器而协议报文里从0开始计数。所以屏幕上显示40001到了Modbus4j里写ReadHoldingRegistersRequest起始地址其实是0。2.2 Modbus4j的核心类一句话讲清楚ModbusFactory工厂类用来创建各种通信Master。就像Android里的Retrofit.Builder一切连接的起点。TcpMaster/TcpMasterParametersTCP主站对应TCP连接的建立与参数配置如IP、端口、超时、重连次数。ModbusMaster统一的主站操作接口读写都通过它来完成。ReadHoldingRegistersRequest/WriteRegisterRequest/WriteRegistersRequest请求对象每个对应一个功能码。ValueFormat这个类实在是太好用了。它把“字节数组转成Java里的int/float/long/bool”这一步高度封装了默认大端字节序的情况下直接拿值。拿到这些类的概念下面就可以撸代码了。3. 工程搭建与核心代码实现3.1 环境准备与依赖引入我用的是Android Studio当前的大版本基本都行项目用Java还是Kotlin都能跑但因为我后续要写一些偏底层的解析逻辑而且对接的很多老工控项目组Java功底更扎实所以下面示例统一用Java写。自己项目里用Kotlin的照着逻辑翻译就行。在app/build.gradle里加依赖dependencies { implementation com.infiniteautomation:modbus4j:3.0.3 // 如果遇到依赖冲突加上以下排除规则 implementation(com.infiniteautomation:modbus4j:3.0.3) { exclude group: org.slf4j, module: slf4j-api } }测试下来3.0.3版本比较稳定老版本2.x也没问题但API命名有些变化。如果你需要在自己电脑上先做协议验证不写Android直接建一个Java main方法类也能跑这个库在纯Java环境下的表现和Android上完全一致。权限方面别忘在AndroidManifest.xml里加网络权限uses-permission android:nameandroid.permission.INTERNET /这步漏了的话Android 9及以上直接抛异常而且很难排查到。3.2 初始化Master连接import com.serotonin.modbus4j.ModbusFactory; import com.serotonin.modbus4j.ModbusMaster; import com.serotonin.modbus4j.ip.tcp.TcpMaster; import com.serotonin.modbus4j.ip.tcp.TcpMasterParameters; public class ModbusTcpClient { private ModbusMaster master; private ModbusFactory factory new ModbusFactory(); // 关键参数IP、端口、超时时间、重试次数 public boolean connect(String ip, int port, int timeout, int retries) { try { TcpMasterParameters params new TcpMasterParameters(ip, port); params.setTimeout(timeout); // 毫秒建议3000-5000 params.setRetries(retries); // 重试次数建议2-3 master factory.getTcpMaster(params); master.init(); return true; } catch (Exception e) { e.printStackTrace(); return false; } } }这里有两个参数很有意思先说timeout。Modbus TCP虽然是走TCP协议有系统级超时兜底但如果你不设应用层超时的话一旦PLC端IP能ping通但业务端口不响应TCP长连接可能挂很久才报错现场体验非常糟糕。建议超时设在3000到5000毫秒之间。太小的话PLC在忙其他任务比如正在执行子程序或者中断服务时经常会误报超时。再说retries。PLC不比服务器它的响应时间是不稳定的CPU扫描周期一出问题几十毫秒内没回包很正常。我一般设2次既不会因为单次超时误判设备离线也不会把大量时间浪费在无意义的等待上。3.3 读取三菱PLC的保持寄存器最常用需求很典型产线上三菱FX系列PLC读取当前变频器频率。变频器的运行频率一般存在D寄存器映射到Modbus的保持寄存器区域。读取代码如下import com.serotonin.modbus4j.msg.ReadHoldingRegistersRequest; import com.serotonin.modbus4j.msg.ReadHoldingRegistersResponse; import com.serotonin.modbus4j.base.ModbusUtils; public int readHoldingRegister(int unitId, int startOffset, int length) { try { ReadHoldingRegistersRequest request new ReadHoldingRegistersRequest(unitId, startOffset, length); ReadHoldingRegistersResponse response (ReadHoldingRegistersResponse) master.send(request); if (response.isException()) { // 功能码返回异常例如从站地址错误、寄存器地址越界 return -1; } // 注意返回的是字节数组按大端模式转int return ModbusUtils.bigEndianToInt(response.getData(), 0); } catch (Exception e) { e.printStackTrace(); return -1; } }注意unitId这是从站地址站号。很多新手在这里会踩坑三菱FX3U在PLC侧把站号设为0但Modbus TCP协议里单元标识符有效范围是1到247站号0会被当成广播地址PLC直接不理你。现场配Modbus网关时要先把PLC的站号改成1或其它非0值协议转换模块才会正常响应。读取多个连续寄存器的时候把length参数传大一点就行。还有一点一次请求的最大寄存器数量是125个这是Modbus协议的限制千万别一次读几千个要分批。这个限制在标准文档里有写但是很多山寨网关并不提示只会返回异常码搞不好排查半天。3.4 写入数据到PLC频率设定/启停控制写入操作是最能体现“用手机控制设备”的场景。比如通过APP把变频器目标频率直接写到PLC的D寄存器import com.serotonin.modbus4j.msg.WriteRegisterRequest; import com.serotonin.modbus4j.msg.WriteRegisterResponse; import com.serotonin.modbus4j.base.ModbusUtils; public boolean writeSingleRegister(int unitId, int offset, int value) { try { WriteRegisterRequest request new WriteRegisterRequest(unitId, offset, value); WriteRegisterResponse response (WriteRegisterResponse) master.send(request); return !response.isException(); } catch (Exception e) { e.printStackTrace(); return false; } }如果你想一次写多个寄存器比如同时下发目标频率和加减速时间那就用WriteRegistersRequest传入一个寄存器的int数组。这在批量设定设备参数时非常有用。import com.serotonin.modbus4j.msg.WriteRegistersRequest; import com.serotonin.modbus4j.msg.WriteRegistersResponse; public boolean writeMultipleRegisters(int unitId, int startOffset, int[] values) { try { WriteRegistersRequest request new WriteRegistersRequest(unitId, startOffset, values); WriteRegistersResponse response (WriteRegistersResponse) master.send(request); return !response.isException(); } catch (Exception e) { e.printStackTrace(); return false; } }写操作是现场事故高发区。建议在产品逻辑上强制加入二次确认对话框同时在代码里做一个写前校验对频率、温度等模拟量设定值限制上下限后裁剪到合法范围内别让一个-1或者65535这种数据直接灌到PLC里。3.5 释放连接资源Android设备不像PC系统资源有限而且一个Activity生命周期变化很可能导致底层连接异常。建议在onDestroy里做释放Override protected void onDestroy() { super.onDestroy(); if (master ! null) { master.destroy(); } }这个destroy()方法是这个库自己维护TCP连接状态的不调用的话TCP连接不会被系统自动回收反复进入页面几次就会出现连接数过多、所有请求超时的情况。而且这种问题在日志里看起来又是“一切正常但没响应”非常迷惑。4. 实际项目中的典型问题与排查记录再好的代码在真实工控现场也会遇到一堆“文档里没有写的”问题。我把这几个月踩过的坑整理成一份速查表希望能帮你省下几天的排查时间。4.1 常见问题速查现象可能原因排查方法解决方案连接超时PLC的IP地址或端口错误ping PLC IP用telnet测502端口核对PLC侧以太网模块配置连接超时Android设备与PLC不在同一网段查看手机WiFi的IP地址段给手机设置静态IP确保和PLC同网段读数据全是0寄存器地址映射不对在PC端先用Modbus Poll工具验证对照PLC编程软件的D寄存器编号注意起始偏移读数据全是65535寄存器不存在或该地址未分配检查PLC侧数据是否已初始化在PLC里给该寄存器赋初值数据错乱高低字节反字节序不匹配打印原始字节比对大小端调整库里的字节序配置写入不生效写功能码不正确确认PLC支持06还是16功能码单寄存器用06多寄存器用16偶发超时PLC扫描周期长CPU忙抓包看响应时间加大timeout降低轮询频率崩溃在主线程执行网络操作看logcat的NetworkOnMainThreadException挪到子线程/协程/HandlerThread4.2 重点说说字节序问题这是所有Modbus调试里最容易让人抓狂的坑没有之一。大端序Big-Endian表示高字节在前小端序Little-Endian表示低字节在前。Modbus官方协议规定的是大端但三菱、西门子都有一些特殊场景会搞出小端来尤其中间加了个网关后字节序就不可控了。比如你读到的原始数据是0x01 0xF4按大端解析就是500按小端解析就是0xF401 62465。一个正常一个疯掉。解决思路很简单打印原始字节然后肉眼判断哪个值合理。byte[] data response.getData(); for (byte b : data) { System.out.printf(%02X , b); }如果发现高低字节是反的做一次字节交换就行public static int swapByteOrder(int value) { return ((value 0xFF) 8) | ((value 8) 0xFF); }有些PLC厂商会把32位浮点数分两个字存储而两个字的顺序也可能是反的字序与字节序两个维度。这种情况下建议自己写一个解析器手动拼装两个寄存器后再按IEEE 754格式转float。Modbus4j里也有LittleEndian的寄存器配置但遇到混合字节序的场景自己拼字节反而更可控。4.3 Android端特有的坑主线程网络操作和生命周期管理这里必须强调一个Android开发的基本红线不能在主线程里直接调用master.send()。Android从4.0开始就强制禁止在主线程做网络访问直接抛NetworkOnMainThreadException。就算不抛异常你也会把UI线程卡到ANR用户看到的就是“手机死机了”。我项目里的做法是用一个单线程的ExecutorService来管理所有Modbus请求。这样可以保证所有读写操作按顺序执行不会出现两个请求同时发出去把PLC搞糊涂的情况private ExecutorService modbusExecutor Executors.newSingleThreadExecutor(); public void postModbusTask(Runnable task) { modbusExecutor.execute(task); }然后在子线程里处理好数据通过runOnUiThread或Handler把结果抛回UI线程刷新界面。页面的生命周期也要小心。如果用户在读写过程中退出了页面而子线程还在执行网络操作很可能把连接状态搞乱。所以我在MainActivity里维护一个volatile boolean isActive标志位在子线程回调前先检查一下页面还活着没避免一个已经销毁的Activity去执行UI更新。4.4 多设备场景下的设备地址管理有一个需求很常见一个App要管理多条产线的十几套PLC。这时Modbus协议里的unitId就是最重要的路由信息。每一套PLC的寄存器数据都要跟它的IP和unitId一起维护。我的做法是封装一个设备对象public class PlcDevice { public String deviceName; public String ipAddress; public int port; public int unitId; public int[] registerAddresses; // 该设备需要监控的寄存器地址表 }这样在界面上切换设备时只需要重新创建TcpMasterParameters指向对应IP再重新初始化即可。但要注意Modbus4j的Master实例和TCP连接是绑定的如果你有十几台设备需要同时采集数据就要创建多个Master实例每个Master维护一路TCP连接并用各自的Executor去调度请求。连接数量多了以后建议加一个连接池管理超过一定空闲时间自动destroy()下次用到时再init()。省电也避免手机端的TCP连接数被打满。5. 断线重连与稳定性优化工控场景里最怕的就是“APP连着一半突然断了”所以断线重连机制必须一开始就设计好而不是等现场出问题再补。5.1 心跳检测机制Modbus TCP本身没有“心跳包”这一说法实际工程上就是用定期读寄存器来间接保活。我一般是每隔5秒发一次读操作读一个或几个寄存器都行关键是产生通信流量连续3次无响应就判定设备离线然后进入重连流程。private void startHeartbeat() { heartbeatRunnable new Runnable() { Override public void run() { if (isConnected()) { int value readHoldingRegister(unitId, heartbeatAddress, 1); if (value -1) { offlineCount; if (offlineCount 3) { // 判定离线触发重连 reconnect(); } } else { offlineCount 0; } } heartBeatHandler.postDelayed(this, 5000); } }; heartBeatHandler.postDelayed(heartbeatRunnable, 5000); }注意心跳间隔别太短5秒是比较保守的。太频繁的话一方面会增加PLC那边的通信负担另一方面手机也会更耗电。有时候PLC厂家看到你每秒刷屏式地读数据还会怀疑你的系统是不是有异常现场沟通起来很尴尬。5.2 自动重连与退避策略重连不能太耿直。如果PLC停电了半小时你的App每两秒重试一次手机电池会哭的。我用了一个简单的指数退避策略第1次重试间隔3秒第2次6秒第3次12秒最大值封顶30秒一旦重连成功立即重置间隔这样既能在PLC恢复后快速感知又不会在长时间离线时浪费资源和电量。5.3 日志记录是保命手段再说一个经验在Android上做Modbus调试如果没有日志记录你基本就是瞎子。你要把每一次请求的时间戳、目标IP、功能码、寄存器地址、读写长度、返回结果全部写到本地文件里去。现场出了问题通过日志能快速定位是App问题、网络问题还是PLC问题。我实现了一个简单的FileLogger每次读写操作后追加一行日志按天滚动保存。虽然看起来土但真的很救命。6. 补充当PLC不支持Modbus TCP时怎么处理不是所有PLC都自带Modbus TCP接口的。三菱FX2N这种老古董本身只带RS485串口如果你非要用Android去连它有两个办法第一种加一个串口转WiFi/串口转以太网的网关模块。市面上很多工业级网关比如有人物联网、USR IOT系列都自带Modbus TCP转Modbus RTU功能。Android发送Modbus TCP报文网关收到后自动转成RTU格式通过RS485总线发给PLC。这种方式对App代码完全透明读写逻辑一个字都不用改。第二种串口直连。Android设备通过OTG接一个USB转RS485模块然后直接用Modbus4j的RTU模式去通信。实现上要处理串口打开、波特率设置、数据位/停止位/校验位配置代码量会多一点而且相对TCP来说串口通信的调试难度更大。我建议能走TCP就走TCP实在要用串口再上这个方案。无论哪种方式PLC侧需要预先做好配置站号不能为0、波特率/校验方式要和网关侧一致、需要映射的D寄存器和M线圈都要在PLC程序里准备好数据。7. 写在最后的几个小建议根据我个人经验还有几件小事值得多啰嗦几句。第一上现场前一定先在办公室用模拟器或PC端工具把通信逻辑验证好。我常用的是Modbus PollPC端测试软件和一套虚拟从站模拟器先在PC上把读写逻辑跑通再往Android上搬。直接拿真机到现场调试一旦出问题你连“到底是硬件问题还是代码问题”都分不清。第二界面上的数据刷新频率不要超过2Hz。人眼完全看不出10Hz和2Hz刷新率的区别但PLC那边可能已经被你的高频读请求拖累了。尤其是还要兼顾多台设备时更要把轮询周期做成分段式避免所有设备都在同一个时间点发请求造成瞬间流量风暴。第三考虑一套离线模式。Android设备本身有本地数据库比如SQLite把最近一次读到的PLC数据缓存下来。这样万一断网断连界面还能显示历史数据至少用户可以知道“上一次正常时设备的状态是什么”这对于现场排障有很大帮助。第四如果可以的话把PLC读写封装在自己团队内部的一个独立Module里与UI层彻底隔离。这样后续如果换通信库、加设备类型都不需要动界面代码。我早期为了赶进度把通信逻辑和Activity混在一起写后面加需求时吃了不少苦头重构花的时间比重写还要多。Modbus4j这个库虽然不算非常活跃但胜在稳定配合Android做移动端的工控监控完全够用。像手机远程看一下产量、改一下频率设定、点一下启动停止这种需求它都能稳稳扛住。如果你正在评估类似方案希望这篇能够给你省下几个加班的晚上。本文还有配套的精品资源点击获取