From fdb25f2eda4ee82aaf602bfad82b3bab70a1cdbd Mon Sep 17 00:00:00 2001 From: jaseg Date: Fri, 6 Oct 2023 14:11:01 +0200 Subject: [PATCH] README: Update and add usage section --- README.rst | 49 +++++++++++++++++++++++++++++++--- screenshot-mesh-schematic.png | Bin 0 -> 50833 bytes 2 files changed, 46 insertions(+), 3 deletions(-) create mode 100644 screenshot-mesh-schematic.png diff --git a/README.rst b/README.rst index f00d9f8..479690f 100644 --- a/README.rst +++ b/README.rst @@ -9,9 +9,52 @@ This repository contains KiMesh, a KiCAD pcbnew plugin that generates security m Installation ------------ -To install, copy the "kimesh" directory into your KiCAD installation's scripting plugin folder. Usually, this is -`~/.config/kicad/scripting/plugins/` for KiCAD stable installations or `~/.config/kicad/5.99/scripting/plugins/` for -nightly builds. On Windows, these paths can be found in your user account's `AppData/Roaming` directory. + +KiMesh has two parts: The pcbnew plugin that generates the traces, and the magic footprints that you use to tell the +plugin how many traces of which dimensions to generate where. + +To install the plugin, copy the "kimesh" directory into your KiCAD installation's scripting plugin folder. Usually, this +is `~/.config/kicad/scripting/plugins/` for KiCAD stable installations or +`~/.config/kicad/[major version].99/scripting/plugins/` for nightly builds. On Windows, these paths can be found in your +user account's `AppData/Roaming` directory. + +To install the footprint libraries, the easiest way is to download the library zip from the project's repo +`[link] `__, unpack it to your project folder, and +add the unpacked libraries as project-specific libraries through KiCad's library management thingy. + +Usage +----- + +To work, KiMesh requires four things: + +1. An area free of other features such as footprints or traces where to generate the mesh. +2. One or more "graphic polygons" on a drawing layer that specify the area of the mesh. +3. A closed board outline on the `Edge.Cuts` layer. +4. One of the magic footprints from the KiMesh anchor library that defines the mesh's number of wires and their + dimensions, and tells KiMesh where to start the mesh and in which direction to start it. + +You can choose any layer for the outline polygons, such as the pre-defined `User.Eco1` or `User.X` layers, or you can +define your own. You just have to select that layer later in KiMesh's generator dialog. Note that KiMesh only processes +graphic polygons on that layer, and ignores other shapes such as lines, rectangles or circles. You can still use other +shapes, but you have to manually convert them to polygons before running KiMesh. To convert other shapes to +a polygon, select them, open the context menu with a right click, then choose the "Create from Selection 🞂 Create +Polygon from Selection" entry. For rectangles or circles, use the "Use Centerlines" option. For lines or arcs, use the +"Create bounding hull" option. + +Place the magic anchor footprint on the outline of the mesh's shape polygons so that you have space to route out the +traces. The anchor footprint has an arrow on the `F.Fab` layer that indicates in which direction the mesh will be +generated. + +I recommend adding the mesh to the schematic with one of KiCad's built-in `Connector_02xN_Top_Bottom` footprints. For a +mesh with k wires, choose a symbol with two rows of 2k pins each. For instance, for two mesh wires, choose +`Connector_02x04_Top_bottom`. Then assign one of the magic footprints to that symbol. To avoid DRC warnings, join the +two halves of the mesh on the output side of the footprint. That's the right side in default orientation, where the +higher-numbered pins are. + +.. image:: screenshot-mesh-schematic.png + :width: 800 + :alt: A screenshot of the connector footprint mentioned in the previous paragraph, shown conencted up as described in + KiCad's schematic editor. Theory of operation ------------------- diff --git a/screenshot-mesh-schematic.png b/screenshot-mesh-schematic.png new file mode 100644 index 0000000000000000000000000000000000000000..2869b5ef6c1ca1629d9733dbe39845f850b289da GIT binary patch literal 50833 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%0A*>hR~bc0boWa&4#zU-R2_p_3^C1A~S+t3>Ik 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


*rrJBh_P%>) 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 MUHx3vIVCg!0L?ZY>i_@% literal 0 HcmV?d00001