/* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2019-2022 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 */ #include #include #include #include #include #include #include /* -------------------------------------------------------------------------------------------- * Specialized Expression References */ BOARD_ITEM* PCBEXPR_VAR_REF::GetObject( const LIBEVAL::CONTEXT* aCtx ) const { wxASSERT( dynamic_cast( aCtx ) ); const PCBEXPR_CONTEXT* ctx = static_cast( aCtx ); BOARD_ITEM* item = ctx->GetItem( m_itemIndex ); return item; } class PCBEXPR_LAYER_VALUE : public LIBEVAL::VALUE { public: PCBEXPR_LAYER_VALUE( PCB_LAYER_ID aLayer ) : LIBEVAL::VALUE( LayerName( aLayer ) ), m_layer( aLayer ) {}; virtual bool EqualTo( LIBEVAL::CONTEXT* aCtx, const VALUE* b ) const override { // For boards with user-defined layer names there will be 2 entries for each layer // in the ENUM_MAP: one for the canonical layer name and one for the user layer name. // We need to check against both. wxPGChoices& layerMap = ENUM_MAP::Instance().Choices(); const wxString& layerName = b->AsString(); BOARD* board = static_cast( aCtx )->GetBoard(); { std::shared_lock readLock( board->m_CachesMutex ); auto i = board->m_LayerExpressionCache.find( layerName ); if( i != board->m_LayerExpressionCache.end() ) return i->second.Contains( m_layer ); } LSET mask; for( unsigned ii = 0; ii < layerMap.GetCount(); ++ii ) { wxPGChoiceEntry& entry = layerMap[ii]; if( entry.GetText().Matches( layerName ) ) mask.set( ToLAYER_ID( entry.GetValue() ) ); } { std::unique_lock writeLock( board->m_CachesMutex ); board->m_LayerExpressionCache[ layerName ] = mask; } return mask.Contains( m_layer ); } protected: PCB_LAYER_ID m_layer; }; class PCBEXPR_PINTYPE_VALUE : public LIBEVAL::VALUE { public: PCBEXPR_PINTYPE_VALUE( const wxString& aPinTypeName ) : LIBEVAL::VALUE( aPinTypeName ) {}; bool EqualTo( LIBEVAL::CONTEXT* aCtx, const VALUE* b ) const override { const wxString& thisStr = AsString(); const wxString& otherStr = b->AsString(); if( thisStr.IsSameAs( otherStr, false ) ) return true; // Handle cases where the netlist token is different from the EEschema token if( thisStr == wxT( "tri_state" ) ) return otherStr.IsSameAs( wxT( "Tri-state" ), false ); if( thisStr == wxT( "power_in" ) ) return otherStr.IsSameAs( wxT( "Power input" ), false ); if( thisStr == wxT( "power_out" ) ) return otherStr.IsSameAs( wxT( "Power output" ), false ); if( thisStr == wxT( "no_connect" ) ) return otherStr.IsSameAs( wxT( "Unconnected" ), false ); return false; } }; class PCBEXPR_NETCLASS_VALUE : public LIBEVAL::VALUE { public: PCBEXPR_NETCLASS_VALUE( BOARD_CONNECTED_ITEM* aItem ) : LIBEVAL::VALUE( wxEmptyString ), m_item( aItem ) {}; const wxString& AsString() const override { const_cast( this )->Set( m_item->GetEffectiveNetClass()->GetName() ); return LIBEVAL::VALUE::AsString(); } bool EqualTo( LIBEVAL::CONTEXT* aCtx, const VALUE* b ) const override { if( const PCBEXPR_NETCLASS_VALUE* bValue = dynamic_cast( b ) ) return m_item->GetEffectiveNetClass() == bValue->m_item->GetEffectiveNetClass(); else return LIBEVAL::VALUE::EqualTo( aCtx, b ); } bool NotEqualTo( LIBEVAL::CONTEXT* aCtx, const LIBEVAL::VALUE* b ) const override { if( const PCBEXPR_NETCLASS_VALUE* bValue = dynamic_cast( b ) ) return m_item->GetEffectiveNetClass() != bValue->m_item->GetEffectiveNetClass(); else return LIBEVAL::VALUE::NotEqualTo( aCtx, b ); } protected: BOARD_CONNECTED_ITEM* m_item; }; class PCBEXPR_NET_VALUE : public LIBEVAL::VALUE { public: PCBEXPR_NET_VALUE( BOARD_CONNECTED_ITEM* aItem ) : LIBEVAL::VALUE( wxEmptyString ), m_item( aItem ) {}; const wxString& AsString() const override { const_cast( this )->Set( m_item->GetNetname() ); return LIBEVAL::VALUE::AsString(); } bool EqualTo( LIBEVAL::CONTEXT* aCtx, const VALUE* b ) const override { if( const PCBEXPR_NET_VALUE* bValue = dynamic_cast( b ) ) return m_item->GetNetCode() == bValue->m_item->GetNetCode(); else return LIBEVAL::VALUE::EqualTo( aCtx, b ); } bool NotEqualTo( LIBEVAL::CONTEXT* aCtx, const LIBEVAL::VALUE* b ) const override { if( const PCBEXPR_NET_VALUE* bValue = dynamic_cast( b ) ) return m_item->GetNetCode() != bValue->m_item->GetNetCode(); else return LIBEVAL::VALUE::NotEqualTo( aCtx, b ); } protected: BOARD_CONNECTED_ITEM* m_item; }; LIBEVAL::VALUE* PCBEXPR_VAR_REF::GetValue( LIBEVAL::CONTEXT* aCtx ) { PCBEXPR_CONTEXT* context = static_cast( aCtx ); if( m_itemIndex == 2 ) return new PCBEXPR_LAYER_VALUE( context->GetLayer() ); BOARD_ITEM* item = GetObject( aCtx ); if( !item ) return new LIBEVAL::VALUE(); auto it = m_matchingTypes.find( TYPE_HASH( *item ) ); if( it == m_matchingTypes.end() ) { // Don't force user to type "A.Type == 'via' && A.Via_Type == 'buried'" when the // simpler "A.Via_Type == 'buried'" is perfectly clear. Instead, return an undefined // value when the property doesn't appear on a particular object. return new LIBEVAL::VALUE(); } else { if( m_type == LIBEVAL::VT_NUMERIC ) { return new LIBEVAL::VALUE( (double) item->Get( it->second ) ); } else { wxString str; if( !m_isEnum ) { str = item->Get( it->second ); if( it->second->Name() == wxT( "Pin Type" ) ) return new PCBEXPR_PINTYPE_VALUE( str ); else return new LIBEVAL::VALUE( str ); } else { const wxAny& any = item->Get( it->second ); PCB_LAYER_ID layer; if( it->second->Name() == wxT( "Layer" ) || it->second->Name() == wxT( "Layer Top" ) || it->second->Name() == wxT( "Layer Bottom" ) ) { if( any.GetAs( &layer ) ) return new PCBEXPR_LAYER_VALUE( layer ); else if( any.GetAs( &str ) ) return new PCBEXPR_LAYER_VALUE( context->GetBoard()->GetLayerID( str ) ); } else { if( any.GetAs( &str ) ) return new LIBEVAL::VALUE( str ); } } return new LIBEVAL::VALUE(); } } } LIBEVAL::VALUE* PCBEXPR_NETCLASS_REF::GetValue( LIBEVAL::CONTEXT* aCtx ) { BOARD_CONNECTED_ITEM* item = dynamic_cast( GetObject( aCtx ) ); if( !item ) return new LIBEVAL::VALUE(); return new PCBEXPR_NETCLASS_VALUE( item ); } LIBEVAL::VALUE* PCBEXPR_NETNAME_REF::GetValue( LIBEVAL::CONTEXT* aCtx ) { BOARD_CONNECTED_ITEM* item = dynamic_cast( GetObject( aCtx ) ); if( !item ) return new LIBEVAL::VALUE(); return new PCBEXPR_NET_VALUE( item ); } LIBEVAL::VALUE* PCBEXPR_TYPE_REF::GetValue( LIBEVAL::CONTEXT* aCtx ) { BOARD_ITEM* item = GetObject( aCtx ); if( !item ) return new LIBEVAL::VALUE(); return new LIBEVAL::VALUE( ENUM_MAP::Instance().ToString( item->Type() ) ); } LIBEVAL::FUNC_CALL_REF PCBEXPR_UCODE::CreateFuncCall( const wxString& aName ) { PCBEXPR_BUILTIN_FUNCTIONS& registry = PCBEXPR_BUILTIN_FUNCTIONS::Instance(); return registry.Get( aName.Lower() ); } std::unique_ptr PCBEXPR_UCODE::CreateVarRef( const wxString& aVar, const wxString& aField ) { PROPERTY_MANAGER& propMgr = PROPERTY_MANAGER::Instance(); std::unique_ptr vref; // Check for a couple of very common cases and compile them straight to "object code". if( aField.CmpNoCase( wxT( "NetClass" ) ) == 0 ) { if( aVar == wxT( "A" ) ) return std::make_unique( 0 ); else if( aVar == wxT( "B" ) ) return std::make_unique( 1 ); else return nullptr; } else if( aField.CmpNoCase( wxT( "NetName" ) ) == 0 ) { if( aVar == wxT( "A" ) ) return std::make_unique( 0 ); else if( aVar == wxT( "B" ) ) return std::make_unique( 1 ); else return nullptr; } else if( aField.CmpNoCase( wxT( "Type" ) ) == 0 ) { if( aVar == wxT( "A" ) ) return std::make_unique( 0 ); else if( aVar == wxT( "B" ) ) return std::make_unique( 1 ); else return nullptr; } if( aVar == wxT( "A" ) || aVar == wxT( "AB" ) ) vref = std::make_unique( 0 ); else if( aVar == wxT( "B" ) ) vref = std::make_unique( 1 ); else if( aVar == wxT( "L" ) ) vref = std::make_unique( 2 ); else return nullptr; if( aField.length() == 0 ) // return reference to base object { return vref; } wxString field( aField ); field.Replace( wxT( "_" ), wxT( " " ) ); for( const PROPERTY_MANAGER::CLASS_INFO& cls : propMgr.GetAllClasses() ) { if( propMgr.IsOfType( cls.type, TYPE_HASH( BOARD_ITEM ) ) ) { PROPERTY_BASE* prop = propMgr.GetProperty( cls.type, field ); if( prop ) { vref->AddAllowedClass( cls.type, prop ); if( prop->TypeHash() == TYPE_HASH( int ) ) { vref->SetType( LIBEVAL::VT_NUMERIC ); } else if( prop->TypeHash() == TYPE_HASH( bool ) ) { vref->SetType( LIBEVAL::VT_NUMERIC ); } else if( prop->TypeHash() == TYPE_HASH( wxString ) ) { vref->SetType( LIBEVAL::VT_STRING ); } else if ( prop->HasChoices() ) { // it's an enum, we treat it as string vref->SetType( LIBEVAL::VT_STRING ); vref->SetIsEnum ( true ); } else { wxFAIL_MSG( wxT( "PCBEXPR_UCODE::createVarRef: Unknown property type." ) ); } } } } if( vref->GetType() == LIBEVAL::VT_UNDEFINED ) vref->SetType( LIBEVAL::VT_PARSE_ERROR ); return vref; } BOARD* PCBEXPR_CONTEXT::GetBoard() const { if( m_items[0] ) return m_items[0]->GetBoard(); return nullptr; } /* -------------------------------------------------------------------------------------------- * Unit Resolvers */ const std::vector& PCBEXPR_UNIT_RESOLVER::GetSupportedUnits() const { static const std::vector pcbUnits = { wxT( "mil" ), wxT( "mm" ), wxT( "in" ) }; return pcbUnits; } wxString PCBEXPR_UNIT_RESOLVER::GetSupportedUnitsMessage() const { return _( "must be mm, in, or mil" ); } double PCBEXPR_UNIT_RESOLVER::Convert( const wxString& aString, int unitId ) const { double v = wxAtof( aString ); switch( unitId ) { case 0: return EDA_UNIT_UTILS::UI::DoubleValueFromString( pcbIUScale, EDA_UNITS::MILS, aString ); case 1: return EDA_UNIT_UTILS::UI::DoubleValueFromString( pcbIUScale, EDA_UNITS::MILLIMETRES, aString ); case 2: return EDA_UNIT_UTILS::UI::DoubleValueFromString( pcbIUScale, EDA_UNITS::INCHES, aString ); default: return v; } }; const std::vector& PCBEXPR_UNITLESS_RESOLVER::GetSupportedUnits() const { static const std::vector emptyUnits; return emptyUnits; } double PCBEXPR_UNITLESS_RESOLVER::Convert( const wxString& aString, int unitId ) const { return wxAtof( aString ); }; PCBEXPR_COMPILER::PCBEXPR_COMPILER( LIBEVAL::UNIT_RESOLVER* aUnitResolver ) { m_unitResolver.reset( aUnitResolver ); } /* -------------------------------------------------------------------------------------------- * PCB Expression Evaluator */ PCBEXPR_EVALUATOR::PCBEXPR_EVALUATOR( LIBEVAL::UNIT_RESOLVER* aUnitResolver ) : m_result( 0 ), m_compiler( aUnitResolver ), m_ucode(), m_errorStatus() { } PCBEXPR_EVALUATOR::~PCBEXPR_EVALUATOR() { } bool PCBEXPR_EVALUATOR::Evaluate( const wxString& aExpr ) { PCBEXPR_UCODE ucode; PCBEXPR_CONTEXT preflightContext( NULL_CONSTRAINT, F_Cu ); if( !m_compiler.Compile( aExpr.ToUTF8().data(), &ucode, &preflightContext ) ) return false; PCBEXPR_CONTEXT evaluationContext( NULL_CONSTRAINT, F_Cu ); LIBEVAL::VALUE* result = ucode.Run( &evaluationContext ); if( result->GetType() == LIBEVAL::VT_NUMERIC ) m_result = KiROUND( result->AsDouble() ); return true; }