在LE Audio的多设备协同体系中Coordinated Set Identification ServiceCSIS是实现设备集群识别、协同操作的核心协议而CSIS的服务特征则是整个协议的实体核心——它定义了协调集的唯一身份标识、成员规模、设备排序规则、人性化名称还设计了独占访问的锁机制让多设备的协同识别有统一的标准也让多客户端访问协调集时的竞争问题得到解决。目录一、CSIS服务特征的整体概览分层设计按需实现二、核心必选特征Set Identity Resolving Key协调集的唯一公章2.1 特征格式TypeValue的标准化结构2.2 特征行为只读可通知严格的暴露规则2.3 与安全工具箱的联动SIRK是安全操作的核心三、基础可选特征Coordinated Set Size Coordinated Set Name协调集的基础信息卡3.1 Coordinated Set Size协调集的人数标识3.2 Coordinated Set Name协调集的人性化标签四、核心管控特征Set Member Lock协调集的独占访问门禁4.1 特征格式单字节的二元状态无冗余设计4.2 基础行为规范全客户端状态一致可通知可持久化4.3 核心流程锁的请求与释放标准化的交互规则4.4 与GATT子过程的联动支持锁则必选GATT操作五、条件必选特征Set Member Rank协调集的成员编号5.1 特征格式单字节的连续唯一值与集规模联动5.2 特征行为纯只读无通知永久不可变六、CSIS服务特征的核心设计原则与工程实现要点6.1 核心设计原则6.2 工程实现关键要点七、CSIS服务特征与协议其他模块的联动形成完整的协调集识别体系八、测试如果把一个CSIS协调集比作一个标准化的团队那么CSIS的服务特征就是这个团队的团队档案管理规则Set Identity Resolving Key是团队的唯一公章Coordinated Set Size是团队的人数Set Member Rank是团队成员的编号Coordinated Set Name是团队的名字而Set Member Lock则是团队的会议室门禁确保同一时间只有一个人能操作会议室的设备。这些特征各司其职、相互配合既让外部能快速识别这个团队也让团队内部的管理和外部的访问更有序。这篇内容会从CSIS服务特征的整体设计逻辑出发逐一拆解每个特征的定义、格式、行为规范和工程实现要点结合协议的硬性要求和实际应用场景做深度解析同时梳理特征之间的关联、特征与CSIS其他模块的联动关系让大家吃透CSIS协调集的核心实体设计理解其在LE Audio多设备协同中的实际价值。一、CSIS服务特征的整体概览分层设计按需实现CSIS共定义了五个核心服务特征协议对每个特征的实现要求做了明确划分必选M、可选O、条件必选C.n同时统一规定了所有特征的安全权限——均要求加密访问避免协调集的核心信息被第三方窃取。此外每个特征都定义了强制属性和可选属性核心以只读为主仅Set Member Lock支持写操作这一设计是为了保证协调集信息的稳定性防止非授权设备篡改。下表是CSIS五个服务特征的核心属性总览也是协议对特征实现的基础要求所有厂商的设备实现都需遵循此规范特征名称实现要求强制属性可选属性安全权限核心作用Set Identity Resolving Key必选M读通知加密要求协调集唯一身份密钥生成RSI的核心Coordinated Set Size可选O读通知加密要求标识协调集的设备数量Set Member Lock可选O读、写、通知无加密要求协调集独占访问锁解决多客户端竞争Set Member Rank条件必选C.1读无加密要求协调集成员唯一排序号规范操作顺序Coordinated Set Name可选O读通知加密要求协调集人性化名称与广播数据联动C.1条件说明该特征为必选当且仅当设备实现了Set Member Lock特征否则为可选。这一设计是因为成员排序号仅在需要独占访问并按顺序操作设备时才有意义比如双耳耳机、多扬声器集群而简单的传感器协调集可省略此特征兼顾协议的通用性和轻量化。协议还规定所有未被列为强制或可选的属性均为排除X即设备不得为这些特征实现额外的未定义属性保证不同厂商设备的互通性。同时所有特征的字节传输均遵循小端序LSO在前与CSIS整体的字节传输规则保持一致这是工程实现中必须遵守的基础规范否则会导致数据解析失败。所有特征的核心属性以读为主的设计逻辑协调集的核心信息身份、规模、排序、名称一般在设备生产阶段配置完成后续仅能通过带外OOB流程更新不支持普通客户端的写操作从源头保证协调集信息的唯一性和稳定性而Set Member Lock的写操作则是为了让合法客户端获取独占访问权是协议设计的唯一动态操作入口。二、核心必选特征Set Identity Resolving Key协调集的唯一公章Set Identity Resolving Key以下简称SIRK是CSIS唯一的必选特征也是整个协调集识别的核心——协议明确规定All servers that are part of the same Coordinated Set shall use the same SIRK即同一协调集的所有设备必须共享同一个SIRK它是协调集的数字唯一标识也是后续生成和解析可解析集标识符RSI的核心密钥没有SIRK客户端就无法识别设备是否属于某一协调集。2.1 特征格式TypeValue的标准化结构SIRK特征的数值格式为固定的17字节由1字节的Type字段和16字节的Value字段组成协议对两个字段的定义做了严格规定如下表所示字段名称字节数字段含义取值规则Type1SIRK暴露类型0x00加密SIRK0x01明文SIRKValue16SIRK实际值128位随机数符合蓝牙核心规范的随机数生成要求协议要求SIRK必须是128位的随机数且生成方法需满足蓝牙核心规范Volume 2, Part H, Section 2的随机数生成标准这一要求是为了保证每个协调集的SIRK具有全球唯一性避免不同协调集的设备被误识别。16字节的Value字段正是对128位随机数的存储是SIRK的核心数据。Type字段的设计则是为了标识SIRK的暴露方式协议为SIRK定义了三种暴露方式加密、明文、带外OOB其中Type字段仅对应加密和明文两种方式OOB方式无对应的Type值且设备若仅支持OOB方式暴露SIRK需拒绝客户端的SIRK读取请求。2.2 特征行为只读可通知严格的暴露规则SIRK的核心属性为只读客户端仅能读取SIRK无法通过GATT写操作修改SIRK的更新仅能通过OOB流程完成这一设计保证了协调集身份标识的稳定性。同时SIRK支持通知Notify可选属性通知的触发条件与SIRK的更新场景强绑定协议定义了两种核心通知场景设备处于连接状态时被配置了新的SIRK若客户端已开启SIRK的通知配置服务器需立即向客户端推送新的SIRK值设备处于断连状态时被配置了新的SIRK若客户端已开启SIRK的通知配置服务器需在客户端重新绑定连接后立即推送新的SIRK值。而SIRK的暴露规则是该特征的核心行为规范协议做了三点硬性要求也是工程实现的重点加密与明文互斥若设备以加密方式暴露SIRKType0x00则禁止同时以明文方式暴露即同一设备不能同时存在Type0x00和Type0x01的SIRK值防止核心密钥泄露OOB方式的错误处理若设备仅支持通过OOB流程暴露SIRK当客户端发起GATT读SIRK请求时服务器需返回ATT错误响应错误码为OOB SIRK Only0x83拒绝客户端的读取请求加密值的计算规则若设备以加密方式暴露SIRKValue字段的数值必须是通过CSIS安全工具箱的sef加密函数计算得到的加密SIRK且加密密钥需根据传输层类型适配LE传输为LTKBR/EDR传输为Link Key。SIRK的通知属性实现也有一个细节若设备未开启通知属性则SIRK值永久不可变若开启通知属性则SIRK值仅能通过OOB流程更新且更新后需按规则触发通知这一设计让SIRK的更新既可控又可感知。2.3 与安全工具箱的联动SIRK是安全操作的核心SIRK作为必选特征是CSIS安全工具箱所有操作的核心输入安全工具箱的sef/sdf加解密函数围绕SIRK展开保证SIRK的传输安全sih哈希函数、RSI生成/解析操作均以SIRK为密钥实现协调集设备的动态身份标识和抗追踪。可以说SIRK是CSIS协议的核心枢纽连接了服务特征和安全工具箱也是协调集识别的唯一依据。三、基础可选特征Coordinated Set Size Coordinated Set Name协调集的基础信息卡Coordinated Set Size和Coordinated Set Name是CSIS的两个基础可选特征分别对应协调集的成员数量和人性化名称属于协调集的基础描述信息。两个特征均为只读可通知设计目的是为了让客户端更全面地识别协调集同时适配消费级设备的人性化需求比如真无线耳机的“我的耳机”、智能家居扬声器的“客厅音响组”等。3.1 Coordinated Set Size协调集的人数标识Coordinated Set Size特征用于标识组成协调集的设备数量其格式为1字节的uint8类型协议对取值做了明确限制允许取值0x01~0xFF0x00为禁止值Prohibited。0x00被禁止的原因是协调集的定义为一组设备最少包含1台设备无设备的协调集无实际意义。1字节的uint8类型决定了协调集的最大设备数量为255台这一数值足以覆盖目前所有的蓝牙多设备协同场景从双耳耳机、双扬声器的小型集群到传感器网络、大型音响系统的中型集群都能满足需求。该特征的行为规范与SIRK类似核心为只读可通知数值的更新仅能通过OOB流程完成通知的触发条件为连接状态下数值变化且客户端开启通知配置服务器立即推送新值断连状态下数值变化且客户端开启通知配置服务器在重连后推送新值。Coordinated Set Size的实际价值在于让客户端知晓协调集的完整规模避免漏连设备。比如一个由5台扬声器组成的协调集客户端读取该特征后得知数量为5即可在扫描时确认是否找到所有设备保证协同操作的完整性。3.2 Coordinated Set Name协调集的人性化标签Coordinated Set Name是CSIS在v1.1版本新增的特征用于为协调集设置人性化的UTF-8名称适配消费级蓝牙设备的用户体验需求。该特征的数值为0~128字节的UTF-8字符串0字节表示协调集未设置名称128字节是蓝牙ATT层的传输限制保证名称的传输效率。该特征的行为规范有三个核心要点也是与其他特征的不同之处是工程实现的重点与广播Service Data的名称一致性协议要求该特征的名称值必须与设备广播的Service Data中的Coordinated Set Name字符串完全一致这一要求保证了客户端在扫描阶段广播和连接阶段GATT读获取的协调集名称一致避免信息混乱通知的MTU限制若名称的字节数超过ATT_MTU-3则服务器在推送通知时仅能将前ATT_MTU-3个字节包含在通知包中剩余字节需客户端通过GATT读操作获取这一设计适配蓝牙ATT层的MTU限制防止通知包过大导致传输失败长读取的错误处理若客户端正在通过Read Long Characteristic Values子过程读取该特征且特征值在读取过程中发生变化服务器需返回ATT错误响应错误码为Value Changed During Read Long0x85避免客户端读取到不完整的名称值。该特征的通知触发条件与其他特征一致但数值更新后除了触发GATT通知设备还需同步更新广播的Service Data中的名称值保证全链路的名称一致性。四、核心管控特征Set Member Lock协调集的独占访问门禁Set Member Lock是CSIS的核心管控特征也是唯一支持写操作的特征协议设计该特征的目的是minimize race conditions when multiple clients access the Coordinated Set at the same time即解决多客户端同时访问同一协调集时的竞争问题让合法客户端能获取协调集的独占访问权比如多手机同时连接同一副耳机时仅能有一个手机对耳机进行音量、模式的调节。如果说SIRK是协调集的身份证那么Set Member Lock就是协调集的门禁锁只有拿到钥匙的客户端才能进入协调集进行操作这一特征也是LE Audio多设备协同中操作一致性的关键保障。4.1 特征格式单字节的二元状态无冗余设计Set Member Lock的特征格式为1字节的uint8类型协议采用极简的二元状态设计仅定义两个合法值其余所有值均为保留未来使用RFU如下表所示数值状态含义0x01Unlocked解锁状态所有合法客户端均可访问协调集0x02Locked锁定状态仅持有锁的客户端可独占访问协调集其他RFU保留值客户端写入时服务器需返回错误二元状态的设计让锁的管理更简单避免复杂的状态流转导致的实现问题。协议规定若客户端尝试向该特征写入RFU值服务器需立即返回ATT错误响应错误码为Invalid Lock Value0x82并拒绝该写操作。4.2 基础行为规范全客户端状态一致可通知可持久化Set Member Lock的核心属性为读、写、通知无可选属性其基础行为规范有三个核心点是锁机制的基础状态全局一致性协议要求服务器向所有客户端暴露相同的锁值即无论有多少个客户端连接协调集看到的锁状态都是一致的不存在客户端A看到锁定客户端B看到解锁的情况保证锁的权威性通知的触发规则锁状态发生变化时若客户端已开启通知配置服务器需向客户端推送新的锁状态但排除客户端自身修改锁状态的场景——即客户端自己将锁从解锁改为锁定服务器无需向该客户端推送通知避免无意义的消息传输绑定状态下的持久化若客户端与服务器为绑定bonded状态锁状态在lock_timeout超时时间内具有跨连接持久性即客户端断连后重连只要未超时锁状态仍保持为锁定且该客户端仍为锁的持有者若为非绑定状态客户端断连后服务器需立即将锁置为解锁状态。这三个基础规范保证了锁机制的一致性、可感知性和安全性避免锁状态混乱或被非法占用。4.3 核心流程锁的请求与释放标准化的交互规则Set Member Lock的核心是锁的请求Lock Request和释放Lock Release流程协议对这两个流程做了极其详细的标准化定义所有设备的实现都需严格遵循否则会导致多客户端的锁竞争处理混乱。协议还为锁流程定义了专属的错误码用于处理各种异常场景保证交互的规范性。4.3.1 锁的请求流程谁先申请谁先持有锁的请求即客户端将锁状态从Unlocked0x01写入为Locked0x02的过程协议定义了三种场景的处理逻辑及对应的响应方式锁为解锁状态服务器接受写操作将锁置为锁定向客户端返回Write Response写成功并启动lock_timeout定时器此时该客户端成为锁的持有者锁为锁定状态且持有者为当前客户端服务器拒绝写操作返回ATT错误响应错误码为Lock Already Granted0x84且不重置lock_timeout定时器锁为锁定状态且持有者为其他客户端服务器拒绝写操作返回ATT错误响应错误码为Lock Denied0x80且不重置lock_timeout定时器。lock_timeout是锁请求流程的关键参数协议建议该值为60秒也可由高层协议自定义。定时器的作用是防止锁被永久占用若持有者客户端在锁定后未主动释放锁定时器超时后服务器会自动将锁置为解锁状态让其他客户端可以申请。协议也明确了定时器的设计原则值过短会导致客户端操作未完成即超时值过长会导致其他客户端长时间无法访问60秒是兼顾操作效率和访问公平性的最优值。4.3.2 锁的释放流程仅持有者可释放支持主动释放锁的释放即客户端将锁状态从Locked0x02写入为Unlocked0x01的过程协议同样定义了三种场景的处理逻辑锁为锁定状态且持有者为当前客户端服务器接受写操作将锁置为解锁向客户端返回Write Response并停止lock_timeout定时器锁为锁定状态且持有者为其他客户端服务器拒绝写操作返回ATT错误响应错误码为Lock Release Not Allowed0x81锁已为解锁状态服务器接受写操作向客户端返回Write Response无其他操作。这一流程的核心原则是仅锁的持有者可释放锁避免其他客户端非法释放锁保证持有者操作的完整性。而锁已为解锁状态时接受写操作的设计是为了兼容客户端的幂等操作避免客户端重复释放锁时收到错误响应导致程序异常。4.4 与GATT子过程的联动支持锁则必选GATT操作Set Member Lock的实现还与CSIS的GATT子过程要求强绑定协议规定若设备实现了Set Member Lock特征则Write Characteristic Value、Notifications、Read Characteristic Descriptors、Write Characteristic Descriptors这四个GATT子过程为必选实现否则为可选。这一要求是因为锁的操作读、写、通知完全依赖这些GATT子过程没有这些子过程锁机制就无法实现。五、条件必选特征Set Member Rank协调集的成员编号Set Member Rank是CSIS的条件必选特征协议定义其实现要求为C.1Mandatory if Set Member Lock is supported, otherwise Optional即仅当设备实现了Set Member Lock特征时该特征才为必选否则为可选。这一设计的逻辑是成员编号仅在客户端获取独占访问权后按固定顺序操作协调集设备时才有意义无独占访问需求的协调集无需为设备分配编号。5.1 特征格式单字节的连续唯一值与集规模联动Set Member Rank的特征格式为1字节的uint8类型协议对取值做了两个核心硬性要求这两个要求与Coordinated Set Size特征的数值强联动也是该特征的核心设计原则取值起始规则数值从0x01开始为正整数无0值和负数唯一且连续规则同一协调集内的所有设备该特征的数值必须唯一且形成连续的整数序列序列的最大值等于Coordinated Set Size特征的数值。比如一个由3台设备组成的协调集Coordinated Set Size值为0x03则三台设备的Set Member Rank值必须分别为0x01、0x02、0x03不能出现0x01、0x03的不连续情况也不能出现两台设备同为0x02的重复情况。这一设计的目的是为了让客户端能按固定的数字顺序操作协调集设备比如双耳耳机中Rank0x01为左耳机Rank0x02为右耳机客户端获取锁后按1→2的顺序完成配对、音量调节等操作保证操作的一致性多扬声器集群中按Rank顺序完成声道分配保证空间音频的效果。5.2 特征行为纯只读无通知永久不可变Set Member Rank是CSIS唯一纯只读且无通知属性的特征协议规定该特征无可选属性仅支持读操作且不支持通知数值也永久不可变——既不能通过GATT写操作修改也不能通过OOB流程更新。这一设计的原因是成员编号是协调集设备的物理属性一般在设备生产阶段与SIRK、Coordinated Set Size一起配置完成与设备的硬件功能强绑定比如左耳机、右耳机的编号不会随使用场景变化无需更新同时编号的唯一性和连续性是协调集操作的基础若允许更新可能导致编号混乱影响客户端的顺序操作。纯只读无通知的设计也让该特征的实现极度轻量化无需处理通知配置、数值更新等逻辑仅需在设备启动时加载配置的编号值供客户端读取即可。六、CSIS服务特征的核心设计原则与工程实现要点梳理完五个服务特征的细节我们能总结出CSIS服务特征的五大核心设计原则这些原则贯穿了整个特征的设计过程也是蓝牙SIG制定该协议的底层逻辑同时结合协议的硬性要求也能提炼出工程实现中的关键要点帮助开发者规避常见的坑保证设备的兼容性和规范性。6.1 核心设计原则最小必选原则仅将SIRK设为必选特征其余特征均为可选或条件必选让协议能适配不同的应用场景——简单的传感器协调集可仅实现SIRK轻量化消费级的音频设备可实现所有特征提升用户体验。安全优先原则所有特征的安全权限均要求加密访问且核心身份信息SIRK支持加密暴露防止协调集的核心信息被第三方窃取保证蓝牙设备的隐私和安全。状态一致性原则Lock特征的全局状态一致、Rank特征的唯一连续保证了协调集信息的标准化让不同厂商的设备能互通避免因信息不一致导致的协同失败。动态与静态分离原则将协调集的静态信息SIRK、Size、Rank、Name设为只读仅将动态的访问控制Lock设为可写既保证了核心信息的稳定性又让协调集的访问管理更灵活。版本兼容与扩展原则v1.1版本新增Coordinated Set Name特征且为可选保证了与v1.0/v1.0.1版本的兼容同时预留RFU值为后续版本的特征扩展留下空间。6.2 工程实现关键要点严格遵循字节序规则所有特征的字节传输均为小端序LSO在前与CSIS整体的字节传输规则保持一致尤其是SIRK的16字节Value字段字节序错误会导致SIRK加解密、RSI生成解析失败。完善的错误码处理协议为特征操作定义了6个专属应用错误码实现时需严格按场景返回对应的错误码不能自定义错误码保证与其他设备的交互规范性。Lock特征的超时机制实现lock_timeout建议设为60秒需实现定时器的启动、停止、超时重置逻辑同时区分绑定/非绑定客户端的断连处理避免锁被非法占用。名称的全链路一致性Coordinated Set Name特征的数值需与广播Service Data中的名称完全一致且更新时需同步更新广播数据保证客户端扫描和连接阶段的信息一致。条件必选的依赖实现实现Set Member Lock特征时必须同时实现Set Member Rank特征且Rank值需与Coordinated Set Size值联动保证唯一连续。通知的触发规则精准实现各特征的通知触发条件不同尤其是Coordinated Set Name的MTU限制和长读取错误处理需严格按协议实现避免通知包过大或读取到不完整数据。七、CSIS服务特征与协议其他模块的联动形成完整的协调集识别体系CSIS的服务特征并非孤立的模块而是与安全工具箱、广播数据类型等模块深度联动形成了一个完整的协调集识别与操作体系各模块相互配合最终实现LE Audio的多设备协同与安全工具箱的联动SIRK是安全工具箱所有操作的核心sef/sdf保证SIRK的传输安全sih/RSI生成解析基于SIRK实现协调集的动态身份标识与广播数据类型的联动Coordinated Set Name与广播的Service Data名称一致RSI的广播基于SIRK生成客户端在扫描阶段即可通过广播数据初步识别协调集与GATT子过程的联动Set Member Lock的实现依赖特定的GATT子过程协议根据Lock的实现状态定义GATT子过程的必选/可选保证锁机制的可实现性与错误码体系的联动协议为特征操作定义了专属的应用错误码这些错误码与GATT/ATT的基础错误码结合形成了CSIS完整的错误处理体系。这种全模块的联动设计让CSIS协议成为一个高度耦合、逻辑自洽的整体而非零散的功能集合也保证了协议在实际应用中的可实现性和兼容性。八、测试题目CSIS中Set Member Rank的实现要求是什么为何将其设计为条件必选答案Set Member Rank的实现要求①格式为1字节uint8取值从0x01开始的正整数②同一协调集内值唯一且连续最大值等于Coordinated Set Size的数值③纯只读无通知属性数值永久不可变条件必选的设计原因该特征的作用是为客户端提供协调集设备的固定操作顺序仅在设备实现Set Member Lock独占访问时才有实际意义——客户端获取独占访问权后按Rank顺序操作设备保证一致性无独占访问需求的协调集无需排序故设为条件必选兼顾协议的通用性和轻量化。题目CSIS中Set Member Lock的锁请求流程有哪几种场景分别如何处理答案锁请求是客户端将锁从解锁置为锁定的过程共三种场景处理逻辑如下锁为解锁状态服务器接受写操作置为锁定返回Write Response启动lock_timeout定时器锁为锁定且持有者为当前客户端返回错误码Lock Already Granted0x84不重置定时器锁为锁定且持有者为其他客户端返回错误码Lock Denied0x80不重置定时器。协议建议lock_timeout为60秒超时后服务器自动将锁置为解锁防止锁被永久占用。题目CSIS中SIRK作为唯一必选特征其暴露规则和格式分别是什么答案SIRK的格式17字节由1字节Type字段和16字节Value字段组成Type字段取值0x00加密SIRK、0x01明文SIRKValue字段为128位随机数SIRK的暴露规则①加密与明文方式互斥不可同时暴露②仅支持OOB方式时拒绝GATT读请求并返回错误码OOB SIRK Only0x83③加密方式的Value值需通过sef函数计算加密密钥适配传输层LE为LTKBR/EDR为Link Key④SIRK为只读仅能通过OOB流程更新。