KiCad PCB EDA Suite
|
Calculate the connectivity of a schematic and generates netlists. More...
#include <connection_graph.h>
Public Member Functions | |
CONNECTION_GRAPH (SCHEMATIC *aSchematic=nullptr) | |
~CONNECTION_GRAPH () | |
void | Reset () |
void | SetSchematic (SCHEMATIC *aSchematic) |
void | SetLastCodes (const CONNECTION_GRAPH *aOther) |
void | Recalculate (const SCH_SHEET_LIST &aSheetList, bool aUnconditional=false, std::function< void(SCH_ITEM *)> *aChangedItemHandler=nullptr) |
Update the connection graph for the given list of sheets. | |
std::shared_ptr< BUS_ALIAS > | GetBusAlias (const wxString &aName) |
Return a bus alias pointer for the given name if it exists (from cache) | |
std::vector< const CONNECTION_SUBGRAPH * > | GetBusesNeedingMigration () |
Determine which subgraphs have more than one conflicting bus label. | |
int | RunERC () |
Run electrical rule checks on the connectivity graph. | |
const NET_MAP & | GetNetMap () const |
CONNECTION_SUBGRAPH * | FindSubgraphByName (const wxString &aNetName, const SCH_SHEET_PATH &aPath) |
Return the subgraph for a given net name on a given sheet. | |
CONNECTION_SUBGRAPH * | FindFirstSubgraphByName (const wxString &aNetName) |
Retrieve a subgraph for the given net name, if one exists. | |
CONNECTION_SUBGRAPH * | GetSubgraphForItem (SCH_ITEM *aItem) const |
const std::vector< CONNECTION_SUBGRAPH * > & | GetAllSubgraphs (const wxString &aNetName) const |
wxString | GetResolvedSubgraphName (const CONNECTION_SUBGRAPH *aSubGraph) const |
Return the fully-resolved netname for a given subgraph. | |
std::set< std::pair< SCH_SHEET_PATH, SCH_ITEM * > > | ExtractAffectedItems (const std::set< SCH_ITEM * > &aItems) |
For a set of items, this will remove the connected items and their associated data including subgraphs and generated codes from the connection graph. | |
void | Merge (CONNECTION_GRAPH &aGraph) |
Combine the input graph contents into the current graph. | |
void | RemoveItem (SCH_ITEM *aItem) |
void | ExchangeItem (SCH_ITEM *aOldItem, SCH_ITEM *aNewItem) |
Replace all references to #aOldItem with #aNewItem in the graph. | |
bool | IsMinor () const |
We modify how we handle the connectivity graph for small graphs vs large graphs. | |
Private Member Functions | |
void | updateItemConnectivity (const SCH_SHEET_PATH &aSheet, const std::vector< SCH_ITEM * > &aItemList) |
Update the graphical connectivity between items (i.e. | |
void | buildConnectionGraph (std::function< void(SCH_ITEM *)> *aChangedItemHandler, bool aUnconditional) |
Generate the connection graph (after all item connectivity has been updated). | |
void | buildItemSubGraphs () |
Generate individual item subgraphs on a per-sheet basis. | |
void | resolveAllDrivers () |
Find all subgraphs in the connection graph and calls ResolveDrivers() in parallel. | |
void | collectAllDriverValues () |
Map the driver values for each subgraph. | |
void | generateGlobalPowerPinSubGraphs () |
Iterate through the global power pins to collect the global labels as drivers. | |
void | generateBusAliasMembers () |
Iterate through labels to create placeholders for bus elements. | |
void | processSubGraphs () |
Process all subgraphs to assign netcodes and merge subgraphs based on labels. | |
int | assignNewNetCode (SCH_CONNECTION &aConnection) |
Helper to assign a new net code to a connection. | |
int | getOrCreateNetCode (const wxString &aNetName) |
void | assignNetCodesToBus (SCH_CONNECTION *aConnection) |
Ensure all members of the bus connection have a valid net code assigned. | |
void | propagateToNeighbors (CONNECTION_SUBGRAPH *aSubgraph, bool aForce) |
Update all neighbors of a subgraph with this one's connectivity info. | |
void | removeSubgraphs (std::set< CONNECTION_SUBGRAPH * > &aSubgraphs) |
Remove references to the given subgraphs from all structures in the connection graph. | |
std::shared_ptr< SCH_CONNECTION > | getDefaultConnection (SCH_ITEM *aItem, CONNECTION_SUBGRAPH *aSubgraph) |
Build a new default connection for the given item based on its properties. | |
void | recacheSubgraphName (CONNECTION_SUBGRAPH *aSubgraph, const wxString &aOldName) |
bool | ercCheckMultipleDrivers (const CONNECTION_SUBGRAPH *aSubgraph) |
If the subgraph has multiple drivers of equal priority that are graphically connected, ResolveDrivers() will have stored the second driver for use by this function, which actually creates the markers. | |
bool | ercCheckBusToNetConflicts (const CONNECTION_SUBGRAPH *aSubgraph) |
Check one subgraph for conflicting connections between net and bus labels. | |
bool | ercCheckBusToBusConflicts (const CONNECTION_SUBGRAPH *aSubgraph) |
Check one subgraph for conflicting connections between two bus items. | |
bool | ercCheckBusToBusEntryConflicts (const CONNECTION_SUBGRAPH *aSubgraph) |
Check one subgraph for conflicting bus entry to bus connections. | |
bool | ercCheckNoConnects (const CONNECTION_SUBGRAPH *aSubgraph) |
Check one subgraph for proper presence or absence of no-connect symbols. | |
bool | ercCheckFloatingWires (const CONNECTION_SUBGRAPH *aSubgraph) |
Check one subgraph for floating wires. | |
bool | ercCheckDanglingWireEndpoints (const CONNECTION_SUBGRAPH *aSubgraph) |
Check one subgraph for dangling wire endpoints. | |
bool | ercCheckLabels (const CONNECTION_SUBGRAPH *aSubgraph) |
Check one subgraph for proper connection of labels. | |
int | ercCheckDirectiveLabels () |
Check directive labels should be connected to something. | |
int | ercCheckHierSheets () |
Check that a hierarchical sheet has at least one matching label inside the sheet for each port on the parent sheet object. | |
int | ercCheckSingleGlobalLabel () |
Check that a global label is instantiated more that once across the schematic heirarchy. | |
size_t | hasPins (const CONNECTION_SUBGRAPH *aLocSubgraph) |
Get the number of pins in a given subgraph. | |
Static Private Member Functions | |
static SCH_CONNECTION * | matchBusMember (SCH_CONNECTION *aBusConnection, SCH_CONNECTION *aSearch) |
Search for a matching bus member inside a bus connection. | |
Private Attributes | |
SCH_SHEET_LIST | m_sheetList |
All the sheets in the schematic (as long as we don't have partial updates). | |
std::vector< SCH_ITEM * > | m_items |
All connectable items in the schematic. | |
std::vector< CONNECTION_SUBGRAPH * > | m_subgraphs |
The owner of all CONNECTION_SUBGRAPH objects. | |
std::vector< CONNECTION_SUBGRAPH * > | m_driver_subgraphs |
Cache of a subset of m_subgraphs. | |
std::unordered_map< SCH_SHEET_PATH, std::vector< CONNECTION_SUBGRAPH * > > | m_sheet_to_subgraphs_map |
Cache to lookup subgraphs in m_driver_subgraphs by sheet path. | |
std::vector< std::pair< SCH_SHEET_PATH, SCH_PIN * > > | m_global_power_pins |
std::unordered_map< wxString, std::shared_ptr< BUS_ALIAS > > | m_bus_alias_cache |
std::unordered_map< wxString, int > | m_net_name_to_code_map |
std::unordered_map< wxString, int > | m_bus_name_to_code_map |
std::unordered_map< wxString, std::vector< const CONNECTION_SUBGRAPH * > > | m_global_label_cache |
std::map< std::pair< SCH_SHEET_PATH, wxString >, std::vector< const CONNECTION_SUBGRAPH * > > | m_local_label_cache |
std::unordered_map< wxString, std::vector< CONNECTION_SUBGRAPH * > > | m_net_name_to_subgraphs_map |
std::unordered_map< SCH_ITEM *, CONNECTION_SUBGRAPH * > | m_item_to_subgraph_map |
NET_MAP | m_net_code_to_subgraphs_map |
int | m_last_net_code |
int | m_last_bus_code |
int | m_last_subgraph_code |
SCHEMATIC * | m_schematic |
The schematic this graph represents. | |
Calculate the connectivity of a schematic and generates netlists.
Definition at line 355 of file connection_graph.h.
|
inline |
Definition at line 358 of file connection_graph.h.
|
inline |
Definition at line 365 of file connection_graph.h.
References Reset().
|
private |
Ensure all members of the bus connection have a valid net code assigned.
aConnection | is a bus connection. |
Definition at line 2532 of file connection_graph.cpp.
References assignNewNetCode(), and SCH_CONNECTION::Members().
Referenced by processSubGraphs().
|
private |
Helper to assign a new net code to a connection.
Definition at line 2522 of file connection_graph.cpp.
References getOrCreateNetCode(), SCH_CONNECTION::Name(), and SCH_CONNECTION::SetNetCode().
Referenced by assignNetCodesToBus(), generateBusAliasMembers(), generateGlobalPowerPinSubGraphs(), and processSubGraphs().
|
private |
Generate the connection graph (after all item connectivity has been updated).
In the first phase, the algorithm iterates over all items, and then over all items that are connected (graphically) to each item, placing them into CONNECTION_SUBGRAPHs. Items that can potentially drive connectivity (i.e. labels, pins, etc.) are added to the m_drivers vector of the subgraph.
In the second phase, each subgraph is resolved. To resolve a subgraph, the driver is first selected by CONNECTION_SUBGRAPH::ResolveDrivers(), and then the connection for the chosen driver is propagated to all the other items in the subgraph.
If the unconitional flag is set, all existing net classes will be removed and re-created. Otherwise, we will preserve existing net classes that do not conflict with the new net classes.
TODO(JE): Net codes are non-deterministic. Fortunately, they are also not really used for anything. We should consider removing them entirely and just using net names everywhere.
Definition at line 2079 of file connection_graph.cpp.
References buildItemSubGraphs(), SCH_CONNECTION::Clone(), collectAllDriverValues(), SCH_ITEM::Connection(), ConnTrace, DanglingProfileMask, alg::delete_if(), generateBusAliasMembers(), generateGlobalPowerPinSubGraphs(), CONNECTION_SUBGRAPH::GetDriverPriority(), SCH_SCREENS::GetFirst(), GetKiCadThreadPool(), CONNECTION_SUBGRAPH::GetNameForDriver(), SCH_SCREENS::GetNext(), PROJECT::GetProjectFile(), SCH_LABEL_BASE::GetShownText(), SCH_CONNECTION::IsBus(), SCH_CONNECTION::IsNet(), SCH_SCREEN::Items(), CONNECTION_SUBGRAPH::m_absorbed, CONNECTION_SUBGRAPH::m_absorbed_by, m_bus_alias_cache, CONNECTION_SUBGRAPH::m_code, CONNECTION_SUBGRAPH::m_dirty, CONNECTION_SUBGRAPH::m_driver_connection, m_driver_subgraphs, CONNECTION_SUBGRAPH::m_drivers, m_net_code_to_subgraphs_map, m_net_name_to_subgraphs_map, PROJECT_FILE::m_NetSettings, m_schematic, CONNECTION_SUBGRAPH::m_sheet, m_sheet_to_subgraphs_map, matchBusMember(), name, SCH_CONNECTION::Name(), EE_RTREE::OfType(), path, pin, CONNECTION_SUBGRAPH::POWER_PIN, SCHEMATIC::Prj(), processSubGraphs(), propagateToNeighbors(), resolveAllDrivers(), SCHEMATIC::Root(), SCH_HIER_LABEL_T, SCH_PIN_T, SCH_SHEET_PIN_T, SCH_CONNECTION::SetType(), PROF_TIMER::Show(), and tp.
|
private |
Generate individual item subgraphs on a per-sheet basis.
Definition at line 1360 of file connection_graph.cpp.
References CONNECTION_SUBGRAPH::AddItem(), CANDIDATE, SCH_SCREENS::GetFirst(), SCH_SCREENS::GetNext(), m_bus_alias_cache, CONNECTION_SUBGRAPH::m_code, CONNECTION_SUBGRAPH::m_dirty, m_item_to_subgraph_map, m_items, m_last_subgraph_code, CONNECTION_SUBGRAPH::m_no_connect, m_schematic, CONNECTION_SUBGRAPH::m_sheet, m_subgraphs, SCHEMATIC::Root(), SCH_NO_CONNECT_T, SCH_CONNECTION::SetSubgraphCode(), and SCH_CONNECTION::SubgraphCode().
Referenced by buildConnectionGraph().
|
private |
Map the driver values for each subgraph.
Definition at line 1523 of file connection_graph.cpp.
References ConnTrace, EDA_ITEM::GetItemDescription(), m_driver_subgraphs, m_global_label_cache, m_local_label_cache, m_net_name_to_subgraphs_map, name, pin, SCH_GLOBAL_LABEL_T, SCH_HIER_LABEL_T, SCH_LABEL_T, SCH_PIN_T, schIUScale, and EDA_ITEM::Type().
Referenced by buildConnectionGraph().
|
private |
Check one subgraph for conflicting connections between two bus items.
For example, a labeled bus wire connected to a hierarchical sheet pin where the labeled bus doesn't contain any of the same bus members as the sheet pin.
aSubgraph | is the subgraph to examine. |
Definition at line 3348 of file connection_graph.cpp.
References SCH_SCREEN::Append(), SCH_ITEM::Connection(), ERC_ITEM::Create(), ERCE_BUS_TO_BUS_CONFLICT, EDA_ITEM::GetPosition(), SCH_CONNECTION::IsBus(), SCH_SHEET_PATH::LastScreen(), CONNECTION_SUBGRAPH::m_items, CONNECTION_SUBGRAPH::m_sheet, SCH_CONNECTION::Members(), SCH_GLOBAL_LABEL_T, SCH_HIER_LABEL_T, SCH_SHEET_PIN_T, SCH_TEXT_T, and EDA_ITEM::Type().
Referenced by RunERC().
|
private |
Check one subgraph for conflicting bus entry to bus connections.
For example, a wire with label "A0" is connected to a bus labeled "D[8..0]"
Will also check for mistakes related to bus group names, for example: A bus group named "USB{DP DM}" should have bus entry connections like "USB.DP" but someone might accidentally just enter "DP".
aSubgraph | is the subgraph to examine. |
Definition at line 3417 of file connection_graph.cpp.
References _, SCH_SCREEN::Append(), SCH_ITEM::Connection(), ERC_ITEM::Create(), ERCE_BUS_ENTRY_CONFLICT, SCH_CONNECTION::FullLocalName(), CONNECTION_SUBGRAPH::GetDriverPriority(), CONNECTION_SUBGRAPH::GetNameForDriver(), SCH_BUS_ENTRY_BASE::GetPosition(), SCH_SHEET_PATH::LastScreen(), SCH_BUS_WIRE_ENTRY::m_connected_bus_item, CONNECTION_SUBGRAPH::m_driver, CONNECTION_SUBGRAPH::m_driver_connection, CONNECTION_SUBGRAPH::m_drivers, CONNECTION_SUBGRAPH::m_items, CONNECTION_SUBGRAPH::m_sheet, SCH_CONNECTION::Members(), SCH_CONNECTION::Name(), SCH_SHEET_PATH::PathHumanReadable(), CONNECTION_SUBGRAPH::POWER_PIN, SCH_BUS_WIRE_ENTRY_T, SCH_LINE_T, EDA_ITEM::Type(), and UnescapeString().
Referenced by RunERC().
|
private |
Check one subgraph for conflicting connections between net and bus labels.
For example, a net wire connected to a bus port/pin, or vice versa
aSubgraph | is the subgraph to examine. |
Definition at line 3287 of file connection_graph.cpp.
References SCH_SCREEN::Append(), SCH_CONNECTION::ConfigureFromLabel(), ERC_ITEM::Create(), CTX_NETNAME, ERCE_BUS_TO_NET_CONFLICT, EscapeString(), SCH_ITEM::GetLayer(), EDA_ITEM::GetPosition(), SCH_CONNECTION::IsBus(), SCH_SHEET_PATH::LastScreen(), LAYER_BUS, CONNECTION_SUBGRAPH::m_items, CONNECTION_SUBGRAPH::m_sheet, SCH_GLOBAL_LABEL_T, SCH_HIER_LABEL_T, SCH_LABEL_T, SCH_LINE_T, SCH_SHEET_PIN_T, text, and EDA_ITEM::Type().
Referenced by RunERC().
|
private |
Check one subgraph for dangling wire endpoints.
Will throw an error for any subgraph that has wires with only one endpoing
aSubgraph | is the subgraph to examine. |
Definition at line 3772 of file connection_graph.cpp.
References _, SCH_SCREEN::Append(), ERC_ITEM::Create(), ERCE_UNCONNECTED_WIRE_ENDPOINT, SCH_LINE::GetConnectionPoints(), SCH_ITEM::GetLayer(), SCH_LINE::IsEndDangling(), SCH_LINE::IsGraphicLine(), SCH_LINE::IsStartDangling(), SCH_SHEET_PATH::LastScreen(), LAYER_WIRE, CONNECTION_SUBGRAPH::m_items, CONNECTION_SUBGRAPH::m_sheet, SCH_LINE_T, and EDA_ITEM::Type().
Referenced by RunERC().
|
private |
Check directive labels should be connected to something.
Definition at line 4078 of file connection_graph.cpp.
References ERC_ITEM::Create(), ERCE_LABEL_NOT_CONNECTED, SCH_LABEL_BASE::IsDangling(), m_sheetList, SCH_DIRECTIVE_LABEL_T, and text.
Referenced by RunERC().
|
private |
Check one subgraph for floating wires.
Will throw an error for any subgraph that consists of just wires with no driver.
aSubgraph | is the subgraph to examine. |
Definition at line 3812 of file connection_graph.cpp.
References SCH_SCREEN::Append(), ERC_ITEM::Create(), ERCE_WIRE_DANGLING, SCH_ITEM::GetLayer(), SCH_SHEET_PATH::LastScreen(), LAYER_WIRE, CONNECTION_SUBGRAPH::m_driver, CONNECTION_SUBGRAPH::m_items, CONNECTION_SUBGRAPH::m_sheet, SCH_BUS_WIRE_ENTRY_T, SCH_LINE_T, and EDA_ITEM::Type().
Referenced by RunERC().
|
private |
Check that a hierarchical sheet has at least one matching label inside the sheet for each port on the parent sheet object.
aSubgraph | is the subgraph to examine. |
Definition at line 4106 of file connection_graph.cpp.
References _, SCH_SCREEN::Append(), ERC_ITEM::Create(), ERCE_HIERACHICAL_LABEL, ERCE_PIN_NOT_CONNECTED, SCHEMATIC::ErcSettings(), SCH_SHEET::GetPins(), SCH_SHEET::GetScreen(), SCH_LABEL_BASE::GetShownText(), ERC_SETTINGS::IsTestEnabled(), SCH_SCREEN::Items(), m_schematic, m_sheetList, pin, SCH_SHEET_PATH::push_back(), SCH_HIER_LABEL_T, SCH_SHEET_T, and UnescapeString().
Referenced by RunERC().
|
private |
Check one subgraph for proper connection of labels.
Labels should be connected to something.
aSubgraph | is the subgraph to examine. |
aCheckGlobalLabels | is true if global labels should be checked for loneliness. |
Definition at line 3851 of file connection_graph.cpp.
References SCH_SCREEN::Append(), ERC_ITEM::Create(), ERCE_GLOBLABEL_DANGLING, ERCE_LABEL_NOT_CONNECTED, SCHEMATIC::ErcSettings(), SCH_TEXT::GetPosition(), GetResolvedSubgraphName(), hasPins(), SCH_CONNECTION::IsBus(), ERC_SETTINGS::IsTestEnabled(), SCH_SHEET_PATH::LastScreen(), CONNECTION_SUBGRAPH::m_bus_parents, CONNECTION_SUBGRAPH::m_driver_connection, CONNECTION_SUBGRAPH::m_hier_parent, CONNECTION_SUBGRAPH::m_items, m_net_name_to_subgraphs_map, CONNECTION_SUBGRAPH::m_no_connect, m_schematic, CONNECTION_SUBGRAPH::m_sheet, SCH_GLOBAL_LABEL_T, SCH_HIER_LABEL_T, SCH_LABEL_T, text, and EDA_ITEM::Type().
Referenced by RunERC().
|
private |
If the subgraph has multiple drivers of equal priority that are graphically connected, ResolveDrivers() will have stored the second driver for use by this function, which actually creates the markers.
aSubgraph | is the subgraph to examine |
Definition at line 3242 of file connection_graph.cpp.
References _, SCH_SCREEN::Append(), ERC_ITEM::Create(), ERCE_DRIVER_CONFLICT, CONNECTION_SUBGRAPH::GetNameForDriver(), EDA_ITEM::GetPosition(), CONNECTION_SUBGRAPH::GetSheet(), SCH_PIN::IsGlobalPower(), SCH_SHEET_PATH::LastScreen(), CONNECTION_SUBGRAPH::m_driver, CONNECTION_SUBGRAPH::m_drivers, CONNECTION_SUBGRAPH::m_multiple_drivers, CONNECTION_SUBGRAPH::m_sheet, SCH_GLOBAL_LABEL_T, SCH_HIER_LABEL_T, SCH_LABEL_T, SCH_PIN_T, and EDA_ITEM::Type().
Referenced by RunERC().
|
private |
Check one subgraph for proper presence or absence of no-connect symbols.
A pin with a no-connect symbol should not have any connections. A pin without a no-connect symbol should have at least one connection.
aSubgraph | is the subgraph to examine. |
Definition at line 3521 of file connection_graph.cpp.
References SCH_SCREEN::Append(), ERC_ITEM::Create(), ERCE_NOCONNECT_CONNECTED, ERCE_NOCONNECT_NOT_CONNECTED, ERCE_PIN_NOT_CONNECTED, SCHEMATIC::ErcSettings(), CONNECTION_SUBGRAPH::GetDriverPriority(), SCH_ITEM::GetParentSymbol(), EDA_ITEM::GetPosition(), SCH_TEXT::GetPosition(), GetResolvedSubgraphName(), SYMBOL::IsPower(), SCH_PIN::IsStacked(), ERC_SETTINGS::IsTestEnabled(), KI_FALLTHROUGH, SCH_SHEET_PATH::LastScreen(), m_global_label_cache, CONNECTION_SUBGRAPH::m_hier_pins, CONNECTION_SUBGRAPH::m_hier_ports, CONNECTION_SUBGRAPH::m_items, m_local_label_cache, m_net_name_to_subgraphs_map, CONNECTION_SUBGRAPH::m_no_connect, m_schematic, CONNECTION_SUBGRAPH::m_sheet, name, CONNECTION_SUBGRAPH::NONE, pin, SCH_GLOBAL_LABEL_T, SCH_HIER_LABEL_T, SCH_LABEL_T, SCH_PIN_T, and EDA_ITEM::Type().
Referenced by RunERC().
|
private |
Check that a global label is instantiated more that once across the schematic heirarchy.
Definition at line 4028 of file connection_graph.cpp.
References SCH_SCREEN::Append(), ERC_ITEM::Create(), CTX_NETNAME, ERCE_SINGLE_GLOBAL_LABEL, EscapeString(), EDA_ITEM::GetPosition(), SCH_TEXT::GetShownText(), SCH_SHEET_PATH::LastScreen(), m_sheetList, and SCH_GLOBAL_LABEL_T.
Referenced by RunERC().
Replace all references to #aOldItem with #aNewItem in the graph.
Definition at line 649 of file connection_graph.cpp.
References SCHEMATIC::CurrentSheet(), exchange, CONNECTION_SUBGRAPH::ExchangeItem(), SCH_SYMBOL::GetPins(), m_item_to_subgraph_map, m_items, m_schematic, SCH_SYMBOL_T, and EDA_ITEM::Type().
Referenced by DIALOG_CHANGE_SYMBOLS::processSymbols().
std::set< std::pair< SCH_SHEET_PATH, SCH_ITEM * > > CONNECTION_GRAPH::ExtractAffectedItems | ( | const std::set< SCH_ITEM * > & | aItems | ) |
For a set of items, this will remove the connected items and their associated data including subgraphs and generated codes from the connection graph.
aItems | A vector of items whose presence should be removed from the graph. |
Definition at line 848 of file connection_graph.cpp.
References ConnTrace, SCHEMATIC::CurrentSheet(), alg::delete_matching(), GetAllSubgraphs(), CONNECTION_SUBGRAPH::GetNetName(), SCH_SHEET::GetPins(), SCH_SYMBOL::GetPins(), GetSubgraphForItem(), CONNECTION_SUBGRAPH::m_code, m_items, m_schematic, path, pin, removeSubgraphs(), CONNECTION_SUBGRAPH::ResolveDrivers(), SCH_SHEET_T, and SCH_SYMBOL_T.
Referenced by SCH_EDIT_FRAME::RecalculateConnections().
CONNECTION_SUBGRAPH * CONNECTION_GRAPH::FindFirstSubgraphByName | ( | const wxString & | aNetName | ) |
Retrieve a subgraph for the given net name, if one exists.
Search every sheet.
aNetName | is the full net name to search for. |
Definition at line 3089 of file connection_graph.cpp.
References m_net_name_to_subgraphs_map.
Referenced by SCH_EDIT_FRAME::RecalculateConnections().
CONNECTION_SUBGRAPH * CONNECTION_GRAPH::FindSubgraphByName | ( | const wxString & | aNetName, |
const SCH_SHEET_PATH & | aPath | ||
) |
Return the subgraph for a given net name on a given sheet.
aNetName | is the local net name to look for. |
aPath | is a sheet path to look on. |
Definition at line 3068 of file connection_graph.cpp.
References CONNECTION_SUBGRAPH::m_absorbed, CONNECTION_SUBGRAPH::m_driver_connection, m_net_name_to_subgraphs_map, CONNECTION_SUBGRAPH::m_sheet, and SCH_CONNECTION::Name().
Referenced by NETLIST_EXPORTER_BASE::CreatePinList(), NETLIST_EXPORTER_BASE::findAllUnitsOfSymbol(), and SCH_EDITOR_CONTROL::UpdateNetHighlighting().
|
private |
Iterate through labels to create placeholders for bus elements.
Need to figure out why these sgs are not getting connected to their bus parents
Definition at line 1586 of file connection_graph.cpp.
References assignNewNetCode(), ConnTrace, dummy, CONNECTION_SUBGRAPH::GetNetName(), SCH_SHEET_PATH::GetSheet(), SCH_LABEL_BASE::GetShownText(), CONNECTION_SUBGRAPH::m_code, CONNECTION_SUBGRAPH::m_driver_connection, m_driver_subgraphs, CONNECTION_SUBGRAPH::m_is_bus_member, m_last_subgraph_code, m_net_code_to_subgraphs_map, m_net_name_to_subgraphs_map, CONNECTION_SUBGRAPH::m_sheet, CONNECTION_SUBGRAPH::m_strong_driver, m_subgraphs, name, SCH_CONNECTION::SetGraph(), SCH_CONNECTION::SetName(), and SCH_CONNECTION::SetType().
Referenced by buildConnectionGraph().
|
private |
Iterate through the global power pins to collect the global labels as drivers.
Definition at line 1645 of file connection_graph.cpp.
References CONNECTION_SUBGRAPH::AddItem(), assignNewNetCode(), CONNECTION_SUBGRAPH::GetNetName(), CONNECTION_SUBGRAPH::m_code, m_driver_subgraphs, m_global_power_pins, m_last_subgraph_code, m_net_code_to_subgraphs_map, CONNECTION_SUBGRAPH::m_sheet, m_subgraphs, pin, CONNECTION_SUBGRAPH::ResolveDrivers(), SCH_CONNECTION::SetName(), SCH_CONNECTION::SetNetCode(), SCH_CONNECTION::SetSubgraphCode(), and SCH_CONNECTION::SubgraphCode().
Referenced by buildConnectionGraph().
const std::vector< CONNECTION_SUBGRAPH * > & CONNECTION_GRAPH::GetAllSubgraphs | ( | const wxString & | aNetName | ) | const |
Definition at line 3115 of file connection_graph.cpp.
References m_net_name_to_subgraphs_map.
Referenced by ExtractAffectedItems(), SCH_EDIT_FRAME::MakeNetNavigatorNode(), and SCH_EDITOR_CONTROL::UpdateNetHighlighting().
std::shared_ptr< BUS_ALIAS > CONNECTION_GRAPH::GetBusAlias | ( | const wxString & | aName | ) |
Return a bus alias pointer for the given name if it exists (from cache)
CONNECTION_GRAPH caches these, they are owned by the SCH_SCREEN that the alias was defined on. The cache is only used to update the graph.
Definition at line 2986 of file connection_graph.cpp.
References m_bus_alias_cache.
Referenced by SCH_CONNECTION::AppendInfoToMsgPanel(), and SCH_CONNECTION::ConfigureFromLabel().
std::vector< const CONNECTION_SUBGRAPH * > CONNECTION_GRAPH::GetBusesNeedingMigration | ( | ) |
Determine which subgraphs have more than one conflicting bus label.
Definition at line 2994 of file connection_graph.cpp.
References SCH_ITEM::Connection(), ConnTrace, SCH_TEXT::GetShownText(), SCH_CONNECTION::IsBus(), SCH_CONNECTION::m_driver, m_subgraphs, and SCH_CONNECTION::Name().
Referenced by DIALOG_MIGRATE_BUSES::loadGraphData().
|
private |
Build a new default connection for the given item based on its properties.
Handles strong drivers (power pins and labels) only.
aItem | is an item that can generate a connection name. |
aSubgraph | is used to determine the sheet to use and retrieve the cached name. |
Definition at line 2877 of file connection_graph.cpp.
References CONNECTION_SUBGRAPH::GetNameForDriver(), CONNECTION_SUBGRAPH::m_sheet, pin, SCH_GLOBAL_LABEL_T, SCH_HIER_LABEL_T, SCH_LABEL_T, SCH_PIN_T, and EDA_ITEM::Type().
Referenced by processSubGraphs(), and propagateToNeighbors().
|
inline |
Definition at line 420 of file connection_graph.h.
References m_net_code_to_subgraphs_map.
Referenced by BOOST_FIXTURE_TEST_CASE(), NETLIST_EXPORTER_ALLEGRO::extractComponentsInfo(), SCHEMATIC::GetNetClassAssignmentCandidates(), NETLIST_EXPORTER_XML::makeListOfNets(), SCH_EDIT_FRAME::RefreshNetNavigator(), SCH_EDIT_FRAME::RefreshOperatingPointDisplay(), NETLIST_EXPORTER_CADSTAR::writeListOfNets(), and NETLIST_EXPORTER_PADS::writeListOfNets().
|
private |
aNetName | string with the netname for coding |
Definition at line 2502 of file connection_graph.cpp.
References m_last_net_code, and m_net_name_to_code_map.
Referenced by assignNewNetCode().
wxString CONNECTION_GRAPH::GetResolvedSubgraphName | ( | const CONNECTION_SUBGRAPH * | aSubGraph | ) | const |
Return the fully-resolved netname for a given subgraph.
aSubGraph | Reference to the subgraph. |
Definition at line 3042 of file connection_graph.cpp.
References CONNECTION_SUBGRAPH::GetNetName(), and m_net_name_to_subgraphs_map.
Referenced by ercCheckLabels(), and ercCheckNoConnects().
CONNECTION_SUBGRAPH * CONNECTION_GRAPH::GetSubgraphForItem | ( | SCH_ITEM * | aItem | ) | const |
Definition at line 3102 of file connection_graph.cpp.
References CONNECTION_SUBGRAPH::m_absorbed, CONNECTION_SUBGRAPH::m_absorbed_by, and m_item_to_subgraph_map.
Referenced by ExtractAffectedItems(), and SCH_CONNECTION::GetNetName().
|
private |
Get the number of pins in a given subgraph.
aLocSubgraph | Subgraph to search |
Referenced by ercCheckLabels().
|
inline |
We modify how we handle the connectivity graph for small graphs vs large graphs.
Partially this is to avoid unneeded complexity for small graphs, where the performance of the graph is not a concern. This is considered a temporary solution until the connectivity graph is refactored with an eye toward partial updates
Definition at line 487 of file connection_graph.h.
References ADVANCED_CFG::GetCfg(), m_items, and ADVANCED_CFG::m_MinorSchematicGraphSize.
|
staticprivate |
Search for a matching bus member inside a bus connection.
For bus groups, this returns a bus member that matches aSearch by name. For bus vectors, this returns a bus member that matches by vector index.
aBusConnection | is the bus connection to search. |
aSearch | is the net connection to search for. |
Definition at line 2916 of file connection_graph.cpp.
References SCH_CONNECTION::IsBus(), SCH_CONNECTION::LocalName(), SCH_CONNECTION::Members(), SCH_CONNECTION::Type(), and SCH_CONNECTION::VectorIndex().
Referenced by buildConnectionGraph(), and propagateToNeighbors().
void CONNECTION_GRAPH::Merge | ( | CONNECTION_GRAPH & | aGraph | ) |
Combine the input graph contents into the current graph.
aGraph | Input graph reference to add to the current graph. |
Definition at line 591 of file connection_graph.cpp.
References m_bus_name_to_code_map, CONNECTION_SUBGRAPH::m_driver_connection, m_driver_subgraphs, m_global_label_cache, m_global_power_pins, CONNECTION_SUBGRAPH::m_graph, m_item_to_subgraph_map, m_items, m_last_bus_code, m_last_net_code, m_last_subgraph_code, m_local_label_cache, m_net_code_to_subgraphs_map, m_net_name_to_code_map, m_net_name_to_subgraphs_map, m_sheet_to_subgraphs_map, m_subgraphs, SCH_ITEM::SetConnectionGraph(), and SCH_CONNECTION::SetGraph().
Referenced by SCH_EDIT_FRAME::RecalculateConnections().
|
private |
Process all subgraphs to assign netcodes and merge subgraphs based on labels.
Definition at line 1714 of file connection_graph.cpp.
References assignNetCodesToBus(), assignNewNetCode(), ConnTrace, alg::delete_matching(), getDefaultConnection(), SCH_CONNECTION::IsBus(), SCH_CONNECTION::IsNet(), CONNECTION_SUBGRAPH::m_absorbed, m_bus_name_to_code_map, CONNECTION_SUBGRAPH::m_bus_parents, CONNECTION_SUBGRAPH::m_code, CONNECTION_SUBGRAPH::m_driver, CONNECTION_SUBGRAPH::m_driver_connection, m_driver_subgraphs, CONNECTION_SUBGRAPH::m_drivers, m_last_bus_code, CONNECTION_SUBGRAPH::m_multiple_drivers, m_net_name_to_subgraphs_map, m_sheet_to_subgraphs_map, name, SCH_CONNECTION::Name(), pin, SCH_GLOBAL_LABEL_T, SCH_HIER_LABEL_T, SCH_LABEL_T, SCH_PIN_T, SCH_SHEET_PIN_T, schIUScale, SCH_CONNECTION::SetBusCode(), SCH_CONNECTION::Type(), and EDA_ITEM::Type().
Referenced by buildConnectionGraph().
|
private |
Update all neighbors of a subgraph with this one's connectivity info.
If this subgraph contains hierarchical links, this method will descent the hierarchy and propagate the connectivity across all linked sheets.
aSubgraph | is the subgraph being processed. |
aForce | prevents this routine from skipping subgraphs. |
Definition at line 2553 of file connection_graph.cpp.
References SCH_CONNECTION::Clone(), ConnTrace, getDefaultConnection(), CONNECTION_SUBGRAPH::GetDriverPriority(), CONNECTION_SUBGRAPH::GetNameForDriver(), CONNECTION_SUBGRAPH::HIER_LABEL, SCH_CONNECTION::IsBus(), kv, SCH_CONNECTION::LocalName(), CONNECTION_SUBGRAPH::m_absorbed, CONNECTION_SUBGRAPH::m_absorbed_by, CONNECTION_SUBGRAPH::m_code, CONNECTION_SUBGRAPH::m_dirty, CONNECTION_SUBGRAPH::m_driver, CONNECTION_SUBGRAPH::m_driver_connection, CONNECTION_SUBGRAPH::m_drivers, CONNECTION_SUBGRAPH::m_graph, CONNECTION_SUBGRAPH::m_hier_children, CONNECTION_SUBGRAPH::m_hier_parent, CONNECTION_SUBGRAPH::m_hier_pins, CONNECTION_SUBGRAPH::m_hier_ports, CONNECTION_SUBGRAPH::m_multiple_drivers, CONNECTION_SUBGRAPH::m_sheet, m_sheet_to_subgraphs_map, CONNECTION_SUBGRAPH::m_strong_driver, matchBusMember(), SCH_CONNECTION::Name(), path, SCH_SHEET_PATH::PathHumanReadable(), pin, CONNECTION_SUBGRAPH::POWER_PIN, propagateToNeighbors(), SCH_SHEET_PATH::push_back(), recacheSubgraphName(), SCH_SHEET_PATH::size(), and SCH_CONNECTION::Type().
Referenced by buildConnectionGraph(), and propagateToNeighbors().
|
private |
Definition at line 2968 of file connection_graph.cpp.
References ConnTrace, alg::delete_matching(), CONNECTION_SUBGRAPH::m_driver_connection, m_net_name_to_subgraphs_map, and SCH_CONNECTION::Name().
Referenced by propagateToNeighbors().
void CONNECTION_GRAPH::Recalculate | ( | const SCH_SHEET_LIST & | aSheetList, |
bool | aUnconditional = false , |
||
std::function< void(SCH_ITEM *)> * | aChangedItemHandler = nullptr |
||
) |
Update the connection graph for the given list of sheets.
aSheetList | is the list of possibly modified sheets |
aUnconditional | is true if an unconditional full recalculation should be done |
aChangedItemHandler | an optional handler to receive any changed items |
Definition at line 724 of file connection_graph.cpp.
References ConnTrace, SCH_SHEET::GetPins(), SCH_SYMBOL::GetPins(), SCH_ITEM::GetUnit(), SCH_SYMBOL::GetUnitSelection(), m_items, m_sheetList, pin, Reset(), SCH_SHEET_T, SCH_SYMBOL_T, and updateItemConnectivity().
Referenced by BOOST_FIXTURE_TEST_CASE(), EESCHEMA_HELPERS::LoadSchematic(), SCH_EDIT_FRAME::RecalculateConnections(), and SCH_SCREENS::UpdateSymbolLinks().
void CONNECTION_GRAPH::RemoveItem | ( | SCH_ITEM * | aItem | ) |
Definition at line 956 of file connection_graph.cpp.
References alg::delete_matching(), CONNECTION_SUBGRAPH::m_absorbed_by, m_item_to_subgraph_map, m_items, and CONNECTION_SUBGRAPH::RemoveItem().
Referenced by SCH_COMMIT::Revert(), and SCH_ITEM::~SCH_ITEM().
|
private |
Remove references to the given subgraphs from all structures in the connection graph.
aSubgraphs | set of unique subgraphs to find/remove. |
Definition at line 974 of file connection_graph.cpp.
References ConnTrace, m_bus_name_to_code_map, CONNECTION_SUBGRAPH::m_bus_neighbors, CONNECTION_SUBGRAPH::m_bus_parents, m_driver_subgraphs, m_global_label_cache, m_item_to_subgraph_map, m_local_label_cache, m_net_code_to_subgraphs_map, m_net_name_to_code_map, m_net_name_to_subgraphs_map, m_sheet_to_subgraphs_map, and m_subgraphs.
Referenced by ExtractAffectedItems().
void CONNECTION_GRAPH::Reset | ( | ) |
Only delete subgraphs of which we are the owner
Definition at line 696 of file connection_graph.cpp.
References m_bus_alias_cache, m_bus_name_to_code_map, m_driver_subgraphs, m_global_label_cache, m_global_power_pins, m_item_to_subgraph_map, m_items, m_last_bus_code, m_last_net_code, m_last_subgraph_code, m_local_label_cache, m_net_code_to_subgraphs_map, m_net_name_to_code_map, m_net_name_to_subgraphs_map, m_sheet_to_subgraphs_map, and m_subgraphs.
Referenced by EESCHEMA_HELPERS::LoadSchematic(), SCH_EDIT_FRAME::OpenProjectFiles(), Recalculate(), SCHEMATIC::Reset(), SCHEMATIC::SetRoot(), and ~CONNECTION_GRAPH().
|
private |
Find all subgraphs in the connection graph and calls ResolveDrivers() in parallel.
Definition at line 1449 of file connection_graph.cpp.
References ConnTrace, GetKiCadThreadPool(), m_driver_subgraphs, m_subgraphs, pin, SCH_BUS_WIRE_ENTRY_T, SCH_NO_CONNECT_T, SCH_PIN_T, tp, and EDA_ITEM::Type().
Referenced by buildConnectionGraph().
int CONNECTION_GRAPH::RunERC | ( | ) |
Run electrical rule checks on the connectivity graph.
Precondition: graph is up-to-date
NOTE:
We could check that labels attached to bus subgraphs follow the proper format (i.e. actually define a bus).
This check doesn't need to be here right now because labels won't actually be connected to bus wires if they aren't in the right format due to their TestDanglingEnds() implementation.
Definition at line 3128 of file connection_graph.cpp.
References ercCheckBusToBusConflicts(), ercCheckBusToBusEntryConflicts(), ercCheckBusToNetConflicts(), ercCheckDanglingWireEndpoints(), ercCheckDirectiveLabels(), ercCheckFloatingWires(), ercCheckHierSheets(), ercCheckLabels(), ercCheckMultipleDrivers(), ercCheckNoConnects(), ercCheckSingleGlobalLabel(), ERCE_BUS_ENTRY_CONFLICT, ERCE_BUS_TO_BUS_CONFLICT, ERCE_BUS_TO_NET_CONFLICT, ERCE_DRIVER_CONFLICT, ERCE_GLOBLABEL_DANGLING, ERCE_HIERACHICAL_LABEL, ERCE_LABEL_NOT_CONNECTED, ERCE_NOCONNECT_CONNECTED, ERCE_NOCONNECT_NOT_CONNECTED, ERCE_PIN_NOT_CONNECTED, ERCE_SINGLE_GLOBAL_LABEL, ERCE_UNCONNECTED_WIRE_ENDPOINT, ERCE_WIRE_DANGLING, SCHEMATIC::ErcSettings(), ERC_SETTINGS::IsTestEnabled(), m_schematic, and m_subgraphs.
Referenced by ERC_TESTER::RunTests().
|
inline |
Definition at line 377 of file connection_graph.h.
References m_last_bus_code, m_last_net_code, and m_last_subgraph_code.
Referenced by BOOST_FIXTURE_TEST_CASE(), and SCH_EDIT_FRAME::RecalculateConnections().
|
inline |
Definition at line 372 of file connection_graph.h.
References m_schematic.
|
private |
Update the graphical connectivity between items (i.e.
where they touch) The items passed in must be on the same sheet.
In the first phase, all items in aItemList have their connections initialized for the given sheet (since they may have connections on more than one sheet, and each needs to be calculated individually). The graphical connection points for the item are added to a map that stores (x, y) -> [list of items].
Any item that is stored in the list of items that have a connection point at a given (x, y) location will eventually be electrically connected. This means that we can't store SCH_SYMBOLs in this map – we must store a structure that links a specific pin on a symbol back to that symbol: a SCH_PIN_CONNECTION. This wrapper class is a convenience for linking a pin and symbol to a specific (x, y) point.
In the second phase, we iterate over each value in the map, which is a vector of items that have overlapping connection points. After some checks to ensure that the items should actually connect, the items are linked together using ConnectedItems().
As a side effect, items are loaded into m_items for BuildConnectionGraph().
aSheet | is the path to the sheet of all items in the list. |
aItemList | is a list of items to consider. |
Definition at line 1132 of file connection_graph.cpp.
References SCH_ITEM::AddConnectionTo(), SCH_ITEM::ClearConnectedItems(), SCH_SCREEN::GetBus(), SCH_PIN::GetDefaultNetName(), SCH_SHEET::GetFileName(), GetKiCadThreadPool(), SCH_ITEM::GetLayer(), SCH_SHEET::GetPins(), SCH_SYMBOL::GetPins(), SCH_PIN::IsGlobalPower(), SCH_SHEET_PATH::Last(), SCH_SHEET_PATH::LastScreen(), LAYER_BUS, LAYER_BUS_JUNCTION, LAYER_JUNCTION, SCH_BUS_WIRE_ENTRY::m_connected_bus_item, SCH_BUS_BUS_ENTRY::m_connected_bus_items, m_global_power_pins, m_items, name, pin, alg::remove_duplicates(), SCH_BUS_BUS_ENTRY_T, SCH_BUS_WIRE_ENTRY_T, SCH_JUNCTION_T, SCH_LINE_T, SCH_PIN_T, SCH_SHEET_T, SCH_SYMBOL_T, SCH_CONNECTION::SetType(), and tp.
Referenced by Recalculate().
|
private |
Definition at line 775 of file connection_graph.h.
Referenced by buildConnectionGraph(), buildItemSubGraphs(), GetBusAlias(), and Reset().
|
private |
Definition at line 779 of file connection_graph.h.
Referenced by Merge(), processSubGraphs(), removeSubgraphs(), and Reset().
|
private |
Cache of a subset of m_subgraphs.
Definition at line 768 of file connection_graph.h.
Referenced by buildConnectionGraph(), collectAllDriverValues(), generateBusAliasMembers(), generateGlobalPowerPinSubGraphs(), Merge(), processSubGraphs(), removeSubgraphs(), Reset(), and resolveAllDrivers().
|
private |
Definition at line 781 of file connection_graph.h.
Referenced by collectAllDriverValues(), ercCheckNoConnects(), Merge(), removeSubgraphs(), and Reset().
|
private |
Definition at line 773 of file connection_graph.h.
Referenced by generateGlobalPowerPinSubGraphs(), Merge(), Reset(), and updateItemConnectivity().
|
private |
Definition at line 788 of file connection_graph.h.
Referenced by buildItemSubGraphs(), ExchangeItem(), GetSubgraphForItem(), Merge(), RemoveItem(), removeSubgraphs(), and Reset().
|
private |
All connectable items in the schematic.
Definition at line 762 of file connection_graph.h.
Referenced by buildItemSubGraphs(), ExchangeItem(), ExtractAffectedItems(), IsMinor(), Merge(), Recalculate(), RemoveItem(), Reset(), and updateItemConnectivity().
|
private |
Definition at line 794 of file connection_graph.h.
Referenced by Merge(), processSubGraphs(), Reset(), and SetLastCodes().
|
private |
Definition at line 792 of file connection_graph.h.
Referenced by getOrCreateNetCode(), Merge(), Reset(), and SetLastCodes().
|
private |
Definition at line 796 of file connection_graph.h.
Referenced by buildItemSubGraphs(), generateBusAliasMembers(), generateGlobalPowerPinSubGraphs(), Merge(), Reset(), and SetLastCodes().
|
private |
Definition at line 784 of file connection_graph.h.
Referenced by collectAllDriverValues(), ercCheckNoConnects(), Merge(), removeSubgraphs(), and Reset().
|
private |
Definition at line 790 of file connection_graph.h.
Referenced by buildConnectionGraph(), generateBusAliasMembers(), generateGlobalPowerPinSubGraphs(), GetNetMap(), Merge(), removeSubgraphs(), and Reset().
|
private |
Definition at line 777 of file connection_graph.h.
Referenced by getOrCreateNetCode(), Merge(), removeSubgraphs(), and Reset().
|
private |
Definition at line 786 of file connection_graph.h.
Referenced by buildConnectionGraph(), collectAllDriverValues(), ercCheckLabels(), ercCheckNoConnects(), FindFirstSubgraphByName(), FindSubgraphByName(), generateBusAliasMembers(), GetAllSubgraphs(), GetResolvedSubgraphName(), Merge(), processSubGraphs(), recacheSubgraphName(), removeSubgraphs(), and Reset().
|
private |
The schematic this graph represents.
Definition at line 798 of file connection_graph.h.
Referenced by buildConnectionGraph(), buildItemSubGraphs(), ercCheckHierSheets(), ercCheckLabels(), ercCheckNoConnects(), ExchangeItem(), ExtractAffectedItems(), RunERC(), and SetSchematic().
|
private |
Cache to lookup subgraphs in m_driver_subgraphs by sheet path.
Definition at line 771 of file connection_graph.h.
Referenced by buildConnectionGraph(), Merge(), processSubGraphs(), propagateToNeighbors(), removeSubgraphs(), and Reset().
|
private |
All the sheets in the schematic (as long as we don't have partial updates).
Definition at line 759 of file connection_graph.h.
Referenced by ercCheckDirectiveLabels(), ercCheckHierSheets(), ercCheckSingleGlobalLabel(), and Recalculate().
|
private |
The owner of all CONNECTION_SUBGRAPH objects.
Definition at line 765 of file connection_graph.h.
Referenced by buildItemSubGraphs(), generateBusAliasMembers(), generateGlobalPowerPinSubGraphs(), GetBusesNeedingMigration(), Merge(), removeSubgraphs(), Reset(), resolveAllDrivers(), and RunERC().