4.3 KiB
Top-level Clauses
(version <number>)
(rule <rule_name> <rule_clause> ...)
Rule Clauses
(constraint <constraint_type> ...)
(condition "<expression>")
(layer "<layer_name>")
Constraint Types
- annular_width
- clearance
- courtyard_clearance
- diff_pair_gap
- diff_pair_uncoupled
- disallow
- edge_clearance
- length
- hole
- hole_clearance
- silk_clearance
- skew
- track_width
- via_count
Item Types
- buried_via
- graphic
- hole
- micro_via
- pad
- text
- track
- via
- zone
Examples
(rule HV
(constraint clearance (min 1.5mm))
(condition "A.NetClass == 'HV'"))
(rule HV
(layer outer)
(constraint clearance (min 1.5mm))
(condition "A.NetClass == 'HV'"))
(rule HV_HV
# wider clearance between HV tracks
(constraint clearance (min "1.5mm + 2.0mm"))
(condition "A.NetClass == 'HV' && B.NetClass == 'HV'"))
(rule HV_unshielded
(constraint clearance (min 2mm))
(condition "A.NetClass == 'HV' && !A.insideArea('Shield*')"))
Notes
Version clause must be the first clause.
Rules should be ordered by specificity. Later rules take precedence over earlier rules; once a matching rule is found no further rules will be checked.
Use Ctrl+/ to comment or uncomment line(s).
Expression functions
All function parameters support simple wildcards (* and ?).
A.insideCourtyard('<footprint_refdes>')
True if any part of A lies within the given footprint's courtyard.
A.insideArea('<zone_name>')
True if any part of A lies within the given zone's outline.
A.isPlated()
True if A has a hole which is plated.
A.isDiffPair()
True if A has a net that is part of a differential pair.
A.inDiffPair('<net_name>')
True if A has net that is part of the specified differential pair.
<net_name> is the base name of the differential pair. For example, inDiffPair('CLK')
matches items in the CLK_P and CLK_N nets.
A.memberOf('<group_name>')
True if A is a member of the given group. Includes nested membership.
A.existsOnLayer('<layer_name>')
True if A exists on the given layer. The layer name can be
either the name assigned in Board Setup > Board Editor Layers or
the canonical name (ie: F.Cu).
NB: this returns true if A is on the given layer, independently
of whether or not the rule is being evaluated for that layer.
For the latter use a (layer "layer_name") clause in the rule.
More Examples
(rule "copper keepout"
(constraint disallow track via zone)
(condition "A.insideArea('zone3')"))
(rule "BGA neckdown"
(constraint track_width (min 0.2mm) (opt 0.25mm))
(constraint clearance (min 0.05mm) (opt 0.08mm))
(condition "A.insideCourtyard('U3')"))
# prevent silk over tented vias
(rule silk_over_via
(constraint silk_clearance (min 0.2mm))
(condition "A.Type == '*Text' && B.Type == 'Via'"))
(rule "Distance between Vias of Different Nets"
(constraint hole_to_hole (min 0.254mm))
(condition "A.Type =='Via' && B.Type =='Via' && A.Net != B.Net"))
(rule "Clearance between Pads of Different Nets"
(constraint clearance (min 3.0mm))
(condition "A.Type =='Pad' && B.Type =='Pad' && A.Net != B.Net"))
(rule "Via Hole to Track Clearance"
(constraint hole_clearance (min 0.254mm))
(condition "A.Type =='Via' && B.Type =='Track'"))
(rule "Pad to Track Clearance"
(constraint clearance (min 0.2mm))
(condition "A.Type =='Pad' && B.Type =='Track'"))
(rule "clearance-to-1mm-cutout"
(constraint clearance (min 0.8mm))
(condition "A.Layer=='Edge.Cuts' && A.Thickness == 1.0mm"))
(rule "Max Drill Hole Size Mechanical"
(constraint hole (max 6.3mm))
(condition "A.Pad_Type == 'NPTH, mechanical'"))
(rule "Max Drill Hole Size PTH"
(constraint hole (max 6.35mm))
(condition "A.Pad_Type == 'Through-hole'"))
# Specify a larger clearance around a particular diff-pair
(rule "dp clearance"
(constraint clearance (min "1.5mm"))
(condition "A.inDiffPair('CLK')"))
# Specify a larger clearance around any diff-pair
(rule "dp clearance"
(constraint clearance (min "1.5mm"))
(condition "A.isDiffPair() && A.NetClass != B.NetClass"))