#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-2017 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 typedef std::map< std::string, MODULE* > MODULE_MAP; typedef std::map< std::string, ENET > 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 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 ), 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 ); }; /** * Class 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: //------------------------------------------------------- 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, const PROPERTIES* aProperties = NULL) override; MODULE* FootprintLoad( const wxString& aLibraryPath, const wxString& aFootprintName, const PROPERTIES* aProperties = NULL ) override; 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 MODULE* 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(); 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 layers data stored by the layer number 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 module names from eagle "hole"s. NET_MAP m_pads_to_nets; ///< net list MODULE_MAP m_templates; ///< is part of a MODULE 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_via; ///< smallest via we find on Load(), in BIU. int m_min_via_hole; ///< smallest via diameter hole 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 wxSize kicad_fontz( const ECOORD& d ) const; /// Convert an Eagle layer to a KiCad layer. PCB_LAYER_ID kicad_layer( int aLayer ) const; /// Get Eagle layer name by its number const std::string& eagle_layer_name( int aLayer ) 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 std::string* aLibName ); void loadLibraries( wxXmlNode* aLibs ); void loadElements( wxXmlNode* aElements ); void orientModuleAndText( MODULE* m, const EELEMENT& e, const EATTR* nameAttr, const EATTR* valueAttr ); void orientModuleText( MODULE* m, const EELEMENT& e, TEXTE_MODULE* txt, const EATTR* a ); /// move the BOARD into the center of the page void centerBoard(); /** * Function fmtDEG * formats an angle in a way particular to a board file format. This function * is the opposite or complement of degParse(). One has to know what the * other is doing. */ std::string fmtDEG( double aAngle ) const; /** * Function makeModule * creates a MODULE from an Eagle package. */ MODULE* makeModule( wxXmlNode* aPackage, const std::string& aPkgName ) const; void packageWire( MODULE* aModule, wxXmlNode* aTree ) const; void packagePad( MODULE* aModule, wxXmlNode* aTree ) const; void packageText( MODULE* aModule, wxXmlNode* aTree ) const; void packageRectangle( MODULE* aModule, wxXmlNode* aTree ) const; void packagePolygon( MODULE* aModule, wxXmlNode* aTree ) const; void packageCircle( MODULE* aModule, wxXmlNode* aTree ) const; void packageHole( MODULE* aModule, wxXmlNode* aTree ) const; void packageSMD( MODULE* aModule, wxXmlNode* aTree ) const; ///> Deletes the footprint templates list void deleteTemplates(); }; #endif // EAGLE_PLUGIN_H_