Code Monkey home page Code Monkey logo

kicad-libraries's Introduction

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

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.

kicad-libraries's People

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

kicad-libraries's Issues

Adherence to KiCad Library Conventions

Hello,

Can I find out if there are plans to have the symbols to adhere to the KiCad Library Conventions? The two specifically I've noticed on the ESP32-WROOM-E:

  • S4.1, point 1, where the pin origin should lie on a 100mil grid
  • S4.3, point 3, where pins of the same type (mostly GND) should be stacked together

ESP32-C3-MINI-1 missing pin 11 & 14

I keep getting errors for missing pin 11/14.

Warning: No net found for symbol U1 pin 14.
Warning: No net found for symbol U1 pin 11.

Upon inspecting the schematic symbol I think these pins are missing and should be with the rest of the ground pins:

Screenshot from 2023-01-07 08-37-20

Plans for ESP32-C6-MINI-1U?

The ESP32-C6-MINI-1 has a symbol/footprint, however there does not appear to be a footprint for the U variant of this module. Were there plans to add this?

New release?

When will the new release be? Or should I just download the latest main branch? Thank you.

Models for ESP32-S3-MINI-1U and ESP8684-MINI-1-H4

Hi guys, would it be possible to update this repo with the latest step files for S3 and C2, please?
Those are the modules we've recently bought and can't find them in the repo.
No rush neither an impediment in getting PCB done.
Would be nice to have that's all.
Thanks

ESP32-S3-MINI-1U
ESP8684-MINI-1-H4
ESP8684-WROOM-01C-H4

Can't open footprint lib

Environment

Application: KiCad
Version: 5.1.8-5.1.8, release build
Libraries:
wxWidgets 3.0.3
libcurl/7.66.0 OpenSSL/1.1.1d-fips zlib/1.2.11 libidn2/2.2.0 libpsl/0.20.1 (+libidn2/2.2.0) libssh/0.8.7/openssl/zlib nghttp2/1.40.0
Platform: Linux 5.3.18-lp152.78-default x86_64, 64 bit, Little endian, wxGTK
Build Info:
wxWidgets: 3.0.3 (wchar_t,STL containers,compatible with 2.8) GTK+ 2.24
Boost: 1.66.0
OpenCASCADE Technology: 7.3.0
Curl: 7.66.0
Compiler: GCC 7.5.0 with C++ ABI 1011

Build settings:
USE_WX_GRAPHICS_CONTEXT=OFF
USE_WX_OVERLAY=OFF
KICAD_SCRIPTING=ON
KICAD_SCRIPTING_MODULES=ON
KICAD_SCRIPTING_PYTHON3=OFF
KICAD_SCRIPTING_WXPYTHON=ON
KICAD_SCRIPTING_WXPYTHON_PHOENIX=OFF
KICAD_SCRIPTING_ACTION_MENU=ON
BUILD_GITHUB_PLUGIN=ON
KICAD_USE_OCE=OFF
KICAD_USE_OCC=ON
KICAD_SPICE=ON

Description

I can't open the footprint Dev_ESP32-S2-Saola-1.kicad_mod on commit c8e7b4fa07bac0. I guess the version is not compatible. Which version of kicad is used for testing?

Following is the error prompt:

11:27:22 AM: file '~/Desktop/kicad-libraries/footprints/Espressif.pretty/Dev_ESP32-S2-Saola-1.kicad_mod', line 1: '=' expected.
11:27:22 AM: file '~/Desktop/kicad-libraries/footprints/Espressif.pretty/Dev_ESP32-S2-Saola-1.kicad_mod', line 2: '=' expected.
11:27:22 AM: file '~/Desktop/kicad-libraries/footprints/Espressif.pretty/Dev_ESP32-S2-Saola-1.kicad_mod', line 3: '=' expected.
11:27:22 AM: file '~/Desktop/kicad-libraries/footprints/Espressif.pretty/Dev_ESP32-S2-Saola-1.kicad_mod', line 4: '=' expected.
11:27:22 AM: file '~/Desktop/kicad-libraries/footprints/Espressif.pretty/Dev_ESP32-S2-Saola-1.kicad_mod', line 5: '=' expected.
11:27:22 AM: file '~/Desktop/kicad-libraries/footprints/Espressif.pretty/Dev_ESP32-S2-Saola-1.kicad_mod', line 6: '=' expected.
11:27:22 AM: file '~/Desktop/kicad-libraries/footprints/Espressif.pretty/Dev_ESP32-S2-Saola-1.kicad_mod', line 7: '=' expected.

Omit similar logs

Feature Request: Add KICAD Library to Offical PCM (Package and Plugin Manager)

Kicad PCM (Plugin and Content Manager) Feature Request

Kicad now provides the possibility to add custom footprint / content libraries to a Plugin Manager. This provide the users the possibility to simple install Offical released versions of your content library. It also helps you to be one of the first "microcontroller" on the platform that also means that you can arrive more and new customers.

Here an screenshot of the library manager, which i think is one of the biggest new features:

Bildschirmfoto 2022-12-07 um 22 03 51

The documentation is simple to understand: https://dev-docs.kicad.org/en/addons/

