marbastlib

A library collecting MX and Choc style footprints, as well as various other parts used to design custom keyboards. It is maintained by ebastler and Marble. Huge thanks to all of our users who test new footprints and notify us about bugs or issues and of course to our awesome contributors who commit components of their own!

The current latest release is made in/for KiCad 10.0 stable version. Older releases are still offered for KiCad 9.0, 8.0 and 7.0 stable versions by the PCM but may lack components and/or bugfixes as no features or fixes are being backported. Older KiCad versions are no longer supported by the main branch, please refer to one of the v6 branches for KiCad 6.x, and my (significantly smaller) legacy lib for KiCad 5.x.

We try to offer 3D models for as many footprints in this library as possible, creating our own models where none exist. All components for which we have models available have them linked into the footprint - the PCM version will automatically download everything in the right file paths.

Disclaimer

We do not assume any responsibility for broken PCBs or damages derived from errors in this library. Use at your own risk, and please open an issue or pull-request if you encounter any errors.

Please do not use any footprint from this library with a symbol from another library (or the other way round). Pin numbering conventions are not always the same, and unless you check very carefully this can lead to broken PCBs.

How to install

Open the KiCad "Plugin and Content Manager" (referred to as "PCM" from now on) and click on "Manage". Add a new entry with the plus sign and paste

https://raw.githubusercontent.com/ebastler/ebastler-KiCad-repository/main/repository.json

From this point on you will have "ebastler KiCad repository" in your drop-down selection, and it will allow you to install (and update) marbastlib through PCM - easy and hassle-free.

Symbol Libs

marbastlib-mx

• MX_SW_solder - switch symbol with pre-assigned 1u solder footprint
• MX_SW_HS_CPG151101S11 - switch symbol with pre-assigned 1u Kailh CPG151101S11 hotswap footprint
• MX_SW_HS_KS-2P02B01-01 - switch symbol with pre-assigned 1u Gateron KS-2P02B01-01 hotswap footprint
• MX_Stab - a symbol used to place keyboard stabilizers. Pre-assigned 6.25u stabilizer.
• MX_SK6812MINI-E - symbol with preassigned footprint for reverse mount addressable SK6812MINI-E RGB LEDs
• MX_LED_6028R - symbol with preassigned footprint for reverse mount 6028 RGB LEDs
• MX_LED_MHT151RGBCT - symbol with preassigned footprint for MHT151RGBCT LEDs

marbastlib-choc

• choc_v1_SW_solder - switch symbol with pre-assigned 1u solder footprint
• choc_v1_SW_HS_CPG135001S30 - switch symbol with pre-assigned 1u Kailh CPG135001S30 hotswap footprint
• choc_Stab - a symbol used to place keyboard stabilizers. Pre-assigned 2u stabilizer.
• choc_SK6812MINI-E - symbol with preassigned footprint for reverse mount addressable SK6812MINI-E RGB LEDs
• choc_LED_6028R - symbol with preassigned footprint for reverse mount 6028 RGB LEDs
• choc_LED_MHT151RGBCT - symbol with preassigned footprint for MHT151RGBCT LEDs

marbastlib-gatlp

• KS33_SW_solder - switch symbol with pre-assigned 1u solder footprint
• KS33_SW_HS_CPG135001S30 - switch symbol with pre-assigned 1u Gateron KS-2P02B01-02 hotswap footprint
• KS33_SK6812MINI-E - symbol with preassigned footprint for reverse mount addressable SK6812MINI-E RGB LEDs
• KS33_LED_6028R - symbol with preassigned footprint for reverse mount 6028 RGB LEDs
• KS33_LED_MHT151RGBCT - symbol with preassigned footprint for MHT151RGBCT LEDs

marbastlib-he

• SW_MX_HE - symbol for Gateron Magnetic Jade and compatible (MX style) hall effect switches with SOT-23-3 hall effect sensors. Defaults to HAL9303SO

marbastlib-various

