/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2018 CERN * Copyright (C) 2019-2021 KiCad Developers, see change_log.txt for contributors. * @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 . */ #include #include #include #include #include #include #include SCH_PIN::SCH_PIN( LIB_PIN* aLibPin, SCH_SYMBOL* aParentSymbol ) : SCH_ITEM( aParentSymbol, SCH_PIN_T ) { m_alt = wxEmptyString; m_number = aLibPin->GetNumber(); m_libPin = aLibPin; SetPosition( aLibPin->GetPosition() ); m_isDangling = true; } /** * Create a proxy pin from an alternate pin designation. * The LIB_PIN data will be filled in when the pin is resolved (see SCH_SYMBOL::UpdatePins). */ SCH_PIN::SCH_PIN( SCH_SYMBOL* aParentSymbol, const wxString& aNumber, const wxString& aAlt ) : SCH_ITEM( aParentSymbol, SCH_PIN_T ) { m_alt = aAlt; m_number = aNumber; m_libPin = nullptr; m_isDangling = true; } SCH_PIN::SCH_PIN( const SCH_PIN& aPin ) : SCH_ITEM( aPin ) { m_alt = aPin.m_alt; m_number = aPin.m_number; m_libPin = aPin.m_libPin; m_position = aPin.m_position; m_isDangling = aPin.m_isDangling; } SCH_PIN& SCH_PIN::operator=( const SCH_PIN& aPin ) { SCH_ITEM::operator=( aPin ); m_alt = aPin.m_alt; m_number = aPin.m_number; m_libPin = aPin.m_libPin; m_position = aPin.m_position; m_isDangling = aPin.m_isDangling; return *this; } wxString SCH_PIN::GetName() const { if( !m_alt.IsEmpty() ) return m_alt; return m_libPin->GetName(); } wxString SCH_PIN::GetShownName() const { wxString name = m_libPin->GetName(); if( !m_alt.IsEmpty() ) name = m_alt; if( name == "~" ) return wxEmptyString; else return name; } wxString SCH_PIN::GetShownNumber() const { if( m_number == "~" ) return wxEmptyString; else return m_number; } ELECTRICAL_PINTYPE SCH_PIN::GetType() const { if( !m_alt.IsEmpty() ) return m_libPin->GetAlt( m_alt ).m_Type; return m_libPin->GetType(); } GRAPHIC_PINSHAPE SCH_PIN::GetShape() const { if( !m_alt.IsEmpty() ) return m_libPin->GetAlt( m_alt ).m_Shape; return m_libPin->GetShape(); } int SCH_PIN::GetOrientation() const { return m_libPin->GetOrientation(); } int SCH_PIN::GetLength() const { return m_libPin->GetLength(); } bool SCH_PIN::Matches( const wxFindReplaceData& aSearchData, void* aAuxDat ) const { if( !( aSearchData.GetFlags() & FR_SEARCH_ALL_PINS ) ) return false; return EDA_ITEM::Matches( GetName(), aSearchData ) || EDA_ITEM::Matches( GetNumber(), aSearchData ); } bool SCH_PIN::Replace( const wxFindReplaceData& aSearchData, void* aAuxData ) { bool isReplaced = false; /* TODO: waiting on a way to override pins in the schematic... isReplaced |= EDA_ITEM::Replace( aSearchData, m_name ); isReplaced |= EDA_ITEM::Replace( aSearchData, m_number ); */ return isReplaced; } SCH_SYMBOL* SCH_PIN::GetParentSymbol() const { return static_cast( GetParent() ); } wxString SCH_PIN::GetSelectMenuText( EDA_UNITS aUnits ) const { return wxString::Format( "%s %s", GetParentSymbol()->GetSelectMenuText( aUnits ), m_libPin->GetSelectMenuText( aUnits ) ); } void SCH_PIN::GetMsgPanelInfo( EDA_DRAW_FRAME* aFrame, std::vector& aList ) { wxString msg; aList.push_back( MSG_PANEL_ITEM( _( "Type" ), _( "Pin" ) ) ); if( m_libPin->GetUnit() == 0 ) msg = _( "All" ); else msg.Printf( wxT( "%d" ), m_libPin->GetUnit() ); aList.push_back( MSG_PANEL_ITEM( _( "Unit" ), msg ) ); if( m_libPin->GetConvert() == LIB_ITEM::LIB_CONVERT::BASE ) msg = _( "no" ); else if( m_libPin->GetConvert() == LIB_ITEM::LIB_CONVERT::DEMORGAN ) msg = _( "yes" ); else msg = wxT( "?" ); aList.push_back( MSG_PANEL_ITEM( _( "Converted" ), msg ) ); aList.push_back( MSG_PANEL_ITEM( _( "Name" ), GetShownName() ) ); aList.push_back( MSG_PANEL_ITEM( _( "Number" ), GetShownNumber() ) ); aList.push_back( MSG_PANEL_ITEM( _( "Type" ), ElectricalPinTypeGetText( GetType() ) ) ); msg = PinShapeGetText( GetShape() ); aList.push_back( MSG_PANEL_ITEM( _( "Style" ), msg ) ); msg = IsVisible() ? _( "Yes" ) : _( "No" ); aList.push_back( MSG_PANEL_ITEM( _( "Visible" ), msg ) ); // Display pin length msg = StringFromValue( aFrame->GetUserUnits(), GetLength() ); aList.push_back( MSG_PANEL_ITEM( _( "Length" ), msg ) ); msg = PinOrientationName( (unsigned) PinOrientationIndex( GetOrientation() ) ); aList.push_back( MSG_PANEL_ITEM( _( "Orientation" ), msg ) ); SCH_EDIT_FRAME* schframe = dynamic_cast( aFrame ); SCH_SHEET_PATH* currentSheet = schframe ? &schframe->GetCurrentSheet() : nullptr; SCH_SYMBOL* symbol = GetParentSymbol(); aList.emplace_back( symbol->GetRef( currentSheet ), symbol->GetValue( currentSheet, true ) ); #if defined(DEBUG) SCH_EDIT_FRAME* frame = dynamic_cast( aFrame ); if( !frame ) return; SCH_CONNECTION* conn = Connection(); if( conn ) conn->AppendInfoToMsgPanel( aList ); #endif } void SCH_PIN::ClearDefaultNetName( const SCH_SHEET_PATH* aPath ) { std::lock_guard lock( m_netmap_mutex ); if( aPath ) m_net_name_map.erase( *aPath ); else m_net_name_map.clear(); } wxString SCH_PIN::GetDefaultNetName( const SCH_SHEET_PATH& aPath, bool aForceNoConnect ) { if( m_libPin->IsPowerConnection() ) return m_libPin->GetName(); std::lock_guard lock( m_netmap_mutex ); auto it = m_net_name_map.find( aPath ); if( it != m_net_name_map.end() ) { if( it->second.second == aForceNoConnect ) return it->second.first; } wxString name = "Net-("; if( aForceNoConnect || GetType() == ELECTRICAL_PINTYPE::PT_NC ) name = ( "unconnected-(" ); name << GetParentSymbol()->GetRef( &aPath ); bool annotated = true; // Add timestamp for uninitialized symbols if( name.Last() == '?' ) { name << GetParentSymbol()->m_Uuid.AsString(); annotated = false; } name << "-Pad" << m_libPin->GetNumber() << ")"; if( annotated ) m_net_name_map[ aPath ] = std::make_pair( name, aForceNoConnect ); return name; } wxPoint SCH_PIN::GetTransformedPosition() const { TRANSFORM t = GetParentSymbol()->GetTransform(); return t.TransformCoordinate( GetLocalPosition() ) + GetParentSymbol()->GetPosition(); } const EDA_RECT SCH_PIN::GetBoundingBox() const { TRANSFORM t = GetParentSymbol()->GetTransform(); EDA_RECT r = m_libPin->GetBoundingBox(); r.RevertYAxis(); r = t.TransformCoordinate( r ); r.Offset( GetParentSymbol()->GetPosition() ); return r; } bool SCH_PIN::HitTest( const wxPoint& aPosition, int aAccuracy ) const { // When looking for an "exact" hit aAccuracy will be 0 which works poorly if the pin has // no pin number or name. Give it a floor. if( Schematic() ) aAccuracy = std::max( aAccuracy, Schematic()->Settings().m_PinSymbolSize / 4 ); EDA_RECT rect = GetBoundingBox(); return rect.Inflate( aAccuracy ).Contains( aPosition ); } bool SCH_PIN::ConnectionPropagatesTo( const EDA_ITEM* aItem ) const { // Reciprocal checking is done in CONNECTION_GRAPH anyway return !( m_libPin->GetType() == ELECTRICAL_PINTYPE::PT_NC ); }