Merge 39bb556eb486433648abb019eb719b95c09dde10 into e4fe099f8c7b86736aee7b4227cc794b6e8b36f0
This commit is contained in:
Ton
GitHub
commit
e854e97c16
BIN
tutorial/MolexKK254.jpg
Normal file
BIN
tutorial/MolexKK254.jpg
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 5.8 KiB |
BIN
tutorial/MolexKK254MALE.jpg
Normal file
BIN
tutorial/MolexKK254MALE.jpg
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 12 KiB |
@ -1,5 +1,24 @@
|
|||||||
# WireViz Tutorial
|
# WireViz Tutorial
|
||||||
|
|
||||||
|
[01 - Bare-bones example](#01---Bare-bones-example)
|
||||||
|
|
||||||
|
[02 - Adding parameters and colors](#02---adding-parameters-and-colors)
|
||||||
|
|
||||||
|
[03 - Pinouts, shielding, templates (I)](#03---pinouts-shielding-templates-(I))
|
||||||
|
|
||||||
|
[04 - Templates (II), notes, American standards, daisy chaining (I)](#04---templates-(II)-notes-american-standards-daisy-chaining-(I))
|
||||||
|
|
||||||
|
[05 - Ferrules, wire bundles, custom wire colors](#05---ferrules,-wire-bundles,-custom-wire-colors)
|
||||||
|
|
||||||
|
[06 - Custom ferrules](#06---custom-ferrules)
|
||||||
|
|
||||||
|
[07 - Daisy chaining (II)](#07---daisy-chaining-(II))
|
||||||
|
|
||||||
|
[08 - Part numbers and additional components](#08---part-numbers-and-additional-components)
|
||||||
|
|
||||||
|
[09 - Hidden wire information and using a template for nice display](#09---hidden-wire-information-and-using-a-template-for-nice-display-as-a-din6771-document)
|
||||||
|
|
||||||
|
|
||||||
## 01 - Bare-bones example
|
## 01 - Bare-bones example
|
||||||
|
|
||||||
* Minimum working example
|
* Minimum working example
|
||||||
@ -417,3 +436,39 @@ additional_bom_items:
|
|||||||
[Source](tutorial08.yml) - [Bill of Materials](tutorial08.bom.tsv)
|
[Source](tutorial08.yml) - [Bill of Materials](tutorial08.bom.tsv)
|
||||||
|
|
||||||
|
|
||||||
|
## 09 - Hidden wire information and using a template for nice display as a DIN6771 document
|
||||||
|
|
||||||
|
What will this 'tutorial' show you?
|
||||||
|
|
||||||
|
## Hide wire information
|
||||||
|
|
||||||
|
* Sometimes the box around the wire will be distracting
|
||||||
|
* unfortunately some fields can not (yetd) be suppressed:
|
||||||
|
length
|
||||||
|
gauge
|
||||||
|
color_code
|
||||||
|
manufacturer
|
||||||
|
mpn
|
||||||
|
supplier
|
||||||
|
spn
|
||||||
|
pn
|
||||||
|
|
||||||
|
## Nice uniform template
|
||||||
|
|
||||||
|
* Formatting the end result in a DIN-6771 template makes for a very nice result.
|
||||||
|
* using a template ensures all your wiring diagrams will have a uniform look
|
||||||
|
* the template can be found at:
|
||||||
|
/home/[USER]/.local/lib/python3.10/site-packages/wireviz/templates/din-6771.html
|
||||||
|
|
||||||
|
## Adding images to your components
|
||||||
|
* Add an image to your component
|
||||||
|
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
<!-- include(tutorial09.yml) -->
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
[Source](tutorial09.yml) - [Bill of Materials](tutorial09.bom.tsv)
|
||||||
576
tutorial/readme09.md
Normal file
576
tutorial/readme09.md
Normal file
@ -0,0 +1,576 @@
|
|||||||
|
# WireViz Tutorial
|
||||||
|
|
||||||
|
## [01 - Bare-bones example](01---Bare-bones-example)
|
||||||
|
## [02 - Adding parameters and colors](02---Adding-parameters-and-colors)
|
||||||
|
## [03 - Pinouts, shielding, templates (I)](03---Pinouts,-shielding,-templates-(I))
|
||||||
|
## [04 - Templates (II), notes, American standards, daisy chaining (I)](04---Templates-(II),-notes,-American-standards,-daisy-chaining-(I))
|
||||||
|
## [05 - Ferrules, wire bundles, custom wire colors](05---Ferrules,-wire-bundles,-custom-wire-colors)
|
||||||
|
## [06 - Custom ferrules](06---Custom-ferrules)
|
||||||
|
## [07 - Daisy chaining (II)](07---Daisy-chaining-(II))
|
||||||
|
## [08 - Part numbers and additional components](08---Part-numbers-and-additional-components)
|
||||||
|
## [09 - Hidden wire information and using a template for nice display as a DIN6771 document](09---Hidden-wire-information-and-using-a-template-for-nice-display-as-a-DIN6771-document)
|
||||||
|
|
||||||
|
|
||||||
|
## 01 - Bare-bones example
|
||||||
|
|
||||||
|
* Minimum working example
|
||||||
|
* Only 1-to-1 sequential wiring
|
||||||
|
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
connectors:
|
||||||
|
X1:
|
||||||
|
pincount: 4
|
||||||
|
X2:
|
||||||
|
pincount: 4
|
||||||
|
|
||||||
|
cables:
|
||||||
|
W1:
|
||||||
|
wirecount: 4
|
||||||
|
length: 1
|
||||||
|
|
||||||
|
connections:
|
||||||
|
-
|
||||||
|
- X1: [1-4]
|
||||||
|
- W1: [1-4]
|
||||||
|
- X2: [1-4]
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
[Source](tutorial01.yml) - [Bill of Materials](tutorial01.bom.tsv)
|
||||||
|
|
||||||
|
|
||||||
|
## 02 - Adding parameters and colors
|
||||||
|
|
||||||
|
* Parameters for connectors and cables
|
||||||
|
* Auto-calculate equivalent AWG from mm2
|
||||||
|
* Non-sequential wiring
|
||||||
|
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
connectors:
|
||||||
|
X1:
|
||||||
|
pincount: 4
|
||||||
|
# More connector parameters:
|
||||||
|
type: Molex KK 254
|
||||||
|
subtype: female
|
||||||
|
X2:
|
||||||
|
pincount: 4
|
||||||
|
type: Molex KK 254
|
||||||
|
subtype: female
|
||||||
|
|
||||||
|
cables:
|
||||||
|
W1:
|
||||||
|
wirecount: 4
|
||||||
|
# more cable parameters:
|
||||||
|
length: 1
|
||||||
|
gauge: 0.25 mm2
|
||||||
|
show_equiv: true # auto-calculate AWG equivalent
|
||||||
|
colors: [WH, BN, GN, YE]
|
||||||
|
|
||||||
|
connections:
|
||||||
|
-
|
||||||
|
- X1: [1-4]
|
||||||
|
- W1: [1-4]
|
||||||
|
# non-sequential wiring:
|
||||||
|
- X2: [1,2,4,3]
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
[Source](tutorial02.yml) - [Bill of Materials](tutorial02.bom.tsv)
|
||||||
|
|
||||||
|
|
||||||
|
## 03 - Pinouts, shielding, templates (I)
|
||||||
|
|
||||||
|
* Connector pinouts
|
||||||
|
* Pincount implicit in pinout
|
||||||
|
* Cable color codes
|
||||||
|
* Cable shielding, shield wiring
|
||||||
|
* Templates
|
||||||
|
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
connectors:
|
||||||
|
X1: &template1 # define a template for later use
|
||||||
|
pinlabels: [GND, VCC, RX, TX] # pincount implicit in pinout
|
||||||
|
type: Molex KK 254
|
||||||
|
subtype: female
|
||||||
|
X2:
|
||||||
|
<<: *template1 # reuse template
|
||||||
|
|
||||||
|
cables:
|
||||||
|
W1:
|
||||||
|
wirecount: 4
|
||||||
|
length: 1
|
||||||
|
gauge: 0.25 mm2
|
||||||
|
show_equiv: true
|
||||||
|
color_code: DIN # auto-assign colors based on DIN 47100
|
||||||
|
shield: true # add cable shielding
|
||||||
|
|
||||||
|
connections:
|
||||||
|
-
|
||||||
|
- X1: [1-4]
|
||||||
|
- W1: [1-4]
|
||||||
|
- X2: [1,2,4,3]
|
||||||
|
- # connect the shielding to a pin
|
||||||
|
- X1: 1
|
||||||
|
- W1: s
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
[Source](tutorial03.yml) - [Bill of Materials](tutorial03.bom.tsv)
|
||||||
|
|
||||||
|
|
||||||
|
## 04 - Templates (II), notes, American standards, daisy chaining (I)
|
||||||
|
|
||||||
|
* Overriding template parameters
|
||||||
|
* Add nodes to connectors and cables
|
||||||
|
* American standards: AWG gauge and IEC colors
|
||||||
|
* Linear daisy-chain
|
||||||
|
* Convenient for shorter chains
|
||||||
|
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
connectors:
|
||||||
|
X1: &template_con
|
||||||
|
pinlabels: [GND, VCC, SCL, SDA]
|
||||||
|
type: Molex KK 254
|
||||||
|
subtype: male
|
||||||
|
notes: to microcontroller # add notes
|
||||||
|
X2:
|
||||||
|
<<: *template_con # use template
|
||||||
|
subtype: female # but override certain parameters
|
||||||
|
notes: to accelerometer
|
||||||
|
X3:
|
||||||
|
<<: *template_con
|
||||||
|
subtype: female
|
||||||
|
notes: to temperature sensor
|
||||||
|
|
||||||
|
cables:
|
||||||
|
W1: &template_cbl
|
||||||
|
wirecount: 4
|
||||||
|
length: 0.3
|
||||||
|
gauge: 24 AWG # specify gauge in AWG directly
|
||||||
|
color_code: IEC # IEC 62 colors also supported
|
||||||
|
notes: This cable is a bit longer
|
||||||
|
W2:
|
||||||
|
<<: *template_cbl
|
||||||
|
length: 0.1
|
||||||
|
notes: This cable is a bit shorter
|
||||||
|
|
||||||
|
connections:
|
||||||
|
-
|
||||||
|
- X1: [1-4]
|
||||||
|
- W1: [1-4]
|
||||||
|
- X2: [1-4]
|
||||||
|
- # daisy chain connectors (in line)
|
||||||
|
- X2: [1-4]
|
||||||
|
- W2: [1-4]
|
||||||
|
- X3: [1-4]
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
[Source](tutorial04.yml) - [Bill of Materials](tutorial04.bom.tsv)
|
||||||
|
|
||||||
|
|
||||||
|
## 05 - Ferrules, wire bundles, custom wire colors
|
||||||
|
|
||||||
|
* Ferrules
|
||||||
|
* Simpler than connectors
|
||||||
|
* Compact graphical representation
|
||||||
|
* Only one pin, only one connection, no designator
|
||||||
|
* Define once, auto-generate where needed
|
||||||
|
* Wire bundles
|
||||||
|
* Internally treated as cables
|
||||||
|
* Different treatment in BOM: Each wire is listed individually
|
||||||
|
* Represented with dashed outline
|
||||||
|
* Custom wire colors
|
||||||
|
* Wirecount can be implicit in color list
|
||||||
|
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
connectors:
|
||||||
|
X1:
|
||||||
|
pinlabels: [+12V, GND, GND, +5V]
|
||||||
|
type: Molex 8981
|
||||||
|
subtype: female
|
||||||
|
F1:
|
||||||
|
style: simple
|
||||||
|
type: Crimp ferrule
|
||||||
|
subtype: 0.5 mm²
|
||||||
|
color: OG # optional color
|
||||||
|
|
||||||
|
cables:
|
||||||
|
W1:
|
||||||
|
category: bundle # bundle
|
||||||
|
length: 0.3
|
||||||
|
gauge: 0.5 mm2
|
||||||
|
colors: [YE, BK, BK, RD] # custom colors, wirecount is implicit
|
||||||
|
|
||||||
|
connections:
|
||||||
|
-
|
||||||
|
- F1. # a new ferrule is auto-generated for each of the four wires
|
||||||
|
- W1: [1-4]
|
||||||
|
- X1: [1-4]
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
[Source](tutorial05.yml) - [Bill of Materials](tutorial05.bom.tsv)
|
||||||
|
|
||||||
|
|
||||||
|
## 06 - Custom ferrules
|
||||||
|
|
||||||
|
* Custom ferrules
|
||||||
|
* Allows attaching more than one wire to a ferrule
|
||||||
|
* Requires defining them as regular connectors with unique designators, adding `category: ferrule` parameter
|
||||||
|
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
connectors:
|
||||||
|
X1:
|
||||||
|
pinlabels: [+12V, GND, GND, +5V]
|
||||||
|
type: Molex 8981
|
||||||
|
subtype: female
|
||||||
|
F_10: # this is a unique ferrule
|
||||||
|
style: simple
|
||||||
|
type: Crimp ferrule
|
||||||
|
subtype: 1.0 mm²
|
||||||
|
color: YE # optional color
|
||||||
|
F_05: # this is a ferrule that will be auto-generated on demand
|
||||||
|
style: simple
|
||||||
|
type: Crimp ferrule
|
||||||
|
subtype: 0.5 mm²
|
||||||
|
color: OG
|
||||||
|
|
||||||
|
cables:
|
||||||
|
W1:
|
||||||
|
category: bundle # bundle
|
||||||
|
length: 0.3
|
||||||
|
gauge: 0.5 mm2
|
||||||
|
colors: [YE, BK, BK, RD] # custom colors, wirecount is implicit
|
||||||
|
|
||||||
|
connections:
|
||||||
|
-
|
||||||
|
- [F_05., F_10.F1, F_10.F1, F_05.]
|
||||||
|
- W1: [1-4]
|
||||||
|
- X1: [1-4]
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
[Source](tutorial06.yml) - [Bill of Materials](tutorial06.bom.tsv)
|
||||||
|
|
||||||
|
|
||||||
|
## 07 - Daisy chaining (II)
|
||||||
|
|
||||||
|
* Zig-zag daisy chain
|
||||||
|
* Convenient for longer chains
|
||||||
|
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
connectors:
|
||||||
|
X1: &template_con
|
||||||
|
type: Molex KK 254
|
||||||
|
subtype: female
|
||||||
|
pinlabels: [GND, VCC, SCL, SDA]
|
||||||
|
X2:
|
||||||
|
<<: *template_con
|
||||||
|
X3:
|
||||||
|
<<: *template_con
|
||||||
|
X4:
|
||||||
|
<<: *template_con
|
||||||
|
X5:
|
||||||
|
<<: *template_con
|
||||||
|
X6:
|
||||||
|
<<: *template_con
|
||||||
|
|
||||||
|
cables:
|
||||||
|
W1: &template_wire
|
||||||
|
gauge: 0.25 mm2
|
||||||
|
length: 0.2
|
||||||
|
colors: [TQ, PK, YE, VT]
|
||||||
|
category: bundle
|
||||||
|
W2:
|
||||||
|
<<: *template_wire
|
||||||
|
W3:
|
||||||
|
<<: *template_wire
|
||||||
|
W4:
|
||||||
|
<<: *template_wire
|
||||||
|
W5:
|
||||||
|
<<: *template_wire
|
||||||
|
|
||||||
|
connections:
|
||||||
|
-
|
||||||
|
- X1: [1-4]
|
||||||
|
- W1: [1-4]
|
||||||
|
- X2: [1-4]
|
||||||
|
-
|
||||||
|
- X3: [1-4]
|
||||||
|
- W2: [1-4]
|
||||||
|
- X2: [1-4]
|
||||||
|
-
|
||||||
|
- X3: [1-4]
|
||||||
|
- W3: [1-4]
|
||||||
|
- X4: [1-4]
|
||||||
|
-
|
||||||
|
- X5: [1-4]
|
||||||
|
- W4: [1-4]
|
||||||
|
- X4: [1-4]
|
||||||
|
-
|
||||||
|
- X5: [1-4]
|
||||||
|
- W5: [1-4]
|
||||||
|
- X6: [1-4]
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
[Source](tutorial07.yml) - [Bill of Materials](tutorial07.bom.tsv)
|
||||||
|
|
||||||
|
|
||||||
|
## 08 - Part numbers and additional components
|
||||||
|
|
||||||
|
* Part number information can be added to parts
|
||||||
|
* Only provided fields will be added to the diagram and bom
|
||||||
|
* Bundles can have part information specified by wire
|
||||||
|
* Additional parts can be added to components or just to the bom
|
||||||
|
* quantities of additional components can be multiplied by features from parent connector or cable
|
||||||
|
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
options:
|
||||||
|
mini_bom_mode: false
|
||||||
|
|
||||||
|
connectors:
|
||||||
|
X1: &template1 # define a template for later use
|
||||||
|
type: Molex KK 254
|
||||||
|
pincount: 4
|
||||||
|
subtype: female
|
||||||
|
manufacturer: '<a href="https://www.molex.com/">Molex</a>' # set manufacter name
|
||||||
|
mpn: '<a href="https://www.molex.com/molex/products/part-detail/crimp_housings/0022013047">22013047</a>' # set manufacturer part number
|
||||||
|
supplier: Digimouse
|
||||||
|
spn: 1234
|
||||||
|
# add a list of additional components to a part (shown in graph)
|
||||||
|
additional_components:
|
||||||
|
- type: Crimp # short identifier used in graph
|
||||||
|
subtype: Molex KK 254, 22-30 AWG # extra information added to type in bom
|
||||||
|
qty_multiplier: populated # multipier for quantity (number of populated pins)
|
||||||
|
manufacturer: Molex # set manufacter name
|
||||||
|
mpn: 08500030 # set manufacturer part number
|
||||||
|
- type: Test
|
||||||
|
qty: 1
|
||||||
|
pn: ABC
|
||||||
|
manufacturer: Molex
|
||||||
|
mpn: 45454
|
||||||
|
supplier: Mousikey
|
||||||
|
spn: 9999
|
||||||
|
X2:
|
||||||
|
<<: *template1 # reuse template
|
||||||
|
pn: CON4 # set an internal part number for just this connector
|
||||||
|
X3:
|
||||||
|
<<: *template1 # reuse template
|
||||||
|
|
||||||
|
cables:
|
||||||
|
W1:
|
||||||
|
wirecount: 4
|
||||||
|
length: 1
|
||||||
|
gauge: 0.25 mm2
|
||||||
|
color_code: IEC
|
||||||
|
manufacturer: CablesCo
|
||||||
|
mpn: ABC123
|
||||||
|
supplier: Cables R Us
|
||||||
|
spn: 999-888-777
|
||||||
|
pn: CAB1
|
||||||
|
W2:
|
||||||
|
category: bundle
|
||||||
|
length: 1
|
||||||
|
gauge: 0.25 mm2
|
||||||
|
colors: [YE, BK, BK, RD]
|
||||||
|
manufacturer: [WiresCo, WiresCo, WiresCo, WiresCo] # set a manufacter per wire
|
||||||
|
mpn: [W1-YE, W1-BK, W1-BK, W1-RD]
|
||||||
|
supplier: [WireShack, WireShack, WireShack, WireShack]
|
||||||
|
spn: [1001, 1002, 1002, 1009]
|
||||||
|
pn: [WIRE1, WIRE2, WIRE2, WIRE3]
|
||||||
|
# add a list of additional components to a part (shown in graph)
|
||||||
|
additional_components:
|
||||||
|
- type: Sleve # short identifier used in graph
|
||||||
|
subtype: Braided nylon, black, 3mm # extra information added to type in bom
|
||||||
|
qty_multiplier: length # multipier for quantity (length of cable)
|
||||||
|
unit: m
|
||||||
|
pn: SLV-1
|
||||||
|
|
||||||
|
connections:
|
||||||
|
- - X1: [1-4]
|
||||||
|
- W1: [1-4]
|
||||||
|
- X2: [1-4]
|
||||||
|
- - X1: [1-4]
|
||||||
|
- W2: [1-4]
|
||||||
|
- X3: [1-4]
|
||||||
|
|
||||||
|
additional_bom_items:
|
||||||
|
- # define an additional item to add to the bill of materials (does not appear in graph)
|
||||||
|
description: Label, pinout information
|
||||||
|
qty: 2
|
||||||
|
designators:
|
||||||
|
- X2
|
||||||
|
- X3
|
||||||
|
manufacturer: '<a href="https://www.bradyid.com">Brady</a>'
|
||||||
|
mpn: '<a href="https://www.bradyid.com/wire-cable-labels/bmp71-bmp61-m611-tls-2200-nylon-cloth-wire-general-id-labels-cps-2958789">B-499</a>'
|
||||||
|
pn: Label-ID-1
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
[Source](tutorial08.yml) - [Bill of Materials](tutorial08.bom.tsv)
|
||||||
|
|
||||||
|
|
||||||
|
## 09 - Hidden wire information and using a template for nice display as a DIN6771 document
|
||||||
|
|
||||||
|
What will this 'tutorial' show you?
|
||||||
|
|
||||||
|
##Hidden wire information
|
||||||
|
* Sometimes the box around the wire will be distrating
|
||||||
|
* unfurtionaly some fields can not (yet) be suppressed:
|
||||||
|
length
|
||||||
|
gauge
|
||||||
|
color_code
|
||||||
|
manufacturer
|
||||||
|
mpn
|
||||||
|
supplier
|
||||||
|
spn
|
||||||
|
pn
|
||||||
|
##Nice uniform template
|
||||||
|
* Formatting the end result in a DIN-6771 template makes for a very nice result.
|
||||||
|
* using a template ensures all your wiring diagrams will have a uniform look
|
||||||
|
* the template can be found at: /home/[USER]/.local/lib/python3.10/site-packages/wireviz/templates/din-6771.html
|
||||||
|
##Adding images to your components
|
||||||
|
* Add an image to your connector (or wire)
|
||||||
|
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
|
||||||
|
|
||||||
|
connectors:
|
||||||
|
X1: &template1 # define a template for later use
|
||||||
|
type: Molex KK 254
|
||||||
|
pincount: 4
|
||||||
|
subtype: female
|
||||||
|
manufacturer: '<a href="https://www.molex.com/">Molex</a>' # set manufacter name
|
||||||
|
mpn: '<a href="https://www.molex.com/molex/products/part-detail/crimp_housings/0022013047">22013047</a>' # set manufacturer part number
|
||||||
|
supplier: Digimouse
|
||||||
|
spn: 1234
|
||||||
|
image:
|
||||||
|
src: MolexKK254.jpg
|
||||||
|
# add a list of additional components to a part (shown in graph)
|
||||||
|
additional_components:
|
||||||
|
- type: Crimp # short identifier used in graph
|
||||||
|
subtype: Molex KK 254, 22-30 AWG # extra information added to type in bom
|
||||||
|
qty_multiplier: populated # multipier for quantity (number of populated pins)
|
||||||
|
manufacturer: Molex # set manufacter name
|
||||||
|
mpn: 08500030 # set manufacturer part number
|
||||||
|
- type: Test
|
||||||
|
qty: 1
|
||||||
|
pn: ABC
|
||||||
|
manufacturer: Molex
|
||||||
|
mpn: 45454
|
||||||
|
supplier: Mousikey
|
||||||
|
spn: 9999
|
||||||
|
X2:
|
||||||
|
<<: *template1 # reuse template
|
||||||
|
pn: CON4 # set an internal part number for just this connector
|
||||||
|
subtype: male
|
||||||
|
image:
|
||||||
|
src: MolexKK254MALE.jpg
|
||||||
|
|
||||||
|
X3:
|
||||||
|
<<: *template1 # reuse template
|
||||||
|
subtype: male
|
||||||
|
image:
|
||||||
|
src: MolexKK254MALE.jpg
|
||||||
|
cables:
|
||||||
|
W1:
|
||||||
|
wirecount: 4
|
||||||
|
# length: 1
|
||||||
|
# gauge: 0.25 mm2
|
||||||
|
# color_code: IEC
|
||||||
|
# manufacturer: CablesCo
|
||||||
|
# mpn: ABC123
|
||||||
|
# supplier: Cables R Us
|
||||||
|
# spn: 999-888-777
|
||||||
|
# pn: CAB1
|
||||||
|
#############
|
||||||
|
show_name: false
|
||||||
|
show_wirecount: false
|
||||||
|
show_wirenumbers: false
|
||||||
|
#############
|
||||||
|
W2:
|
||||||
|
category: bundle
|
||||||
|
length: 1
|
||||||
|
gauge: 0.25 mm2
|
||||||
|
colors: [YE, BK, BK, RD]
|
||||||
|
manufacturer: [WiresCo, WiresCo, WiresCo, WiresCo] # set a manufacter per wire
|
||||||
|
mpn: [W1-YE, W1-BK, W1-BK, W1-RD]
|
||||||
|
supplier: [WireShack, WireShack, WireShack, WireShack]
|
||||||
|
spn: [1001, 1002, 1002, 1009]
|
||||||
|
pn: [WIRE1, WIRE2, WIRE2, WIRE3]
|
||||||
|
# add a list of additional components to a part (shown in graph)
|
||||||
|
additional_components:
|
||||||
|
- type: Sleve # short identifier used in graph
|
||||||
|
subtype: Braided nylon, black, 3mm # extra information added to type in bom
|
||||||
|
qty_multiplier: length # multipier for quantity (length of cable)
|
||||||
|
unit: m
|
||||||
|
pn: SLV-1
|
||||||
|
|
||||||
|
connections:
|
||||||
|
- - X1: [1-4]
|
||||||
|
- W1: [1-4]
|
||||||
|
- X2: [1-4]
|
||||||
|
- - X1: [1-4]
|
||||||
|
- W2: [1-4]
|
||||||
|
- X3: [1-4]
|
||||||
|
#############
|
||||||
|
tweak:
|
||||||
|
override:
|
||||||
|
graph:
|
||||||
|
ranksep: "0.5" # Reduce the horizontal spacing (default 2)
|
||||||
|
wireTweak: &wireTweak
|
||||||
|
shape: none # Hide the surrounding frame
|
||||||
|
fontsize: "12" # Reduce the space needed for text
|
||||||
|
fontcolor: white # Same as background to hide the text
|
||||||
|
## W1 uses the gauge and length field, they can not be suppressed at the moment. There was an issue #221
|
||||||
|
W1:
|
||||||
|
<<: *wireTweak
|
||||||
|
###############
|
||||||
|
|
||||||
|
###### the din template, A4 format
|
||||||
|
metadata:
|
||||||
|
title: Power supplies
|
||||||
|
pn: PSU
|
||||||
|
|
||||||
|
authors:
|
||||||
|
Created:
|
||||||
|
name: Ton
|
||||||
|
date: 2025-03-11
|
||||||
|
Approved:
|
||||||
|
name: Ton
|
||||||
|
date: 2025-03-11
|
||||||
|
|
||||||
|
revisions:
|
||||||
|
A:
|
||||||
|
name: Ton
|
||||||
|
date: 2025-03-12
|
||||||
|
changelog: updates]
|
||||||
|
|
||||||
|
template:
|
||||||
|
name: din-6771
|
||||||
|
sheetsize: A4
|
||||||
|
<!-- /include (tutorial09.yml) -->
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
[Source](tutorial09.yml) - [Bill of Materials](tutorial09.bom.tsv)
|
||||||
11
tutorial/tutorial09.bom.tsv
generated
Normal file
11
tutorial/tutorial09.bom.tsv
generated
Normal file
@ -0,0 +1,11 @@
|
|||||||
|
Id Description Qty Unit Designators P/N Manufacturer MPN Supplier SPN
|
||||||
|
1 Cable, 4 wires 0 m
|
||||||
|
2 Connector, Molex KK 254, female, 4 pins 1 X1 Molex 22013047 Digimouse 1234
|
||||||
|
3 Connector, Molex KK 254, male, 4 pins 1 X3 Molex 22013047 Digimouse 1234
|
||||||
|
4 Connector, Molex KK 254, male, 4 pins 1 X2 CON4 Molex 22013047 Digimouse 1234
|
||||||
|
5 Crimp, Molex KK 254, 22-30 AWG 12 X1, X2, X3 Molex 08500030
|
||||||
|
6 Sleve, Braided nylon, black, 3mm 1 m W2 SLV-1
|
||||||
|
7 Test 3 X1, X2, X3 ABC Molex 45454 Mousikey 9999
|
||||||
|
8 Wire, 0.25 mm², BK 2 m W2 WIRE2 WiresCo W1-BK WireShack 1002
|
||||||
|
9 Wire, 0.25 mm², RD 1 m W2 WIRE3 WiresCo W1-RD WireShack 1009
|
||||||
|
10 Wire, 0.25 mm², YE 1 m W2 WIRE1 WiresCo W1-YE WireShack 1001
|
||||||
|
730
tutorial/tutorial09.html
generated
Normal file
730
tutorial/tutorial09.html
generated
Normal file
File diff suppressed because one or more lines are too long
BIN
tutorial/tutorial09.png
generated
Normal file
BIN
tutorial/tutorial09.png
generated
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 460 KiB |
312
tutorial/tutorial09.svg
generated
Normal file
312
tutorial/tutorial09.svg
generated
Normal file
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 64 KiB |
114
tutorial/tutorial09.yml
Normal file
114
tutorial/tutorial09.yml
Normal file
@ -0,0 +1,114 @@
|
|||||||
|
connectors:
|
||||||
|
X1: &template1 # define a template for later use
|
||||||
|
type: Molex KK 254
|
||||||
|
pincount: 4
|
||||||
|
subtype: female
|
||||||
|
manufacturer: '<a href="https://www.molex.com/">Molex</a>' # set manufacter name
|
||||||
|
mpn: '<a href="https://www.molex.com/molex/products/part-detail/crimp_housings/0022013047">22013047</a>' # set manufacturer part number
|
||||||
|
supplier: Digimouse
|
||||||
|
spn: 1234
|
||||||
|
image:
|
||||||
|
src: MolexKK254.jpg
|
||||||
|
# add a list of additional components to a part (shown in graph)
|
||||||
|
additional_components:
|
||||||
|
- type: Crimp # short identifier used in graph
|
||||||
|
subtype: Molex KK 254, 22-30 AWG # extra information added to type in bom
|
||||||
|
qty_multiplier: populated # multipier for quantity (number of populated pins)
|
||||||
|
manufacturer: Molex # set manufacter name
|
||||||
|
mpn: 08500030 # set manufacturer part number
|
||||||
|
- type: Test
|
||||||
|
qty: 1
|
||||||
|
pn: ABC
|
||||||
|
manufacturer: Molex
|
||||||
|
mpn: 45454
|
||||||
|
supplier: Mousikey
|
||||||
|
spn: 9999
|
||||||
|
X2:
|
||||||
|
<<: *template1 # reuse template
|
||||||
|
pn: CON4 # set an internal part number for just this connector
|
||||||
|
subtype: male
|
||||||
|
image:
|
||||||
|
src: MolexKK254MALE.jpg
|
||||||
|
|
||||||
|
X3:
|
||||||
|
<<: *template1 # reuse template
|
||||||
|
subtype: male
|
||||||
|
image:
|
||||||
|
src: MolexKK254MALE.jpg
|
||||||
|
cables:
|
||||||
|
W1:
|
||||||
|
wirecount: 4
|
||||||
|
# length: 1
|
||||||
|
# gauge: 0.25 mm2
|
||||||
|
# color_code: IEC
|
||||||
|
# manufacturer: CablesCo
|
||||||
|
# mpn: ABC123
|
||||||
|
# supplier: Cables R Us
|
||||||
|
# spn: 999-888-777
|
||||||
|
# pn: CAB1
|
||||||
|
#############
|
||||||
|
show_name: false
|
||||||
|
show_wirecount: false
|
||||||
|
show_wirenumbers: false
|
||||||
|
#############
|
||||||
|
W2:
|
||||||
|
category: bundle
|
||||||
|
length: 1
|
||||||
|
gauge: 0.25 mm2
|
||||||
|
colors: [YE, BK, BK, RD]
|
||||||
|
manufacturer: [WiresCo, WiresCo, WiresCo, WiresCo] # set a manufacter per wire
|
||||||
|
mpn: [W1-YE, W1-BK, W1-BK, W1-RD]
|
||||||
|
supplier: [WireShack, WireShack, WireShack, WireShack]
|
||||||
|
spn: [1001, 1002, 1002, 1009]
|
||||||
|
pn: [WIRE1, WIRE2, WIRE2, WIRE3]
|
||||||
|
# add a list of additional components to a part (shown in graph)
|
||||||
|
additional_components:
|
||||||
|
- type: Sleeve # short identifier used in graph
|
||||||
|
subtype: Braided nylon, black, 3mm # extra information added to type in bom
|
||||||
|
qty_multiplier: length # multipier for quantity (length of cable)
|
||||||
|
unit: m
|
||||||
|
pn: SLV-1
|
||||||
|
|
||||||
|
connections:
|
||||||
|
- - X1: [1-4]
|
||||||
|
- W1: [1-4]
|
||||||
|
- X2: [1-4]
|
||||||
|
- - X1: [1-4]
|
||||||
|
- W2: [1-4]
|
||||||
|
- X3: [1-4]
|
||||||
|
#############
|
||||||
|
tweak:
|
||||||
|
override:
|
||||||
|
graph:
|
||||||
|
ranksep: "0.5" # Reduce the horizontal spacing (default 2)
|
||||||
|
wireTweak: &wireTweak
|
||||||
|
shape: none # Hide the surrounding frame
|
||||||
|
fontsize: "12" # Reduce the space needed for text
|
||||||
|
fontcolor: white # Same as background to hide the text
|
||||||
|
## W1 uses the gauge and length field, they can not be suppressed at the moment. There was an issue #221
|
||||||
|
W1:
|
||||||
|
<<: *wireTweak
|
||||||
|
###############
|
||||||
|
|
||||||
|
###### the din template, A4 format
|
||||||
|
metadata:
|
||||||
|
title: Power supplies
|
||||||
|
pn: PSU
|
||||||
|
|
||||||
|
authors:
|
||||||
|
Created:
|
||||||
|
name: Ton
|
||||||
|
date: 2025-03-11
|
||||||
|
Approved:
|
||||||
|
name: Ton
|
||||||
|
date: 2025-03-11
|
||||||
|
|
||||||
|
revisions:
|
||||||
|
A:
|
||||||
|
name: Ton
|
||||||
|
date: 2025-03-12
|
||||||
|
changelog: updates]
|
||||||
|
|
||||||
|
template:
|
||||||
|
name: din-6771
|
||||||
|
sheetsize: A4
|
||||||
24
tutorial/vscode.md
Normal file
24
tutorial/vscode.md
Normal file
@ -0,0 +1,24 @@
|
|||||||
|
## Editing y(a)ml files with VSCode
|
||||||
|
|
||||||
|
If you already use vscode as your editor you are in luck. Steffano wrote a very handy how-to setup run-on-save extesion for vscode.
|
||||||
|
|
||||||
|
https://www.stefanocottafavi.com/vscode_wireviz/
|
||||||
|
|
||||||
|
|
||||||
|
If you want to use the prepend parameter so you can use a parent document (components.yml) with all your components defined you could do the following.
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
"settings": {
|
||||||
|
"emeraldwalk.runonsave": {
|
||||||
|
"commands": [
|
||||||
|
{
|
||||||
|
"match": "\\.yml$",
|
||||||
|
"cmd": "wireviz --prepend components.yml ${file} -f h"
|
||||||
|
},
|
||||||
|
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
(the -f h instructs wireviz to only produce a html file. Do a wireviz -h for a overview of all the parameters)
|
||||||
Loading…
x
Reference in New Issue
Block a user