如何用Python结合.h头文件解析传感器二进制数据？

一、完全可以用Python解析 #

Python的struct模块专门用于处理C风格二进制数据，只要能将.h头文件中的结构体类型映射为struct.unpack所需的格式字符串，就能顺利解析传感器二进制文件。

二、从.h头文件生成格式字符串的方法 #

1. 手动映射（适合简单结构体） #

先把C语言基本类型对应到Python struct格式符，同时注意字节序和内存对齐：

字节序前缀：

• <：小端字节序（x86/ARM常见）
• >：大端字节序（嵌入式设备常见）
• @：本机字节序+默认对齐

示例转换：
假设你的.h头文件中有如下结构体：

typedef struct {
int SensorType;
char Name[20];
float Temperature;
unsigned long Timestamp;
} SensorIf;

对应的格式字符串（小端）为：<i20cfL，每个部分依次对应结构体字段。

2. 自动化生成（适合复杂/多个结构体） #

如果结构体数量多或包含嵌套类型，可以用pycparser库解析.h文件，自动生成格式字符串：

首先安装依赖：

pip install pycparser

示例解析脚本：

from pycparser import c_parser, c_ast

def generate_struct_format(header_content, struct_name, endian='<'):
    # 解析C头文件AST
    parser = c_parser.CParser()
    ast = parser.parse(header_content)
    
    # 定位目标结构体
    struct_node = None
    for ext in ast.ext:
        if (isinstance(ext, c_ast.Decl) 
            and isinstance(ext.type, c_ast.Struct) 
            and ext.type.name == struct_name):
            struct_node = ext.type
            break
    
    if not struct_node:
        raise ValueError(f"未找到结构体 {struct_name}")
    
    # 类型映射表，可根据需求扩展
    type_map = {
        'int': 'i',
        'short': 'h',
        'long': 'l',
        'unsigned int': 'I',
        'unsigned long': 'L',
        'float': 'f',
        'double': 'd',
        'char': lambda size: f"{size}c"
    }
    
    format_str = endian
    for decl in struct_node.decls:
        # 处理数组类型
        if isinstance(decl.type, c_ast.ArrayDecl):
            base_type = decl.type.type.names[0]
            arr_size = decl.type.dim.value
            format_str += type_map[base_type](arr_size)
        # 处理基本类型
        else:
            type_name = decl.type.names[0]
            format_str += type_map[type_name]
    
    return format_str

# 测试使用
header_text = """
typedef struct {
    int SensorType;
    char Name[20];
    float Temperature;
    unsigned long Timestamp;
} SensorIf;
"""
print(generate_struct_format(header_text, "SensorIf"))  # 输出: <i20cfL

注意：脚本需要根据实际使用的C类型扩展type_map，如果有嵌套结构体，需要递归处理；如果涉及内存对齐，可将字节序前缀改为@。

三、完整解析二进制文件示例 #

import struct

# 假设已生成格式字符串
format_str = '<i20cfL'
# 计算单个结构体的字节大小
struct_size = struct.calcsize(format_str)

# 读取并解析二进制文件
with open('sensor_measurements.bin', 'rb') as f:
    while chunk := f.read(struct_size):
        # 解析二进制数据
        sensor_type, name_bytes, temp, timestamp = struct.unpack(format_str, chunk)
        # 处理字符数组（去除末尾空字符）
        sensor_name = b''.join(name_bytes).decode('utf-8').rstrip('\x00')
        # 输出解析结果
        print(f"类型: {sensor_type}, 名称: {sensor_name}, 温度: {temp:.2f}, 时间戳: {timestamp}")

四、关键注意事项 #

• 字节序匹配：必须和生成二进制文件的程序一致，比如嵌入式设备常使用大端字节序，需将格式字符串前缀改为>。
• 内存对齐：C编译器默认会对结构体字段做对齐优化，如果二进制文件是对齐后的，可使用@前缀启用本机对齐规则，或手动计算字段偏移用struct.unpack_from解析。
• 复杂类型处理：遇到枚举类型时，需将枚举值映射为对应的整数；嵌套结构体需先单独生成子结构体的格式字符串，再分步解析。

内容的提问来源于stack exchange，提问作者Mikhail Trunov