원클릭으로 Manus에서 모든 스킬 실행

ble

스타2

포크2

업데이트2026년 3월 1일 15:49

Bluetooth context for the Megahub project. Use when working on BLE GATT server, Classic Bluetooth HID host, Web Bluetooth API integration, btremote library, connection handling, or any Bluetooth-related firmware code.

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

mirkosertic

mirkosertic/Megahub

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

Bluetooth Architecture — Megahub ESP32

The project uses both BLE and Classic Bluetooth simultaneously (BTDM dual-mode).

Type	Purpose	Library
BLE (GATT server)	Web Bluetooth API ↔ firmware	`lib/btremote/`
Classic BT (HID host)	Gamepad/keyboard/mouse input	`lib/btremote/`

BLE GATT Server

Service UUID: 4fafc201-1fb5-459e-8fcc-c5c9c331914b

Characteristic	UUID	Direction	Type
REQUEST	`beb5483e-36e1-4688-b7f5-ea07361b26a8`	Browser → Firmware	Write
RESPONSE	`1c95d5e3-d8f7-413a-bf3d-7a2e5d7be87e`	Firmware → Browser	Notify
EVENT	`d8de624e-140f-4a22-8594-e2216b84a5f2`	Firmware → Browser	Notify
CONTROL	`f78ebbff-c8b7-4107-93de-889a6a06d408`	Firmware → Browser	Indicate

Indications vs Notifications: CONTROL uses indications (require client ACK). RESPONSE/EVENT use notifications.
MTU: Default 23 bytes on connect. Firmware sends MTU_INFO notification immediately after connect, then again after negotiation (up to 517 bytes).
From real device logs: MTU negotiates to 514/517 bytes reliably.

BLE Rules (never violate)

Never block in BLE callbacks — they run in the BLE stack task context
Always check isConnected() before sending notifications/indications
Reconnection: Browser handles reconnect via device.gatt.connect() — firmware must keep advertising
Multiple connections: Each consumes ~30KB heap — the BT stack alone drops free heap from ~140KB to ~75KB
BLE callbacks → post work to a queue, handle in BTMsgProcessor task
Indication failures (status=132) during startup are normal — the client ACK pipeline needs time to stabilize after connect

Classic Bluetooth (HID Host)

Only for HID devices: gamepads, keyboards, mice
Auto-pairing enabled (IO capability: NONE, PIN: "0000")
HID events processed in HIDEventTask (priority 5, separate from BLE stack)
Never block in HID callback — post to queue
Pairing state is persisted in NVS; handle removal gracefully

Startup Sequence

From real device logs, BT init order:

BT controller starts in BTDM dual-mode (esp_bt_controller_enable)
Classic GAP callback registered
Classic scan mode: connectable + discoverable
HID Host initialized → waits for ESP_HIDH_INIT_EVT
Bluedroid BLE init → waits for GATTS registration
GATT service + characteristics created (handles 40–51)
Advertising started
Total heap consumed by BT stack: ~65KB

Message Protocol (BLE)

5-byte fragment header: [type, messageId, fragmentNum(2), flags]
Fragmentation: automatic for all requests/responses
Streaming file upload: sliding window of 8 chunks, waits for ACK before advancing
App request types: from logs — type 10=ready-for-events, type 7=get-projects, type 8=get-autostart, type 9=set-autostart, type 2=get-file, type 6=execute-lua

Debugging BLE

# Enable HCI logs in ESP-IDF menuconfig for raw BLE packet capture
# Watch for these in serial log:
# [INFO] handleGattsConnect()   — client connected
# [INFO] handleGattsMTU()       — MTU negotiated
# [WARN] handleGattsConfirm()   — indication failed (status=132 at startup is normal)

이 저장소의 다른 Skills

같은 저장소

blockly

mirkosertic/Megahub

Blockly visual programming context for the Megahub project. Use when adding, modifying, or debugging custom Blockly blocks, the Lua code generator, the toolbox, block colors, or the BLOCKS.md documentation generation script.

2026-03-062

documentation

mirkosertic/Megahub

Documentation structure and maintenance rules for the Megahub project. Use whenever making user-facing changes — adding features, changing behavior, fixing hardware compatibility, or modifying configuration. Describes which files to update, the README structure, and writing style.

2026-03-012

firmware-core

mirkosertic/Megahub

Core firmware context for the Megahub ESP32 project. Use when working on PlatformIO configuration, build scripts, library structure, main.cpp, or general ESP32 firmware development. Covers build system, project structure, common pitfalls, and debugging.

