如何配置静默模式

简介

静默模式 (silence mode) 是 ESP-AT 固件的一种编译配置选项，用于控制 AT 的日志（即 AT 日志端口输出的日志）行为，通常建议禁用。如果启用，将减少应用固件的大小。但建议您 优先考虑 下面两种方式减少应用固件的大小：

在 python build.py menuconfig > Component config > AT 路径下禁用不需要的 AT 功能。

参考最小化二进制文件大小文档中的优化方法。

启用和禁用静默模式的优点和缺点对比
静默模式	优点	缺点
禁用静默模式（即设置为 0），推荐此配置	开启一些 AT 的日志	应用固件 (esp-at.bin) 的大小会增加，这可能会导致编译 AT 固件时，应用固件大小超过了代码中划分的应用分区大小，从而导致编译失败（编译失败日志）。
启用静默模式（即设置为 1），不推荐此配置	应用固件 (esp-at.bin) 的大小会减小	此模式会删除一些 AT 的日志，并会使 CONFIG_LOG_DEFAULT_LEVEL 配置失效，从而无法输出相应等级日志，这会增加您调试 AT 功能的难度。

编译失败日志示例：

$ ./build.py build

... (more lines of build ESP-AT)

Generated /path/to/esp-at/build/esp-at.bin
[836/838] cd /path/to/esp-at/build/esp-at.bin
FAILED: esp-idf/esptool_py/CMakeFiles/app_check_size
cd /path/to/esp-at/build/esp-idf/esptool_py && [...]/bin/python /path/to/esp-at/esp-idf/components/partition_table/check_sizes.py --offset 0x8000 partition --type app /path/to/esp-at/build/partition_table/partition-table.bin /path/to/esp-at/build/esp-at.bin
Error: app partition is too small for binary esp-at.bin size 0x135ae0:
  - Part 'ota_0' 0/16 @ 0xd0000 size 0x130000 (overflow 0x5ae0)
ninja: build stopped: subcommand failed.

配置

启用或禁用静默模式配置：

本地编译 ESP-AT 工程

在第三步安装环境时配置 silence mode 为 No （或 Yes）来禁用（或启用）静默模式。

网页编译 ESP-AT 工程

在执行第 5.3 步提交更改时，修改 esp-at/.github/workflows/build_template_esp32.yml 文件中 silence_mode 的值，来启用或禁用静默模式。例如，要开启静默模式，则设置为：

- name: Configure prerequisites
  run: |
    # set module information
    silence_mode=1
    # set the silence_sdkconfig.defaults file path
    silence_sdkconfig=module_config/module_<your_module_name>/sdkconfig_silence.defaults
    mkdir build
    echo -e "{\"platform\": \"PLATFORM_ESP32\", \"module\": \"${{ inputs.module_name }}\", \"silence\": ${silence_mode}}" > build/module_info.json

请将编译好的 AT 固件烧录到模组上，然后执行 AT+GMR 命令，确认是否成功配置了静默模式的启用或禁用。
- 如果启用静默模式，AT+GMR 命令响应中应包含 s-，例如：
```
AT+GMR
AT version:3.5.0.0-dev(s-88b4ea4...

... (more lines of version information)

OK
```
- 如果禁用静默模式，AT+GMR 命令响应中不包含 s-，例如：
```
AT+GMR
AT version:3.5.0.0-dev(88b4ea4...

... (more lines of version information)

OK
```

提供有关此文档的反馈