跳至主要內容

资源占用

fastbee大约 16 分钟

资源占用与功能裁剪

本文用于决定"哪些功能要编进固件，哪些功能应关闭"。构建段落、环境列表和宏定义位置见 构建配置；本页只保留资源预算、裁剪策略和交付前检查清单，避免重复维护 platformio.ini 的完整说明。

ESP32 内存背景

资源ESP32ESP32-S3ESP32-C3ESP32-C6
内部 SRAM~320KB~512KB~400KB~512KB
可用堆（启动后）~220KB~310KB~140KB~220KB
PSRAM4-8MB 可选2-8MB 可选无无
Flash4-16MB8-16MB4MB4MB

关键约束：

  • WiFi、lwIP、FreeRTOS、TLS 握手等仍需要内部 DRAM，不能完全依赖 PSRAM。
  • PSRAM 适合 HTTP/JSON 缓冲区和较大临时对象，不适合实时性高或硬件要求内部 DRAM 的结构。
  • ESP32-C3/C6 的 4MB 无 PSRAM 环境应优先使用 Lite，并关闭未接硬件的显示、网络和高级协议模块。
  • 长期运行时最大连续堆比总空闲堆更重要；总空闲 35KB 但最大连续块只有 8KB 时，大对象仍可能分配失败。

DRAM 消耗源实测分解（esp32-F4R0）

以 2026-08 实测固件（无 PSRAM）为例，排查“空闲 DRAM 为何下降”时可直接对照：

静态占用（data+bss，链接期确定）≈ 89.3KB，主要构成：

消耗源占用说明
FastBee StaticSlabPool 三个池（256×32 / 192×32 / 64×64）≈18.5KBHTTP/Web 预分配 slab，换取运行期零碎片
WiFi/BT 协议栈静态内存（libnet80211/libpp/libbt 等）≈12KB芯片库固定占用，不可裁
LoggerSystem 单例 + MQTT 发布池 + WiFi 扫描缓冲≈6.2KB各约 2KB
lwIP/mDNS/FreeRTOS/U8g2 等框架静态其余dns_table、mdns 任务栈等

运行期动态大头（启动后逐步占用）：MQTT（尤其 MQTTS：TLS 缓冲可达 35KB）、lwIP TCP 缓冲、AsyncTCP 连接块、JSON 配置解析峰值。

典型案例：free8 从 22.8KB 跌到 7.8KB 的原因链：

  1. MQTT 建连占 12-15KB lwIP 缓冲（叠加 TLS 时更多）
  2. 旧固件传感器并发读反复触发崩溃复位，启动期内存叠加碎片
  3. 碎片化：总空闲尚可但最大连续块 <6KB 时静态文件门控拒接，体感雪崩

修复（单总线互斥锁 + 限流退避 + MQTT 让位）后，STA 稳态实测：free8≈25-27KB、blk8≈11.7KB、frag≈49%、min free≈42.8KB（INTERNAL 口径），Web 8/8 资源正常。排查内存下降时先看 [METRICS] 行的 min 字段确定历史最低点，再对照上表定位是 MQTT/TLS 还是碎片问题。

内存优化策略

PSRAM 分配阈值

固件通过 heap_caps_malloc_extmem_enable(256) 设置 PSRAM 分配阈值：大于 256 字节的分配优先走 PSRAM（如果有），小于该阈值的分配保留在内部 DRAM。这确保 TLS 缓冲区、JSON 文档等大对象不挤占宝贵的内部堆。

集中管理在 include/core/MemoryBudget.h，关键常量：

常量值说明
PSRAM_ALLOC_THRESHOLD256PSRAM 分配最小阈值（字节）
HEAP_WARN_THRESHOLD20000堆空闲低于此值触发 WARN
HEAP_SEVERE_THRESHOLD12000堆空闲低于此值触发 SEVERE
HEAP_CRITICAL_THRESHOLD8000堆空闲低于此值触发 CRITICAL
MQTT_CMD_QUEUE_MAX_BYTES4096MQTT 命令队列内存上限

