构建 Watcher 开发环境
本文档由 AI 翻译。如您发现内容有误或有改进建议,欢迎通过页面下方的评论区,或在以下 Issue 页面中告诉我们:https://github.com/Seeed-Studio/wiki-documents/issues
ESP-IDF 安装
请参考 Espressif 的官方安装指南。
请注意,factory_fw
示例是基于 IDF 的 v5.2.1 版本。
mkdir -p ~/esp
cd ~/esp
git clone --recursive https://github.com/espressif/esp-idf.git
我们强烈建议您在 macOS 或 Linux 上为 IDF 环境初始化创建别名 get_idf
。
第一次构建
获取 IDF 环境
get_idf
idf.py
如果您正确安装了 IDF,在运行 idf.py
命令后,您将看到 idf.py 工具的帮助信息打印。
$ idf.py
Usage: idf.py [OPTIONS] COMMAND1 [ARGS]... [COMMAND2 [ARGS]...]...
ESP-IDF CLI 构建管理工具。对于 idf.py 未知的命令,将尝试将其作为构建系统目标执行。选定目标:esp32s3
...
将芯片目标设置为 esp32s3
。
idf.py set-target esp32s3
构建项目
idf.py build
最新的工厂固件代码位于 example/factory_firmware
。
cd example/factory_firmware
idf.py build
烧录固件
使用 USB 数据线将 SenseCAP Watcher 连接到您的 PC 或笔记本电脑。
请注意!!!
只有底部(侧面)的 USB 接口支持数据传输
背面的 USB 接口仅为设备提供电源。
当您使用正确的数据线并从正确的 USB-C 接口连接 Watcher 时,您的 PC 上会出现 1 个 USB 设备条目,以及 2 个 UART 设备。这些是连接到 ESP32S3 和 Himax SoC 的 UART。没有固定的模式表明哪个 SoC 使用哪个 UART。因此,请尝试以下命令中的每个 UART 设备,直到您看到日志打印。
idf.py --port /dev/ttyACM0 monitor
请将 /dev/ttyACM0
替换为您操作系统上的正确 UART 设备名称。例如,在 macOS 上看起来像 /dev/tty.wchusbserial56F3067xxxx
,在 Windows 上看起来像 COMx
。如果您没有看到日志打印的进展,请尝试下一个 UART。
请注意!!!
名为 nvsfactory
的分区包含设备正常工作所需的关键工厂数据,请小心不要擦除该分区。因此,我们强烈建议您在执行任何烧录操作之前备份此分区。
我们将使用 esptool.py 进行备份。此工具是 IDF 安装的一部分,因此如果您已完成 IDF 安装,它应该已经存在。
# Linux / MacOS
which esptool.py
# Windows
where esptool.py
现在让我们备份我们的 nvsfactory
分区。
esptool.py --port /dev/tty.wchusbserial56F3067xxxx --baud 2000000 --chip esp32s3 --before default_reset --after hard_reset --no-stub read_flash 0x9000 204800 nvsfactory.bin
完成备份后,就可以烧录我们的固件了。
idf.py --port /dev/ttyACM0 -b 2000000 app-flash
使用子命令 app-flash
仅烧录应用程序分区,这将保护您的 nvsfactory
分区,最重要的是,它将节省您的时间。
监控日志输出
idf.py monitor
使用 ctrl + ]
退出监控。
技术支持与产品讨论
感谢您选择我们的产品!我们为您提供多种支持,以确保您使用我们的产品时体验顺畅。我们提供多种沟通渠道,以满足不同的偏好和需求。