partition_editor.md

Using the partition editor

Let's open a ESP-IDF project. For this tutorial we will use the system/console example.

1. Click menu View -> Command Palette... and search for the ESP-IDF: Show Examples Projects command and choose Use current ESP-IDF (/path/to/esp-idf). If the user doesn't see the option, please review the setup in Install tutorial.

2. A window will be open with a list a projects, go the system section and choose the console. You will see a Create project using example console button in the top and a description of the project below. Click the button and choose the containing directory. The project will be opened in a new window.

3. Click menu View -> Command Palette... and search for the ESP-IDF: SDK Configuration editor command (CTRL E G keyboard shortcut ).

4. Search for partition_table_custom and select Custom partition table CSV from Partition Table and set the filename. It will search this file in your current project directory. (This is already configured in the example we are using.)

5. If the partition table file doesn't exists, when you execute the command the file will be created. But if the partition table file already exists, make sure that the first two lines of the partion table csv file are:

# ESP-IDF Partition Table
# Name, Type, SubType, Offset, Size, Flag

6. Once partition table editor is open, the user can edit the partition table as desired. For more information please refer to this article.

7. Once the user is satisfied press Save to save the changes, this will override the content of csv file.

8. Now you can click the Build & Flash button on the top-right, to build & flash the partition table to the chip.