Ble gatt integration
Reusable Agent Skills for embedded systems, MCU debugging, firmware workflows, and AI automation. （嵌入式、MCU 调试、固件流程与 AI 自动化的可复用 Agent Skills 集合）。
npx -y skills add easyzoom/aix-skills --skill ble-gatt-integrationAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 22 stars22 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Use when integrating, designing, or debugging BLE GATT services, characteristics, descriptors, MTU, notifications, indications, pairing, connection parameters, or throughput
SKILL.md
3.2 KB, as published. Nobody here has run it
BLE GATT Integration
Overview
Use this skill to debug BLE GATT by separating advertising, connection, discovery, attributes, permissions, MTU, security, and data flow. GATT failures are often permission or state-machine mismatches, not radio failures.
When To Use
Use this skill when:
- The user is creating or debugging BLE services, characteristics, descriptors, notifications, indications, reads, writes, or subscriptions.
- The issue involves missing services, write failures, CCCD problems, MTU, data truncation, pairing, bonding, connection parameters, or low throughput.
- The stack is Zephyr, ESP-IDF, nRF Connect SDK, NimBLE, BlueZ, Android, iOS, or a vendor BLE SDK.
Do not use this skill when the device cannot advertise or connect at all. Start with platform-specific radio and controller bring-up first.
First Questions
Ask for:
- BLE stack, device role, central/client app, peripheral firmware, and logs.
- Advertising data, connection status, service UUIDs, characteristic UUIDs, and properties.
- Attribute permissions, security level, pairing/bonding state, and CCCD state.
- MTU, connection interval, PHY, data length extension, and payload size.
- Sniffer trace or client error if available.
Debug Workflow
-
Prove discovery. Confirm advertising, connection, primary service discovery, and attribute handles using a known BLE client.
-
Check attribute contract. Verify UUIDs, properties, permissions, descriptors, lengths, and endian/unit conventions.
-
Separate reads, writes, and subscriptions. Test read, write-with-response, write-without-response, notify, and indicate one at a time.
-
Validate security. Match permissions to pairing, bonding, encryption, MITM, and key storage.
-
Tune transport parameters. For throughput, check MTU, connection interval, PHY, data length, buffering, and application pacing.
-
Test client diversity. Compare behavior on at least one generic tool and the real Android/iOS/client app.
Common Failures
- Characteristic lacks the property needed by the client operation.
- CCCD is not enabled before notifications are sent.
- Attribute requires encryption but the client is not paired or bonded.
- Payload exceeds negotiated MTU minus ATT overhead.
- Indications are sent before the previous confirmation arrives.
- Android/iOS cached an old GATT table after firmware changed.
Verification
Before claiming BLE GATT works:
- State stack, role, service/characteristic UUIDs, permissions, and MTU.
- Confirm discovery and each required operation with logs or a client trace.
- Confirm security and bonding behavior if protected attributes are used.
- Confirm throughput parameters if performance is part of the requirement.
Example
User:
BLE notify 开了但手机收不到数据。
Agent:
- Checks characteristic properties, CCCD subscription, and connection state.
- Verifies MTU and payload length.
- Uses a generic BLE client before debugging the mobile app.