make-project.rst 2.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172
  1. 通过 make 指令创建和烧录项目
  2. =============================
  3. :link_to_translation:`en:[English]`
  4. 寻找项目
  5. -----------------
  6. 和 `esp-idf-template <https://github.com/espressif/esp-idf-template>`_ 项目一样,ESP-IDF 在 Github 上的 :idf:`examples` 目录下也有示例项目。
  7. 找到需要的项目后,切换到其目录,然后可以对其进行配置和构建。
  8. 配置项目
  9. ------------------------
  10. ::
  11. make menuconfig
  12. 编译项目
  13. ----------------------
  14. ::
  15. make all
  16. ... 该命令将配置 app 和 bootloader 并根据配置生成分区表。
  17. 烧录项目
  18. ---------------------
  19. 当 ``make all`` 结束后,系统将打印一命令行提示您如何使用 esptool.py 烧录芯片。用户也可以通过以下指令进行烧录::
  20. make flash
  21. 这种方法将烧录整个项目(包括 app, bootloader 和分割表)到芯片中。通过命令 `make menuconfig` 可以配置串口。
  22. 运行 ``make flash`` 之前无需运行 ``make all``。运行 ``make flash`` 将自动重建烧录所需的一切。
  23. 仅编译和烧录应用程序
  24. ---------------------------------
  25. 在最初的烧录之后,用户可以仅创建烧录 app,不烧录 bootloader 和分区表:
  26. * ``make app`` - 仅创建应用程序。
  27. * ``make app-flash`` - 仅烧录应用程序。
  28. 需要时 ``make app-flash`` 指令将自动重建 app。
  29. 如果 bootloader 和分区表不变的话,对他们进行重新烧录并不会有负面影响。
  30. 分区表
  31. -------------------
  32. 编译完项目后,"build" 目录将包含一个名为 "my_app.bin" 的二进制文件。这是一个可由 bootloader 加载的 ESP32 映像二进制文件。
  33. 一个 ESP32 flash 可以包含多个应用程序,以及多种数据(校准数据,文件系统,参数存储等)。因此,分区表烧录在 flash 偏移地址 0x8000 的地方。
  34. 分区表中的每个条目都有一个名称(标签),类型(app,数据或其他),子类型和闪存中分区表被存放的偏移量。
  35. 使用分区表最简单的方法是 `make menuconfig` 并选择一个简单的预定义分区表:
  36. * "Single factory app, no OTA"
  37. * "Factory app, two OTA definitions"
  38. 在这两种情况下,出厂应用程序的烧录偏移为 0x10000。运行 `make partition_table`,可以打印分区表摘要。
  39. 更多关于 :doc:`分区表 <../api-guides/partition-tables>` 的信息,以及如何创建自定义分区表,可以查看 :doc:`文档 <../api-guides/partition-tables>`。