运行期分配闸门（低内存时跳过本次操作而非 OOM 重启，阈值统一收拢在 MemoryBudget.h）：

常量值作用点
MQTT_RECEIVE_MIN_DRAM12000MQTT 入站消息低于此值直接丢弃
TCP_RX_MIN_DRAM12000TCP 收包低于此值 drain 丢弃入站
TCP_RX_MAX_FRAME2048TCP 单轮读取上限（剩余下轮再读）
PERIPH_EXEC_MIN_DRAM15000外设执行动作链低于此值跳过剩余动作
MODBUS_POLL_MIN_DRAM12000Modbus 轮询低于此值跳过
ACTION_TICKER_MIN_DRAM4096BLINK/BREATHE ticker 分配前水位预检
CELLULAR_BEGIN_MIN_DRAM81924G 适配器创建 TinyGSM 对象族前预检

运行期分配三件套

新增可被 MQTT 指令/Web/定时器触发的堆分配时，必须遵循：① 水位预检（heap_caps_get_free_size(MALLOC_CAP_INTERNAL) 对比 MemoryBudget 闸门）→ ② new (std::nothrow) → ③ 判空降级（跳过本次动作/优雅失败退避，绝不解引用空指针）。抛出型 new 在 OOM 时会直接 abort 整机重启，绕过全部降级保护，只允许用于启动期一次性分配。TCP 收包禁止使用无界 readString()（O(n²) 追加 churn + 无上限累积），必须走 readTcpBounded() 限长读。WiFi 扫描的成功与失败路径都必须调用 WiFi.scanDelete() 释放驱动内结果。回归守护：test/test_stability_fixes.cpp。

HealthMonitor 四级保护

HealthMonitor 根据 DRAM 内部空闲量（排除 PSRAM）实施四级保护策略。WiFi、MQTT、TLS 握手等都不能使用 PSRAM，因此 DRAM 空闲才是评估系统稳定性的真实指标。

级别条件行为
NORMALDRAM 空闲 > WARN 阈值正常运行；恢复已停止的服务（MQTT 被禁用除外）
WARNDRAM 空闲 < WARN 阈值日志警告，尝试碎片紧凑化
SEVEREDRAM 空闲 < 16KBMQTTS→MQTT 降级 + 停 Modbus + 暂停 PeriphExec
CRITICALDRAM 空闲 < 8KB30s 永久禁用 MQTT + 90s 安全重启（含 boot loop 保护）

PSRAM 动态阈值

CRITICAL 阈值根据 PSRAM 容量自动调整：无 PSRAM 8KB、4MB PSRAM 10KB、8MB PSRAM 12KB。阈值在首次检测时计算一次，运行时不变。

内存自动恢复机制

当 DRAM 持续下降进入 SEVERE 或 CRITICAL 时，固件自动执行分级恢复，任何情况下 Web 服务保持可用，设备不会变砖。

分级恢复策略

触发时机恢复动作持久性
SEVERE（DRAM < 16KB）① MQTTS→MQTT 降级（释放 ~35KB TLS DRAM）
② 停止 Modbus RTU
③ 暂停 PeriphExec 定时器		降级持久；Modbus/PeriphExec 恢复后自动恢复
EMERGENCY（DRAM < 4KB）立即执行全部 SEVERE 恢复 + 永久禁用 MQTT，不等计时持久
CRITICAL 持续 30s写入 protocol.json 设置 mqtt.enabled=false + 停止 MQTT持久：重启后 MQTT 不连，用户手动在 Web 开启
CRITICAL 持续 90s安全重启（MQTT 已禁用，重启后内存充裕）重启后系统恢复
NORMAL 恢复（DRAM > 30KB）恢复 Modbus + PeriphExec；MQTT 被禁用时不自动恢复用户手动开启 MQTT

