Bring-up

Hello World UART heartbeat

Tells you in one page whether the toolchain, flash path and serial monitor work.

Bring-up Serial log ESP32 family

Official path: examples/get-started/hello_world

01 Overview

The official Hello World prints a counter. It validates IDF, UART and the chip clock — not a product feature.

Use when: new PC setup, new module lot, factory flash station.
Skip when: firmware already downloads reliably.
Official proves: app_main runs and UART logs appear.
Official does not: log-level policy or sealing the debug port for production.

Chip: any IDF target.
Minimum parts: USB-UART (on-board or external). Do not rely only on USB-Serial-JTAG if you will debug sleep.
Pins: UART0 by default (often GPIO1/3). If the custom board moves the port, the dongle must follow.
Power: flashing draws more than idle; weak USB cables fail here.

1. idf.py set-target.

2. Build, flash, monitor.

3. app_main loops printf + delay.

4. Leave the monitor with Ctrl+].

5. Products should use ESP_LOGx and drop verbose for release.

This is a fixture, not a feature.
Baud, port and chip target must match.
Plan how the board is programmed after the enclosure is closed — that leads to OTA.
Custom work: programming header, UART map, factory log format.

中文

点亮与上电

工具链、烧录、串口监控是否通，这一页就能判断。

点亮与上电串口日志 ESP32 family

官方路径: examples/get-started/hello_world

官方 Hello World 周期性打印计数。用来确认 IDF、串口和芯片时钟，不是产品功能。

1. idf.py set-target 选芯片。

2. 编译、烧录、monitor。

3. app_main 里循环 printf + delay。

4. 退出监视器 Ctrl+] 。

5. 产品里应换成 ESP_LOGx，并按量产关闭 verbose。