espressif/kicad-libraries

KiCad libraries for Espressif SoCs, modules, and DevKits.

Python

1,407

148 commits

updated Jul 28, 2026

See the code

README

Espressif KiCad Library

Stars Issues Downloads

Notice: A major update from version 1.0.1 was made to be compliant to the KLC. Please consider updating your library and checking the symbols and footprints.

From the version 2.0.0, the library installation process is done by the PCM.

This repository contains the Symbols, Footprint, and 3D Models for the Espressif SoC and Modules family.

  • Notice: The libraries are provided in the hope that they will be useful but without a warranty of any kind.

The libraries in this repository are intended to be used with KiCad version 10

Each footprint library is stored as a directory with the .pretty suffix. The footprint files are .kicad_mod files within.

Hardware Design Guidelines

Before designing your hardware, be sure to check all recommendations at:

Symbols and Footprints

All footprints were designed according to the Recommended PCB Land Pattern section present on each module datasheet.

SoC

The following SoC are included in this library

Please note: The footprints in this table are only available when the official KiCad library is installed as the symbols rely on its footprints.

SoCSymbolFootprintResource
ESP32YesYesDatasheet
ESP32-PICO-V3YesYesDatasheet
ESP32-S2YesYesDatasheet
ESP32-S3YesYesDatasheet
ESP8684 (ESP32-C2)YesYesDatasheet
ESP32-C3YesYesDatasheet
ESP8685YesYesDatasheet
ESP32-C6YesYesDatasheet
ESP32-H2YesYesDatasheet
ESP8286YesYesDatasheet
ESP8285YesYesDatasheet
ESP32-P4 (EOL)YesYes
ESP32-P4XYesYesDatasheet

Modules

ModuleSymbolFootprintResource
ESP32-WROOM-32EYesYesDatasheet
ESP32-WROOM-32UEYesYesDatasheet
ESP32-WROOM-DAYesYesDatasheet
ESP32-WROVER-EYesYesDatasheet
ESP32-MINI-1YesYesDatasheet
ESP32-MINI-1UYesYesDatasheet
ESP32-C3-MINI-1YesYesDatasheet
ESP32-C3-WROOM-02YesYesDatasheet
ESP32-C5-MINI-1YesYesDatasheet
ESP32-C5-WROOM-1YesYesDatasheet
ESP32-C5-WROOM-1UYesYesDatasheet
ESP32-C6-MINI-1YesYesDatasheet
ESP32-C6-MINI-1UYesYesDatasheet
ESP32-C6-WROOM-1YesYesDatasheet
ESP32-C6-WROOM-1UYesYesDatasheet
ESP32-S2-MINI-1YesYesDatasheet
ESP32-S2-MINI-1UYesYesDatasheet
ESP32-S2-SOLOYesYesDatasheet
ESP32-S2-SOLO-2UYesYesDatasheet
ESP32-S2-WROOMYesYesDatasheet
ESP32-S2-WROVERYesYesDatasheet
ESP32-S3-MINI-1YesYesDatasheet
ESP32-S3-MINI-1UYesYesDatasheet
ESP32-S3-WROOM-1YesYesDatasheet
ESP32-S3-WROOM-1UYesYesDatasheet
ESP32-S3-WROOM-2YesYesDatasheet
ESP32-S31-WROOM-3YesYesDatasheet
ESP32-H2-MINI-1YesYesDatasheet
ESP32-H2-MINI-1UYesYesDatasheet
ESP8684-WROOM-02CYesYesDatasheet
ESP8684-WROOM-01UCYesYesDatasheet
ESP8685-WROOM-01NoNoDatasheet
ESP8685-WROOM-03NoNoDatasheet
ESP8685-WROOM-04NoNoDatasheet
ESP8685-WROOM-05NoYesDatasheet
ESP8685-WROOM-06YesYesDatasheet

Development Boards