防砖保护

机制说明
Web 服务永不停止所有降级级别中 Web 服务器始终保持运行；SSE 在 SEVERE 时关闭以节省内存，但 Web 核心保持响应
重启循环保护启动 < 120s 内不执行 90s 重启，防止"启动→CRITICAL→重启"死循环
紧急释放兜底DRAM < 4KB 时不等 30s 计时，立即禁用 MQTT + 停止所有非 Web 服务
MQTT 永久禁用CRITICAL 30s 写入 mqtt.enabled=false，重启后 MQTT 不连，用户需通过 Web 手动开启
配置写入失败安全退出protocol.json 写入失败时跳过降级操作，不标记已完成，避免状态不一致

串口日志格式

每个恢复动作输出 [MEMRECOVER] 前缀的结构化日志，便于串口排查：

[MEMRECOVER] === SEVERE recovery triggered === dram=15832 largest=4096 frag=74%
[MEMRECOVER] Step 1/3: MQTTS -> MQTT downgrade (releasing ~35KB TLS DRAM)
[MEMRECOVER]   protocol.json updated: scheme=mqtt, port=1883
[MEMRECOVER]   DRAM after downgrade: 48216 bytes
[MEMRECOVER] Step 2/3: Modbus stopped (was running)
[MEMRECOVER] Step 3/3: PeriphExec timers paused
[MEMRECOVER] === SEVERE recovery complete === dram=48216 (gained 32384 bytes)

[MEMRECOVER] === CRITICAL 30s: disabling MQTT permanently ===
[MEMRECOVER]   protocol.json updated: mqtt.enabled=false
[MEMRECOVER]   MQTT stopped (will NOT reconnect after reboot)

[MEMRECOVER] === Recovery summary before reboot ===
[MEMRECOVER]   Uptime: 3600s, CRITICAL duration: 90s
[MEMRECOVER]   Actions taken: MQTTS->MQTT(SEVERE) Modbus stopped PeriphExec paused MQTT disabled(30s)
[MEMRECOVER]   DRAM: current=6144 largest=2048
[MEMRECOVER]   Reboot reason: DRAM<8KB for 90s, all recovery exhausted

恢复状态 API

/api/system/health 接口的 memguard 字段包含恢复状态标志：

{
  "memguard": {
    "level": 2,
    "level_name": "SEVERE",
    "mqtts_downgraded": true,
    "mqtt_stopped": false,
    "mqtt_disabled": false,
    "modbus_stopped": true,
    "periph_exec_paused": true,
    "critical_duration_s": 0
  }
}

内存池管理

  • StringBufferPool：模板缓冲池 StringBufferPool<BufSize, PoolCount>，用于 Modbus 等重复缓冲区场景，避免频繁 new/delete 导致碎片。
  • Modbus 缓冲池：PSRAM 设备 8 个槽位，无 PSRAM 设备 4 个槽位，条件编译控制。
  • MQTT 命令队列：总字节数跟踪 _cmdQueueTotalBytes，超过 4096 字节时丢弃新命令，防止队列无限增长。

PSRAM JSON 分配器

配置保存等大 JSON 操作使用 FastBee::makeJsonDocument(8192)，在有 PSRAM 时自动分配到 PSRAM，避免内部堆峰值。

MQTTS(TLS) 内存影响

MQTTS 使用 WiFiClientSecure 进行 TLS 握手，单次连接需要 ~20-40KB 额外内存。内存优化措施：

  • WiFiClientSecure 实例按需创建（new），连接断开后立即释放（delete）
  • 无 PSRAM 设备 mqtts 连接失败后进入慢速退避，避免反复消耗
  • TLS 传输层生命周期独立管理，releaseTlsTransport() 确保及时释放

功能开关方法

功能开关通过 platformio.ini 的 build_flags 设置：

build_flags =
    -DFASTBEE_ENABLE_XXX=1    ; 启用
    -DFASTBEE_ENABLE_XXX=0    ; 禁用

