Skip to content
WireVizDocs
⌘ K
Open editor
Examples

Branched cable harness

Route separate groups of controller pins to two sensor connectors.

Open in editor ↗Download YAMLDownload BOM
Branched cable harness rendered with WireViz, showing the connectors, wires and pin assignments
Generated directly from the example YAML with WireViz 0.4.1.

Purpose

Document two cable branches leaving one connector. Each branch uses its own controller pins; this example contains no wire splice or shared electrical junction. Its pinout and dimensions are illustrative.

Components

  • CONTROLLER has eight positions, four for each branch.
  • SENSOR_A and SENSOR_B each have four positions.
  • BRANCH_A is 0.4 meters long; BRANCH_B is 0.8 meters long.

Wiring

Pins 1–4 feed sensor A through the first cable. Pins 5–8 feed sensor B through the second cable. The YAML anchors &sensor and &branch share repeated properties. <<: *branch inherits the first cable's properties, then overrides its length.

What to change

Change the second branch's length independently. Add local properties to an inherited connector or cable when a branch differs. To add another branch, allocate further controller positions and add a cable, connector, and connection set for them.

Generated bill of materials

Id Description Qty Unit Designators
1 Cable, 4 x 24 AWG 1.2 m BRANCH_A, BRANCH_B
2 Connector, Eight-position controller connector, 8 pins 1 CONTROLLER
3 Connector, Four-position sensor connector, 4 pins 2 SENSOR_A, SENSOR_B

YAML source

branched-harness.yml
metadata:
  title: Controller harness with two branches
  description: Illustrative connector fanout, not a certified electrical design.

connectors:
  CONTROLLER:
    type: Eight-position controller connector
    pincount: 8
    pinlabels: [SUPPLY_A, RETURN_A, DATA_A, CLOCK_A, SUPPLY_B, RETURN_B, DATA_B, CLOCK_B]
  SENSOR_A: &sensor
    type: Four-position sensor connector
    pincount: 4
    pinlabels: [SUPPLY, RETURN, DATA, CLOCK]
  SENSOR_B:
    <<: *sensor

cables:
  BRANCH_A: &branch
    wirecount: 4
    gauge: 24 AWG
    length: 0.4
    colors: [RD, BK, YE, GN]
  BRANCH_B:
    <<: *branch
    length: 0.8

connections:
  - - CONTROLLER: [1-4]
    - BRANCH_A: [1-4]
    - SENSOR_A: [1-4]
  - - CONTROLLER: [5-8]
    - BRANCH_B: [1-4]
    - SENSOR_B: [1-4]