2026-03-012

frontend

mirkosertic/Megahub

Frontend development context for the Megahub project. Use when working on the web-based IDE, Vite build system, Blockly visual programming, Web Bluetooth API integration, JavaScript frontend code, CSS/styles, UI components, or anything in the /frontend/ directory.

2026-03-012

lego-protocol

mirkosertic/Megahub

LEGO Powered Up protocol context for the Megahub project. Use when working on LEGO device communication, lpfuart library, UART parsing, motor control, sensor modes, device initialization, or debugging UART noise/corruption issues.

2026-03-012

linting

mirkosertic/Megahub

Code formatting and linting context for the Megahub project. Use when writing or reviewing code in C++ or JavaScript, or when running format/lint checks. Describes tool commands, style conventions, and when to apply them.

2026-03-012

name	ble
description	Bluetooth context for the Megahub project. Use when working on BLE GATT server, Classic Bluetooth HID host, Web Bluetooth API integration, btremote library, connection handling, or any Bluetooth-related firmware code.

Bluetooth Architecture — Megahub ESP32

The project uses both BLE and Classic Bluetooth simultaneously (BTDM dual-mode).

Type	Purpose	Library
BLE (GATT server)	Web Bluetooth API ↔ firmware	`lib/btremote/`
Classic BT (HID host)	Gamepad/keyboard/mouse input	`lib/btremote/`

BLE GATT Server

Service UUID: 4fafc201-1fb5-459e-8fcc-c5c9c331914b

Characteristic	UUID	Direction	Type
REQUEST	`beb5483e-36e1-4688-b7f5-ea07361b26a8`	Browser → Firmware	Write
RESPONSE	`1c95d5e3-d8f7-413a-bf3d-7a2e5d7be87e`	Firmware → Browser	Notify
EVENT	`d8de624e-140f-4a22-8594-e2216b84a5f2`	Firmware → Browser	Notify
CONTROL	`f78ebbff-c8b7-4107-93de-889a6a06d408`	Firmware → Browser	Indicate

Indications vs Notifications: CONTROL uses indications (require client ACK). RESPONSE/EVENT use notifications.
MTU: Default 23 bytes on connect. Firmware sends MTU_INFO notification immediately after connect, then again after negotiation (up to 517 bytes).
From real device logs: MTU negotiates to 514/517 bytes reliably.

BLE Rules (never violate)

Never block in BLE callbacks — they run in the BLE stack task context
Always check isConnected() before sending notifications/indications
Reconnection: Browser handles reconnect via device.gatt.connect() — firmware must keep advertising
Multiple connections: Each consumes ~30KB heap — the BT stack alone drops free heap from ~140KB to ~75KB
BLE callbacks → post work to a queue, handle in BTMsgProcessor task
Indication failures (status=132) during startup are normal — the client ACK pipeline needs time to stabilize after connect

Classic Bluetooth (HID Host)

Only for HID devices: gamepads, keyboards, mice
Auto-pairing enabled (IO capability: NONE, PIN: "0000")
HID events processed in HIDEventTask (priority 5, separate from BLE stack)
Never block in HID callback — post to queue
Pairing state is persisted in NVS; handle removal gracefully

Startup Sequence

From real device logs, BT init order:

BT controller starts in BTDM dual-mode (esp_bt_controller_enable)
Classic GAP callback registered
Classic scan mode: connectable + discoverable
HID Host initialized → waits for ESP_HIDH_INIT_EVT
Bluedroid BLE init → waits for GATTS registration
GATT service + characteristics created (handles 40–51)
Advertising started
Total heap consumed by BT stack: ~65KB

Message Protocol (BLE)

5-byte fragment header: [type, messageId, fragmentNum(2), flags]
Fragmentation: automatic for all requests/responses
Streaming file upload: sliding window of 8 chunks, waits for ACK before advancing
App request types: from logs — type 10=ready-for-events, type 7=get-projects, type 8=get-autostart, type 9=set-autostart, type 2=get-file, type 6=execute-lua

Debugging BLE

# Enable HCI logs in ESP-IDF menuconfig for raw BLE packet capture
# Watch for these in serial log:
# [INFO] handleGattsConnect()   — client connected
# [INFO] handleGattsMTU()       — MTU negotiated
# [WARN] handleGattsConfirm()   — indication failed (status=132 at startup is normal)