drc_item.h

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright (C) 2007 Dick Hollenbeck, [email protected]
 * Copyright (C) 2018-2020 KiCad Developers, see AUTHORS.txt for contributors.
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, you may find one here:
 * http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
 * or you may search the http://www.gnu.org website for the version 2 license,
 * or you may write to the Free Software Foundation, Inc.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
 */

#ifndef DRC_ITEM_H
#define DRC_ITEM_H

#include <rc_item.h>

class PCB_BASE_FRAME;
class DRC_RULE;
class DRC_TEST_PROVIDER;

enum PCB_DRC_CODE {
 DRCE_FIRST = 1,
 DRCE_UNCONNECTED_ITEMS = DRCE_FIRST, // items are unconnected
 DRCE_SHORTING_ITEMS, // items short two nets but are not a net-tie
 DRCE_ALLOWED_ITEMS, // a disallowed item has been used
 DRCE_TEXT_ON_EDGECUTS, // text or dimension on Edge.Cuts layer
 DRCE_CLEARANCE, // items are too close together
 DRCE_TRACKS_CROSSING, // tracks are crossing
 DRCE_EDGE_CLEARANCE, // a copper item is too close to the board edge
 DRCE_ZONES_INTERSECT, // copper area outlines intersect
 DRCE_ZONE_HAS_EMPTY_NET, // copper area has a net but no pads in nets, which is suspicious
 DRCE_DANGLING_VIA, // via which isn't connected to anything
 DRCE_DANGLING_TRACK, // track with at least one end not connected to anything
 DRCE_DRILLED_HOLES_TOO_CLOSE, // overlapping drilled holes break drill bits
 DRCE_DRILLED_HOLES_COLOCATED, // two holes at the same location
 DRCE_HOLE_CLEARANCE, //
 DRCE_TRACK_WIDTH, // Track width is too small or too large
 DRCE_ANNULAR_WIDTH, // Via size and drill leave annular ring too small
 DRCE_DRILL_OUT_OF_RANGE, // Too small via or pad drill
 DRCE_VIA_DIAMETER, // Via diameter checks (min/max)
 DRCE_PADSTACK, // something is wrong with a pad or via stackup
 DRCE_MICROVIA_DRILL_OUT_OF_RANGE, // Too small micro via drill
 DRCE_OVERLAPPING_FOOTPRINTS, // footprint courtyards overlap
 DRCE_MISSING_COURTYARD, // footprint has no courtyard defined
 DRCE_MALFORMED_COURTYARD, // footprint has a courtyard but malformed
 // (not convertible to a closed polygon with holes)
 DRCE_PTH_IN_COURTYARD,
 DRCE_NPTH_IN_COURTYARD,
 DRCE_DISABLED_LAYER_ITEM, // item on a disabled layer
 DRCE_INVALID_OUTLINE, // invalid board outline

 DRCE_MISSING_FOOTPRINT, // footprint not found for netlist item
 DRCE_DUPLICATE_FOOTPRINT, // more than one footprints found for netlist item
 DRCE_EXTRA_FOOTPRINT, // netlist item not found for footprint
 DRCE_NET_CONFLICT, // pad net doesn't match netlist

 DRCE_FOOTPRINT_TYPE_MISMATCH, // footprint attribute does not match actual pads
 DRCE_PAD_TH_WITH_NO_HOLE, // footprint has Plated Through-Hole with no hole

 DRCE_UNRESOLVED_VARIABLE,
 DRCE_SILK_MASK_CLEARANCE, // silkscreen clipped by mask (potentially leaving it
 // over pads, exposed copper, etc.)
 DRCE_OVERLAPPING_SILK, // silk to silk clearance error
 DRCE_LENGTH_OUT_OF_RANGE,
 DRCE_SKEW_OUT_OF_RANGE,
 DRCE_TOO_MANY_VIAS,

 DRCE_DIFF_PAIR_GAP_OUT_OF_RANGE,
 DRCE_DIFF_PAIR_UNCOUPLED_LENGTH_TOO_LONG,