Dev BoardSymbolFootprintResource
ESP32-DevKitM-1YesYesSchematic
ESP32-S2-Saola-1YesYesSchematic
ESP32-S2-DevKitC-1YesYesSchematic
ESP32-DevKitCYesYesSchematic
ESP32-S3-DevKitCYesYesSchematic
ESP32-S2-DevKitMYesYesSchematic
ESP32-C3-DevKitMYesYesSchematic
ESP32-C5-DevKitC-1YesYesSchematic
ESP32-C6-DevKitC-1YesYesSchematic
ESP32-C6-DevKitM-1YesYesSchematic

Manual Installation - PCM

The Espressif KiCad library is distributed via the Plug-in and Content Manager (PCM) and the installation is done automatically.

To install the library, you need to download the espressif-kicad-addon.zip file from the latest release. For legacy support, please visit the legacy branch and follow the instructions from there.

Download here the latest library!

Make sure to download the correct zip file and do not extract the files. If you are using macOS and Safari, ensure to that the automatic unzip feature (Open safe files after downloading) is disabled.

For KiCad 6, 7 and 8 you can use the following steps:

  1. On KiCad, open the PCM in the main KiCad window.

First Step

  1. The PCM window will display a list of available plugins, libraries, and color themes. You can browse through the categories or use the search bar to find a specific package.

First Step

  1. To install the library manually using the ZIP file from the latest release, you need to select the file from "Install from file..."

First Step

  1. Once the package is installed, you will see the Espressif Library listed on the Installed tab.

First Step

  1. Now you are ready to use the library. Note that the library will be listed as PCM_Espressif in the Symbol and Footprint.

Contributing

If you want to contribute, please consider sending us a Pull Request (PR).

About KiCad

KiCad is a Cross-Platform and Open Source Electronics Design Automation Suite. See KiCad EDA for more information.

espressif
footprint
kicad
symbols

espressif/kicad-libraries

KiCad libraries for Espressif SoCs, modules, and DevKits.

Python

1,407

148 commits

updated Jul 28, 2026

See the code

README

Espressif KiCad Library

Stars Issues Downloads

Notice: A major update from version 1.0.1 was made to be compliant to the KLC. Please consider updating your library and checking the symbols and footprints.

From the version 2.0.0, the library installation process is done by the PCM.

This repository contains the Symbols, Footprint, and 3D Models for the Espressif SoC and Modules family.

  • Notice: The libraries are provided in the hope that they will be useful but without a warranty of any kind.

The libraries in this repository are intended to be used with KiCad version 10

Each footprint library is stored as a directory with the .pretty suffix. The footprint files are .kicad_mod files within.

Hardware Design Guidelines

Before designing your hardware, be sure to check all recommendations at:

Symbols and Footprints

All footprints were designed according to the Recommended PCB Land Pattern section present on each module datasheet.

SoC

The following SoC are included in this library

Please note: The footprints in this table are only available when the official KiCad library is installed as the symbols rely on its footprints.

SoCSymbolFootprintResource
ESP32YesYesDatasheet
ESP32-PICO-V3YesYesDatasheet
ESP32-S2YesYesDatasheet
ESP32-S3YesYesDatasheet
ESP8684 (ESP32-C2)YesYesDatasheet
ESP32-C3YesYesDatasheet
ESP8685YesYesDatasheet
ESP32-C6YesYesDatasheet
ESP32-H2YesYesDatasheet
ESP8286YesYesDatasheet
ESP8285YesYesDatasheet
ESP32-P4 (EOL)YesYes
ESP32-P4XYesYesDatasheet

Modules