• AP2317QD - 3.3x3.3mm DFN8 dual power MOSFET. Datasheet
• BAV70_Small - a smaller version of the regular BAV70 symbol (easier to use in keyboard matrices)
• DMP1022UFDF - very small p-ch FET, -9.5A, -12V DMP1022UFDF
• DW01A - a cheap and easily available 1S battery protection chip
• FS8205 - a dual MOSFET used in the DW01A ref implementation
• FE1.1 - a 4 port USB 2.0 High-Speed (480 Mbit/s) hub with multiple transaction translator
• FUSB303B - Standalone USB Type-C dual role port controller with I2C and GPIO control
• FUSB301A - Autonomous USB Type-C Controller with Configurable I2C Address
• IS31FL3741A - a 39x9 i2c LED multiplex driver
• AW20216SQNR - a 18x12 SPI LED multiplex driver
• AW20108QNR - a 9x12 SPI LED multiplex driver
• AW88082QNR - 3.1 W Digital Input mono Digital Smart K Audio Amplifier with I2C control interface
• joystick_analog - symbol for a analog, dual pot thumbstick, comes pre-assigned with a PSP-1000 thumbstick footprint
• LED_6028R - symbol with preassigned footprint for reverse mount 6028 RGB LEDs
• BQ25628 - I²C-controlled, 18-V max input 2-A single-cell battery charger with boost mode and ADC
• BQ27427 - Single-cell battery fuel gauge with pre-programmed chemistry and integrated sense resistor
• IQS318xxxQFR - Standalone and I2C sensing device for single-channel proximity or touch-sensing requirements
• LED_MHT151RGBCT - symbol with preassigned footprint for MHT151RGBCT LEDs
• MA782 - Ultra-Small, Low-Power Angle Sensor with Integrated Wake-Up Angle Detection
• MAX17048 - a small shunt-less fuel gauge by Maxim Integrated
• MAX77751 - a 1S LiIon battery management chip
• MAX77757 - a 1S LiIon battery management chip
• MCP1711T-xxI-5X - 150 mA Ultra-Low Quiescent Current, Capacitorless LDO Regulator
• MP2722 - a 1S LiIon battery management chip
• MP3431 - Synchronous boost converter, 2.7 to 13Vin, 16 Vout, 30-40W
• nRF52840_holyiot_18010 - a symbol for the holyiot 18010 nRF52840 BLE module
• nRF52840_moko_mk08 - a symbol for the Moko MK08 nRF52840 BLE module
• nRF52840_E73-2G4M08S1C - a symbol for the EBYTE E73-2G4M08S1C nRF52840 BLE module
• OPT3004DNPR - Digital ambient light sensor (ALS) with increased angular IR rejection
• PI3USB102EZLEX - a high-speed diffpair 1x2 MUX
• SK6812MINI-E - symbol with preassigned footprint for reverse mount addressable SK6812MINI-E RGB LEDs
• SRV05-4 - symbol with attached footprint of the popular SRV05 - difference to default: pad spacing is large enough to allow 2 traces between them
• STM32WB5MMG - a small form factor package including STM32WB chip and antenna
• TAS2110 - 6.1W mono digital input Class-D speaker amp with integrated 11V Class-H boost
• TC2030_AVR - symbol for AVR ISP programming connector with pre-assigned TC2030 footprint
• TC2030_JTAG - symbol for JTAG programming connector with pre-assigned TC2030 footprint
• TCA9543A - Low Voltage 2-Channel I2C Bus Switch With Interrupt Logic And Reset
• TPS25961 - 2.7-V to 19-V 100-mΩ eFuse with overvoltage, overcurrent and short-circuit protection
• TP4056 - a cheap and easily available 1S battery charging chip
• TXB0101 - a bidirectional levelshifter
• WS2812_2020 - symbol with preassigned footprint for WS2812B-2020 and WS2812C-2020
• WS2812_4020 - symbol with preassigned footprint for WS2812B-4020 side-firing LED
• WSD4070DN - high power n-ch FET, 68A, 40V: WSD4070DN
• ROT_SKYLOON_HS-Swicth - symbol for a Skyloon MX-footprint-compatible rotary encoder

marbastlib-promicroish

• Arduino_ProMicro - symbol for Arduino Pro Micro controller
• Elite-C - symbol for Elite-C controller
• Helios - symbol for 0xCB Helios controller
• Pluto - symbol for 0xCB Pluto controller
• Liatris - symbol for Splitkb Liatris controller
• nice_nano - symbol for nicekeyboards nice!nano Bluetooth controller
• seeeduino Xiao nRF52840 - symbol for Seeed Studio Xiao nRF52840 Bluetooth controller
• seeeduino Xiao rp2040 - symbol for Seeed Studio Xiao rp2040 controller
• RP2040-Matrix - symbol for a Waveshare rp2040 based controller board with 25 pixel WS2812 LED matrix

Footprint libs

Unlike previous versions of marbastlib, were main, untested and specialty were separate libraries, now all footprints were merged into a single repository, but separate libraries. marbastlib-choc (to pick one example) is the new equivalent to main/stable, while marbastlib-xp-choc ("xp" stands for "experimental", but also makes sure the xp libs end up on the bottom of the list) join specialty and untested into one library. Please use anything in a "xp" library with special care, and report back to us once a footprint in such a lib has been successfully tested, so it can be moved into the regular libs.

marbastlib-choc

All switch and stab footprints in this lib include plate cuts on User.Eco2, as well as placement hints for both choc (User.Eco1) and MX (User.Drawings) switch spacing. LED and Stab footprints are n