iBeacon原始十六进制数据解码教程

本文旨在指导读者如何解析和理解iBeacon设备的原始十六进制广播数据。通过详细剖析iBeacon数据包的结构，我们将展示如何从`rawData`字段中提取出Proximity UUID、Major、Minor和Measured Power等关键信息，并提供编程实现思路及注意事项，帮助开发者准确解码iBeacon数据。

在物联网（IoT）应用中，iBeacon设备通过蓝牙低功耗（BLE）广播其标识信息。这些信息通常以原始十六进制字符串的形式被IoT网关捕获并传输到服务器。理解并正确解码这些rawData对于利用iBeacon进行定位、追踪或触发特定事件至关重要。

iBeacon数据包结构概览

iBeacon数据包本质上是蓝牙低功耗（BLE）广告数据包的一种特定格式。它遵循通用的BLE广告数据单元（ADU）结构，其中包含一个或多个广告数据（AD）结构。对于iBeacon，核心信息封装在“制造商特定数据”（Manufacturer Specific Data）AD结构中。

一个典型的iBeacon原始十六进制数据串（如rawData）通常由以下部分组成：

1. BLE AD Flags (3字节): 通常为020106，表示通用发现模式和BLE支持。
2. AD Length (1字节): 制造商特定数据部分的长度。对于标准的iBeacon，通常是1A（十进制26），表示后续有26字节的数据。
3. AD Type (1字节): 广告数据类型，FF表示制造商特定数据。
4. Company Identifier (2字节): 制造商ID。对于Apple iBeacon，固定为4C00（Apple Inc.）。
5. iBeacon Type (1字节): iBeacon数据类型标识，固定为02。
6. iBeacon Length (1字节): iBeacon有效载荷的长度，固定为15（十进制21）。
7. Proximity UUID (16字节): iBeacon的唯一标识符，用于区分不同的iBeacon部署。
8. Major (2字节): 用于区分同一UUID下的一组iBeacon。
9. Minor (2字节): 用于区分同一Major下单个iBeacon。
10. Measured Power (Tx Power) (1字节): 校准后的RSSI值，表示在距离iBeacon 1米处接收到的信号强度。这是一个有符号字节，用于距离估算。

将上述结构整合起来，iBeacon的“前缀”部分通常是固定的9个字节（0201061AFF4C000215），其后紧跟着UUID、Major、Minor和Tx Power。

解析示例

让我们使用提供的rawData示例进行详细解析： 0201061AFF4C000215FDA50693A4E24FB1AFCFC6EB0764782527114CB9C5

按照iBeacon数据包结构进行分解：

• BLE AD Flags: 020106 (3字节)
• AD Length: 1A (1字节) -> 十进制26
• AD Type: FF (1字节)
• Company Identifier: 4C00 (2字节) -> Apple Inc.
• iBeacon Type: 02 (1字节)
• iBeacon Length: 15 (1字节) -> 十进制21

至此，iBeacon的固定前缀部分为 0201061AFF4C000215，共9个字节（18个十六进制字符）。

Clips AI

自动将长视频或音频内容转换为社交媒体短片

201

查看详情

接下来是iBeacon的有效载荷：

• Proximity UUID: FDA50693A4E24FB1AFCFC6EB07647825 (16字节)
  • 这是一个32个十六进制字符组成的字符串，通常表示为UUID格式，例如FDA50693-A4E2-4FB1-AFCFC6EB07647825（尽管标准UUID有特定分隔符，原始数据中没有）。
• Major: 2711 (2字节)
  • 十六进制 2711 转换为十进制是 10001。
• Minor: 4CB9 (2字节)
  • 十六进制 4CB9 转换为十进制是 19641。
• Measured Power (Tx Power): C5 (1字节)
  • 十六进制 C5 转换为十进制是 197。由于Tx Power是有符号字节，且通常表示负值，我们需要将其解释为带符号的8位整数。0xC5在补码表示中是-59。

因此，从原始数据中我们成功提取了iBeacon的所有关键信息。

编程实现

在实际应用中，您可以使用各种编程语言（如Python, JavaScript, Java等）来解析这些十六进制字符串。核心步骤包括字符串切片和十六进制到十进制的转换。

以下是一个Python示例代码片段，演示如何解析iBeacon的rawData：

import struct

def parse_ibeacon_raw_data(raw_data_hex):
    """
    解析iBeacon原始十六进制数据字符串。

    Args:
        raw_data_hex (str): iBeacon设备的原始十六进制数据字符串。

    Returns:
        dict: 包含解析后iBeacon信息的字典，如果解析失败则返回None。
    """
    if not raw_data_hex or len(raw_data_hex) < 60: # 至少需要30字节 = 60个十六进制字符
        print("Invalid raw data length.")
        return None

    try:
        # 提取固定前缀部分进行验证 (可选，但推荐)
        ad_flags = raw_data_hex[0:6]        # 020106
        ad_length = raw_data_hex[6:8]       # 1A
        ad_type = raw_data_hex[8:10]        # FF
        company_id = raw_data_hex[10:14]    # 4C00
        ibeacon_type = raw_data_hex[14:16]  # 02
        ibeacon_len = raw_data_hex[16:18]   # 15

        # 验证是否是标准的iBeacon前缀
        if not (ad_flags == "020106" and ad_length == "1A" and \
                ad_type == "FF" and company_id == "4C00" and \
                ibeacon_type == "02" and ibeacon_len == "15"):
            print("Data does not match standard iBeacon prefix.")
            return None

        # 提取iBeacon有效载荷
        payload_start_index = 18
        uuid_hex = raw_data_hex[payload_start_index : payload_start_index + 32]
        major_hex = raw_data_hex[payload_start_index + 32 : payload_start_index + 36]
        minor_hex = raw_data_hex[payload_start_index + 36 : payload_start_index + 40]
        tx_power_hex = raw_data_hex[payload_start_index + 40 : payload_start_index + 42]

        # 转换值
        # UUID通常保持十六进制字符串或格式化
        formatted_uuid = f"{uuid_hex[0:8]}-{uuid_hex[8:12]}-{uuid_hex[12:16]}-{uuid_hex[16:20]}-{uuid_hex[20:32]}"
        major = int(major_hex, 16)
        minor = int(minor_hex, 16)

        # Tx Power是带符号的8位整数
        tx_power = struct.unpack("b", bytes.fromhex(tx_power_hex))[0]

        return {
            "proximity_uuid": formatted_uuid,
            "major": major,
            "minor": minor,
            "measured_power": tx_power
        }

    except Exception as e:
        print(f"Error parsing iBeacon data: {e}")
        return None

# 示例使用
raw_data_example = "0201061AFF4C000215FDA50693A4E24FB1AFCFC6EB0764782527114CB9C5"
parsed_ibeacon_info = parse_ibeacon_raw_data(raw_data_example)

if parsed_ibeacon_info:
    print("Parsed iBeacon Information:")
    for key, value in parsed_ibeacon_info.items():
        print(f"  {key}: {value}")

注意事项

• 数据完整性验证: 在解析之前，务必检查rawData的长度。一个完整的iBeacon数据包通常是30字节（60个十六进制字符）。如果数据不完整，可能会导致解析错误。
• 多种Beacon类型: 并非所有rawData都代表iBeacon。市面上还有Eddystone、AltBeacon等其他类型的Beacon。它们的rawData结构不同，需要根据其特定的前缀或标识符进行区分和解析。本教程仅针对iBeacon。
• 字节序（Endianness）: 在转换多字节数值（如Major和Minor）时，需要注意字节序。iBeacon标准通常采用大端序（Big-Endian），即最高有效字节在前。Python的int(hex_string, 16)默认会正确处理。
• Tx Power的解释: Measured Power（Tx Power）是一个有符号的8位整数，表示iBeacon在1米距离处的RSSI值。在进行距离估算时，这个值是关键的校准参数。

总结

通过理解iBeacon数据包的固定结构，我们可以有效地从原始十六进制数据中提取出Proximity UUID、Major、Minor和Measured Power等关键信息。掌握这一解析过程对于开发基于iBeacon的物联网解决方案至关重要。在编程实现时，应注重数据完整性校验和对不同Beacon类型的区分，以确保解析的准确性和鲁棒性。

以上就是iBeacon原始十六进制数据解码教程的详细内容，更多请关注php中文网其它相关文章！