espressif/esp-idf
1
0
Fork 1
mirror of https://github.com/espressif/esp-idf.git synced 2025-08-03 20:54:32 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: Separate "build and flash" into building then flashing

Browse Source 
Explains idf.py build as mentioned here: https://github.com/espressif/esp-idf/issues/1906#issuecomment-387557050
This commit is contained in:
Angus Gratton
2018-05-10 18:15:03 +08:00
committed by Angus Gratton
parent f07c1ca94f
commit 979568fa0b
2 changed files with 16 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
components/esp32/lib

Submodule components/esp32/lib updated: 8cd9fd455e...92a091649f

19
docs/en/get-started/index.rst
View File

@@ -247,18 +247,29 @@ Here are couple of tips on navigation and use of ``menuconfig``:
.. _get-started-build-flash: .. _get-started-build-flash:
Build and Flash Build The Project and Flash
=============== ===========================
.. highlight:: bash .. highlight:: bash
Now you can build and flash the application. Run:: Now you can build the project. Run::
idf.py build
This command will compile the application and all the ESP-IDF components, generate bootloader, partition table, and application binaries.
Flash To A Device
=================
Now you can flash the application to the ESP32 board. Run::
idf.py -p PORT flash idf.py -p PORT flash
Replace PORT with the name of your ESP32 board's serial port. On Windows, serial ports have names like ``COM1``. On MacOS, they start with ``/dev/cu.``. On Linux, they start with ``/dev/tty``. (See :doc:`establish-serial-connection` for full details.) Replace PORT with the name of your ESP32 board's serial port. On Windows, serial ports have names like ``COM1``. On MacOS, they start with ``/dev/cu.``. On Linux, they start with ``/dev/tty``. (See :doc:`establish-serial-connection` for full details.)
This will compile the application and all the ESP-IDF components, generate bootloader, partition table, and application binaries, and flash these binaries to your ESP32 board. This step will flash the binaries that you just built to your ESP32 board.
.. note:: Running ``idf.py build`` before ``idf.py flash`` is not actually necessary, the flash step will automatically build the project if required before flashing.
.. highlight:: none .. highlight:: none