ModuleSymbolFootprintResource
ESP32-WROOM-32EYesYesDatasheet
ESP32-WROOM-32UEYesYesDatasheet
ESP32-WROOM-DAYesYesDatasheet
ESP32-WROVER-EYesYesDatasheet
ESP32-MINI-1YesYesDatasheet
ESP32-MINI-1UYesYesDatasheet
ESP32-C3-MINI-1YesYesDatasheet
ESP32-C3-WROOM-02YesYesDatasheet
ESP32-C5-MINI-1YesYesDatasheet
ESP32-C5-WROOM-1YesYesDatasheet
ESP32-C5-WROOM-1UYesYesDatasheet
ESP32-C6-MINI-1YesYesDatasheet
ESP32-C6-MINI-1UYesYesDatasheet
ESP32-C6-WROOM-1YesYesDatasheet
ESP32-C6-WROOM-1UYesYesDatasheet
ESP32-S2-MINI-1YesYesDatasheet
ESP32-S2-MINI-1UYesYesDatasheet
ESP32-S2-SOLOYesYesDatasheet
ESP32-S2-SOLO-2UYesYesDatasheet
ESP32-S2-WROOMYesYesDatasheet
ESP32-S2-WROVERYesYesDatasheet
ESP32-S3-MINI-1YesYesDatasheet
ESP32-S3-MINI-1UYesYesDatasheet
ESP32-S3-WROOM-1YesYesDatasheet
ESP32-S3-WROOM-1UYesYesDatasheet
ESP32-S3-WROOM-2YesYesDatasheet
ESP32-S31-WROOM-3YesYesDatasheet
ESP32-H2-MINI-1YesYesDatasheet
ESP32-H2-MINI-1UYesYesDatasheet
ESP8684-WROOM-02CYesYesDatasheet
ESP8684-WROOM-01UCYesYesDatasheet
ESP8685-WROOM-01NoNoDatasheet
ESP8685-WROOM-03NoNoDatasheet
ESP8685-WROOM-04NoNoDatasheet
ESP8685-WROOM-05NoYesDatasheet
ESP8685-WROOM-06YesYesDatasheet

Development Boards

Dev BoardSymbolFootprintResource
ESP32-DevKitM-1YesYesSchematic
ESP32-S2-Saola-1YesYesSchematic
ESP32-S2-DevKitC-1YesYesSchematic
ESP32-DevKitCYesYesSchematic
ESP32-S3-DevKitCYesYesSchematic
ESP32-S2-DevKitMYesYesSchematic
ESP32-C3-DevKitMYesYesSchematic
ESP32-C5-DevKitC-1YesYesSchematic
ESP32-C6-DevKitC-1YesYesSchematic
ESP32-C6-DevKitM-1YesYesSchematic

Manual Installation - PCM

The Espressif KiCad library is distributed via the Plug-in and Content Manager (PCM) and the installation is done automatically.

To install the library, you need to download the espressif-kicad-addon.zip file from the latest release. For legacy support, please visit the legacy branch and follow the instructions from there.

Download here the latest library!

Make sure to download the correct zip file and do not extract the files. If you are using macOS and Safari, ensure to that the automatic unzip feature (Open safe files after downloading) is disabled.

For KiCad 6, 7 and 8 you can use the following steps:

  1. On KiCad, open the PCM in the main KiCad window.

First Step

  1. The PCM window will display a list of available plugins, libraries, and color themes. You can browse through the categories or use the search bar to find a specific package.

First Step

  1. To install the library manually using the ZIP file from the latest release, you need to select the file from "Install from file..."

First Step

  1. Once the package is installed, you will see the Espressif Library listed on the Installed tab.

First Step

  1. Now you are ready to use the library. Note that the library will be listed as PCM_Espressif in the Symbol and Footprint.

Contributing

If you want to contribute, please consider sending us a Pull Request (PR).

About KiCad

KiCad is a Cross-Platform and Open Source Electronics Design Automation Suite. See KiCad EDA for more information.

espressif
footprint
kicad
symbols

Significant stargazers

Nathan Broadbent

365 followers · starred May 2025

samy kamkar

11,918 followers · starred Aug 2026

Variant9

712 followers · starred May 2026

Xing

441 followers · starred Oct 2021