Skip to content

mirkosertic/Megahub / .claude/skills/memory-freertos

memory-freertos

Verified

Memory management and FreeRTOS context for the Megahub ESP32 project. Use when dealing with heap allocation, stack size, task creation, inter-task communication, semaphores, queues, or any ESP32 memory constraints.

Memory Management & FreeRTOS — Megahub ESP32

Memory Budget (real device measurements)

Point in startupFree heap
After IMU init~170 KB
After Lua state creation~140 KB
After LEGO motor init~140 KB
After configuration load~139 KB
After BT stack start~76 KB
After BLE characteristics setup~76 KB
During BLE connection (connected)~63–73 KB

PSRAM: ~4.1 MB available (confirmed present on this board — ESP.getFreePsram()).

BT stack alone consumes ~65 KB of heap. Every BLE connection consumes an additional ~30 KB.


Memory Rules

  • Stack: Never allocate large arrays as local variables. Use static, heap, or PSRAM.
  • Heap: Minimize new/malloc. Every allocation needs a matching delete/free.
  • Strings: Avoid String += loops. Prefer std::string::reserve() or fixed char[] buffers.
  • PSRAM: Available, but don't assume — always check. Use for large buffers if needed.
  • Constants: Use const and PROGMEM for large constant data to keep it in flash.
  • Lua VM: Runs in heap. Large scripts reduce available heap for everything else.

FreeRTOS Task Reference

Known tasks and their stack high-water marks (from real device logs):

TaskPriorityStack HWM (words)Notes
loopTask1272Arduino main loop
BTMsgProcessor22968–7528Processes BLE messages
HIDEventTask51920Classic BT HID events
PortStatus11420LEGO port status reporting
StatusMonitor12452Heap/task monitoring
Device monitor11776Lua thread for device monitoring
BTU_TASK203624–4988BT stack internal
BTC_TASK194328–4364BT stack internal
hciT221516–1544BT HCI layer
btController232088BT controller
esp_timer224048ESP timer service
ipc0/124356/476IPC (highest priority)

⚠ loopTask HWM of 272 words is critically low — avoid adding stack usage to the main loop.


FreeRTOS Rules

  • Mutexes: Always use xSemaphoreTake with a timeout — never block indefinitely
  • Task stacks: Monitor with uxTaskGetStackHighWaterMark(). Stack overflow = silent crash.
  • Inter-task communication: Use queues or semaphores — not global variables without synchronization
  • BLE callbacks: Run in BLE task context — post work to a queue, handle in application task
  • Never block in BLE callbacks, HID callbacks, or ISRs
  • Task priorities: BT stack tasks run at 19–24. Application tasks at 1–5. Don't starve the BT stack.

Monitoring Pattern

// Log heap + PSRAM
INFO("Free heap: %d bytes, Free PSRAM: %d bytes",
     ESP.getFreeHeap(), ESP.getFreePsram());

// Log task stack (for current task)
INFO("Stack HWM: %d words", uxTaskGetStackHighWaterMark(NULL));

// Log all task stacks (use vTaskList for full snapshot)
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 197kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall