mirror of
https://gitlab.com/kicad/code/kicad.git
synced 2025-09-15 02:33:15 +02:00
8ccf0320b4
File "rules" has instructional text as comments near top. 2) Convert all text files in repo to LF line ending form. Any checkout done with "rules" in play will convert the working tree to native line ending, while keeping repo as LF line ending.
114 lines
3.8 KiB
Python
114 lines
3.8 KiB
Python
#
|
|
# Example python script to generate a BOM from a KiCad generic netlist
|
|
#
|
|
# Example: Sorted and Grouped HTML BOM with more advanced grouping
|
|
#
|
|
|
|
# Import the KiCad python helper module and the csv formatter
|
|
import ky
|
|
import sys
|
|
|
|
# Start with a basic html template
|
|
html = """
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<title>KiCad BOM Example 5</title>
|
|
</head>
|
|
<body>
|
|
<h1><!--SOURCE--></h1>
|
|
<p><!--DATE--></p>
|
|
<p><!--TOOL--></p>
|
|
<p><!--COMPCOUNT--></p>
|
|
<table>
|
|
<!--TABLEROW-->
|
|
</table>
|
|
</body>
|
|
</html>
|
|
"""
|
|
|
|
def myEqu(self, other):
|
|
"""myEqu is a more advanced equivalence function for components which is
|
|
used by component grouping. Normal operation is to group components based
|
|
on their Value, Library source, and Library part.
|
|
|
|
In this example of a more advanced equivalency operator we also compare the
|
|
custom fields Voltage, Tolerance and Manufacturer as well as the assigned
|
|
footprint. If these fields are not used in some parts they will simply be
|
|
ignored (they will match as both will be empty strings).
|
|
|
|
"""
|
|
result = True
|
|
if self.getValue() != other.getValue():
|
|
result = False
|
|
elif self.getLib() != other.getLib():
|
|
result = False
|
|
elif self.getPart() != other.getPart():
|
|
result = False
|
|
elif self.getFootprint() != other.getFootprint():
|
|
result = False
|
|
elif self.getField("Tolerance") != other.getField("Tolerance"):
|
|
result = False
|
|
elif self.getField("Manufacturer") != other.getField("Manufacturer"):
|
|
result = False
|
|
elif self.getField("Voltage") != other.getField("Voltage"):
|
|
result = False
|
|
|
|
return result
|
|
|
|
# Override the component equivalence operator - it is important to do this
|
|
# before loading the netlist, otherwise all components will have the original
|
|
# equivalency operator.
|
|
ky.component.__equ__ = myEqu
|
|
|
|
# Generate an instance of a generic netlist, and load the netlist tree from
|
|
# video.tmp. If the file doesn't exist, execution will stop
|
|
net = ky.netlist(sys.argv[1])
|
|
|
|
# Open a file to write too, if the file cannot be opened output to stdout
|
|
# instead
|
|
try:
|
|
f = open(sys.argv[2], 'w')
|
|
except IOError:
|
|
print >> sys.stderr, __file__, ":", e
|
|
f = stdout
|
|
|
|
# Output a set of rows for a header providing general information
|
|
html = html.replace('<!--SOURCE-->', net.getSource())
|
|
html = html.replace('<!--DATE-->', net.getDate())
|
|
html = html.replace('<!--TOOL-->', net.getTool())
|
|
html = html.replace('<!--COMPCOUNT-->', "<b>Component Count:</b>" + \
|
|
str(len(net.components)))
|
|
|
|
row = "<tr><th style='width:640px'>Ref</th>" + "<th>Qnty</th>"
|
|
row += "<th>Value</th>" + "<th>Part</th>" + "<th>Datasheet</th>"
|
|
row += "<th>Description</th>" + "<th>Vendor</th></tr>"
|
|
|
|
html = html.replace('<!--TABLEROW-->', row + "<!--TABLEROW-->")
|
|
|
|
# Get all of the components in groups of matching parts + values (see ky.py)
|
|
grouped = net.groupComponents()
|
|
|
|
# Output all of the component information
|
|
for group in grouped:
|
|
refs = ""
|
|
|
|
# Add the reference of every component in the group and keep a reference
|
|
# to the component so that the other data can be filled in once per group
|
|
for component in group:
|
|
refs += component.getRef() + ", "
|
|
c = component
|
|
|
|
row = "<tr><td>" + refs +"</td><td>" + str(len(group))
|
|
row += "</td><td>" + c.getValue() + "</td><td>" + c.getLib() + "/"
|
|
row += c.getPart() + "</td><td>" + c.getDatasheet() + "</td><td>"
|
|
row += c.getDescription() + "</td><td>" + c.getField("Vendor")
|
|
row += "</td></tr>"
|
|
|
|
html = html.replace('<!--TABLEROW-->', row + "<!--TABLEROW-->")
|
|
|
|
# Print the formatted html to output file
|
|
print >> f, html
|