Bairan.Zhang/AI_Printer
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(idf): update to esp-idf 5.5.3

Browse Source
This commit is contained in:
admin
2026-04-29 16:00:58 +08:00
parent 559df3b570
commit 9294d72aea
4 changed files with 23 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

24
AGENTS.md
View File

@@ -25,15 +25,23 @@
8. Blocking APIs must define timeout and idempotent semantics (no destructive background continuation after caller timeout). 8. Blocking APIs must define timeout and idempotent semantics (no destructive background continuation after caller timeout).
## Build, Flash, and Validation ## Build, Flash, and Validation
Activate ESP-IDF v5.5.2 before running any `idf.py` command: Activate ESP-IDF v5.5.3 before running any `idf.py` command:
```bash ```bash
export PATH=/opt/homebrew/bin:$PATH export PATH=/opt/homebrew/bin:$PATH
export IDF_PATH=/Users/moyyang/esp/v5.5.2/esp-idf export IDF_PATH=/Users/moyyang/.espressif/v5.5.3/esp-idf
source $IDF_PATH/export.sh source $IDF_PATH/export.sh
``` ```
- `idf.py set-target esp32s3`: one-time target setup. - `idf.py set-target esp32s3`: one-time target setup.
- `idf.py build`: compile and validate. - `idf.py build`: compile and validate; generated flash maps and binaries stay under `build/`.
- `idf.py -p <PORT> flash monitor`: flash and open serial monitor (`Ctrl+]` to exit). - Secured/provisioned boards with Secure Boot and Flash Encryption enabled must use encrypted app-only flashing:
```bash
idf.py -p <PORT> encrypted-app-flash
idf.py -p <PORT> monitor
```
This updates only the encrypted app partition at `0x30000` via `build/encrypted_app-flash_args`; it must not rewrite the bootloader, partition table, or OTA data on secured boards.
- Do not use `idf.py flash` on secured boards. It attempts to write low flash regions such as the bootloader at `0x0`, which Secure Boot blocks to protect the device.
- Do not use plain `idf.py app-flash` on Flash Encryption boards. It writes a plaintext app image and can boot-fail with invalid app magic or no bootable app partition.
- `idf.py -p <PORT> flash monitor` is only for fresh development boards without Secure Boot/Flash Encryption, or for initial factory provisioning handled by `tools/esptool-factory`.
- `idf.py menuconfig`: adjust project options. - `idf.py menuconfig`: adjust project options.
- `idf.py fullclean && idf.py build`: clear stale artifacts. - `idf.py fullclean && idf.py build`: clear stale artifacts.
@@ -46,8 +54,12 @@ source $IDF_PATH/export.sh
## Testing Guidelines ## Testing Guidelines
There is no dedicated unit-test directory currently. Minimum validation: There is no dedicated unit-test directory currently. Minimum validation:
- Build check: `idf.py build`. - Build check: `idf.py build`.
- Device smoke test after flash: `/v1/health`, printer connect/disconnect, and one print flow (text or image) via `curl`. - Secured-board flash check: `idf.py -p <PORT> encrypted-app-flash`, then `idf.py -p <PORT> monitor`.
- For Control Plane or REST changes, include one request/response or lifecycle scenario in PR notes. - Monitor boot logs should show Secure Boot signature verification, app ESP-IDF version, Wi-Fi connection/IP when configured, printer protocol initialization, `MIC_KEY` readiness, control-plane lifecycle start, and `TQ printer runtime started`.
- If STA connects, confirm host reachability with `ping <DEVICE_IP>`.
- For unprovisioned devices, validate the SoftAP provisioning flow at `http://192.168.4.1` and the provisioning endpoints `/`, `/scan`, and `/provision`.
- Physical smoke tests should cover `MIC_KEY` press/release, POWER key long press, and one normal product print flow when the required printer hardware/workflow is available.
- For Control Plane or protocol changes, include one lifecycle or request/response scenario in PR notes.
## Commit & Pull Request Guidelines ## Commit & Pull Request Guidelines
Use a clear conventional format: Use a clear conventional format:

4
README.md
View File

@@ -58,13 +58,13 @@
## 构建环境 ## 构建环境
本项目按当前实际使用 ESP-IDF `v5.5.2`。 本项目按当前实际使用 ESP-IDF `v5.5.3`。
先激活环境: 先激活环境:
```bash ```bash
export PATH=/opt/homebrew/bin:$PATH export PATH=/opt/homebrew/bin:$PATH
export IDF_PATH=/Users/moyyang/esp/v5.5.2/esp-idf export IDF_PATH=/Users/moyyang/.espressif/v5.5.3/esp-idf
source $IDF_PATH/export.sh source $IDF_PATH/export.sh
``` ```

2
dependencies.lock
View File

@@ -80,7 +80,7 @@ dependencies:
idf: idf:
source: source:
type: idf type: idf
version: 5.5.2 version: 5.5.3
direct_dependencies: direct_dependencies:
- espressif/button - espressif/button
- espressif/esp_audio_codec - espressif/esp_audio_codec

4
sdkconfig.defaults
View File

@@ -14,8 +14,8 @@ CONFIG_LWIP_TCP_SND_BUF_DEFAULT=57344
CONFIG_LWIP_TCP_WND_DEFAULT=262144 CONFIG_LWIP_TCP_WND_DEFAULT=262144
CONFIG_LWIP_TCP_RECVMBOX_SIZE=192 CONFIG_LWIP_TCP_RECVMBOX_SIZE=192
CONFIG_LWIP_TCPIP_RECVMBOX_SIZE=256 CONFIG_LWIP_TCPIP_RECVMBOX_SIZE=256
CONFIG_LOG_DEFAULT_LEVEL_WARN=y CONFIG_LOG_DEFAULT_LEVEL_INFO=y
CONFIG_BOOTLOADER_LOG_LEVEL_WARN=y CONFIG_BOOTLOADER_LOG_LEVEL_INFO=y
CONFIG_TQ_WIFI_PROV_SOFTAP_SSID="TalkingQ-Setup" CONFIG_TQ_WIFI_PROV_SOFTAP_SSID="TalkingQ-Setup"
CONFIG_TQ_WIFI_PROV_SOFTAP_PASSWORD="" CONFIG_TQ_WIFI_PROV_SOFTAP_PASSWORD=""
CONFIG_TQ_WIFI_PROV_SOFTAP_CHANNEL=1 CONFIG_TQ_WIFI_PROV_SOFTAP_CHANNEL=1