4. 消息编码差异处理：SECS-II消息头版本差异的兼容方案

SECS-II消息头是设备与主机之间交换数据的核心信封。不同版本的SEMI标准（E5、E30、E37）对消息头中Device ID长度、W-bit（Wait-bit）处理方式存在显著差异。若未做兼容处理，轻则消息解析失败，重则导致设备通信中断或数据错乱。本节将系统梳理这些差异，并给出经过验证的兼容方案。

4.1 Device ID长度差异与兼容方案

Device ID在SECS-II消息头中用于标识目标设备或控制单元。不同标准版本对其长度定义不同：

从表中可以看出，10-bit与16-bit Device ID在消息头字节0-1的编码方式完全不同。10-bit方案将低6位用于其他标志位（如R-bit、W-bit），而16-bit方案则独占全部16位。

4.1.1 兼容方案：动态Device ID掩码与长度协商

推荐采用以下三层兼容策略：

1. 连接建立阶段版本协商：在HSMS连接建立或GEM通信初始化时，通过S1F13/S1F14（Establish Communications Request/Response）交换双方支持的Device ID长度信息。建议在S1F14的MDLN（Model Number）或SOFTREV（Software Revision）中携带扩展属性。
2. 发送端动态掩码：根据协商结果，发送端在编码消息头时对Device ID进行掩码处理：
   • 若对端支持16-bit：直接写入完整16位Device ID。
   • 若对端仅支持10-bit：将Device ID左移6位，低6位置0（保留R-bit和W-bit位置）。
3. 接收端自适应解码：接收端根据本地配置或消息头中的版本指示位（如HSMS Session ID的扩展标志）选择解码方式。若无法确定，则尝试两种解码方式并通过消息体校验和验证。

/* C语言示例：Device ID编码兼容函数 */
uint16_t encode_device_id(uint16_t device_id, uint8_t peer_version) {
    if (peer_version & DEVICE_ID_16BIT_SUPPORT) {
        /* 16-bit模式：直接写入 */
        return device_id & 0xFFFF;
    } else {
        /* 10-bit模式：左移6位，保留低6位控制位空间 */
        return (device_id & 0x03FF) << 6;
    }
}

uint16_t decode_device_id(uint16_t header_word, uint8_t local_version) {
    if (local_version & DEVICE_ID_16BIT_SUPPORT) {
        /* 16-bit模式：直接读取 */
        return header_word & 0xFFFF;
    } else {
        /* 10-bit模式：右移6位 */
        return (header_word >> 6) & 0x03FF;
    }
}

4.2 W-bit（Wait-bit）处理差异与兼容方案

W-bit是SECS-II消息头中用于控制事务同步的关键标志位。不同版本和实现对其处理存在以下差异：

4.2.1 兼容方案：W-bit规范化与容错处理

针对W-bit的常见差异，推荐以下兼容处理方案：

• W-bit位置校验与修正：在解析消息头时，根据Device ID长度模式确定W-bit的正确位置。对于10-bit模式，W-bit位于字节1 bit 0；对于16-bit模式，W-bit位于字节1 bit 6（HSMS扩展头）。若检测到W-bit在非标准位置，记录告警并尝试修正。
• W-bit/R-bit互斥检查：接收端在解析消息头时检查W-bit与R-bit是否同时为1。若发现冲突，优先按W-bit=1处理（即期望回复），并记录协议违规日志。发送端在编码时强制保证互斥。
• W-bit超时容错：实现可配置的超时定时器（建议默认10秒），超时后自动清除W-bit等待状态，并触发重试或错误回调。避免因对端未回复导致永久阻塞。
• 多块消息W-bit过滤：对于多块消息（Message Block），仅处理最后一块（Block Number=0）的W-bit，中间块的W-bit强制忽略。在重组缓冲区中，仅当最后一块到达且W-bit=1时才触发回复。

/* Python示例：W-bit兼容解析与修正 */
def parse_wbit(header_bytes, device_id_mode):
    """
    解析W-bit，支持10-bit和16-bit模式
    返回 (wbit_value, warning_list)
    """
    warnings = []
    
    if device_id_mode == 10:
        # 10-bit模式：W-bit在字节1 bit 0
        wbit = (header_bytes[1] & 0x01) != 0
        rbit = (header_bytes[1] & 0x80) != 0
    else:
        # 16-bit模式：W-bit在字节1 bit 6（HSMS扩展头）
        wbit = (header_bytes[1] & 0x40) != 0
        rbit = (header_bytes[1] & 0x80) != 0
    
    # W-bit/R-bit互斥检查
    if wbit and rbit:
        warnings.append("W-bit和R-bit同时置位，按W-bit=1处理")
        # 修正：清除R-bit
        if device_id_mode == 10:
            header_bytes[1] &= 0x7F
        else:
            header_bytes[1] &= 0x7F
    
    return wbit, warnings

def encode_wbit(header_bytes, wbit_value, device_id_mode):
    """
    编码W-bit，保证与R-bit互斥
    """
    if device_id_mode == 10:
        if wbit_value:
            header_bytes[1] |= 0x01   # 置位W-bit
            header_bytes[1] &= 0x7F   # 清除R-bit
        else:
            header_bytes[1] &= 0xFE   # 清除W-bit
    else:
        if wbit_value:
            header_bytes[1] |= 0x40   # 置位W-bit
            header_bytes[1] &= 0x7F   # 清除R-bit
        else:
            header_bytes[1] &= 0xBF   # 清除W-bit
    
    return header_bytes

4.3 消息头版本协商与回退机制

为了在运行时自动适应不同版本的SECS-II消息头，推荐实现以下版本协商与回退机制：

/* 版本协商状态机伪代码 */
typedef enum {
    VERSION_UNKNOWN,
    VERSION_NEGOTIATING,
    VERSION_10BIT_LEGACY,
    VERSION_16BIT_EXTENDED,
    VERSION_MISMATCH
} VersionState;

VersionState negotiate_version(uint8_t local_caps, uint8_t peer_caps) {
    /* local_caps和peer_caps为位掩码：
       bit 0: 支持10-bit Device ID
       bit 1: 支持16-bit Device ID
       bit 2: 支持标准W-bit
       bit 3: 支持扩展W-bit
    */
    
    if ((local_caps & 0x02) && (peer_caps & 0x02)) {
        /* 双方都支持16-bit，优先使用 */
        return VERSION_16BIT_EXTENDED;
    } else if ((local_caps & 0x01) && (peer_caps & 0x01)) {
        /* 双方都支持10-bit */
        return VERSION_10BIT_LEGACY;
    } else {
        /* 无交集，回退到10-bit */
        return VERSION_10BIT_LEGACY;
    }
}

4.4 兼容性测试验证清单

在完成消息编码差异处理方案的实施后，建议按照以下清单进行验证测试：