Auditing the Pin Map Between a Symbol and Its Footprint

A symbol and footprint can each look plausible while mapping the circuit to the wrong physical pins. Electrical-rule and clearance checks may not detect the mistake because both objects are internally consistent. Audit the mapping against the exact purchased component before first use or a package substitution.

Use one authoritative component identity

KiCad’s library conventions require attention to pin names, numbering, specialized pads, and datasheet requirements. The conventions help organize libraries, but the component manufacturer’s documentation remains essential when a package has a special mapping. A familiar package name is not proof of electrical compatibility. KiCad: symbol and footprint conventions.

Record the complete manufacturer part number and package suffix. Open the pin-function table, package drawing, and recommended land pattern for that exact option. Check whether each illustration is a top view, bottom view, or mating-face view. Write the interpretation down before comparing it with the footprint.

Create a direct mapping table

• List each physical pin or ball identifier.
• Record its datasheet function and schematic net.
• Identify the corresponding symbol pin and footprint pad.
• Include exposed pads, shields, duplicated contacts, and mechanical pads as applicable.
• Resolve every unexplained or missing identifier.

For example, two three-terminal devices in the same outline can use different functional pin arrangements. Replacing the value field and keeping the old symbol may connect the gate, source, and drain incorrectly even though the footprint fits perfectly. The audit must follow numbers and functions, not body shape.

Check special cases deliberately

Verify multi-unit symbols and shared power pins. Confirm how electrically common physical pads are represented and whether a thermal pad needs an explicit net. Distinguish a shield connection from a purely mechanical mounting feature. For connectors, compare both the PCB-side numbering and the intended mating cable or board.

Inspect the placed result

After assigning the footprint, trace a few distinctive nets through the board and compare pin-one or ball-map orientation with the assembly view. A correctly mapped library object can still be associated with the wrong package variant in the project. Review generated assembly documentation as a separate check.

Keep the approved mapping table and source-document revision with the library item. If an error is found, identify other designs that used the same object before changing it. A controlled library correction should preserve traceability and trigger appropriate output regeneration. This audit is especially valuable for downloaded models, newly created symbols, and substitutions whose mechanical similarity makes them easy to accept too quickly.