Why this happens
Hand sketches and photos of wiring are hard to read and easy to misinterpret, which leads to wrong connections. A proper diagram with labelled wires, connector pin numbers, fuse ratings and wire sizes makes a system understandable and checkable, and free schematic and diagram tools now do this well.
What you need
Tools
- Laptop
- A free schematic tool (for example KiCad)
- A free general diagram tool (for example draw.io / diagrams.net)
- Optional: a text-based harness drawing tool such as WireViz
Materials
- Your system's component list
- Connector pinouts from datasheets or manuals
- Photos and notes of the existing wiring, if documenting a vehicle
Before you start
- Documenting a vehicle's wiring is visual work: do not unplug or probe main battery, motor or high-voltage connections, and never touch the orange high-voltage cables of an electric car.
- Opening sealed covers to photograph wiring may void the warranty; check first.
Step by step
- 1
Decide what kind of diagram you need
A block diagram shows how major parts connect, such as battery, BMS, controller, motor, throttle and lights. A schematic shows every electrical connection and component. A harness drawing shows physical wires, connectors, pins, lengths and colours. Most projects need a block diagram for the report and either a schematic or harness drawing for build and repair work.
- 2
Gather pinouts and ratings first
Collect pin numbers, signal names, wire gauges, fuse ratings and connector part types from datasheets and manuals before drawing. Where you document an existing vehicle, take clear photos of connector faces with the power off and note wire colours. Never probe or unplug the main battery connections of a vehicle just to document them; record what is visible.
- 3
Draw the block diagram
In a general diagram tool, place one box per major component and connect them with lines labelled by function, such as 'battery positive', 'throttle signal' or 'CAN'. Use thicker lines for high-current paths and thinner lines for signals. Keep power flowing left to right and signals top to bottom, so the reader's eye follows the system naturally.
- 4
Build a proper schematic
In a schematic tool, use standard symbols for battery, fuse, switch, relay, connector and ground. Give every net a meaningful name rather than relying on long crossing wires, and use net labels to connect distant points. Add fuse ratings, wire sizes and connector designators. Run the tool's electrical rule check to catch unconnected pins and mislabelled nets.
- 5
Create a harness drawing
For physical wiring, draw each connector with numbered pins and list every wire with its colour, gauge, length and both end points. A text-based harness tool lets you describe connectors and cables in a simple file and generates the drawing and a bill of materials automatically, which is easy to keep in Git and update.
Tip: Match drawn wire colours to the real ones so the diagram can be checked against the vehicle.
- 6
Add a legend and title block
Include a legend explaining symbols, line styles and colour codes, and a title block with project name, revision number, date and author. Revision numbers matter: when wiring changes, update the drawing and increment the revision so nobody works from an old version.
- 7
Check the diagram against reality
Have a teammate trace each connection on the diagram against the real build or vehicle photos, ticking off wires. Any mismatch means either the diagram or the build is wrong. Fix the source of truth and note the change. For a vehicle, do this visually only; continuity checks are for de-energised bench assemblies.
- 8
Export for reports and printing
Export diagrams as vector PDF or SVG so they stay sharp when zoomed or printed. Use a large enough font for wire labels to read on A4. Keep the editable source files alongside the exports so the diagram can be revised later.
How to tell it worked
Someone who has never seen your system can follow the diagram and correctly identify each wire's function, colour, size and both end points, and the electrical rule check passes without errors.
Stop and call a technician if
- You find damaged insulation, melted connectors or burn marks while photographing wiring; stop and take the vehicle to an authorised service centre.
- The wiring you want to document is behind a warranty seal or inside the battery pack; do not open it.
Questions
Which tool should I learn first?
Start with a general diagram tool for block diagrams, then learn a schematic tool, since schematic capture is also the first step of PCB design. Harness tools are worth adding when you build looms.
Should I use standard symbols or my own?
Use standard symbols wherever possible and add a legend for anything unusual. Examiners and engineers read standard symbols instantly.