默认值定义在 include/core/FeatureFlags.h，platformio.ini 中的值会覆盖默认值。通常先选择 lite_flags、standard_flags 或 full_flags，再在具体 [env:*] 中覆盖少量项目。

双层控制架构（编译宏 + 运行时配置）

2026-08 功能模块可配置化重构后，功能启用决策链为 编译宏 AND 用户配置 AND 启动预算：

层载体作用
编译时FASTBEE_ENABLE_* 宏（FeatureFlags.h / platformio.ini）决定功能是否编入固件；宏为 0 时代码完全不编译
运行时/config/features.json（RuntimeFeatureManager 管理）首次启动自动生成；可在 Web "功能配置"页面按模块启用/禁用，保存后重启生效；支持父子依赖级联（如关闭 lcd 自动关闭 lcd_gb2312）
启动预算include/core/FeatureBudget.h（checkFeatureBudgets()）启动时逐项校验 DRAM 预算，不足的功能自动降级为 noMemory 不初始化

相关 API（FeatureRouteHandler）：

端点方法说明
/api/features/statusGET返回全部功能的编译状态、用户开关、激活状态、资源估算和依赖关系
/api/features/configPOST仅保存 features.json，不重启
/api/features/applyPOST保存配置并延时重启生效
/api/features/estimatePOST预估应用某组开关后的 Flash/RAM 占用

请求体格式（config/apply/estimate 通用）：{"features": {"lcd": {"enabled": false}, "irRemote": {"enabled": true}}}。

unified 全量编译环境

platformio.ini 提供 *-unified 环境（esp32-F4R0-unified、esp32c3-F4R0-unified、esp32c6-F4R0-unified、esp32s3-F8R4-unified、esp32s3-F16R8-unified）：编译全部功能模块（full_unified_flags），由启动预算自动裁剪超预算模块，用户再通过 Web 功能配置页面按需关闭不用的功能，实现"一个固件适配多种硬件"。无 PSRAM 的 4MB 环境会由预算门控自动拒绝重内存模块（如 LED 点阵、RFID）。

启动内存预算校验

2026-08 功能模块可配置化重构后，固件启动时会逐项校验已启用功能的内存预算（checkFeatureBudgets()，预算表集中在 include/core/FeatureBudget.h）：

  • 串口输出 [BUDGET] <feature> ok/denied: free8=XXKB >= need=XXKB；预算不足的功能自动降级为不初始化（状态 noMemory），避免启用重模块后启动即 OOM。
  • /api/system/status 的 features 字段返回各功能运行时状态（active / disabled / noMemory），可用于部署后确认功能档位是否符合预期。
  • 新增重内存功能时应在 FeatureBudget 表登记预算，并补充 native 测试守卫（test_memory_budget.cpp / test_profile_consistency.cpp）。

优先裁剪顺序

优先级模块建议
1BLE2026-08 起 full_flags 默认关闭；当前没有完整 BLE 配网页面和处理链路，需要时手动覆盖 FASTBEE_ENABLE_BLE=1 并补齐依赖
24G / 以太网未接硬件就关闭；标准版默认关闭 4G 和以太网
3OTA / 文件管理 / 文件日志 / 用户角色交付版按维护需求开启，4MB 环境默认不启用 OTA
4LCD/OLED、NeoPixel、LED 点阵、RFID、红外、I2C 高级传感器、GB2312 中文字库未接模块就关闭；量产配置不要为预留硬件提前启用；中文字库单个占 ~107KB Flash，Lite/Standard 默认关闭；也可保留编译、在 Web 功能配置页面运行时关闭
5规则脚本 / 命令脚本需要现场自动化和脚本能力时开启；低内存环境优先用固定动作

原 TCP 客户端 / HTTP 客户端 / CoAP 协议模块已于 2026-08 从代码库移除（保留 MQTT 与 Modbus），不再参与裁剪决策。

