19 位域与跨平台协议布局

一、核心结论

位域适合表达程序内部的紧凑状态，但不要直接把位域结构体的原始内存当作跨平台 BLE/TWS 报文。

struct Status {
    unsigned int connected : 1;
    unsigned int playing   : 1;
};
  • : 1 表示成员宽度是 1 bit，不代表该成员的值必须为 1。
  • 无符号 1 位位域可以表示 0 或 1。
  • 位域的排列方向、存储单元与部分布局细节由具体实现决定，不能直接当成协议定义。

二、位域与协议 bit 编号不是一回事

假设自定义 BLE 协议要求：bit 0 = connected，bit 1 = playing。

协议字节位编号（从高位到低位）
 bit7 bit6 bit5 bit4 bit3 bit2 bit1 bit0
  ┌───┬───┬───┬───┬───┬───┬───┬───┐
  │ 0 │ 0 │ 0 │ 0 │ 0 │ 0 │ P │ C │
  └───┴───┴───┴───┴───┴───┴───┴───┘
                                ↑  ↑
                         playing  connected

这里的 C 和 P 位置是协议规定的，不能通过位域成员在源码中的先后顺序来保证。

对比C 位域显式位掩码与移位
优点用成员名操作状态，直观bit 位置可精确控制
局限原始内存布局依赖实现需要明确写编码逻辑
推荐场景本地状态跨平台 BLE/TWS 报文

三、packed 为什么不够？

部分编译器支持 packed 扩展，例如 GCC/Clang：

struct __attribute__((packed)) Flags {
    unsigned int connected : 1;
    unsigned int playing   : 1;
};

packed 通常用于减少填充、降低对齐要求，但不保证不同编译器或 ABI 采用相同的位域分配顺序。因此即便结构体占用很少空间，也不能据此认定其原始内存一定符合 BLE 协议规定。

注意：__attribute__((packed)) 不是 ISO C 标准语法，实际行为需查对应工具链文档。

四、BLE 状态报文：正确的编码方法

协议约定：bit 0 表示连接，bit 1 表示播放；其他位为 0。

#include <stdint.h>
#include <stdio.h>

struct Status {
    unsigned int connected : 1;
    unsigned int playing   : 1;
};

int main(void)
{
    struct Status s = {0};
    s.connected = 1;
    s.playing = 0;

    uint8_t tx = 0;
    if (s.connected)
        tx |= (uint8_t)(1u << 0);
    if (s.playing)
        tx |= (uint8_t)(1u << 1);

    printf("0x%02X\n", (unsigned)tx);
    return 0;
}

输出：0x01。

本地位域逻辑值                  BLE 协议字节
connected = 1  ── 设置 bit0 ──┐
playing   = 0  ── bit1 保持0 ─┴──→ 0000 0001 = 0x01

此处读取的是位域成员的逻辑值，然后按协议显式生成字节，因此不依赖位域在内存中的实际位置。

五、速记

  1. : 1 表示 1 bit 宽度，不是赋值 1。
  2. 位域源码成员顺序 不等于 跨平台协议 bit 顺序。
  3. packed 不负责统一 位域分配顺序。
  4. 本地状态可以使用位域；对外报文按协议用位掩码和移位编码。

一句话：位域管本地逻辑，掩码管协议格式。