[DOCs][Added] How to include THT components and fiducials
In position files
This commit is contained in:
parent
0625f76f71
commit
d6e06c1463
|
|
@ -364,10 +364,100 @@ rotations and ``JLCPCB Position Offset`` and/or ``JLCPosOffset`` for offsets. Th
|
||||||
like ``jlcrotoffset`` is accepted.
|
like ``jlcrotoffset`` is accepted.
|
||||||
|
|
||||||
|
|
||||||
|
Including through-hole components
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
The default behavior is to only include SMD components in the position files. This is because in most cases is expensive to
|
||||||
|
automatically solder them. But with some manufacturers offering simple assembly at no cost you could want to include them.
|
||||||
|
|
||||||
|
For a ``position`` output you just need to disable the ``only_smd`` option. When using the ``JLCPCB`` template you can just use:
|
||||||
|
|
||||||
|
.. code:: yaml
|
||||||
|
|
||||||
|
kibot:
|
||||||
|
version: 1
|
||||||
|
|
||||||
|
import:
|
||||||
|
- file: JLCPCB
|
||||||
|
definitions:
|
||||||
|
_KIBOT_POS_ONLY_SMD: false
|
||||||
|
|
||||||
|
|
||||||
|
Including fiducials and similar stuff
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
Position files are intended to be used by pick and place machines. So things like reference position marks are excluded.
|
||||||
|
You can include them enabling the ``include_virtual`` option. But this could include other things you don't want.
|
||||||
|
As an example we will show how to include fiducials, but exclude mounting holes:
|
||||||
|
|
||||||
|
.. code:: yaml
|
||||||
|
|
||||||
|
kibot:
|
||||||
|
version: 1
|
||||||
|
|
||||||
|
filters:
|
||||||
|
- name: remove_extra
|
||||||
|
comment: 'Remove mounting holes'
|
||||||
|
type: generic
|
||||||
|
exclude_any:
|
||||||
|
- column: References
|
||||||
|
regex: "^H\\d+"
|
||||||
|
|
||||||
|
outputs:
|
||||||
|
- name: 'position'
|
||||||
|
type: position
|
||||||
|
dir: positiondir
|
||||||
|
options:
|
||||||
|
dnf_filter: remove_extra
|
||||||
|
format: CSV # CSV or ASCII format
|
||||||
|
units: millimeters # millimeters or inches
|
||||||
|
separate_files_for_front_and_back: false
|
||||||
|
only_smd: false
|
||||||
|
include_virtual: true
|
||||||
|
|
||||||
|
Here the `remove_extra` filter removes references starting with `H` and followed by a number, which are used for mounting holes.
|
||||||
|
You could also filter them using a regular expression for the footprint.
|
||||||
|
|
||||||
|
The following example will generate a positions file only with the fiducials:
|
||||||
|
|
||||||
|
.. code:: yaml
|
||||||
|
|
||||||
|
kibot:
|
||||||
|
version: 1
|
||||||
|
|
||||||
|
filters:
|
||||||
|
- name: remove_extra
|
||||||
|
comment: 'Keep only fiducials'
|
||||||
|
type: generic
|
||||||
|
include_only:
|
||||||
|
- column: References
|
||||||
|
regex: "^FID\\d+"
|
||||||
|
|
||||||
|
outputs:
|
||||||
|
- name: 'position'
|
||||||
|
type: position
|
||||||
|
dir: positiondir
|
||||||
|
options:
|
||||||
|
dnf_filter: remove_extra
|
||||||
|
format: CSV # CSV or ASCII format
|
||||||
|
units: millimeters # millimeters or inches
|
||||||
|
separate_files_for_front_and_back: false
|
||||||
|
only_smd: false
|
||||||
|
include_virtual: true
|
||||||
|
|
||||||
|
|
||||||
|
Note that this needs synchronized schematics and PCBs. This means that all important objects in the PCB must be related to a
|
||||||
|
symbol in the schematic and that you must ask KiCad to sync both. In particular the above example assumes fiducials are also
|
||||||
|
in the schematic.
|
||||||
|
|
||||||
|
If the PCB contains footprints not found in the schematic, like in the case of a KiKit panel, you'll need KiBot 1.6.4 or newer.
|
||||||
|
|
||||||
|
|
||||||
.. index::
|
.. index::
|
||||||
pair: position; XYRS files
|
pair: position; XYRS files
|
||||||
pair: pick and place; XYRS files
|
pair: pick and place; XYRS files
|
||||||
|
|
||||||
|
|
||||||
XYRS files
|
XYRS files
|
||||||
~~~~~~~~~~
|
~~~~~~~~~~
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue