https://github.com/espressif/esp32-arduino-lib-builder

https://github.com/espressif/esp32-arduino-lib-builder

Last synced: 2 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/espressif/esp32-arduino-lib-builder
• Owner: espressif
• Created: 2019-03-12T11:01:28.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-05-22T13:32:14.000Z (4 months ago)
• Last Synced: 2024-05-22T14:47:33.911Z (4 months ago)
• Language: C
• Size: 459 KB
• Stars: 129
• Watchers: 11
• Forks: 133
• Open Issues: 25
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# ESP32 Arduino Lib Builder [![ESP32 Arduino Libs CI](https://github.com/espressif/esp32-arduino-lib-builder/actions/workflows/push.yml/badge.svg)](https://github.com/espressif/esp32-arduino-lib-builder/actions/workflows/push.yml)

This repository contains the scripts that produce the libraries included with esp32-arduino.

Tested on Ubuntu (32 and 64 bit), Raspberry Pi and MacOS.

### Build on Ubuntu and Raspberry Pi

```bash

sudo apt-get install git wget curl libssl-dev libncurses-dev flex bison gperf python python-pip python-setuptools python-serial python-click python-cryptography python-future python-pyparsing python-pyelftools cmake ninja-build ccache jq

sudo pip install --upgrade pip

git clone https://github.com/espressif/esp32-arduino-lib-builder

cd esp32-arduino-lib-builder

./build.sh

```

### Using the User Interface

You can more easily build the libraries using the user interface found in the `tools/config_editor/` folder.

It is a Python script that allows you to select and edit the options for the libraries you want to build.

The script has mouse support and can also be pre-configured using the same command line arguments as the `build.sh` script.

For more information and troubleshooting, please refer to the [UI README](tools/config_editor/README.md).

To use it, follow these steps:

1. Make sure you have the following prerequisites:

  - Python 3.9 or later

  - All the dependencies listed in the previous section

2. Install the required UI packages using `pip install -r tools/config_editor/requirements.txt`.

3. Execute the script `tools/config_editor/app.py` from any folder. It will automatically detect the path to the root of the repository.

4. Configure the compilation and ESP-IDF options as desired.

5. Click on the "Compile Static Libraries" button to start the compilation process.

6. The script will show the compilation output in a new screen. Note that the compilation process can take many hours, depending on the number of libraries selected and the options chosen.

7. If the compilation is successful and the option to copy the libraries to the Arduino Core folder is enabled, it will already be available for use in the Arduino IDE. Otherwise, you can find the compiled libraries in the `esp32-arduino-libs` folder alongside this repository.

  - Note that the copy operation doesn't currently support the core downloaded from the Arduino IDE Boards Manager, only the manual installation from the [`arduino-esp32`](https://github.com/espressif/arduino-esp32) repository.

### Documentation

For more information about how to use the Library builder, please refer to this [Documentation page](https://docs.espressif.com/projects/arduino-esp32/en/latest/lib_builder.html?highlight=lib%20builder)