Skip to content

Latest commit

 

History

History
394 lines (319 loc) · 7.28 KB

readme.md

File metadata and controls

394 lines (319 loc) · 7.28 KB
Raw

WireViz Tutorial

01 - Bare-bones example

  • Minimum working example
  • Only 1-to-1 sequential wiring
connectors:
  X1:
    pincount: 4
  X2:
    pincount: 4

cables:
  W1:
    wirecount: 4
    length: 1

connections:
  -
    - X1: [1-4]
    - W1: [1-4]
    - X2: [1-4]

Source - Bill of Materials

02 - Adding parameters and colors

  • Parameters for connectors and cables
  • Auto-calculate equivalent AWG from mm2
  • Non-sequential wiring
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 - Bill of Materials

03 - Pinouts, shielding, templates (I)

  • Connector pinouts
    • Pincount implicit in pinout
  • Cable color codes
  • Cable shielding, shield wiring
  • Templates
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 - Bill of Materials

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
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 - Bill of Materials

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
connectors:
  X1:
    pinlabels: [+12V, GND, GND, +5V]
    type: Molex 8981
    subtype: female
  F1:
    style: simple
    autogenerate: true
    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 - Bill of Materials

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
connectors:
  X1:
    pinlabels: [+12V, GND, GND, +5V]
    type: Molex 8981
    subtype: female
  F_10: # this is a unique ferrule
    style: simple
    show_name: false # non-autogenerated connectors show their name by default; override
    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
    autogenerate: true
    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, F_10, F_05]
      - W1: [1-4]
      - X1: [1-4]

Source - Bill of Materials

07 - Daisy chaining (II)

  • Zig-zag daisy chain
    • Convenient for longer chains
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 - Bill of Materials

08 - Part numbers

  • 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 the bom
connectors:
  X1: &template1 # define a template for later use
    type: Molex KK 254
    pincount: 4
    subtype: female
    manufacturer: Molex # set manufacter name
    mpn: 22013047 # set manufacturer part number
  X2:
    <<: *template1 # reuse template
    pn: CON4 # set an internal part number
  X3:
    <<: *template1 # reuse template

cables:
  W1:
    wirecount: 4
    length: 1
    gauge: 0.25 mm2
    color_code: IEC
    manufacturer: CablesCo
    mpn: ABC123
    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]
    pn: [WIRE1,WIRE2,WIRE2,WIRE3]


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
    description: Label, pinout information
    qty: 2
    designators:
      - X2
      - X3
    manufacturer: generic company
    mpn: Label1
    pn: Label-ID-1

Source - Bill of Materials