#ifndef EAGLE_PLUGIN_H_ #define EAGLE_PLUGIN_H_ /* * This program source code file is part of KiCad, a free EDA CAD application. * * Copyright (C) 2012 SoftPLC Corporation, Dick Hollenbeck * Copyright (C) 2012-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 */ #include #include #include #include #include #include #include class PAD; class FP_TEXT; class ZONE; typedef std::map FOOTPRINT_MAP; typedef std::vector ZONES; typedef std::map NET_MAP; typedef NET_MAP::const_iterator NET_MAP_CITER; /// subset of eagle.drawing.board.designrules in the XML document struct ERULES { int psElongationLong; ///< percent over 100%. 0-> not elongated, 100->twice as wide as is tall ///< Goes into making a scaling factor for "long" pads. int psElongationOffset; ///< the offset of the hole within the "long" pad. double mvStopFrame; ///< solder mask, expressed as percentage of the smaller pad/via dimension double mvCreamFrame; ///< solderpaste mask, expressed as percentage of the smaller pad/via dimension int mlMinStopFrame; ///< solder mask, minimum size (Eagle mils, here nanometers) int mlMaxStopFrame; ///< solder mask, maximum size (Eagle mils, here nanometers) int mlMinCreamFrame; ///< solder paste mask, minimum size (Eagle mils, here nanometers) int mlMaxCreamFrame; ///< solder paste mask, maximum size (Eagle mils, here nanometers) int psTop; ///< Shape of the top pads int psBottom; ///< Shape of the bottom pads int psFirst; ///< Shape of the first pads double srRoundness; ///< corner rounding ratio for SMD pads (percentage) int srMinRoundness; ///< corner rounding radius, minimum size (Eagle mils, here nanometers) int srMaxRoundness; ///< corner rounding radius, maximum size (Eagle mils, here nanometers) double rvPadTop; ///< top pad size as percent of drill size // double rvPadBottom; ///< bottom pad size as percent of drill size double rlMinPadTop; ///< minimum copper annulus on through hole pads double rlMaxPadTop; ///< maximum copper annulus on through hole pads double rvViaOuter; ///< copper annulus is this percent of via hole double rlMinViaOuter; ///< minimum copper annulus on via double rlMaxViaOuter; ///< maximum copper annulus on via double mdWireWire; ///< wire to wire spacing I presume. ERULES() : psElongationLong ( 100 ), psElongationOffset ( 0 ), mvStopFrame ( 1.0 ), mvCreamFrame ( 0.0 ), mlMinStopFrame ( Mils2iu( 4.0 ) ), mlMaxStopFrame ( Mils2iu( 4.0 ) ), mlMinCreamFrame ( Mils2iu( 0.0 ) ), mlMaxCreamFrame ( Mils2iu( 0.0 ) ), psTop ( EPAD::UNDEF ), psBottom ( EPAD::UNDEF ), psFirst ( EPAD::UNDEF ), srRoundness ( 0.0 ), srMinRoundness ( Mils2iu( 0.0 ) ), srMaxRoundness ( Mils2iu( 0.0 ) ), rvPadTop ( 0.25 ), // rvPadBottom ( 0.25 ), rlMinPadTop ( Mils2iu( 10 ) ), rlMaxPadTop ( Mils2iu( 20 ) ), rvViaOuter ( 0.25 ), rlMinViaOuter ( Mils2iu( 10 ) ), rlMaxViaOuter ( Mils2iu( 20 ) ), mdWireWire ( 0 ) {} void parse( wxXmlNode* aRules ); }; /** * EAGLE_PLUGIN * works with Eagle 6.x XML board files and footprints to implement the * Pcbnew PLUGIN API, or a portion of it. */ class EAGLE_PLUGIN : public PLUGIN, public LAYER_REMAPPABLE_PLUGIN { public: //------------------------------------------------------- const wxString PluginName() const override; BOARD* Load( const wxString& aFileName, BOARD* aAppendToMe, const PROPERTIES* aProperties = NULL ) override; const wxString GetFileExtension() const override; void FootprintEnumerate( wxArrayString& aFootprintNames, const wxString& aLibraryPath, bool aBestEfforts, const PROPERTIES* aProperties = NULL) override; FOOTPRINT* FootprintLoad( const wxString& aLibraryPath, const wxString& aFootprintName, const PROPERTIES* aProperties = NULL ) override; long long GetLibraryTimestamp( const wxString& aLibraryPath ) const override { return getModificationTime( aLibraryPath ).GetValue().GetValue(); } bool IsFootprintLibWritable( const wxString& aLibraryPath ) override { return false; // until someone writes others like FootprintSave(), etc. } void FootprintLibOptions( PROPERTIES* aProperties ) const override; /* void Save( const wxString& aFileName, BOARD* aBoard, const PROPERTIES* aProperties = NULL ); void FootprintSave( const wxString& aLibraryPath, const FOOTPRINT* aFootprint, const PROPERTIES* aProperties = NULL ); void FootprintDelete( const wxString& aLibraryPath, const wxString& aFootprintName, const PROPERTIES* aProperties = NULL ); void FootprintLibCreate( const wxString& aLibraryPath, const PROPERTIES* aProperties = NULL ); bool FootprintLibDelete( const wxString& aLibraryPath, const PROPERTIES* aProperties = NULL ); */ //------------------------------------------------------ typedef int BIU; EAGLE_PLUGIN(); ~EAGLE_PLUGIN(); /** * @brief Default callback - just returns the automapped layers * * The callback needs to have the context of the current board so it can * correctly determine copper layer mapping. Thus, it is not static and is * expected to be bind to an instance of EAGLE_PLUGIN. * * @param aInputLayerDescriptionVector * @return Auto-mapped layers */ std::map DefaultLayerMappingCallback( const std::vector& aInputLayerDescriptionVector ); private: typedef std::vector ELAYERS; typedef ELAYERS::const_iterator EITER; int m_cu_map[17]; ///< map eagle to kicad, cu layers only. std::map m_eagleLayers; ///< Eagle layer data stored by layer number std::map m_eagleLayersIds; ///< Eagle layer ids stored by layer name std::map m_layer_map; ///< Map of Eagle layers to KiCAD layers ERULES* m_rules; ///< Eagle design rules. XPATH* m_xpath; ///< keeps track of what we are working on within ///< XML document during a Load(). int m_hole_count; ///< generates unique footprint names from eagle "hole"s. NET_MAP m_pads_to_nets; ///< net list FOOTPRINT_MAP m_templates; ///< is part of a FOOTPRINT factory that operates using copy ///< construction. ///< lookup key is either libname.packagename or simply ///< packagename if FootprintLoad() or FootprintEnumberate() const PROPERTIES* m_props; ///< passed via Save() or Load(), no ownership, may be NULL. BOARD* m_board; ///< which BOARD is being worked on, no ownership here int m_min_trace; ///< smallest trace we find on Load(), in BIU. int m_min_hole; ///< smallest diameter hole we find on Load(), in BIU. int m_min_via; ///< smallest via we find on Load(), in BIU. int m_min_annulus; ///< smallest via annulus we find on Load(), in BIU. wxString m_lib_path; wxDateTime m_mod_time; /// initialize PLUGIN like a constructor would, and futz with fresh BOARD if needed. void init( const PROPERTIES* aProperties ); void clear_cu_map(); /// Convert an Eagle distance to a KiCad distance. int kicad_y( const ECOORD& y ) const { return -y.ToPcbUnits(); } int kicad_x( const ECOORD& x ) const { return x.ToPcbUnits(); } /// create a font size (fontz) from an eagle font size scalar and KiCAD font thickness wxSize kicad_fontz( const ECOORD& d, int aTextThickness ) const; /// Generate mapping between Eagle na KiCAD layers void mapEagleLayersToKicad(); /// Convert an Eagle layer to a KiCad layer. PCB_LAYER_ID kicad_layer( int aLayer ) const; /// Get default KiCAD layer corresponding to an Eagle layer of the board, /// a set of sensible layer mapping options and required flag std::tuple defaultKicadLayer( int aEagleLayer ) const; /// Get Eagle layer name by its number const wxString& eagle_layer_name( int aLayer ) const; /// Get Eagle leayer number by its name int eagle_layer_id( const wxString& aLayerName ) const; /// This PLUGIN only caches one footprint library, this determines which one. void cacheLib( const wxString& aLibraryPath ); /// get a file's or dir's modification time. static wxDateTime getModificationTime( const wxString& aPath ); // all these loadXXX() throw IO_ERROR or ptree_error exceptions: void loadAllSections( wxXmlNode* aDocument ); void loadDesignRules( wxXmlNode* aDesignRules ); void loadLayerDefs( wxXmlNode* aLayers ); void loadPlain( wxXmlNode* aPlain ); void loadSignals( wxXmlNode* aSignals ); /** * Function loadLibrary * loads the Eagle "library" XML element, which can occur either under * a "libraries" element (if a *.brd file) or under a "drawing" element if a * *.lbr file. * @param aLib is the portion of the loaded XML document tree that is the "library" * element. * @param aLibName is a pointer to the library name or NULL. If NULL this means * we are loading a *.lbr not a *.brd file and the key used in m_templates is to exclude * the library name. */ void loadLibrary( wxXmlNode* aLib, const wxString* aLibName ); void loadLibraries( wxXmlNode* aLibs ); void loadElements( wxXmlNode* aElements ); /** Loads a copper or keepout polygon and adds it to the board. * * @return The loaded zone or nullptr if was not processed. */ ZONE* loadPolygon( wxXmlNode* aPolyNode ); void orientFootprintAndText( FOOTPRINT* aFootprint, const EELEMENT& e, const EATTR* aNameAttr, const EATTR* aValueAttr ); void orientFPText( FOOTPRINT* aFootprint, const EELEMENT& e, FP_TEXT* aFPText, const EATTR* aAttr ); /// move the BOARD into the center of the page void centerBoard(); /** * Function makeFootprint * creates a FOOTPRINT from an Eagle package. */ FOOTPRINT* makeFootprint( wxXmlNode* aPackage, const wxString& aPkgName ); void packageWire( FOOTPRINT* aFootprint, wxXmlNode* aTree ) const; void packagePad( FOOTPRINT* aFootprint, wxXmlNode* aTree ); void packageText( FOOTPRINT* aFootprint, wxXmlNode* aTree ) const; void packageRectangle( FOOTPRINT* aFootprint, wxXmlNode* aTree ) const; void packagePolygon( FOOTPRINT* aFootprint, wxXmlNode* aTree ) const; void packageCircle( FOOTPRINT* aFootprint, wxXmlNode* aTree ) const; /** * Function packageHole * @parameter aFootprint - The KiCad footprint to which to assign the hole * @parameter aTree - The Eagle XML node that is of type "hole" * @parameter aCenter - If true, center the hole in the footprint and * offset the footprint position */ void packageHole( FOOTPRINT* aFootprint, wxXmlNode* aTree, bool aCenter ) const; void packageSMD( FOOTPRINT* aFootprint, wxXmlNode* aTree ) const; ///> Handles common pad properties void transferPad( const EPAD_COMMON& aEaglePad, PAD* aPad ) const; ///> Deletes the footprint templates list void deleteTemplates(); }; #endif // EAGLE_PLUGIN_H_