在Fox-Edge之上开发并调试ZS-SHT30-1T-1H-485 通讯协议解码器

}

* 为设备的一个操作添加一堆编码/解码函数


需要为设备操作，添加一对static的编码/解码函数，用于通信数据的编码和解码。  
 在编码函数/解码函数上加上注解FoxEdgeOperate，告诉Fox-Edge对应的操作名称和这是编码/解码函数，建议的通信超时是多长。 Fox-Edge的Device服务在启动的时候，会扫描解码器jar包的信息。此时，它可以通过这个组件，获知可管理的设备的操作信息。  
 比如，这边定义了读取温湿度的一对编码/解码函数

/**

• 读取Registers
  /
  @FoxEdgeDeviceType(value = “温湿度采集模块(ZS-SHT30-1T-1H-485)”, manufacturer = “中盛科技”)
  public class ZSKJReadTemperatureAndHumidity {
  /*

  • 编码函数
  • @param param 编码参数，它来自设备配置的参数和操作任务配置的参数的合并
  • @return 编码结果 该数据的对象类型，要根据你准备转发的Channel服务来定义。
  • 比如，serial-channel提供的数据格式，是16进制格式的来表示通信报文，所以你要返回一个hex通信报文格式的String给外部
    */
    @FoxEdgeOperate(name = “读取温湿度”, polling = true, type = FoxEdgeOperate.encoder, timeout = 2000)
    public static String packReadInputRegister(Map<String, Object> param) {
    return (String) operateReadRegister(“”, param);
    }

  /**

  • 解码函数
  • @param hexString 该对象是由你使用的channnel从设备获得的报文，以hex格式文本输入给你。
  • 如果你用的是其他channel，其他channel有自己的约定，那么你需要采用对应的格式。
  • 目前各类channel支持的有常见的hexString，也有结构复杂一点的Map<String, Object>
  • @param param 解码参数，它来自设备配置的参数和操作任务配置的参数的合并，到时候你知道该如何对设备返回报文进行解码
  • @return 解码后的数据 必须为Map<String, Object>格式，表示一批key-value的设备数据对象和它的数值
    */
    @FoxEdgeOperate(name = “读取温湿度”, polling = true, type = FoxEdgeOperate.decoder, timeout = 2000)
    public static Map<String, Object> unpackReadInputRegister(String hexString, Map<String, Object> param) {
    return (Map<String, Object>) operateReadRegister(hexString, param);
    }
    }

#### [完整JAVA代码]( )

package cn.foxtech.device.protocol.zs.sht301t1h;

import cn.foxtech.device.protocol.core.annotation.FoxEdgeDeviceType;
import cn.foxtech.device.protocol.core.annotation.FoxEdgeOperate;
import cn.foxtech.device.protocol.core.exception.ProtocolException;
import cn.foxtech.device.protocol.core.utils.HexUtils;
import cn.foxtech.device.protocol.core.utils.MethodUtils;
import cn.foxtech.device.protocol.modbus.core.ModBusConstants;
import cn.foxtech.device.protocol.modbus.core.ModBusProtocol;
import cn.foxtech.device.protocol.modbus.core.ModBusProtocolFactory;
import cn.foxtech.device.protocol.modbus.core.ModBusReadRegistersRespond;

import java.util.HashMap;
import java.util.Map;

/**

• 读取Registers
  /
  @FoxEdgeDeviceType(value = “温湿度采集模块(ZS-SHT30-1T-1H-485)”, manufacturer = “中盛科技”)
  public class ZSKJReadTemperatureAndHumidity {
  /*

  • 读取保持寄存器
  • @param param 必须包含device_addr和modbus_holding_registers_template两个输入参数
  • @return 16进制文本格式的报文
    */
    @FoxEdgeOperate(name = “读取温湿度”, polling = true, type = FoxEdgeOperate.encoder, timeout = 2000)
    public static String packReadInputRegister(Map<String, Object> param) {
    return (String) operateReadRegister(“”, param);
    }

  /**

  • 解码保持寄存器
  • @param hexString 16进制文本格式的报文
  • @param param 必须包含 device_addr 和 modbus_holding_registers_template 两个输入参数
  • @return 解码后的数据
    */
    @FoxEdgeOperate(name = “读取温湿度”, polling = true, type = FoxEdgeOperate.decoder, timeout = 2000)
    public static Map<String, Object> unpackReadInputRegister(String hexString, Map<String, Object> param) {
    return (Map<String, Object>) operateReadRegister(hexString, param);
    }

  /**

  • 编码/解码 读取保持寄存器

  • @param hexString 解码报文：如果它为空，那么为编码操作，如果不为空，那么为编码操作

  • @param param 参数表

  • // 检查输入参数
    if (MethodUtils.hasEmpty(devAddr, modbusMode)) {
    throw new ProtocolException(“输入参数不能为空:devAddr, modbusMode”);
    }

    // 准备参数
    param.put(ModBusConstants.ADDR, devAddr);
    param.put(ModBusConstants.REG_ADDR, 0);
    param.put(ModBusConstants.REG_CNT, 6);
    param.put(ModBusConstants.MODE, modbusMode);

    // 选择对应的协议类型
    ModBusProtocol protocol = ModBusProtocolFactory.createProtocol(modbusMode);

    // 编码处理
    if (hexString.isEmpty()) {
    byte[] pack = protocol.packCmdReadRegisters4Map((byte) 0x04, param);
    return HexUtils.byteArrayToHexString(pack);
    }

    // 解码处理

    byte[] arrCmd = HexUtils.hexStringToByteArray(hexString);
    // 报文解析
    ModBusReadRegistersRespond respond = protocol.unPackCmdReadInputRegisters2Respond(arrCmd);
    if (respond == null) {
    throw new ProtocolException(“报文格式不正确，解析失败！”);
    }

    Map<String, Object> value = new HashMap<>();
    if (respond.getStatus().length < 2) {
    return value;
    }

    int status = respond.getStatus()[0];
    if (status < 10000) {
    value.put(“温度”, status * 0.1);
    } else {
    value.put(“温度”, (status - 10000) * -0.1);
    }

    status = respond.getStatus()[1];
    value.put(“湿度”, status * 0.1);

    return value;
    }
    }

### [介绍]( )



> 
> 制造商：中盛科技
> 
> 
> 



> 
> 产品名称：温湿度采集模块
> 
> 
> 



> 
> 产品型号：ZS-SHT30-1T-1H-485
> 
> 
> 



> 
> 官网连接：[产品详情]( )
> 
> 
> 


### [设备报文参数]( )


#### [设备通讯报文]( )


##### [请求报文]( )

01 04 00 00 00 06 70 08

##### [响应报文]( )

01 04 0c 01 1f 01 c8 41 e5 b7 a4 42 36 c3 91 14 e6

#### [设备操作请求]( )


##### [请求参数]( )

最后

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数Java工程师，想要提升技能，往往是自己摸索成长，自己不成体系的自学效果低效漫长且无助。

因此收集整理了一份《2024年嵌入式&物联网开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上嵌入式&物联网开发知识点，真正体系化！

943704)]

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上嵌入式&物联网开发知识点，真正体系化！