Web 资源预算

Web 静态资源通过 scripts/gzip-www.js 按 profile 生成 staging（.pio/fs-staging/run-*/）后上传 LittleFS，各档预算（2026-08 实测）：

profile文件大小主要内容DRAM 解压峰值参考
lite（--web-lite）~217KB核心页 + 中文 i18n，无 OTA/文件管理/用户角色/RuleScript/Modbus TCP首屏 CSS 解压 ~71KB
standard（--web-standard）~225KBlite + RuleScript + Modbus RTU 配置页；不含设备大屏首屏 CSS 解压 ~71KB
full（--web-full）~350KB全量模块（含英文 i18n、OTA、文件、用户、设备大屏）设备大屏加载时额外 ~106KB

lite/standard 镜像构建时会自动清理 device-control.js/-view.js/-modbus.js 等设备大屏 bundle（build-web-modules.js 的 cleanProdObsoleteModules()），避免上次 full 构建残留进镜像。

设备大屏 DRAM 影响分析

设备大屏（FASTBEE_ENABLE_DEVICE_CONTROL）包含 3 个 JS bundle（约 21.5KB gz）+ CSS（~5.7KB gz）：

  • 加载时需 ~106KB DRAM（bundle 解压 + DOM 节点），无 PSRAM 的 esp32-F4R0（稳态 free8 仅 ~25KB）完全无法承载，强行加载必然触发 OOM/重启循环。
  • 因此 Lite/Standard 双门控排除：固件侧宏为 0 不编译 API/路由，Web 构建侧不打包对应 bundle；仅 Full（PSRAM 设备）包含。
  • 部署后可通过 /api/system/status 的 features.deviceControl 字段确认门控生效（standard 应返回 disabled）。

模块资源预算

以下为估算值，用于选型和裁剪决策；实际占用以当前编译输出和运行时 /api/system/info 为准。

外设与显示

开关宏RAMFlash预设说明
FASTBEE_ENABLE_LCD~1.2KB~20KBLite/Standard/Full 默认启用OLED/LCD，依赖 U8g2
FASTBEE_ENABLE_NEOPIXEL~2KB + 3B/颗~12KB默认启用WS2812 灯带；可用 FASTBEE_NEOPIXEL_MAX_LEDS 降低上限
FASTBEE_ENABLE_LED_SCREEN动态分配~10KBStandard/FullWS2812B 点阵屏
FASTBEE_ENABLE_I2C_SENSORS~500B~15KBFull（Standard 可覆盖启用）BMP280、MPU6050、SHT31、BH1750、AHT20 等
FASTBEE_ENABLE_RFID~200B~12KBFull（Standard 可覆盖启用）MFRC522
FASTBEE_ENABLE_IR_REMOTE~300B~8KBFull（esp32-F8R4；Standard 可覆盖），S3 禁用ESP32-S3 与 IRremoteESP8266 RMT 驱动冲突
FASTBEE_ENABLE_LCD_GB2312-~107KB (wqy12) / ~141KB (wqy15)仅 Full 默认启用OLED GB2312 中文字库；禁用时回退 ASCII 字体
FASTBEE_ENABLE_DEVICE_CONTROL加载时 ~106KBWeb 21.5KB gz + CSS 5.7KB gz仅 Full设备大屏；无 PSRAM 设备不要启用
FASTBEE_ENABLE_SENSOR_DRIVER~200B~8KB默认启用DHT、DS18B20 等基础传感器
FASTBEE_ENABLE_SEVEN_SEGMENT~32B/实例~3KB默认启用TM1637 数码管
FASTBEE_ENABLE_DS1302~100B~2KB默认关闭有 NTP 时通常不必启用
FASTBEE_ENABLE_LCD1602~100B~3KB默认关闭LCD1602/LCD2004 I2C 字符屏

网络与协议