I would love to see this package in the plugin manager in the future. I maybe also can help a little bit if you don't have the time to do that.

Thank you very much.

Linux install

Hi all

I try to install on KiCad : The last version on Linux but it's does not wok any idea please
Regards

Application: KiCad

Version: 6.0.8+dfsg-1~bpo11+1+rpt1, release build

Libraries:
wxWidgets 3.0.5
libcurl/7.74.0 OpenSSL/1.1.1n zlib/1.2.11 brotli/1.0.9 libidn2/2.3.0 libpsl/0.21.0 (+libidn2/2.3.0) libssh2/1.9.0 nghttp2/1.43.0 librtmp/2.3

Platform: Linux 6.1.21-v8+ aarch64, 64 bit, Little endian, wxGTK, lightdm-xsession, x11

Build Info:
Date: Oct 7 2022 14:52:26
wxWidgets: 3.0.5 (wchar_t,wx containers,compatible with 2.8) GTK+ 3.24
Boost: 1.74.0
OCC: 7.5.1
Curl: 7.74.0
ngspice: 34
Compiler: GCC 10.2.1 with C++ ABI 1014

Build settings:
KICAD_USE_OCC=ON
KICAD_SPICE=ON

Document how to get 3D models working correctly

I see the 3d models in the repository, but they are not referenced correctly in the footprint files. There seems to be a missing ${ESPRESSIF_3DMODELS} definition in the path. This should be documented in the README as part of installation instructions.

Ideally, there would be a default relative path that would work without any further setup, but I don't think Kicad5 has a facility for this.

ESP32-C3-WROOM-02U 3D model

Would be great to have a 3D model (step) for the -02U module (without PCB antenna)
as well as we are just implementing it in a commercial design - thank you a lot.

Keepout zones over antenna regions

In the datasheets for various modules one can find that there is a keepout zone where the antenna is, this makes sense. However, I don't see such a keepout zone in the footprints. Is this for a specific reason I'm not seeing? If it isn't, it might be a good addition to the footprints.

Prepare KiCad 6 port

Prepare libraries to KiCad 6.

  • Test current libraries.
  • Convert to KiCad 6.
  • Test

ESP32-S3-WROOM2

Any chance we can expect the WROOM2 versions of the S3 modules any time soon? From what I've seen they have slightly rearranged ground pads in the middle compared to the WROOM1.

Please add ESP-C3-32S

Not sure if this is the right way to ask for it but I was hoping to see footprints for the ESP-C3-32S.

Please add a footprint for that chip (38p with 0.05mm less bottom space than the other WROOMS)

ESP32-S3-WROOM-1U Symbol

I noticed there is no dedicated symbol for ESP32-S3-WROOM-1U.
Are we supposed to just choose the ESP32-S3-WROOM-1 (without U) symbol and change the footprint to ESP32-S3-WROOM-1U? It does seem to work.

Just trying to clarify whether intentional or not.

esp32-mini-1 symbol / footprint

Hi,

I'm working on a project that incorporates the esp32-mini-1, and I was wondering if there is a KiCad symbol / footprint available for that module? I don't see one in this repository, but I would be happy to make one if there is a similar module I can copy from.

Any help would be greatly appreciated.

Thanks!

add WT32-S3-WROVER please

Hi,
Can you add WT32-S3-WROVER please?
The S2 seam not pin to pin compatible. I search in particular WT32-S3-WROVER-N4
image

WROOM and WROVER symbols are swapped

The ESP32-WROOM-E and ESP32-WROVER-E symbols seems to be swapped. This can be verified by looking at GPIO16 & GPIO17. On WROVER these should be NC (due to PSRAM) but are connected. On WROOM these should be connect but marked NC.

README is confusing

It's not clear when you arrive on the GitHub page for this library where the referenced footprints and symbols are.

I suggest that either:

The README.md should be updated to reference the appropriate branches
or

Include the 5.0-compatible files in the Main branch and leave the 6.0 versions in a branch to be merged later (after 6.0 is released)

or

Include folders for each major version of KiCAD in the Main branch

Espressif.kicad_sym is too new for KiCad 6

It looks like #75 potentially inadvertently updated the symbol library file version from 20211014 to 20220914. This is newer than KiCad 6 and prevents the library from being used in KiCad 6, which contradicts the README: "The libraries in this repository are intended to be used with KiCad version 6."

https://github.com/espressif/kicad-libraries/pull/75/files#diff-6baf09fc71704e53002684da5f4d513448f657a453d74b5e3561ae2046c733cdL1

I'm able to load the library if I manually change the version back to 20211014, though I'm not sure if that PR included any other changes to the file that rely on newer KiCad behavior, so I'm not certain it's completely safe to revert just the version.

Thermal pads of ESP32-WROOM-E at wrong location?

Hi,

Our PCBA house noted a mismatch (both in X and Y location as size) between the thermal pads of ESP32-WROOM-E in this library and the datasheet (in red):
image

Footprint 8.32mm to center of thermal pads:
image

Datasheet 7.5mm to center of thermal pads:
image

Same applies in the vertical direction and the size of the pads themselves.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.