<< Back Home UK uk   Donate Donate

Automated KiCad7 Symbol generation tool generates KiCad7 symbol files from simplified chip pinout description. Just specify chip name, size and describe pins one by one for each side. See example below

Input File Format Description

Component Name
  • Keyword: name:
  • Example: name: ESP32-WT32-S1
  • Description: Defines the component's name.
  • Keyword: prop:
  • Example: prop: Reference U
  • Description: Sets various properties, like reference, footprint, datasheet link, keywords, and description.
Font Size
  • Keyword: font:
  • Example: font: 1.27
  • Description: Specifies the font size for the component representation.
Step Size
  • Keyword: step:
  • Example: step: 2.54
  • Description: Defines the step size for calculating pin positions.
Component Size
  • Keyword: sizep:
  • Example: sizep: 17 17
  • Description: Specifies component width and height, calculated based on the step size.
Pin Side and Configuration
  • Keywords: side:, [Pin Name] [Pin Type]
  • Examples: side: L, GPIO36 i
  • Description: Sets the side for pin definitions and defines each pin with its name and type.
Direct Numbering
  • Keyword: num:
  • Example: num: 1
  • Description: Restarts pin numbering from the specified number, incrementing for each subsequent pin.
Reverse Numbering
  • Keyword: rnum:
  • Example: rnum: 31
  • Description: Restarts pin numbering from the specified number, decrementing for each subsequent pin.
Skipping Positions
  • Keyword: --
  • Description: Skips a single position without affecting the numbering.
Pin Types

Pin types can be specific KiCad keywords like 'input', 'output', 'bidirectional', etc., or shortcuts:

  • i for input
  • o for output
  • io for bidirectional
  • vin for power_in (also v)
  • n for passive (also -)
  • vout for power_out


Pins are positioned sequentially from top to bottom and left to right, following the order of their definition under each side: directive.


name: ESP32-WT32-S1

prop: Reference U
prop: Footprint RF_Module:ESP32-WT32-S1
prop: Datasheet
prop: ki_keywords RF Radio BT ESP ESP32 Espressif Ethernet external U.FL antenna
prop: ki_description RF Module, ESP32-D0WD SoC, Wi-Fi 802.11b/g/n, Bluetooth, BLE, Ethernet RMII, 32-bit, 2.7-3.6V, PCB antenna, SMD
prop: ki_fp_filters ESP32?WT32?S1*

font: 1.27
step: 2.54
sizep: 12 12

side: L
EN  input
GPIO36  i
GPIO38  i
GPIO39  i
GPIO34  i

GPIO37  i
GPIO35  i
GPIO32  i
GPIO33  i

GPIO25  io
GPIO26  io

side: B
GPIO27  io
GPIO14  io
GPIO12  io
GPIO13  io

GPIO15  io
GPIO2  io
GPIO0  io
GPIO4  io

GPIO16  io

side: R
rnum: 31
GPIO21  io

GPIO22  io
GPIO19  io
GPIO23  io
GPIO18  io

GPIO5  io
GPIO17  io
VDD  vin


python <input_file> > <output_file.kicad_sym>
python <input_file> <output_file.csv>


Download:, use Python 3.x


FB or mail (remove X)   Share
designed by Alter aka Alexander A. Telyatnikov powered by Apache+PHP under FBSD © 2002-2024