soldermaskdocs

What is not guaranteed

This page lists what a finished board does not promise. A board that routes is not always a board that works, and this list is the difference.

The command line prints this section last, so it stays on your screen. The workbench counts these lines as Advisories, beside the verdict's checks.

Said by the model

unsupported lists what the prompt asked for that the model could not do. It also lists anything the model was not sure is correct. It is published word for word.

An empty unsupported list on a hard prompt is a reason for more doubt, not less.

Gaps: what did not happen

  • A part with no orderable match in its package is dropped. Every net it was on loses that pin.
  • A pin given as a number on a part whose symbol is known is not resolved.
  • A pin that is not a pad cannot be resolved.
  • A net left with one pin is removed.
  • A part with no symbol found has unverified pin functions.

Notes: done, but worth saying

  • A footprint taken from the vendor, because JLCPCB does not name the package: not IPC-verified, check it before ordering.
  • A pinout borrowed from a pin-compatible family: assumed, not verified.
  • A vendor footprint or 3D model that sits more than 0.35 mm from the nominal package at its best angle.
  • A vendor model whose orientation could not be checked.
  • A part that is real but has zero stock today.
  • Part figures reconciled between data sources, or ones that could not be confirmed.
  • A schema relaxed for a backend that rejects a keyword.
  • Parts a repair round removed rather than fixed.

Structural limits

Layers. A board is built on two copper layers, or four when asked. Ground is poured on the outer layers, and on four layers In1.Cu is a solid ground plane. Where the fill cannot reach every ground pad, ground is routed as tracks and the notes say so. Power nets are tracks. They are poured only in a second build, when the copper alone fails as tracks.

Differential pairs. A pair is laid side by side and its two lengths matched. On four layers its width is the one nearest 90 Ω for USB, 100 Ω for others and 120 Ω for CAN. On two layers no sensible width reaches 90 Ω, and the note gives the impedance it has. A pair the build cannot lay cleanly stays as routed, and the notes say why.

Packages. Parts must use a supported package. Footprints imported from the KiCad library stop at 48 pins. USB-C PD controllers are not covered yet, and lose most of their parts.

A board imported from a KiCad file. Only a two-layer board can be imported: at most 150 mm a side, with 3 to 120 footprints and no ball grid array. Its fab files keep the file's outline, its holes and the copper and mask shapes it draws. They do not carry its copper text or its own silkscreen, and the gaps say so. Routed or placed again, it is built from the file it came from. The placer keeps parts off its outline, holes, copper and mask artwork. A piece a part does sit on is left out, and the gaps name the part. The project's net classes and custom rules are not read, so it is routed at 0.127 / 0.127 mm.

The placer minimises wirelength and overlap and keeps parts apart. It pulls connectors to the edge and ESD parts to the connectors they guard. It keeps parts off an antenna's keepout, the areas you keep clear and the mounting holes. It knows nothing about heat or EMI, and checks no enclosure.

Two-sided assembly. Parts go on the back only when the front is full and the board cannot grow. Assembly is then two-sided, which needs JLCPCB's Standard service.

Mains isolation. Nothing checks creepage or clearance between mains and low-voltage copper. That is why the sizer never cuts a board that carries mains.

The routers. Lightcycle routes, and ranks the placements by routing them. The A* router routes when you name it, or when Lightcycle is not installed. No second router is asked when a pin is left unreached. See Routers.

  • Track width is sized per net to IPC-2221 from the net's declared current. A net with no current gets the router's own track width, or the floor you set.
  • Clearance is 0.127 mm for both routers, which is the fab's floor.
  • Vias are fixed at a 0.60 mm pad and a 0.30 mm drill.
  • A net can stay incomplete: a pin its copper never reaches. The pin is named. Lightcycle routes and ranks six placements first, or nine when none reaches every pin. Up to three are then routed in full before the board is saved that way.

The routability model predicts; it does not decide. In a default build it ranks nothing: Lightcycle ranks the placements by routing them. On a poured or four-layer board the model stands down for an analytic score. It ranks placements only on an unpoured two-layer board under the A* router. There, where its first choice was confident and wrong, the board says so. See Routability.

ERC reads the netlist, not the copper. KiCad's DRC judges the copper, and it runs only when KiCad is installed. Without it, the verdict reads not judged.

The electrical checks need declared numbers. Trace and via sizing, LED resistors, resistor and regulator heat, and capacitor ratings all need a net's voltage_v and current_a. Without them the check stays silent rather than passing. The notes name every power net that declared nothing.

Copper is sized for steady heat only, to IPC-2221, on 1 oz outer copper with a 10 °C rise. A run left narrower than its net asks is judged at the declared current. A 20 °C rise is a gap, and 100 °C fails the board. Nothing models inrush, fusing current, or copper resistance in series with a regulator.

3D models are vendor geometry, not verified CAD.

Stock and price are snapshots taken at build time. They move between quote and order.

What is checked by something other than the code that made it

  • gerbonara reads the Gerbers back.
  • The .kicad_pcb is parsed again, and every pad is compared with the placement.
  • With KiCad installed, its Gerber plot is compared with ours, and its DRC runs.
  • Pin names come from data, never from memory: the KiCad symbol library or the vendor's symbol, checked against the pin table in the part's datasheet.

Everything else is checked by the same code that produced it. That is the fair criticism of a generator that grades itself, and it is why this page exists.

On this page