296 lines
12 KiB
C++
296 lines
12 KiB
C++
#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 <dick@softplc.com>
|
|
* 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 <io_mgr.h>
|
|
#include <layers_id_colors_and_visibility.h>
|
|
#include <eagle_parser.h>
|
|
|
|
#include <map>
|
|
#include <wx/xml/xml.h>
|
|
|
|
class D_PAD;
|
|
class TEXTE_MODULE;
|
|
|
|
typedef std::map<wxString, MODULE*> MODULE_MAP;
|
|
typedef std::vector<ZONE_CONTAINER*> ZONES;
|
|
typedef std::map<wxString, 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 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:
|
|
|
|
//-----<PUBLIC PLUGIN API>--------------------------------------------------
|
|
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;
|
|
|
|
MODULE* 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 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 );
|
|
*/
|
|
|
|
//-----</PUBLIC PLUGIN API>-------------------------------------------------
|
|
|
|
typedef int BIU;
|
|
|
|
EAGLE_PLUGIN();
|
|
~EAGLE_PLUGIN();
|
|
|
|
private:
|
|
typedef std::vector<ELAYER> ELAYERS;
|
|
typedef ELAYERS::const_iterator EITER;
|
|
|
|
int m_cu_map[17]; ///< map eagle to kicad, cu layers only.
|
|
std::map<int, ELAYER> 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 wxString& 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 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_CONTAINER* loadPolygon( wxXmlNode* aPolyNode );
|
|
|
|
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.
|
|
*/
|
|
wxString fmtDEG( double aAngle ) const;
|
|
|
|
/**
|
|
* Function makeModule
|
|
* creates a MODULE from an Eagle package.
|
|
*/
|
|
MODULE* makeModule( wxXmlNode* aPackage, const wxString& 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;
|
|
|
|
/**
|
|
* Function packageHole
|
|
* @parameter aModule - The KiCad module 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 module and
|
|
* offset the module position
|
|
*/
|
|
void packageHole( MODULE* aModule, wxXmlNode* aTree, bool aCenter ) const;
|
|
void packageSMD( MODULE* aModule, wxXmlNode* aTree ) const;
|
|
|
|
///> Handles common pad properties
|
|
void transferPad( const EPAD_COMMON& aEaglePad, D_PAD* aPad ) const;
|
|
|
|
///> Deletes the footprint templates list
|
|
void deleteTemplates();
|
|
};
|
|
|
|
#endif // EAGLE_PLUGIN_H_
|