Gatt核心组件解析Service、Characteristic与Descriptor实战【免费下载链接】gattGatt is a Go package for building Bluetooth Low Energy peripherals项目地址: https://gitcode.com/gh_mirrors/ga/gattGatt是一个用于构建蓝牙低功耗BLE外设的Go语言包它提供了完整的GATT协议实现让开发者能够轻松创建自定义BLE服务。本文将深入解析Gatt中的三大核心组件——Service服务、Characteristic特征和Descriptor描述符帮助新手快速掌握BLE应用开发的基础知识。一、GATT核心组件概览在BLE通信中GATT通用属性配置文件定义了设备间数据交换的结构和规则。Gatt包通过清晰的对象模型实现了这些规范主要包含三个核心组件Service服务一组相关特征的集合用于实现特定功能Characteristic特征实际存储数据的单元是GATT通信的基本数据单元Descriptor描述符提供特征的额外信息和配置选项这三个组件形成了一个层次结构一个设备可以包含多个服务一个服务可以包含多个特征一个特征可以包含多个描述符。二、Service服务详解2.1 服务的基本结构在Gatt包中Service结构体定义如下type Service struct { uuid UUID chars []*Characteristic h uint16 endh uint16 }uuid服务的唯一标识符用于区分不同类型的服务chars包含的特征列表h/endh句柄范围用于在BLE协议中标识服务2.2 服务的类型与UUIDGatt定义了多种标准服务UUID如电池服务180f、当前时间服务1805等。这些UUID在known_uuid.go文件中定义var knownServices map[string]struct{ Name, Type string }{ 1805: {Name: Current Time Service, Type: org.bluetooth.service.current_time}, 180f: {Name: Battery Service, Type: org.bluetooth.service.battery_service}, // 更多标准服务... }除了标准服务开发者还可以使用自定义UUID创建私有服务。2.3 创建服务的基本方法使用NewService函数可以创建一个新的服务// NewService creates and initialize a new Service using u as its UUID. func NewService(u UUID) *Service { return Service{uuid: u} }创建服务后可以通过AddCharacteristic方法添加特征。三、Characteristic特征详解3.1 特征的基本结构Characteristic结构体定义如下type Characteristic struct { uuid UUID props Property // enabled properties secure Property // security enabled properties svc *Service cccd *Descriptor descs []*Descriptor value []byte }uuid特征的唯一标识符props特征的属性如读、写、通知等secure安全属性控制访问权限svc所属的服务cccd客户端特征配置描述符descs包含的描述符列表value特征的值3.2 特征属性Property特征属性决定了该特征支持的操作类型常见的属性包括Read允许读取特征值Write允许写入特征值Notify允许服务器主动发送通知Indicate允许服务器主动发送指示需要确认这些属性可以组合使用例如一个特征可以同时支持Read和Notify。3.3 标准特征UUIDGatt定义了多种标准特征UUID如服务更改特征2a05var knownCharacteristics map[string]struct{ Name, Type string }{ 2a05: {Name: Service Changed, Type: org.bluetooth.characteristic.gatt.service_changed}, // 更多标准特征... }四、Descriptor描述符详解4.1 描述符的基本结构Descriptor结构体定义如下type Descriptor struct { uuid UUID char *Characteristic props Property // enabled properties secure Property // security enabled properties h uint16 value []byte rhandler ReadHandler }uuid描述符的唯一标识符char所属的特征props描述符的属性secure安全属性h句柄value描述符的值rhandler读取处理函数4.2 常见描述符类型Gatt定义了多种标准描述符如var knownDescriptors map[string]struct{ Name, Type string }{ 2900: {Name: Characteristic Extended Properties, Type: org.bluetooth.descriptor.gatt.characteristic_extended_properties}, 2901: {Name: Characteristic User Description, Type: org.bluetooth.descriptor.gatt.characteristic_user_description}, 2902: {Name: Client Characteristic Configuration, Type: org.bluetooth.descriptor.gatt.client_characteristic_configuration}, // 更多标准描述符... }其中Client Characteristic Configuration (2902)是最常用的描述符之一用于配置客户端是否接收来自服务器的通知或指示。五、实战应用构建一个简单的BLE服务5.1 创建服务和特征以下是创建一个简单BLE服务的基本步骤创建一个服务创建特征并设置属性将特征添加到服务中将服务添加到GATT服务器示例代码框架来自examples/service/// 创建电池服务 batteryService : NewService(UUID16(0x180f)) // 创建电池电量特征 batteryLevelChar : NewCharacteristic(UUID16(0x2a19)) batteryLevelChar.Props PropertyRead | PropertyNotify // 添加特征到服务 batteryService.AddCharacteristic(batteryLevelChar) // 将服务添加到服务器 server.AddService(batteryService)5.2 处理特征读写通过设置处理函数可以响应客户端的读写请求// 设置读处理函数 batteryLevelChar.ReadHandler func(req Request, rsp ResponseWriter) { // 获取当前电池电量 level : getBatteryLevel() rsp.Write([]byte{level}) } // 设置写处理函数 someChar.WriteHandler func(req Request, rsp ResponseWriter) { data : req.Data() // 处理写入的数据 processData(data) }5.3 发送通知当特征值变化时可以主动向客户端发送通知// 更新特征值 batteryLevelChar.SetValue([]byte{newLevel}) // 发送通知 server.Notify(batteryLevelChar)六、总结与最佳实践Gatt的Service、Characteristic和Descriptor组件构成了BLE应用开发的基础。理解这些组件的工作原理和使用方法是构建功能丰富的BLE外设的关键。开发建议合理规划服务结构将相关功能组织到同一个服务中保持清晰的层次结构优化特征设计根据数据更新频率和大小选择合适的特征属性正确使用描述符利用标准描述符提供额外信息简化客户端实现注重安全性为敏感数据设置适当的安全属性通过examples/目录中的示例代码你可以快速上手Gatt的使用。无论是创建简单的传感器服务还是复杂的交互应用Gatt都提供了灵活而强大的API来满足你的需求。【免费下载链接】gattGatt is a Go package for building Bluetooth Low Energy peripherals项目地址: https://gitcode.com/gh_mirrors/ga/gatt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Gatt核心组件解析：Service、Characteristic与Descriptor实战
发布时间：2026/6/24 13:06:56
Gatt核心组件解析Service、Characteristic与Descriptor实战【免费下载链接】gattGatt is a Go package for building Bluetooth Low Energy peripherals项目地址: https://gitcode.com/gh_mirrors/ga/gattGatt是一个用于构建蓝牙低功耗BLE外设的Go语言包它提供了完整的GATT协议实现让开发者能够轻松创建自定义BLE服务。本文将深入解析Gatt中的三大核心组件——Service服务、Characteristic特征和Descriptor描述符帮助新手快速掌握BLE应用开发的基础知识。一、GATT核心组件概览在BLE通信中GATT通用属性配置文件定义了设备间数据交换的结构和规则。Gatt包通过清晰的对象模型实现了这些规范主要包含三个核心组件Service服务一组相关特征的集合用于实现特定功能Characteristic特征实际存储数据的单元是GATT通信的基本数据单元Descriptor描述符提供特征的额外信息和配置选项这三个组件形成了一个层次结构一个设备可以包含多个服务一个服务可以包含多个特征一个特征可以包含多个描述符。二、Service服务详解2.1 服务的基本结构在Gatt包中Service结构体定义如下type Service struct { uuid UUID chars []*Characteristic h uint16 endh uint16 }uuid服务的唯一标识符用于区分不同类型的服务chars包含的特征列表h/endh句柄范围用于在BLE协议中标识服务2.2 服务的类型与UUIDGatt定义了多种标准服务UUID如电池服务180f、当前时间服务1805等。这些UUID在known_uuid.go文件中定义var knownServices map[string]struct{ Name, Type string }{ 1805: {Name: Current Time Service, Type: org.bluetooth.service.current_time}, 180f: {Name: Battery Service, Type: org.bluetooth.service.battery_service}, // 更多标准服务... }除了标准服务开发者还可以使用自定义UUID创建私有服务。2.3 创建服务的基本方法使用NewService函数可以创建一个新的服务// NewService creates and initialize a new Service using u as its UUID. func NewService(u UUID) *Service { return Service{uuid: u} }创建服务后可以通过AddCharacteristic方法添加特征。三、Characteristic特征详解3.1 特征的基本结构Characteristic结构体定义如下type Characteristic struct { uuid UUID props Property // enabled properties secure Property // security enabled properties svc *Service cccd *Descriptor descs []*Descriptor value []byte }uuid特征的唯一标识符props特征的属性如读、写、通知等secure安全属性控制访问权限svc所属的服务cccd客户端特征配置描述符descs包含的描述符列表value特征的值3.2 特征属性Property特征属性决定了该特征支持的操作类型常见的属性包括Read允许读取特征值Write允许写入特征值Notify允许服务器主动发送通知Indicate允许服务器主动发送指示需要确认这些属性可以组合使用例如一个特征可以同时支持Read和Notify。3.3 标准特征UUIDGatt定义了多种标准特征UUID如服务更改特征2a05var knownCharacteristics map[string]struct{ Name, Type string }{ 2a05: {Name: Service Changed, Type: org.bluetooth.characteristic.gatt.service_changed}, // 更多标准特征... }四、Descriptor描述符详解4.1 描述符的基本结构Descriptor结构体定义如下type Descriptor struct { uuid UUID char *Characteristic props Property // enabled properties secure Property // security enabled properties h uint16 value []byte rhandler ReadHandler }uuid描述符的唯一标识符char所属的特征props描述符的属性secure安全属性h句柄value描述符的值rhandler读取处理函数4.2 常见描述符类型Gatt定义了多种标准描述符如var knownDescriptors map[string]struct{ Name, Type string }{ 2900: {Name: Characteristic Extended Properties, Type: org.bluetooth.descriptor.gatt.characteristic_extended_properties}, 2901: {Name: Characteristic User Description, Type: org.bluetooth.descriptor.gatt.characteristic_user_description}, 2902: {Name: Client Characteristic Configuration, Type: org.bluetooth.descriptor.gatt.client_characteristic_configuration}, // 更多标准描述符... }其中Client Characteristic Configuration (2902)是最常用的描述符之一用于配置客户端是否接收来自服务器的通知或指示。五、实战应用构建一个简单的BLE服务5.1 创建服务和特征以下是创建一个简单BLE服务的基本步骤创建一个服务创建特征并设置属性将特征添加到服务中将服务添加到GATT服务器示例代码框架来自examples/service/// 创建电池服务 batteryService : NewService(UUID16(0x180f)) // 创建电池电量特征 batteryLevelChar : NewCharacteristic(UUID16(0x2a19)) batteryLevelChar.Props PropertyRead | PropertyNotify // 添加特征到服务 batteryService.AddCharacteristic(batteryLevelChar) // 将服务添加到服务器 server.AddService(batteryService)5.2 处理特征读写通过设置处理函数可以响应客户端的读写请求// 设置读处理函数 batteryLevelChar.ReadHandler func(req Request, rsp ResponseWriter) { // 获取当前电池电量 level : getBatteryLevel() rsp.Write([]byte{level}) } // 设置写处理函数 someChar.WriteHandler func(req Request, rsp ResponseWriter) { data : req.Data() // 处理写入的数据 processData(data) }5.3 发送通知当特征值变化时可以主动向客户端发送通知// 更新特征值 batteryLevelChar.SetValue([]byte{newLevel}) // 发送通知 server.Notify(batteryLevelChar)六、总结与最佳实践Gatt的Service、Characteristic和Descriptor组件构成了BLE应用开发的基础。理解这些组件的工作原理和使用方法是构建功能丰富的BLE外设的关键。开发建议合理规划服务结构将相关功能组织到同一个服务中保持清晰的层次结构优化特征设计根据数据更新频率和大小选择合适的特征属性正确使用描述符利用标准描述符提供额外信息简化客户端实现注重安全性为敏感数据设置适当的安全属性通过examples/目录中的示例代码你可以快速上手Gatt的使用。无论是创建简单的传感器服务还是复杂的交互应用Gatt都提供了灵活而强大的API来满足你的需求。【免费下载链接】gattGatt is a Go package for building Bluetooth Low Energy peripherals项目地址: https://gitcode.com/gh_mirrors/ga/gatt创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