 DRCE_LAST = DRCE_DIFF_PAIR_UNCOUPLED_LENGTH_TOO_LONG
};


class DRC_ITEM : public RC_ITEM
{
public:
 static std::shared_ptr<DRC_ITEM> Create( int aErrorCode );

 static std::shared_ptr<DRC_ITEM> Create( const wxString& aErrorKey );

 static std::vector<std::reference_wrapper<RC_ITEM>> GetItemsWithSeverities()
 {
 return allItemTypes;
 }

 void SetViolatingRule ( DRC_RULE *aRule ) { m_violatingRule = aRule; }
 DRC_RULE* GetViolatingRule() const { return m_violatingRule; }

 wxString GetViolatingRuleDesc() const override;

 void SetViolatingTest( DRC_TEST_PROVIDER *aProvider ) { m_violatingTest = aProvider; }
 DRC_TEST_PROVIDER* GetViolatingTest() const { return m_violatingTest; }

 KIID GetAuxItem2ID() const override;
 KIID GetAuxItem3ID() const override;

private:
 DRC_ITEM( int aErrorCode = 0, const wxString& aTitle = "", const wxString& aSettingsKey = "" )
 {
 m_errorCode = aErrorCode;
 m_errorTitle = aTitle;
 m_settingsKey = aSettingsKey;
 m_parent = nullptr;
 }

 static std::vector<std::reference_wrapper<RC_ITEM>> allItemTypes;

 static DRC_ITEM heading_electrical;
 static DRC_ITEM heading_DFM;
 static DRC_ITEM heading_schematic_parity;
 static DRC_ITEM heading_signal_integrity;
 static DRC_ITEM heading_misc;

 static DRC_ITEM unconnectedItems;
 static DRC_ITEM shortingItems;
 static DRC_ITEM itemsNotAllowed;
 static DRC_ITEM textOnEdgeCuts;
 static DRC_ITEM clearance;
 static DRC_ITEM tracksCrossing;
 static DRC_ITEM edgeClearance;
 static DRC_ITEM zonesIntersect;
 static DRC_ITEM zoneHasEmptyNet;
 static DRC_ITEM viaDangling;
 static DRC_ITEM trackDangling;
 static DRC_ITEM holeNearHole;
 static DRC_ITEM holesCoLocated;
 static DRC_ITEM holeClearance;
 static DRC_ITEM trackWidth;
 static DRC_ITEM annularWidth;
 static DRC_ITEM drillTooSmall;
 static DRC_ITEM viaDiameter;
 static DRC_ITEM padstack;
 static DRC_ITEM microviaDrillTooSmall;
 static DRC_ITEM courtyardsOverlap;
 static DRC_ITEM missingCourtyard;
 static DRC_ITEM malformedCourtyard;
 static DRC_ITEM pthInsideCourtyard;
 static DRC_ITEM npthInsideCourtyard;
 static DRC_ITEM itemOnDisabledLayer;
 static DRC_ITEM invalidOutline;
 static DRC_ITEM duplicateFootprints;
 static DRC_ITEM missingFootprint;
 static DRC_ITEM extraFootprint;
 static DRC_ITEM netConflict;
 static DRC_ITEM unresolvedVariable;
 static DRC_ITEM silkMaskClearance;
 static DRC_ITEM silkOverlaps;
 static DRC_ITEM lengthOutOfRange;
 static DRC_ITEM skewOutOfRange;
 static DRC_ITEM tooManyVias;
 static DRC_ITEM diffPairGapOutOfRange;
 static DRC_ITEM diffPairUncoupledLengthTooLong;
 static DRC_ITEM footprintTypeMismatch;
 static DRC_ITEM footprintTHPadhasNoHole;

private:
 DRC_RULE* m_violatingRule = nullptr;
 DRC_TEST_PROVIDER* m_violatingTest = nullptr;
};

#endif // DRC_ITEM_H