android-ble-gatt-status
Installation
SKILL.md
Android BLE GATT Status Diagnosis
Step 1: Frame the failure without naming a cause
- DEFINE initial direct-connect failure | auto-connect stall | disconnect after connection | service-discovery failure | operation status failure | timeout | stale callback | retry storm | OEM-only issue | persistent system-wide failure.
- CAPTURE exact callback/API stage, decimal/hex status,
newState, submission result, attempt ID, connection epoch, elapsed time, Android/API/OEM/device/peripheral firmware matrix, app/process state, adapter/permission/bond state, scan observation freshness/connectability/RSSI, and reproduction rate. - TREAT
status == 133(0x85) as a legacy raw/opaque status. Current public API 37/37.1 has noGATT_ERRORor 133 constant; do not infer RF, cache, resource leak, or stack corruption from that number alone. - EVALUATE callback
statusbefore acceptingnewState. OnlyGATT_SUCCESSplusSTATE_CONNECTEDestablishes a usable connection. - READ
references/status-semantics.mdand exact currentBluetoothGatt/BluetoothGattCallbacksymbols before classifying a status. - READ
references/article-audit.mdbefore copying the supplied retry, close, delay, address, auto-connect, or adapter-reset examples. - ROUTE ADB executable/device selection/shell/logcat/dumpsys/bugreport mechanics to
android-debug-bridge, ordinary BLE lifecycle changes toandroid-ble, client operation serialization toandroid-ble-gatt-queue, local server failures toandroid-ble-gatt-server, and inspector UI toandroid-ble-inspector.
Completion: the failure is an observed stage/status/state/timeline/matrix, not “status 133 means X.”