Embedded Aimed Bluetooth Protocol Stack Knowledge Base

Auto-Generated Index Last Updated: 2026-03-10 14:05:39

Based on Bluetooth Core Specification v6.2 and HOGP v1.1. This knowledge base is governed by the Gemini Agent and utilizes the pdf skill for accurate specification extraction.

---

📚 Knowledge Index

• Components/ : ---
  • 链路层控制协议 (Link Layer Control Protocol - LLCP)
  • 最大传输单元 (Max Transfer Unit - MTU)
  • GATT 通知机制与 CCCD 深度解析
• Profiles/
  • Hid/
    • 嵌入式Hid设备开发——自底向上视角 V0
    • 嵌入式 HID 设备开发——自底向上视角
    • 嵌入式 HID 设备开发——自底向上视角 (v2)
    • 00 Hgop/
      • GAP 视角下的 HOGP：从配对到加密全景解析
      • 从按键到RF PHY：HID Report 全栈数据流解构
      • HID 认知体系构建：从协议定义到内核实现
      • HOGP (HID over GATT Profile) 架构详解
      • HOGP 初始化中的 ATT 报文交换详解
      • HOGP 设备完整初始化流程：从广播到可用
      • HOGP 初始化与配置：ATT 报文全解析
    • 01 Descriptors/
      • HID Report Descriptor 实战指南
      • 标准键盘 HID Usage Map (Page 0x07)
      • 进阶 HID 多媒体与系统键开发指南
      • Map/
        • Consumer Page (0x0C)
        • Generic Desktop Page (0x01)
        • [International Physical Key Naming & HID Mapping](Knowledge_Base/profiles/hid/01_Descriptors/Map/ISO-IEC 9995物理键位命名方案.md)
        • LED Page (0x08)
        • Multimedia & Special Keys Usage Map
        • [Keyboard/Keypad Page (0x07)](Knowledge_Base/profiles/hid/01_Descriptors/Map/Page0x7-standardKey MAP.md)
        • 复杂 KB ISO 符号与 Usage 对应指南
    • 02 App Notes/
      • Hid Kb Long Pressed情景分析
      • HID 多媒体键实现指南
      • 机械键盘全键无冲 (NKRO) 实现指南
    • 03 Kernel Os/
      • Linux Kernel HID Subsystem: 补充阅读与实战指南
  • Le Audio/ : > [!note]
    • Codec/
      • LC3 编解码器概览 (Low Complexity Communication Codec)
      • LC3 技术细节与处理流程
    • Overview/
      • BAP 架构与角色 (Basic Audio Profile)
    • Unicast/
      • BAP 单播音频流控制 (ASE Control Operations)
• Vol1 Architecture/
  • 蓝牙传输架构层级 (Transport Architecture Hierarchy)
• Vol3 Host/ : 蓝牙主机（Host）协议栈位于 HCI 层之上，负责处理逻辑链路、安全、属性管理以及应用程序的通用访问。
  • Att/
    • Attribute Protocol (ATT) 深度解析
  • Gap/
    • GAP Advertising Data Format (广播数据格式)
    • GAP Modes & Procedures (模式与过程)
  • Gatt/
    • GATT Caching & Robustness (缓存与健壮性)
    • GATT 交互操作 (GATT Procedures)
    • GATT MTU Specification
    • GATT 核心概念与角色 (GATT Overview & Roles)
    • GATT Service Discovery (服务发现子过程)
  • L2Cap/
    • L2CAP 核心机制 (General Operation & Channels)
    • L2CAP MTU Specification
    • L2CAP 数据包格式 (Packet Formats)
  • Smp/
    • SMP Key Distribution (密钥分发与管理)
    • SMP Pairing Process (配对与安全连接流程)
• Vol4 Hci/
  • HCI Initialization & Command Flow (初始化与核心流程)
  • HCI Packet Structures (HCI 包结构详解)
  • Commands/
    • HCI Command: Read Local Version Information
    • HCI Command: Reset
    • HCI Command: LE Set Advertising Parameters
  • Hci Raw/
    • HCI Command: Read Local Version
    • HCI Command: Reset
    • HCI Command: LE Set Adv Params
    • HCI Packet Formats (Command, Event, ACL)
    • Transport Raw/
      • Part B USB Transport Layer (H2)
      • Part A UART Transport Layer (H4)
      • Part D Three-wire UART Transport Layer (H5)
      • Part C Secure Digital (SD) Transport Layer
  • Transport/
    • HCI USB Transport Layer (H2)
    • HCI UART Transport Layer (H4)
    • HCI Three-wire UART Transport Layer (H5)
    • HCI 传输层 (Transport Layers) 概览
    • HCI Secure Digital (SD) Transport Layer
• Vol6 Controller/
  • BLE 空口包格式 (Air Interface Packets)
  • BLE 连接建立流程 (Connection Establishment Flow)
  • Isochronous Channels & ISOAL (等时通道详解)
  • BLE Link Layer 状态机 (Link Layer State Machine)
  • LLCP Specification
  • MSC Raw Text Extraction
  • Iso Raw/
    • ISOAL Features (Framed vs Unframed PDU)
    • ISOAL Timing (Time Stamp & Offset)

---

🚀 自动化工作流 (Automation Workflow)

本项目集成了自动化运维脚本，建议通过 do.bat 进行所有日常操作：

• do.bat: 核心自动化入口。依次运行 README 索引更新、JSON 索引生成，并引导完成 Git 提交流程。
  • 用法：do -m "commit message" (自动更新并提交)
  • 用法：do --check (仅更新并预览索引，不提交)

🛠️ 运维工具库 (Operational Tools)

这些脚本位于 .gemini/scripts/，用于维持知识库的结构化与准确性：

• 索引治理:
  • generate_root_index.py: (本脚本) 自动扫描 Knowledge_Base 并重建根目录 README.md 导航树。
  • generate_kb_index.py: 为 Agent 生成结构化的 index.json，提升机器检索效率。

---

📜 License & Copyright

Copyright (c) 2026 yceachan ([email protected])

This project is licensed under the MIT License. See the LICENSE file for details.