/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2018 CERN * @author Jon Evans * * 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, see . */ #ifndef _ERC_SETTINGS_H #define _ERC_SETTINGS_H #include #include #include #include class SCH_MARKER; class SCHEMATIC; /// ERC error codes enum ERCE_T { ERCE_UNSPECIFIED = 0, ERCE_FIRST, ERCE_DUPLICATE_SHEET_NAME = ERCE_FIRST, // duplicate sheet names within a given sheet ERCE_PIN_NOT_CONNECTED, // pin not connected and not no connect symbol ERCE_PIN_NOT_DRIVEN, // pin connected to some others pins but no pin to drive it ERCE_HIERACHICAL_LABEL, // mismatch between hierarchical labels and pins sheets ERCE_NOCONNECT_CONNECTED, // a no connect symbol is connected to more than 1 pin ERCE_NOCONNECT_NOT_CONNECTED, // a no connect symbol is not connected to anything ERCE_LABEL_NOT_CONNECTED, // label not connected to anything ERCE_SIMILAR_LABELS, // 2 labels are equal fir case insensitive comparisons ERCE_DIFFERENT_UNIT_FP, // different units of the same component have different footprints assigned ERCE_DIFFERENT_UNIT_NET, // a shared pin in a multi-unit component is connected to more than one net ERCE_BUS_ALIAS_CONFLICT, // conflicting bus alias definitions across sheets ERCE_DRIVER_CONFLICT, // conflicting drivers (labels, etc) on a subgraph ERCE_BUS_ENTRY_CONFLICT, // a wire connected to a bus doesn't match the bus ERCE_BUS_LABEL_ERROR, // a label attached to a bus isn't in bus format ERCE_BUS_TO_BUS_CONFLICT, // a connection between bus objects doesn't share at least one net ERCE_BUS_TO_NET_CONFLICT, // a bus wire is graphically connected to a net port/pin (or vice versa) ERCE_GLOBLABEL, // a global label is unique ERCE_UNRESOLVED_VARIABLE, ERCE_LAST = ERCE_UNRESOLVED_VARIABLE, // Errors after this point will not automatically appear in the Severities Panel ERCE_PIN_TO_PIN_WARNING, // pin connected to an other pin: warning level ERCE_PIN_TO_PIN_ERROR, // pin connected to an other pin: error level }; /// The values a pin-to-pin entry in the pin matrix can take on enum class PIN_ERROR { OK, WARNING, PP_ERROR, UNCONNECTED }; /// Types of drive on a net (used for legacy ERC) #define NPI 4 // Net with Pin isolated, this pin has type Not Connected and must be left N.C. #define DRV 3 // Net driven by a signal (a pin output for instance) #define NET_NC 2 // Net "connected" to a "NoConnect symbol" #define NOD 1 // Net not driven ( Such as 2 or more connected inputs ) #define NOC 0 // initial state of a net: no connection /** * Container for ERC settings * * Currently only stores flags about checks to run, but could later be expanded * to contain the matrix of electrical pin types. */ class ERC_SETTINGS : public NESTED_SETTINGS { public: ERC_SETTINGS( JSON_SETTINGS* aParent, const std::string& aPath ); virtual ~ERC_SETTINGS(); void LoadDefaults() { m_Severities[ERCE_SIMILAR_LABELS] = RPT_SEVERITY_WARNING; m_Severities[ERCE_GLOBLABEL] = RPT_SEVERITY_WARNING; m_Severities[ERCE_DRIVER_CONFLICT] = RPT_SEVERITY_WARNING; m_Severities[ERCE_BUS_ENTRY_CONFLICT] = RPT_SEVERITY_WARNING; m_Severities[ERCE_BUS_TO_BUS_CONFLICT] = RPT_SEVERITY_ERROR; m_Severities[ERCE_BUS_TO_NET_CONFLICT] = RPT_SEVERITY_ERROR; } bool operator==( const ERC_SETTINGS& other ) const { return ( other.m_Severities == m_Severities ); } bool operator!=( const ERC_SETTINGS& other ) const { return !( other == *this ); } bool IsTestEnabled( int aErrorCode ) const { return m_Severities.at( aErrorCode ) != RPT_SEVERITY_IGNORE; } int GetSeverity( int aErrorCode ) const; void SetSeverity( int aErrorCode, int aSeverity ); void ResetPinMap(); PIN_ERROR GetPinMapValue( int aFirstType, int aSecondType ) const { wxASSERT( aFirstType < ELECTRICAL_PINTYPES_TOTAL && aSecondType < ELECTRICAL_PINTYPES_TOTAL ); return m_PinMap[aFirstType][aSecondType]; } PIN_ERROR GetPinMapValue( ELECTRICAL_PINTYPE aFirstType, ELECTRICAL_PINTYPE aSecondType ) const { return m_PinMap[static_cast( aFirstType )][static_cast( aSecondType )]; } void SetPinMapValue( int aFirstType, int aSecondType, PIN_ERROR aValue ) { wxASSERT( aFirstType < ELECTRICAL_PINTYPES_TOTAL && aSecondType < ELECTRICAL_PINTYPES_TOTAL ); m_PinMap[aFirstType][aSecondType] = aValue; } void SetPinMapValue( ELECTRICAL_PINTYPE aFirstType, ELECTRICAL_PINTYPE aSecondType, PIN_ERROR aValue ) { m_PinMap[static_cast( aFirstType )][static_cast( aSecondType )] = aValue; } int GetPinMinDrive( ELECTRICAL_PINTYPE aFirstType, ELECTRICAL_PINTYPE aSecondType ) const { return m_PinMinDrive[static_cast( aFirstType )][static_cast( aSecondType )]; } public: std::map m_Severities; PIN_ERROR m_PinMap[ELECTRICAL_PINTYPES_TOTAL][ELECTRICAL_PINTYPES_TOTAL]; static int m_PinMinDrive[ELECTRICAL_PINTYPES_TOTAL][ELECTRICAL_PINTYPES_TOTAL]; private: static PIN_ERROR m_defaultPinMap[ELECTRICAL_PINTYPES_TOTAL][ELECTRICAL_PINTYPES_TOTAL]; }; /** * SHEETLIST_ERC_ITEMS_PROVIDER * is an implementation of the RC_ITEM_LISTinterface which uses the global SHEETLIST * to fulfill the contract. */ class SHEETLIST_ERC_ITEMS_PROVIDER : public RC_ITEMS_PROVIDER { private: SCHEMATIC* m_schematic; int m_severities; std::vector m_filteredMarkers; public: SHEETLIST_ERC_ITEMS_PROVIDER( SCHEMATIC* aSchematic ) : m_schematic( aSchematic ), m_severities( 0 ) { } void SetSeverities( int aSeverities ) override; int GetCount( int aSeverity = -1 ) override; ERC_ITEM* GetItem( int aIndex ) override; void DeleteItem( int aIndex, bool aDeep ) override; void DeleteAllItems() override; }; #endif