Skip to content

espressif/kicad-libraries

Repository files navigation

Espressif KiCad Library

Stars Forks 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 instalation 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 8.

For the KiCad legacy libraries, please use the following branch:

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.

SoC Symbol Footprint Resource
ESP32 Yes Yes Datasheet
ESP32-PICO-V3 Yes Yes Datasheet
ESP32-S2 Yes Yes Datasheet
ESP32-S3 Yes Yes Datasheet
ESP8684 (ESP32-C2) Yes Yes Datasheet
ESP32-C3 Yes Yes Datasheet
ESP8685 Yes Yes Datasheet
ESP32-C6 Yes Yes Datasheet
ESP32-H2 Yes Yes Datasheet
ESP8286 Yes Yes Datasheet
ESP8285 Yes Yes Datasheet
ESP32-P4 Yes Yes Datasheet

Modules

Module Symbol Footprint Resource
ESP32-WROOM-32E Yes Yes Datasheet
ESP32-WROOM-32UE Yes Yes Datasheet
ESP32-WROOM-DA Yes Yes Datasheet
ESP32-WROVER-E Yes Yes Datasheet
ESP32-MINI-1 Yes Yes Datasheet
ESP32-MINI-1U Yes Yes Datasheet
ESP32-C3-MINI-1 Yes Yes Datasheet
ESP32-C3-WROOM-02 Yes Yes Datasheet
ESP32-C6-MINI-1 Yes Yes Datasheet
ESP32-C6-MINI-1U Yes Yes Datasheet
ESP32-C6-WROOM-1 Yes Yes Datasheet
ESP32-C6-WROOM-1U Yes Yes Datasheet
ESP32-S2-MINI-1 Yes Yes Datasheet
ESP32-S2-MINI-1U Yes Yes Datasheet
ESP32-S2-SOLO Yes Yes Datasheet
ESP32-S2-SOLO-2U Yes Yes Datasheet
ESP32-S2-WROOM Yes Yes Datasheet
ESP32-S2-WROVER Yes Yes Datasheet
ESP32-S3-MINI-1 Yes Yes Datasheet
ESP32-S3-MINI-1U Yes Yes Datasheet
ESP32-S3-WROOM-1 Yes Yes Datasheet
ESP32-S3-WROOM-1U Yes Yes Datasheet
ESP32-S3-WROOM-2 Yes Yes Datasheet
ESP32-H2-MINI-1 Yes Yes Datasheet
ESP8685-WROOM-01 No No Datasheet
ESP8685-WROOM-03 No No Datasheet
ESP8685-WROOM-04 No No Datasheet
ESP8685-WROOM-05 No No Datasheet
ESP8685-WROOM-06 Yes Yes Datasheet

Development Boards

Dev Board Symbol Footprint Resource
ESP32-DevKitM-1 Yes Yes Schematic
ESP32-S2-Saola-1 Yes Yes Schematic
ESP32-S2-DevKitC-1 Yes Yes Schematic
ESP32-DevKitC Yes Yes Schematic
ESP32-S3-DevKitC Yes Yes Schematic
ESP32-S2-DevKitM Yes Yes Schematic
ESP32-C3-DevKitM Yes Yes Schematic
ESP32-C6-DevKitC-1 Yes Yes Schematic
ESP32-C6-DevKitM-1 Yes Yes Schematic

Manual Installation - PCM

The Espressif KiCad library is distributed via the Pluguin 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.

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.