开关宏RAMFlash预设说明
FASTBEE_ENABLE_MQTT~4-8KB~15KB默认启用平台通信核心能力；mqtts 额外需 ~20-40KB（TLS）
FASTBEE_ENABLE_MODBUS~3-5KB~20KBStandard/Full工业现场常用
FASTBEE_MODBUS_SLAVE_ENABLE~440B~10KBFull依赖 FASTBEE_ENABLE_MODBUS=1
FASTBEE_ENABLE_ETHERNET~8KB~8KBFullW5500，以太网硬件未接时关闭
FASTBEE_ENABLE_CELLULAR~10-15KB~15KBFullEC801E 4G，RAM 占用高
FASTBEE_ENABLE_BLE~20-30KB~80KB默认关闭（2026-08 起）当前无完整 BLE 配网页面和处理链路；启用前需补齐依赖和验证
FASTBEE_ENABLE_MDNS~2KB~5KB默认启用禁用后不能用 fastbee.local
FASTBEE_ENABLE_DNS~1KB~3KB默认启用AP 配网页面常用
FASTBEE_ENABLE_AP_MODE~1-2KB~2KB默认启用禁用后首次配网能力受影响

系统与 Web

开关宏RAMFlash预设说明
FASTBEE_ENABLE_WEB_SERVER~20-30KB~25KB默认启用Web 控制台和 REST API 核心
FASTBEE_ENABLE_PERIPH_EXEC~2-4KB~8KB默认启用定时、事件、平台触发等自动化规则
FASTBEE_ENABLE_RULE_SCRIPT~4-8KB~8KBStandard/Full规则脚本引擎
FASTBEE_ENABLE_COMMAND_SCRIPT~1-2KB~3KB继承规则脚本命令脚本
FASTBEE_ENABLE_OTA / FASTBEE_ENABLE_OTA_FS~4-6KB~10KBFullFlash >= 8MB 才适合开启
FASTBEE_ENABLE_STORAGE_CACHE~2-4KB~1KB默认关闭大配置文件会绕过缓存，避免峰值翻倍
FASTBEE_ENABLE_FILE_LOGGING~500B~3KBFull持续写 Flash 会影响寿命
FASTBEE_ENABLE_USER_ADMIN~500B~5KBFull多用户管理
FASTBEE_ENABLE_FILE_MANAGER~500B~3KBFull文件管理器
FASTBEE_ENABLE_HEALTH_MONITOR~200B~4KB默认启用不建议关闭；四级堆保护策略
FASTBEE_ENABLE_LOGGER~300B~6KB默认启用可调小 FASTBEE_LOG_BUFFER_SIZE

性能调优参数

参数建议说明
FASTBEE_USE_PSRAM / BOARD_HAS_PSRAM只在真实带 PSRAM 的环境开启配合 heap_caps_malloc_extmem_enable(256) 将较大 HTTP/JSON 分配优先放到 PSRAM
FASTBEE_JSON_DOC_SIZE低内存环境可从 4096/8192 下调减少 JSON 文档峰值，但不能小到影响配置解析
CONFIG_ASYNC_TCP_MAX_CONNECTIONSC3/C6 保守，S3+PSRAM 可提高每个连接会消耗内部 DRAM 和 lwIP PCB
ARDUINO_LOOP_STACK_SIZEModbus、配置保存、脚本路径需保持足够栈栈溢出会表现为 Stack canary watchpoint triggered
FASTBEE_STRIP_INFO_LOGS生产建议 1编译期剥离 INFO 日志字符串，节省 Flash
FASTBEE_DEBUG_LOG / CORE_DEBUG_LEVEL生产保持低级别调试日志会增加 Flash 和运行时输出压力

典型配置方案

ESP32-C3/C6 4MB 精简版

目标是保留 MQTT、Web/API、基础 GPIO/传感器和 AP 配网，关闭 Modbus、OTA、脚本、4G/以太网、显示和高级外设。若不使用灯带，也关闭 NeoPixel：

