786 lines
36 KiB
YAML
786 lines
36 KiB
YAML
kiplot:
|
|
version: 1
|
|
|
|
preflight:
|
|
# [boolean=false] Zones are filled before doing any operation involving PCB layers
|
|
check_zone_fills: true
|
|
# [list(dict)] A list of entries to filter out ERC/DRC messages
|
|
filters:
|
|
- filter: 'Filter description'
|
|
number: 10
|
|
regex: 'Regular expression to match'
|
|
# [boolean=false] Option for `run_drc`. Ignores the unconnected nets. Useful if you didn't finish the routing
|
|
ignore_unconnected: false
|
|
# [boolean=false] Runs the DRC (Distance Rules Check). To ensure we have a valid PCB
|
|
run_drc: true
|
|
# [boolean=false] Runs the ERC (Electrical Rules Check). To ensure the schematic is electrically correct
|
|
run_erc: true
|
|
# [boolean=false] Update the XML version of the BoM (Bill of Materials). To ensure our generated BoM is up to date
|
|
update_xml: true
|
|
|
|
outputs:
|
|
# BoM (Bill of Materials):
|
|
# Is compatible with KiBoM, but doesn't need to update the XML netlist because the components
|
|
# are loaded from the schematic.
|
|
# Important differences with KiBoM output:
|
|
# - All options are in the main `options` section, not in `conf` subsection.
|
|
# - The `Component` column is named `Row` and works just like any other column.
|
|
# This output is what you get from the 'Tools/Generate Bill of Materials' menu in eeschema.
|
|
- name: 'bom_example'
|
|
comment: 'Used to generate the BoM in CSV, HTML, TSV, TXT, XML or XLSX format using the internal BoM.'
|
|
type: 'bom'
|
|
dir: 'Example/bom_dir'
|
|
options:
|
|
# [list(dict)|list(string)] List of columns to display.
|
|
# Can be just the name of the field
|
|
columns:
|
|
# [string=''] Name of the field to use for this column
|
|
field: ''
|
|
# [list(string)|string=''] List of fields to join to this column
|
|
join: ''
|
|
# [string=''] Name to display in the header. The field is used when empty
|
|
name: ''
|
|
# [list(list(string))] A series of values which are considered to be equivalent for the part name.
|
|
# Each entry is a list of equivalen names. Example: ['c', 'c_small', 'cap' ]
|
|
# will ensure the equivalent capacitor symbols can be grouped together.
|
|
# If empty the following aliases are used:
|
|
# - ['r', 'r_small', 'res', 'resistor']
|
|
# - ['l', 'l_small', 'inductor']
|
|
# - ['c', 'c_small', 'cap', 'capacitor']
|
|
# - ['sw', 'switch']
|
|
# - ['zener', 'zenersmall']
|
|
# - ['d', 'diode', 'd_small']
|
|
component_aliases: [['r', 'r_small', 'res', 'resistor'], ['l', 'l_small', 'inductor'], ['c', 'c_small', 'cap', 'capacitor'], ['sw', 'switch'], ['zener', 'zenersmall'], ['d', 'diode', 'd_small']]
|
|
# [dict] Options for the CSV, TXT and TSV formats
|
|
csv:
|
|
# [boolean=false] Hide project information
|
|
hide_pcb_info: false
|
|
# [boolean=false] Hide statistics information
|
|
hide_stats_info: false
|
|
# [boolean=false] Enclose all values using double quotes
|
|
quote_all: false
|
|
# [string=','] CSV Separator. TXT and TSV always use tab as delimiter
|
|
separator: ','
|
|
# [list(dict)] A series of regular expressions used to exclude parts.
|
|
# If a component matches ANY of these, it will be excluded.
|
|
# Column names are case-insensitive.
|
|
# If empty the following list is used:
|
|
# - column: References
|
|
# regex: '^TP[0-9]*'
|
|
# - column: References
|
|
# regex: '^FID'
|
|
# - column: Part
|
|
# regex: 'mount.*hole'
|
|
# - column: Part
|
|
# regex: 'solder.*bridge'
|
|
# - column: Part
|
|
# regex: 'solder.*jump'
|
|
# - column: Part
|
|
# regex: 'test.*point'
|
|
# - column: Footprint
|
|
# regex: 'test.*point'
|
|
# - column: Footprint
|
|
# regex: 'mount.*hole'
|
|
# - column: Footprint
|
|
# regex: 'fiducial'
|
|
exclude_any:
|
|
# [string=''] Name of the column to apply the regular expression
|
|
column: ''
|
|
# `field` is an alias for `column`
|
|
# [string=''] Regular expression to match
|
|
regex: ''
|
|
# `regexp` is an alias for `regex`
|
|
# [string='Config'] Field name used to determine if a particular part is to be fitted (also DNC and variants)
|
|
fit_field: 'Config'
|
|
# [string=''] [HTML,CSV,TXT,TSV,XML,XLSX] format for the BoM.
|
|
# If empty defaults to CSV or a guess according to the options.
|
|
format: ''
|
|
# [boolean=true] Connectors with the same footprints will be grouped together, independent of the name of the connector
|
|
group_connectors: true
|
|
# [list(string)] List of fields used for sorting individual components into groups.
|
|
# Components which match (comparing *all* fields) will be grouped together.
|
|
# Field names are case-insensitive.
|
|
# If empty: ['Part', 'Part Lib', 'Value', 'Footprint', 'Footprint Lib'] is used
|
|
group_fields: ['part', 'part lib', 'value', 'footprint', 'footprint lib']
|
|
# [dict] Options for the HTML format
|
|
html:
|
|
# [boolean=true] Use colors to show the field type
|
|
col_colors: true
|
|
# [string=''] Column with links to the datasheet
|
|
datasheet_as_link: ''
|
|
# [string|list(string)=''] Column/s containing Digi-Key part numbers, will be linked to web page
|
|
digikey_link: ''
|
|
# [boolean=true] Generate a separated section for DNF (Do Not Fit) components
|
|
generate_dnf: true
|
|
# [boolean=false] Hide project information
|
|
hide_pcb_info: false
|
|
# [boolean=false] Hide statistics information
|
|
hide_stats_info: false
|
|
# [boolean=true] Use a color for empty cells. Applies only when `col_colors` is `true`
|
|
highlight_empty: true
|
|
# [string|boolean=''] PNG file to use as logo, use false to remove
|
|
logo: ''
|
|
# [string='modern-blue'] Page style. Internal styles: modern-blue, modern-green, modern-red and classic.
|
|
# Or you can provide a CSS file name. Please use .css as file extension.
|
|
style: 'modern-blue'
|
|
# [string='KiBot Bill of Materials'] BoM title
|
|
title: 'KiBot Bill of Materials'
|
|
# [boolean=true] Exclude DNF (Do Not Fit) components
|
|
ignore_dnf: true
|
|
# [list(dict)] A series of regular expressions used to select included parts.
|
|
# If there are any regex defined here, only components that match against ANY of them will be included.
|
|
# Column names are case-insensitive.
|
|
# If empty all the components are included
|
|
include_only:
|
|
# [string=''] Name of the column to apply the regular expression
|
|
column: ''
|
|
# `field` is an alias for `column`
|
|
# [string=''] Regular expression to match
|
|
regex: ''
|
|
# `regexp` is an alias for `regex`
|
|
# [boolean=true] Component groups with blank fields will be merged into the most compatible group, where possible
|
|
merge_blank_fields: true
|
|
# [boolean=false] When normalizing values use the locale decimal point
|
|
normalize_locale: false
|
|
# [boolean=false] Try to normalize the R, L and C values, producing uniform units and prefixes
|
|
normalize_values: false
|
|
# [number=1] Number of boards to build (components multiplier)
|
|
number: 1
|
|
# [string='%f-%i.%x'] filename for the output (%i=bom). Affected by global options
|
|
output: '%f-%i.%x'
|
|
# [boolean=true] Each component group will be tested against a number of regular-expressions
|
|
# (see `include_only` and `exclude_any`)
|
|
test_regex: true
|
|
# [boolean=false] Print grouped references in the alternate compressed style eg: R1-R7,R18
|
|
use_alt: false
|
|
# [string|list(string)=''] Board variant(s), used to determine which components
|
|
# are output to the BoM.
|
|
variant: ''
|
|
# [dict] Options for the XLSX format
|
|
xlsx:
|
|
# [boolean=true] Use colors to show the field type
|
|
col_colors: true
|
|
# [string=''] Column with links to the datasheet
|
|
datasheet_as_link: ''
|
|
# [string|list(string)=''] Column/s containing Digi-Key part numbers, will be linked to web page
|
|
digikey_link: ''
|
|
# [boolean=true] Generate a separated section for DNF (Do Not Fit) components
|
|
generate_dnf: true
|
|
# [boolean=false] Hide project information
|
|
hide_pcb_info: false
|
|
# [boolean=false] Hide statistics information
|
|
hide_stats_info: false
|
|
# [boolean=true] Use a color for empty cells. Applies only when `col_colors` is `true`
|
|
highlight_empty: true
|
|
# [string|boolean=''] PNG file to use as logo, use false to remove
|
|
logo: ''
|
|
# [number=60] [20,999] Maximum column width (characters)
|
|
max_col_width: 60
|
|
# [string='modern-blue'] Head style: modern-blue, modern-green, modern-red and classic.
|
|
style: 'modern-blue'
|
|
# [string='KiBot Bill of Materials'] BoM title
|
|
title: 'KiBot Bill of Materials'
|
|
|
|
# DXF (Drawing Exchange Format):
|
|
# This output is what you get from the File/Plot menu in pcbnew.
|
|
- name: 'dxf_example'
|
|
comment: 'Exports the PCB to 2D mechanical EDA tools (like AutoCAD).'
|
|
type: 'dxf'
|
|
dir: 'Example/dxf_dir'
|
|
options:
|
|
# [string='full'] what to use to indicate the drill places, can be none, small or full (for real scale)
|
|
drill_marks: 'full'
|
|
# [boolean=true] do not include the PCB edge layer
|
|
exclude_edge_layer: true
|
|
# [boolean=false] do not plot the component pads in the silk screen
|
|
exclude_pads_from_silkscreen: false
|
|
# [boolean=false] include references and values even when they are marked as invisible
|
|
force_plot_invisible_refs_vals: false
|
|
# [boolean=false] use mm instead of inches
|
|
metric_units: false
|
|
# [string='%f-%i.%x'] output file name, the default KiCad name if empty. Affected by global options
|
|
output: '%f-%i.%x'
|
|
# [boolean=true] include the footprint references
|
|
plot_footprint_refs: true
|
|
# [boolean=true] include the footprint values
|
|
plot_footprint_values: true
|
|
# [boolean=false] currently without effect
|
|
plot_sheet_reference: false
|
|
# [boolean=true] plot using the contour, instead of the center line
|
|
polygon_mode: true
|
|
# [boolean=false] don't fill objects, just draw the outline
|
|
sketch_plot: false
|
|
# [boolean=true] cover the vias
|
|
tent_vias: true
|
|
# [boolean=false] use the auxiliar axis as origin for coordinates
|
|
use_aux_axis_as_origin: false
|
|
layers: all
|
|
|
|
# Excellon drill format:
|
|
# You can create a map file for documentation purposes.
|
|
# This output is what you get from the 'File/Fabrication output/Drill Files' menu in pcbnew.
|
|
- name: 'excellon_example'
|
|
comment: 'This is the main format for the drilling machine.'
|
|
type: 'excellon'
|
|
dir: 'Example/excellon_dir'
|
|
options:
|
|
# [dict|string] [hpgl,ps,gerber,dxf,svg,pdf] format for a graphical drill map.
|
|
# Not generated unless a format is specified
|
|
map:
|
|
# [string='%f-%i.%x'] name for the map file, KiCad defaults if empty (%i='PTH_drill_map'). Affected by global options
|
|
output: '%f-%i.%x'
|
|
# [string='pdf'] [hpgl,ps,gerber,dxf,svg,pdf] format for a graphical drill map
|
|
type: 'pdf'
|
|
# [boolean=true] use metric units instead of inches
|
|
metric_units: true
|
|
# [boolean=false] use a minimal header in the file
|
|
minimal_header: false
|
|
# [boolean=false] invert the Y axis
|
|
mirror_y_axis: false
|
|
# [string='%f-%i.%x'] name for the drill file, KiCad defaults if empty (%i='PTH_drill'). Affected by global options
|
|
output: '%f-%i.%x'
|
|
# [boolean=true] generate one file for both, plated holes and non-plated holes, instead of two separated files
|
|
pth_and_npth_single_file: true
|
|
# [dict|string] name of the drill report. Not generated unless a name is specified
|
|
report:
|
|
# [string=''] name of the drill report. Not generated unless a name is specified.
|
|
# (%i='drill_report' %x='txt')
|
|
filename: ''
|
|
# [boolean=false] use the auxiliar axis as origin for coordinates
|
|
use_aux_axis_as_origin: false
|
|
|
|
# Gerber drill format:
|
|
# You can create a map file for documentation purposes.
|
|
# This output is what you get from the 'File/Fabrication output/Drill Files' menu in pcbnew.
|
|
- name: 'gerb_drill_example'
|
|
comment: 'This is the information for the drilling machine in gerber format.'
|
|
type: 'gerb_drill'
|
|
dir: 'Example/gerb_drill_dir'
|
|
options:
|
|
# [dict|string] [hpgl,ps,gerber,dxf,svg,pdf] format for a graphical drill map.
|
|
# Not generated unless a format is specified
|
|
map:
|
|
# [string='%f-%i.%x'] name for the map file, KiCad defaults if empty (%i='PTH_drill_map'). Affected by global options
|
|
output: '%f-%i.%x'
|
|
# [string='pdf'] [hpgl,ps,gerber,dxf,svg,pdf] format for a graphical drill map
|
|
type: 'pdf'
|
|
# [string='%f-%i.%x'] name for the drill file, KiCad defaults if empty (%i='PTH_drill'). Affected by global options
|
|
output: '%f-%i.%x'
|
|
# [dict|string] name of the drill report. Not generated unless a name is specified
|
|
report:
|
|
# [string=''] name of the drill report. Not generated unless a name is specified.
|
|
# (%i='drill_report' %x='txt')
|
|
filename: ''
|
|
# [boolean=false] use the auxiliar axis as origin for coordinates
|
|
use_aux_axis_as_origin: false
|
|
|
|
# Gerber format:
|
|
# This output is what you get from the File/Plot menu in pcbnew.
|
|
- name: 'gerber_example'
|
|
comment: 'This is the main fabrication format for the PCB.'
|
|
type: 'gerber'
|
|
dir: 'Example/gerber_dir'
|
|
options:
|
|
# [boolean=true] creates a file with information about all the generated gerbers.
|
|
# You can use it in gerbview to load all gerbers at once
|
|
create_gerber_job_file: true
|
|
# [boolean=true] do not include the PCB edge layer
|
|
exclude_edge_layer: true
|
|
# [boolean=false] do not plot the component pads in the silk screen
|
|
exclude_pads_from_silkscreen: false
|
|
# [boolean=false] include references and values even when they are marked as invisible
|
|
force_plot_invisible_refs_vals: false
|
|
# [string='%f-%i.%x'] name for the gerber job file (%i='job', %x='gbrjob')
|
|
gerber_job_file: '%f-%i.%x'
|
|
# [number=4.6] this the gerber coordinate format, can be 4.5 or 4.6
|
|
gerber_precision: 4.6
|
|
# [number=0.1] [0.02,2] line_width for objects without width [mm]
|
|
line_width: 0.1
|
|
# [string='%f-%i.%x'] output file name, the default KiCad name if empty. Affected by global options
|
|
output: '%f-%i.%x'
|
|
# [boolean=true] include the footprint references
|
|
plot_footprint_refs: true
|
|
# [boolean=true] include the footprint values
|
|
plot_footprint_values: true
|
|
# [boolean=false] currently without effect
|
|
plot_sheet_reference: false
|
|
# [boolean=false] substract the solder mask from the silk screen
|
|
subtract_mask_from_silk: false
|
|
# [boolean=true] cover the vias
|
|
tent_vias: true
|
|
# [boolean=false] use the auxiliar axis as origin for coordinates
|
|
use_aux_axis_as_origin: false
|
|
# [boolean=true] include netlist metadata
|
|
use_gerber_net_attributes: true
|
|
# [boolean=true] use the extended X2 format
|
|
use_gerber_x2_attributes: true
|
|
# [boolean=false] use legacy Protel file extensions
|
|
use_protel_extensions: false
|
|
layers: all
|
|
|
|
# HPGL (Hewlett & Packard Graphics Language):
|
|
# This output is what you get from the File/Plot menu in pcbnew.
|
|
- name: 'hpgl_example'
|
|
comment: 'Exports the PCB for plotters and laser printers.'
|
|
type: 'hpgl'
|
|
dir: 'Example/hpgl_dir'
|
|
options:
|
|
# [string='full'] what to use to indicate the drill places, can be none, small or full (for real scale)
|
|
drill_marks: 'full'
|
|
# [boolean=true] do not include the PCB edge layer
|
|
exclude_edge_layer: true
|
|
# [boolean=false] do not plot the component pads in the silk screen
|
|
exclude_pads_from_silkscreen: false
|
|
# [boolean=false] include references and values even when they are marked as invisible
|
|
force_plot_invisible_refs_vals: false
|
|
# [boolean=false] plot mirrored
|
|
mirror_plot: false
|
|
# [string='%f-%i.%x'] output file name, the default KiCad name if empty. Affected by global options
|
|
output: '%f-%i.%x'
|
|
# [number=1] [1,16] pen number
|
|
pen_number: 1
|
|
# [number=20] [1,99] pen speed
|
|
pen_speed: 20
|
|
# [number=15] [0,100] pen diameter in MILS, useful to fill areas. However, it is in mm in HPGL files
|
|
pen_width: 15
|
|
# [boolean=true] include the footprint references
|
|
plot_footprint_refs: true
|
|
# [boolean=true] include the footprint values
|
|
plot_footprint_values: true
|
|
# [boolean=false] currently without effect
|
|
plot_sheet_reference: false
|
|
# [number=0] scale factor (0 means autoscaling)
|
|
scaling: 0
|
|
# [boolean=false] don't fill objects, just draw the outline
|
|
sketch_plot: false
|
|
# [boolean=true] cover the vias
|
|
tent_vias: true
|
|
layers: all
|
|
|
|
# IBoM (Interactive HTML BoM):
|
|
# For more information: https://github.com/INTI-CMNB/InteractiveHtmlBom
|
|
# This output is what you get from the InteractiveHtmlBom plug-in (pcbnew).
|
|
- name: 'ibom_example'
|
|
comment: 'Generates an interactive web page useful to identify the position of the components in the PCB.'
|
|
type: 'ibom'
|
|
dir: 'Example/ibom_dir'
|
|
options:
|
|
# [string=''] List of comma separated blacklisted components or prefixes with *. E.g. 'X1,MH*'
|
|
blacklist: ''
|
|
# [boolean=false] Blacklist components with empty value
|
|
blacklist_empty_val: false
|
|
# [number=0] Board rotation in degrees (-180 to 180). Will be rounded to multiple of 5
|
|
board_rotation: 0
|
|
# [string='left-right'] [bom-only,left-right,top-bottom] Default BOM view
|
|
bom_view: 'left-right'
|
|
# [string='Sourced,Placed'] Comma separated list of checkbox columns
|
|
checkboxes: 'Sourced,Placed'
|
|
# [boolean=false] Default to dark mode
|
|
dark_mode: false
|
|
# [string=''] Name of the extra field that indicates do not populate status. Components with this field not empty will be
|
|
# blacklisted
|
|
dnp_field: ''
|
|
# [string=''] Comma separated list of extra fields to pull from netlist or xml file
|
|
extra_fields: ''
|
|
# [boolean=false] Hide footprint pads by default
|
|
hide_pads: false
|
|
# [boolean=false] Hide silkscreen by default
|
|
hide_silkscreen: false
|
|
# [boolean=false] Highlight pin1 by default
|
|
highlight_pin1: false
|
|
# [boolean=false] Include netlist information in output.
|
|
include_nets: false
|
|
# [boolean=false] Include track/zone information in output. F.Cu and B.Cu layers only
|
|
include_tracks: false
|
|
# [string='FB'] [F,FB,B] Default layer view
|
|
layer_view: 'FB'
|
|
# [string='ibom'] Output file name format supports substitutions:
|
|
# %f : original pcb file name without extension.
|
|
# %p : pcb/project title from pcb metadata.
|
|
# %c : company from pcb metadata.
|
|
# %r : revision from pcb metadata.
|
|
# %d : pcb date from metadata if available, file modification date otherwise.
|
|
# %D : bom generation date.
|
|
# %T : bom generation time.
|
|
# Extension .html will be added automatically.
|
|
# Note that this name is used only when output is ''
|
|
name_format: 'ibom'
|
|
# [string=''] Path to netlist or xml file
|
|
netlist_file: ''
|
|
# [boolean=false] Do not blacklist virtual components
|
|
no_blacklist_virtual: false
|
|
# [boolean=false] Do not redraw pcb on drag by default
|
|
no_redraw_on_drag: false
|
|
# [boolean=false] Normalize extra field name case. E.g. 'MPN' and 'mpn' will be considered the same field
|
|
normalize_field_case: false
|
|
# [string='%f-%i.%x'] Filename for the output, use '' to use the IBoM filename (%i=ibom, %x=html). Affected by global options
|
|
output: '%f-%i.%x'
|
|
# [boolean=false] Show fabrication layer by default
|
|
show_fabrication: false
|
|
# [string='C,R,L,D,U,Y,X,F,SW,A,~,HS,CNN,J,P,NT,MH'] Default sort order for components. Must contain '~' once
|
|
sort_order: 'C,R,L,D,U,Y,X,F,SW,A,~,HS,CNN,J,P,NT,MH'
|
|
# [string=''] Name of the extra field that stores board variant for component
|
|
variant_field: ''
|
|
# [string=''] List of board variants to exclude from the BOM
|
|
variants_blacklist: ''
|
|
# [string=''] List of board variants to include in the BOM
|
|
variants_whitelist: ''
|
|
|
|
# KiBoM (KiCad Bill of Materials):
|
|
# For more information: https://github.com/INTI-CMNB/KiBoM
|
|
# This output is what you get from the 'Tools/Generate Bill of Materials' menu in eeschema.
|
|
- name: 'kibom_example'
|
|
comment: 'Used to generate the BoM in HTML or CSV format using the KiBoM plug-in.'
|
|
type: 'kibom'
|
|
dir: 'Example/kibom_dir'
|
|
options:
|
|
# [string|dict] BoM configuration file, relative to PCB.
|
|
# You can also define the configuration here, will be stored in `config.kibom.ini`
|
|
conf:
|
|
# [list(dict)|list(string)] List of columns to display.
|
|
# Can be just the name of the field
|
|
columns:
|
|
# [string=''] Name of the field to use for this column
|
|
field: ''
|
|
# [list(string)|string=''] List of fields to join to this column
|
|
join: ''
|
|
# [string=''] Name to display in the header. The field is used when empty
|
|
name: ''
|
|
# [list(list(string))] A series of values which are considered to be equivalent for the part name.
|
|
# Each entry is a list of equivalen names. Example: ['c', 'c_small', 'cap' ]
|
|
# will ensure the equivalent capacitor symbols can be grouped together.
|
|
# If empty the following aliases are used:
|
|
# - ['r', 'r_small', 'res', 'resistor']
|
|
# - ['l', 'l_small', 'inductor']
|
|
# - ['c', 'c_small', 'cap', 'capacitor']
|
|
# - ['sw', 'switch']
|
|
# - ['zener', 'zenersmall']
|
|
# - ['d', 'diode', 'd_small']
|
|
component_aliases: [['r', 'r_small', 'res', 'resistor'], ['l', 'l_small', 'inductor'], ['c', 'c_small', 'cap', 'capacitor'], ['sw', 'switch'], ['zener', 'zenersmall'], ['d', 'diode', 'd_small']]
|
|
# [string=''] Column with links to the datasheet (HTML only)
|
|
datasheet_as_link: ''
|
|
# [string|list(string)=''] Column/s containing Digi-Key part numbers, will be linked to web page (HTML only)
|
|
digikey_link: ''
|
|
# [list(dict)] A series of regular expressions used to exclude parts.
|
|
# If a component matches ANY of these, it will be excluded.
|
|
# Column names are case-insensitive.
|
|
# If empty the following list is used:
|
|
# - column: References
|
|
# regex: '^TP[0-9]*'
|
|
# - column: References
|
|
# regex: '^FID'
|
|
# - column: Part
|
|
# regex: 'mount.*hole'
|
|
# - column: Part
|
|
# regex: 'solder.*bridge'
|
|
# - column: Part
|
|
# regex: 'test.*point'
|
|
# - column: Footprint
|
|
# regex 'test.*point'
|
|
# - column: Footprint
|
|
# regex: 'mount.*hole'
|
|
# - column: Footprint
|
|
# regex: 'fiducial'
|
|
exclude_any:
|
|
# [string=''] Name of the column to apply the regular expression
|
|
column: ''
|
|
# `field` is an alias for `column`
|
|
# [string=''] Regular expression to match
|
|
regex: ''
|
|
# `regexp` is an alias for `regex`
|
|
# [string='Config'] Field name used to determine if a particular part is to be fitted (also DNC and variants)
|
|
fit_field: 'Config'
|
|
# [boolean=true] Connectors with the same footprints will be grouped together, independent of the name of the connector
|
|
group_connectors: true
|
|
# [list(string)] List of fields used for sorting individual components into groups.
|
|
# Components which match (comparing *all* fields) will be grouped together.
|
|
# Field names are case-insensitive.
|
|
# If empty: ['Part', 'Part Lib', 'Value', 'Footprint', 'Footprint Lib'] is used
|
|
group_fields: ['Part', 'Part Lib', 'Value', 'Footprint', 'Footprint Lib']
|
|
# [boolean=false] Hide column headers
|
|
hide_headers: false
|
|
# [boolean=false] Hide project information
|
|
hide_pcb_info: false
|
|
# [boolean=true] Generate a separated section for DNF (Do Not Fit) components (HTML only)
|
|
html_generate_dnf: true
|
|
# [boolean=true] Exclude DNF (Do Not Fit) components
|
|
ignore_dnf: true
|
|
# [list(dict)] A series of regular expressions used to select included parts.
|
|
# If there are any regex defined here, only components that match against ANY of them will be included.
|
|
# Column names are case-insensitive.
|
|
# If empty all the components are included
|
|
include_only:
|
|
# [string=''] Name of the column to apply the regular expression
|
|
column: ''
|
|
# `field` is an alias for `column`
|
|
# [string=''] Regular expression to match
|
|
regex: ''
|
|
# `regexp` is an alias for `regex`
|
|
# [boolean=true] Component groups with blank fields will be merged into the most compatible group, where possible
|
|
merge_blank_fields: true
|
|
# [boolean=true] First column is the row number
|
|
number_rows: true
|
|
# [boolean=true] Each component group will be tested against a number of regular-expressions (see ``).
|
|
test_regex: true
|
|
# [boolean=false] Print grouped references in the alternate compressed style eg: R1-R7,R18
|
|
use_alt: false
|
|
# [string='HTML'] [HTML,CSV,XML,XLSX] format for the BoM
|
|
format: 'HTML'
|
|
# [number=1] Number of boards to build (components multiplier)
|
|
number: 1
|
|
# [string='%f-%i.%x'] filename for the output (%i=bom). Affected by global options
|
|
output: '%f-%i.%x'
|
|
# [string=','] CSV Separator
|
|
separator: ','
|
|
# [string=''] Board variant(s), used to determine which components
|
|
# are output to the BoM. To specify multiple variants,
|
|
# with a BOM file exported for each variant, separate
|
|
# variants with the ';' (semicolon) character
|
|
variant: ''
|
|
|
|
# PcbDraw - Beautiful 2D PCB render:
|
|
# Uses configurable colors.
|
|
# Can also render the components if the 2D models are available
|
|
- name: 'pcbdraw_example'
|
|
comment: 'Exports the PCB as a 2D model (SVG, PNG or JPG).'
|
|
type: 'pcbdraw'
|
|
dir: 'Example/pcbdraw_dir'
|
|
options:
|
|
# [boolean=false] render the bottom side of the board (default is top side)
|
|
bottom: false
|
|
# [number=300] [10,1200] dots per inch (resolution) of the generated image
|
|
dpi: 300
|
|
# [string='svg'] [svg,png,jpg] output format. Only used if no `output` is specified
|
|
format: 'svg'
|
|
# [list(string)=[]] list of components to highlight
|
|
highlight: []
|
|
# [list(string)=[]] list of libraries
|
|
libs: []
|
|
# [boolean=false] mirror the board
|
|
mirror: false
|
|
# [boolean=false] do not make holes transparent
|
|
no_drillholes: false
|
|
# [string='%f-%i.%x'] name for the generated file. Affected by global options
|
|
output: '%f-%i.%x'
|
|
# [boolean=false] show placeholder for missing components
|
|
placeholder: false
|
|
# [dict|None] replacements for PCB references using components (lib:component)
|
|
remap:
|
|
# [string|list(string)=none] [none,all] list of components to draw, can be also a string for none or all.
|
|
# The default is none
|
|
show_components: none
|
|
# [string|dict] PCB style (colors). An internal name, the name of a JSON file or the style options
|
|
style:
|
|
# [string='#4ca06c'] color for the board without copper (covered by solder mask)
|
|
board: '#4ca06c'
|
|
# [string='#9c6b28'] color for the PCB core (not covered by solder mask)
|
|
clad: '#9c6b28'
|
|
# [string='#417e5a'] color for the copper zones (covered by solder mask)
|
|
copper: '#417e5a'
|
|
# [boolean=false] highlight over the component (not under)
|
|
highlight_on_top: false
|
|
# [number=1.5] [0,1000] how much the highlight extends around the component [mm]
|
|
highlight_padding: 1.5
|
|
# [string='stroke:none;fill:#ff0000;opacity:0.5;'] SVG code for the highlight style
|
|
highlight_style: 'stroke:none;fill:#ff0000;opacity:0.5;'
|
|
# [string='#000000'] color for the outline
|
|
outline: '#000000'
|
|
# [string='#b5ae30'] color for the exposed pads (metal finish)
|
|
pads: '#b5ae30'
|
|
# [string='#f0f0f0'] color for the silk screen
|
|
silk: '#f0f0f0'
|
|
# [string='#bf2600'] color for the V-CUTS
|
|
vcut: '#bf2600'
|
|
# [boolean=false] render V-CUTS on the Cmts.User layer
|
|
vcuts: false
|
|
# [string='visible'] [visible,all,none] using visible only the warnings about components in the visible side are generated
|
|
warnings: 'visible'
|
|
|
|
# PDF (Portable Document Format):
|
|
# Note that this output isn't the best for documating your project.
|
|
# This output is what you get from the File/Plot menu in pcbnew.
|
|
- name: 'pdf_example'
|
|
comment: 'Exports the PCB to the most common exhange format. Suitable for printing.'
|
|
type: 'pdf'
|
|
dir: 'Example/pdf_dir'
|
|
options:
|
|
# [string='full'] what to use to indicate the drill places, can be none, small or full (for real scale)
|
|
drill_marks: 'full'
|
|
# [boolean=true] do not include the PCB edge layer
|
|
exclude_edge_layer: true
|
|
# [boolean=false] do not plot the component pads in the silk screen
|
|
exclude_pads_from_silkscreen: false
|
|
# [boolean=false] include references and values even when they are marked as invisible
|
|
force_plot_invisible_refs_vals: false
|
|
# [number=0.1] [0.02,2] for objects without width [mm]
|
|
line_width: 0.1
|
|
# [boolean=false] plot mirrored
|
|
mirror_plot: false
|
|
# [boolean=false] invert black and white
|
|
negative_plot: false
|
|
# [string='%f-%i.%x'] output file name, the default KiCad name if empty. Affected by global options
|
|
output: '%f-%i.%x'
|
|
# [boolean=true] include the footprint references
|
|
plot_footprint_refs: true
|
|
# [boolean=true] include the footprint values
|
|
plot_footprint_values: true
|
|
# [boolean=false] currently without effect
|
|
plot_sheet_reference: false
|
|
# [boolean=true] cover the vias
|
|
tent_vias: true
|
|
layers: all
|
|
|
|
# PDF PCB Print (Portable Document Format):
|
|
# This is the main format to document your PCB.
|
|
# This output is what you get from the 'File/Print' menu in pcbnew.
|
|
- name: 'pdf_pcb_print_example'
|
|
comment: 'Exports the PCB to the most common exhange format. Suitable for printing.'
|
|
type: 'pdf_pcb_print'
|
|
dir: 'Example/pdf_pcb_print_dir'
|
|
options:
|
|
# [string='%f-%i.%x'] filename for the output PDF (%i=layers, %x=pdf). Affected by global options
|
|
output: '%f-%i.%x'
|
|
# `output_name` is an alias for `output`
|
|
layers: all
|
|
|
|
# PDF Schematic Print (Portable Document Format):
|
|
# This is the main format to document your schematic.
|
|
# This output is what you get from the 'File/Print' menu in eeschema.
|
|
- name: 'pdf_sch_print_example'
|
|
comment: 'Exports the PCB to the most common exhange format. Suitable for printing.'
|
|
type: 'pdf_sch_print'
|
|
dir: 'Example/pdf_sch_print_dir'
|
|
options:
|
|
# [string='%f-%i.%x'] filename for the output PDF (%i=schematic %x=pdf). Affected by global options
|
|
output: '%f-%i.%x'
|
|
|
|
# Pick & place:
|
|
# This output is what you get from the 'File/Fabrication output/Footprint poistion (.pos) file' menu in pcbnew.
|
|
- name: 'position_example'
|
|
comment: 'Generates the file with position information for the PCB components, used by the pick and place machine.'
|
|
type: 'position'
|
|
dir: 'Example/position_dir'
|
|
options:
|
|
# [string='ASCII'] [ASCII,CSV] format for the position file
|
|
format: 'ASCII'
|
|
# [boolean=true] only include the surface mount components
|
|
only_smd: true
|
|
# [string='%f-%i.%x'] output file name (%i='top_pos'|'bottom_pos'|'both_pos', %x='pos'|'csv'). Affected by global options
|
|
output: '%f-%i.%x'
|
|
# [boolean=true] generate two separated files, one for the top and another for the bottom
|
|
separate_files_for_front_and_back: true
|
|
# [string='millimeters'] [millimeters,inches] units used for the positions
|
|
units: 'millimeters'
|
|
|
|
# PS (Postscript):
|
|
# This output is what you get from the File/Plot menu in pcbnew.
|
|
- name: 'ps_example'
|
|
comment: 'Exports the PCB to a format suitable for printing.'
|
|
type: 'ps'
|
|
dir: 'Example/ps_dir'
|
|
options:
|
|
# [boolean=true] force A4 paper size
|
|
a4_output: true
|
|
# [string='full'] what to use to indicate the drill places, can be none, small or full (for real scale)
|
|
drill_marks: 'full'
|
|
# [boolean=true] do not include the PCB edge layer
|
|
exclude_edge_layer: true
|
|
# [boolean=false] do not plot the component pads in the silk screen
|
|
exclude_pads_from_silkscreen: false
|
|
# [boolean=false] include references and values even when they are marked as invisible
|
|
force_plot_invisible_refs_vals: false
|
|
# [number=0.15] [0.02,2] for objects without width [mm]
|
|
line_width: 0.15
|
|
# [boolean=false] plot mirrored
|
|
mirror_plot: false
|
|
# [boolean=false] invert black and white
|
|
negative_plot: false
|
|
# [string='%f-%i.%x'] output file name, the default KiCad name if empty. Affected by global options
|
|
output: '%f-%i.%x'
|
|
# [boolean=true] include the footprint references
|
|
plot_footprint_refs: true
|
|
# [boolean=true] include the footprint values
|
|
plot_footprint_values: true
|
|
# [boolean=false] currently without effect
|
|
plot_sheet_reference: false
|
|
# [number=1.0] fine grain adjust for the X scale (floating point multiplier)
|
|
scale_adjust_x: 1.0
|
|
# [number=1.0] fine grain adjust for the Y scale (floating point multiplier)
|
|
scale_adjust_y: 1.0
|
|
# [number=1] scale factor (0 means autoscaling)
|
|
scaling: 1
|
|
# [boolean=false] don't fill objects, just draw the outline
|
|
sketch_plot: false
|
|
# [boolean=true] cover the vias
|
|
tent_vias: true
|
|
# [number=0] this width factor is intended to compensate PS printers/plotters that do not strictly obey line width settings.
|
|
# Only used to plot pads and tracks
|
|
width_adjust: 0
|
|
layers: all
|
|
|
|
# STEP (ISO 10303-21 Clear Text Encoding of the Exchange Structure):
|
|
# This is the most common 3D format for exchange purposes.
|
|
# This output is what you get from the 'File/Export/STEP' menu in pcbnew.
|
|
- name: 'step_example'
|
|
comment: 'Exports the PCB as a 3D model.'
|
|
type: 'step'
|
|
dir: 'Example/step_dir'
|
|
options:
|
|
# [boolean=true] use metric units instead of inches
|
|
metric_units: true
|
|
# [number=-1] the minimum distance between points to treat them as separate ones (-1 is KiCad default: 0.01 mm)
|
|
min_distance: -1
|
|
# [boolean=false] used to exclude 3D models for components with 'virtual' attribute
|
|
no_virtual: false
|
|
# [string='grid'] determines the coordinates origin. Using grid the coordinates are the same as you have in the design sheet.
|
|
# The drill option uses the auxiliar reference defined by the user.
|
|
# You can define any other origin using the format 'X,Y', i.e. '3.2,-10'
|
|
origin: 'grid'
|
|
# [string='%f-%i.%x'] name for the generated STEP file (%i='3D' %x='step'). Affected by global options
|
|
output: '%f-%i.%x'
|
|
|
|
# SVG (Scalable Vector Graphics):
|
|
# Unlike bitmaps SVG drawings can be scaled without losing resolution.
|
|
# This output is what you get from the File/Plot menu in pcbnew.
|
|
- name: 'svg_example'
|
|
comment: 'Exports the PCB to a format suitable for 2D graphics software.'
|
|
type: 'svg'
|
|
dir: 'Example/svg_dir'
|
|
options:
|
|
# [string='full'] what to use to indicate the drill places, can be none, small or full (for real scale)
|
|
drill_marks: 'full'
|
|
# [boolean=true] do not include the PCB edge layer
|
|
exclude_edge_layer: true
|
|
# [boolean=false] do not plot the component pads in the silk screen
|
|
exclude_pads_from_silkscreen: false
|
|
# [boolean=false] include references and values even when they are marked as invisible
|
|
force_plot_invisible_refs_vals: false
|
|
# [number=0.25] [0.02,2] for objects without width [mm]
|
|
line_width: 0.25
|
|
# [boolean=false] plot mirrored
|
|
mirror_plot: false
|
|
# [boolean=false] invert black and white
|
|
negative_plot: false
|
|
# [string='%f-%i.%x'] output file name, the default KiCad name if empty. Affected by global options
|
|
output: '%f-%i.%x'
|
|
# [boolean=true] include the footprint references
|
|
plot_footprint_refs: true
|
|
# [boolean=true] include the footprint values
|
|
plot_footprint_values: true
|
|
# [boolean=false] currently without effect
|
|
plot_sheet_reference: false
|
|
# [boolean=true] cover the vias
|
|
tent_vias: true
|
|
layers: all
|
|
|
|
# SVG Schematic Print:
|
|
# This is a format to document your schematic.
|
|
- name: 'svg_sch_print_example'
|
|
comment: 'Exports the PCB. Suitable for printing.'
|
|
type: 'svg_sch_print'
|
|
dir: 'Example/svg_sch_print_dir'
|
|
options:
|
|
# [string='%f-%i.%x'] filename for the output SVG (%i=schematic %x=svg). Affected by global options
|
|
output: '%f-%i.%x'
|
|
|