==== ESP-IDF ====

EPS32 development environment.

Previously tested on Raspberry Pi 3 (armv7l / python 3.7.3)

Recently tested on Raspberry Pi 400 (aarch64 / python 3.9.2).

ESP-IDF is truly awful.

=== Setup ===

Install various dependencies.

<code>
apt update
apt full-upgrade
apt install build-essential cmake git wget flex bison gperf python3 python3-venv python3-pip python3-setuptools python3-pyparsing ninja-build ccache libffi-dev libssl-dev dfu-util
</code>

Debian bullseye has python 3 but on buster python 3 will need to be the default version.

<code>
update-alternatives --remove-all python
update-alternatives --install /usr/bin/python python /usr/bin/python3 2
update-alternatives --install /usr/bin/python python /usr/bin/python2 1
update-alternatives --config python
python -V
Python 3.7.3
</code>

=== User ===

Create a user for the home of the dev kit.

<code>
useradd -d /home/esp -m esp
</code>

Append paths to .profile

<code>
vi ~esp/.profile
</code>

<code>
IDF_PATH="$HOME/esp-idf"
IDF_TOOLS_PATH="$HOME/esp-idf"
</code>


=== Install===

Login as user esp

<code>
/bin/su - esp
</code>

Clone dev kit into home dir.

<code>
git clone --recursive https://github.com/espressif/esp-idf
</code>

Run installation script.

<code>
cd esp-idf
sh install.sh
</code>

Finalise installation

<code>
. ~/esp-idf/export.sh
</code>

If it complains about openocd...

<code>
/usr/bin/python3 /home/esp/esp-idf/tools/idf_tools.py export --prefer-system
</code>

Save the configuration

<code>
echo ". ~/esp-idf/export.sh" >> ~/.profile
</code>

Logout from user esp

<code>
exit
</code>

===Test===

Login as user esp

<code>
/bin/su - esp
</code>

Enter the hello world example dir

<code>
cd ~/esp-idf/examples/get-started/hello_world 
</code>

Build

<code>
idf.py build
</code>

=== Resources ===

[[https://www.espressif.com/sites/default/files/documentation/esp32_technical_reference_manual_en.pdf|MCU reference manual]]

[[https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/index.html|Get Started with ESP-IDF]]

[[https://docs.espressif.com/projects/esp-idf/en/latest/esp32/get-started/linux-macos-setup.html#get-started-linux-macos-first-steps|First project with ESP-IDF]]