-DFASTBEE_ENABLE_MODBUS=0
-DFASTBEE_ENABLE_OTA=0
-DFASTBEE_ENABLE_RULE_SCRIPT=0
-DFASTBEE_ENABLE_COMMAND_SCRIPT=0
-DFASTBEE_ENABLE_LCD=0
-DFASTBEE_ENABLE_NEOPIXEL=0
-DFASTBEE_ENABLE_I2C_SENSORS=0
-DFASTBEE_STRIP_INFO_LOGS=1
-DFASTBEE_LOG_BUFFER_SIZE=128

注意：无 PSRAM 的 C3/C6 设备不建议使用 mqtts（TLS），请选择 mqtt 协议。

ESP32 4MB 标准版

目标是 WiFi + MQTT + Modbus + 基础外设。标准预设已关闭 4G、以太网、BLE 和 OTA；2026-08 重构后还默认裁剪 RFID、红外、I2C 高级传感器、GB2312 中文字库和设备大屏（F4R0 实测 Flash 82.3%）。再按实际接线关闭未使用的显示等模块：

-DFASTBEE_ENABLE_OTA=0
-DFASTBEE_ENABLE_ETHERNET=0
-DFASTBEE_ENABLE_CELLULAR=0
-DFASTBEE_ENABLE_LCD=0

注意：标准 ESP32 无 PSRAM 时 mqtts 可能失败，建议使用 mqtt。如需 RFID/红外/I2C 传感器，按 构建配置常见定制场景 覆盖宏并加回 lib_deps，但需先确认 Flash 预算（<82%）。

ESP32-S3/ESP32 带 PSRAM 全功能版

目标是完整联网能力、OTA、文件/日志和高级规则。Full 默认启用 4G、以太网，并保留 BLE 编译开关；未接 4G、以太网时应主动关闭对应宏，BLE 未补齐实现前也建议关闭。

-DFASTBEE_USE_PSRAM=1
-DBOARD_HAS_PSRAM
-DFASTBEE_ENABLE_BLE=0

提示：带 PSRAM 的设备可正常使用 mqtts（TLS），TLS 缓冲区自动分配到 PSRAM。

资源上限参考

参数ESP32-C3 LiteESP32 StandardESP32-S3 Full
最大外设数162432
推荐执行规则数121632
传感器缓存条目162432
TCP 并发预算468
SSE 连接预算112
HTTP 连接预算356
TCP 耗尽阈值101214
MQTT 命令队列上限4096B4096B4096B
Modbus 缓冲池4 槽4 槽8 槽（PSRAM）

配置检查清单

  • 确认硬件实际连接了哪些外设模块。
  • 确认需要的联网方式：WiFi、以太网或 4G。
  • 确认协议需求：MQTT 通常保留，Modbus 按需开启（TCP/HTTP/CoAP 客户端已移除）。
  • Flash 小于 8MB 时不要启用 OTA。
  • 有 PSRAM 的环境才启用 FASTBEE_USE_PSRAM=1 和 BOARD_HAS_PSRAM。
  • 未连接的外设、网络模块和管理功能默认关闭。
  • 需要 BLE 时同步确认依赖、源码入口、Web/API 能力、配网流程和资源验证；当前设备端默认使用 WiFi AP/Web 配网。
  • unified 全量固件交付前，通过 Web 功能配置页面确认实际硬件用不到的模块已关闭，节省 Flash 与运行期内存。
  • 修改后执行 pio run -e <环境名>，并检查编译输出的 RAM/Flash 使用量。
  • 烧录后通过仪表盘或 /api/system/info 查看 heapFree、heapMaxAlloc、PSRAM 和功能档位是否符合预期。
  • 无 PSRAM 设备如需加密通信，评估是否改用外部 TLS 代理或 VPN，而非设备端 mqtts。
上次编辑于:
贡献者: kerwincui
蜂信物联 | 曲靖蜂信科技有限公司
Copyright © 2026 fastbee