kicad/pcbnew/specctra_import_export/specctra_import.cpp

541 lines
18 KiB
C++
Raw Normal View History

2008-02-06 22:32:15 +00:00
/*
* This program source code file is part of KiCad, a free EDA CAD application.
2008-02-06 22:32:15 +00:00
*
* Copyright (C) 2007-2013 SoftPLC Corporation, Dick Hollenbeck <dick@softplc.com>
* Copyright (C) 2007-2022 KiCad Developers, see AUTHORS.txt for contributors.
2008-02-07 20:23:58 +00:00
*
2008-02-06 22:32:15 +00:00
* 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.
2008-02-07 20:23:58 +00:00
*
2008-02-06 22:32:15 +00:00
* 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.
2008-02-07 20:23:58 +00:00
*
2008-02-06 22:32:15 +00:00
* You should have received a copy of the GNU General Public License
* along with this program; if not, you may find one here:
2008-02-07 20:23:58 +00:00
* 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.,
2008-02-06 22:32:15 +00:00
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
*/
2008-02-07 20:23:58 +00:00
2008-02-06 22:32:15 +00:00
/* This source is a complement to specctra.cpp and implements the import of
2008-02-07 20:23:58 +00:00
a specctra session file (*.ses), and import of a specctra design file
(*.dsn) file. The specification for the grammar of the specctra dsn file
2008-02-06 22:32:15 +00:00
used to develop this code is given here:
2008-09-17 13:32:43 +00:00
http://tech.groups.yahoo.com/group/kicad-users/files/ then file "specctra.pdf"
2008-02-06 22:32:15 +00:00
Also see the comments at the top of the specctra.cpp file itself.
*/
#include <confirm.h> // DisplayError()
#include <gestfich.h> // EDA_FileSelector()
2018-01-29 20:58:58 +00:00
#include <pcb_edit_frame.h>
2020-10-24 01:38:50 +00:00
#include <locale_io.h>
#include <macros.h>
#include <board.h>
#include <board_design_settings.h>
#include <footprint.h>
2021-06-11 21:07:02 +00:00
#include <pcb_track.h>
#include <connectivity/connectivity_data.h>
#include <view/view.h>
#include "specctra.h"
#include <math/util.h> // for KiROUND
#include <pcbnew_settings.h>
2008-02-06 22:32:15 +00:00
using namespace DSN;
bool PCB_EDIT_FRAME::ImportSpecctraSession( const wxString& fullFileName )
{
// To avoid issues with undo/redo lists (dangling pointers) clear the lists
// todo: use undo/redo feature
ClearUndoRedoList();
// Remove existing tracks from view. They will be readded later after loading new tracks.
if( GetCanvas() ) // clear view:
{
for( PCB_TRACK* track : GetBoard()->Tracks() )
GetCanvas()->GetView()->Remove( track );
}
2008-02-07 06:49:16 +00:00
SPECCTRA_DB db;
2012-01-16 21:43:07 +00:00
LOCALE_IO toggle;
2008-02-07 20:23:58 +00:00
try
{
db.LoadSESSION( fullFileName );
db.FromSESSION( GetBoard() );
2008-02-07 06:49:16 +00:00
}
catch( const IO_ERROR& ioe )
2008-02-07 06:49:16 +00:00
{
2019-06-04 20:59:59 +00:00
wxString msg = _( "Board may be corrupted, do not save it.\n Fix problem and try again" );
wxString extra = ioe.What();
2008-02-09 08:34:45 +00:00
DisplayErrorMessage( this, msg, extra);
return false;
2008-02-07 06:49:16 +00:00
}
2008-02-07 17:10:12 +00:00
GetBoard()->GetConnectivity()->ClearRatsnest();
GetBoard()->BuildConnectivity();
OnModify();
if( GetCanvas() ) // Update view:
{
// Update footprint positions
GetCanvas()->GetView()->RecacheAllItems();
// add imported tracks (previous tracks are removed, therefore all are new)
2019-05-31 02:30:28 +00:00
for( auto track : GetBoard()->Tracks() )
GetCanvas()->GetView()->Add( track );
}
2008-02-07 20:23:58 +00:00
SetStatusText( wxString( _( "Session file imported and merged OK." ) ) );
2008-02-07 20:23:58 +00:00
Refresh();
return true;
2008-02-07 06:49:16 +00:00
}
namespace DSN {
2008-02-07 17:10:12 +00:00
/**
* Function scale
* converts a session file distance to KiCad units of deci-mils.
* @param distance The session file length to convert.
* @param aResolution The session UNIT_RES which holds the engineering unit specifier
* @return int - The KiCad length in internal unit
*/
static int scale( double distance, UNIT_RES* aResolution )
2008-02-07 17:10:12 +00:00
{
2008-02-07 20:23:58 +00:00
double resValue = aResolution->GetValue();
2012-04-11 14:49:11 +00:00
double factor;
2008-02-07 20:23:58 +00:00
switch( aResolution->GetEngUnits() )
{
default:
case T_inch: factor = 25.4e6; break; // nanometers per inch
case T_mil: factor = 25.4e3; break; // nanometers per mil
case T_cm: factor = 1e7; break; // nanometers per cm
case T_mm: factor = 1e6; break; // nanometers per mm
case T_um: factor = 1e3; break; // nanometers per um
}
return KiROUND( factor * distance / resValue );
}
2008-02-12 01:02:53 +00:00
/**
* Function mapPt
* translates a point from the Specctra Session format coordinate system
* to the KiCad coordinate system.
2008-02-12 01:02:53 +00:00
* @param aPoint The session point to translate
* @param aResolution - The amount to scale the point.
* @return wxPoint - The KiCad coordinate system point.
2008-02-12 01:02:53 +00:00
*/
static wxPoint mapPt( const POINT& aPoint, UNIT_RES* aResolution )
{
wxPoint ret( scale( aPoint.x, aResolution ),
2008-02-29 06:49:34 +00:00
-scale( aPoint.y, aResolution ) ); // negate y
2008-02-07 20:23:58 +00:00
2008-02-07 17:10:12 +00:00
return ret;
}
2008-02-07 06:49:16 +00:00
2008-02-07 20:23:58 +00:00
PCB_TRACK* SPECCTRA_DB::makeTRACK( WIRE* wire, PATH* aPath, int aPointIndex, int aNetcode )
{
int layerNdx = findLayerName( aPath->layer_id );
if( layerNdx == -1 )
{
2021-06-27 13:24:02 +00:00
THROW_IO_ERROR( wxString::Format( _( "Session file uses invalid layer id '%s'." ),
FROM_UTF8( aPath->layer_id.c_str() ) ) );
}
2021-06-11 21:07:02 +00:00
PCB_TRACK* track = new PCB_TRACK( m_sessionBoard );
track->SetStart( mapPt( aPath->points[aPointIndex+0], m_routeResolution ) );
track->SetEnd( mapPt( aPath->points[aPointIndex+1], m_routeResolution ) );
track->SetLayer( m_pcbLayer2kicad[layerNdx] );
track->SetWidth( scale( aPath->aperture_width, m_routeResolution ) );
track->SetNetCode( aNetcode );
// a track can be locked.
// However specctra as 4 types, none is exactly the same as our locked option
// wire->wire_type = T_fix, T_route, T_normal or T_protect
// fix and protect could be used as lock option
// but protect is returned for all tracks having initially the route or protect property
if( wire->m_wire_type == T_fix )
track->SetLocked( true );
return track;
}
PCB_VIA* SPECCTRA_DB::makeVIA( WIRE_VIA*aVia, PADSTACK* aPadstack, const POINT& aPoint, int aNetCode,
2021-06-11 21:07:02 +00:00
int aViaDrillDefault )
2008-02-09 08:34:45 +00:00
{
PCB_VIA* via = nullptr;
2021-06-11 21:07:02 +00:00
SHAPE* shape;
int shapeCount = aPadstack->Length();
int drill_diam_iu = -1;
int copperLayerCount = m_sessionBoard->GetCopperLayerCount();
2008-02-09 08:34:45 +00:00
// The drill diameter is encoded in the padstack name if Pcbnew did the DSN export.
// It is after the colon and before the last '_'
2023-04-01 13:11:56 +00:00
int drillStartNdx = aPadstack->m_padstack_id.find( ':' );
2008-02-09 08:34:45 +00:00
if( drillStartNdx != -1 )
{
2008-02-12 01:02:53 +00:00
++drillStartNdx; // skip over the ':'
2023-04-01 13:11:56 +00:00
int drillEndNdx = aPadstack->m_padstack_id.rfind( '_' );
2008-02-09 08:34:45 +00:00
if( drillEndNdx != -1 )
{
2023-04-01 13:11:56 +00:00
std::string diam_txt( aPadstack->m_padstack_id,
drillStartNdx, drillEndNdx-drillStartNdx );
2008-02-09 16:33:03 +00:00
double drill_um = strtod( diam_txt.c_str(), 0 );
2022-09-17 00:45:14 +00:00
drill_diam_iu = int( drill_um * ( pcbIUScale.IU_PER_MM / 1000.0 ) );
if( drill_diam_iu == aViaDrillDefault )
drill_diam_iu = UNDEFINED_DRILL_DIAMETER;
2008-02-09 08:34:45 +00:00
}
}
if( shapeCount == 0 )
{
THROW_IO_ERROR( _( "Session via padstack has no shapes" ) );
2008-02-09 08:34:45 +00:00
}
else if( shapeCount == 1 )
{
shape = (SHAPE*) (*aPadstack)[0];
2008-02-12 01:02:53 +00:00
DSN_T type = shape->shape->Type();
2008-02-12 01:02:53 +00:00
if( type != T_circle )
{
THROW_IO_ERROR( wxString::Format( _( "Unsupported via shape: %s." ),
GetTokenString( type ) ) );
}
2008-02-12 01:02:53 +00:00
CIRCLE* circle = (CIRCLE*) shape->shape;
int viaDiam = scale( circle->diameter, m_routeResolution );
2008-02-12 01:02:53 +00:00
2021-06-11 21:07:02 +00:00
via = new PCB_VIA( m_sessionBoard );
via->SetPosition( mapPt( aPoint, m_routeResolution ) );
via->SetDrill( drill_diam_iu );
2019-12-28 00:55:11 +00:00
via->SetViaType( VIATYPE::THROUGH );
via->SetWidth( viaDiam );
via->SetLayerPair( F_Cu, B_Cu );
2008-02-09 08:34:45 +00:00
}
2008-02-12 01:02:53 +00:00
else if( shapeCount == copperLayerCount )
2008-02-09 08:34:45 +00:00
{
shape = (SHAPE*) (*aPadstack)[0];
2008-02-12 01:02:53 +00:00
DSN_T type = shape->shape->Type();
2008-02-12 01:02:53 +00:00
if( type != T_circle )
{
THROW_IO_ERROR( wxString::Format( _( "Unsupported via shape: %s" ),
GetTokenString( type ) ) );
}
2008-02-12 01:02:53 +00:00
CIRCLE* circle = (CIRCLE*) shape->shape;
int viaDiam = scale( circle->diameter, m_routeResolution );
2008-02-12 01:02:53 +00:00
2021-06-11 21:07:02 +00:00
via = new PCB_VIA( m_sessionBoard );
via->SetPosition( mapPt( aPoint, m_routeResolution ) );
via->SetDrill( drill_diam_iu );
2019-12-28 00:55:11 +00:00
via->SetViaType( VIATYPE::THROUGH );
via->SetWidth( viaDiam );
via->SetLayerPair( F_Cu, B_Cu );
2008-02-12 01:02:53 +00:00
}
else // VIA_MICROVIA or VIA_BLIND_BURIED
{
int topLayerNdx = -1; // session layer detectors
int botLayerNdx = INT_MAX;
2008-02-12 01:02:53 +00:00
int viaDiam = -1;
for( int i=0; i<shapeCount; ++i )
2008-02-09 08:34:45 +00:00
{
2008-02-12 01:02:53 +00:00
shape = (SHAPE*) (*aPadstack)[i];
DSN_T type = shape->shape->Type();
2008-02-12 01:02:53 +00:00
if( type != T_circle )
{
THROW_IO_ERROR( wxString::Format( _( "Unsupported via shape: %s" ),
GetTokenString( type ) ) );
}
2008-02-12 01:02:53 +00:00
2008-02-09 08:34:45 +00:00
CIRCLE* circle = (CIRCLE*) shape->shape;
2008-02-12 01:02:53 +00:00
int layerNdx = findLayerName( circle->layer_id );
if( layerNdx == -1 )
2008-02-12 01:02:53 +00:00
{
wxString layerName = FROM_UTF8( circle->layer_id.c_str() );
THROW_IO_ERROR( wxString::Format( _( "Session file uses invalid layer id '%s'" ),
layerName ) );
2008-02-12 01:02:53 +00:00
}
if( layerNdx > topLayerNdx )
topLayerNdx = layerNdx;
if( layerNdx < botLayerNdx )
botLayerNdx = layerNdx;
if( viaDiam == -1 )
viaDiam = scale( circle->diameter, m_routeResolution );
2008-02-09 08:34:45 +00:00
}
2008-02-12 01:02:53 +00:00
2021-06-11 21:07:02 +00:00
via = new PCB_VIA( m_sessionBoard );
via->SetPosition( mapPt( aPoint, m_routeResolution ) );
via->SetDrill( drill_diam_iu );
2008-02-12 01:02:53 +00:00
if( ( topLayerNdx == 0 && botLayerNdx == 1 )
|| ( topLayerNdx == copperLayerCount-2 && botLayerNdx == copperLayerCount-1 ) )
{
2019-12-28 00:55:11 +00:00
via->SetViaType( VIATYPE::MICROVIA );
}
2008-02-12 01:02:53 +00:00
else
{
2019-12-28 00:55:11 +00:00
via->SetViaType( VIATYPE::BLIND_BURIED );
}
2008-02-12 01:02:53 +00:00
via->SetWidth( viaDiam );
via->SetLayerPair( m_pcbLayer2kicad[ topLayerNdx ], m_pcbLayer2kicad[ botLayerNdx ] );
2008-02-09 08:34:45 +00:00
}
wxASSERT( via );
2008-02-09 08:34:45 +00:00
via->SetNetCode( aNetCode );
// a via can be locked.
// However specctra as 4 types, none is exactly the same as our locked option
// aVia->via_type = T_fix, T_route, T_normal or T_protect
// fix and protect could be used as lock option
// but protect is returned for all tracks having initially the route or protect property
if( aVia->m_via_type == T_fix )
via->SetLocked( true );
2008-02-09 08:34:45 +00:00
return via;
}
2008-02-07 20:23:58 +00:00
// no UI code in this function, throw exception to report problems to the
// UI handler: void PCB_EDIT_FRAME::ImportSpecctraSession( wxCommandEvent& event )
2008-02-07 06:49:16 +00:00
void SPECCTRA_DB::FromSESSION( BOARD* aBoard )
2008-02-07 06:49:16 +00:00
{
m_sessionBoard = aBoard; // not owned here
2008-02-07 06:49:16 +00:00
if( !m_session )
THROW_IO_ERROR( _("Session file is missing the \"session\" section") );
2008-02-07 20:23:58 +00:00
if( !m_session->route )
THROW_IO_ERROR( _("Session file is missing the \"routes\" section") );
2008-02-07 06:49:16 +00:00
if( !m_session->route->library )
THROW_IO_ERROR( _("Session file is missing the \"library_out\" section") );
2008-02-07 20:23:58 +00:00
// delete the old tracks and vias but save locked tracks/vias; they will be re-added later
std::vector<PCB_TRACK*> locked;
while( !aBoard->Tracks().empty() )
{
PCB_TRACK* track = aBoard->Tracks().back();
aBoard->Tracks().pop_back();
if( track->IsLocked() )
locked.push_back( track );
else
delete track;
}
2008-02-07 17:10:12 +00:00
2008-02-07 20:23:58 +00:00
aBoard->DeleteMARKERs();
2008-02-07 17:10:12 +00:00
buildLayerMaps( aBoard );
// Add locked tracks: because they are exported as Fix tracks, they are not
// in .ses file.
for( PCB_TRACK* track: locked )
aBoard->Add( track );
if( m_session->placement )
2008-02-07 06:49:16 +00:00
{
2012-01-16 21:43:07 +00:00
// Walk the PLACEMENT object's COMPONENTs list, and for each PLACE within
// each COMPONENT, reposition and re-orient each component and put on
// correct side of the board.
COMPONENTS& components = m_session->placement->m_components;
2012-01-16 21:43:07 +00:00
for( COMPONENTS::iterator comp=components.begin(); comp!=components.end(); ++comp )
2008-02-07 17:10:12 +00:00
{
PLACES& places = comp->m_places;
2012-01-16 21:43:07 +00:00
for( unsigned i=0; i<places.size(); ++i )
2008-02-07 17:10:12 +00:00
{
2012-01-16 21:43:07 +00:00
PLACE* place = &places[i]; // '&' even though places[] holds a pointer!
2008-02-07 20:23:58 +00:00
wxString reference = FROM_UTF8( place->m_component_id.c_str() );
2020-11-13 15:15:52 +00:00
FOOTPRINT* footprint = aBoard->FindFootprintByReference( reference );
2020-02-20 12:11:04 +00:00
2020-11-13 15:15:52 +00:00
if( !footprint )
2012-01-16 21:43:07 +00:00
{
2020-02-20 12:11:04 +00:00
THROW_IO_ERROR( wxString::Format( _( "Reference '%s' not found." ),
reference ) );
2012-01-16 21:43:07 +00:00
}
2008-02-07 20:23:58 +00:00
if( !place->m_hasVertex )
2012-01-16 21:43:07 +00:00
continue;
2008-02-07 20:23:58 +00:00
2012-01-16 21:43:07 +00:00
UNIT_RES* resolution = place->GetUnits();
wxASSERT( resolution );
2008-02-07 20:23:58 +00:00
wxPoint newPos = mapPt( place->m_vertex, resolution );
2020-11-13 15:15:52 +00:00
footprint->SetPosition( newPos );
2012-01-16 21:43:07 +00:00
if( place->m_side == T_front )
2008-02-07 20:23:58 +00:00
{
2012-01-16 21:43:07 +00:00
// convert from degrees to tenths of degrees used in KiCad.
EDA_ANGLE orientation( place->m_rotation, DEGREES_T );
2020-11-13 15:15:52 +00:00
if( footprint->GetLayer() != F_Cu )
2012-01-16 21:43:07 +00:00
{
// footprint is on copper layer (back)
2020-11-13 15:15:52 +00:00
footprint->Flip( footprint->GetPosition(), false );
2012-01-16 21:43:07 +00:00
}
2020-11-13 15:15:52 +00:00
footprint->SetOrientation( orientation );
2008-02-07 20:23:58 +00:00
}
else if( place->m_side == T_back )
2008-02-07 20:23:58 +00:00
{
EDA_ANGLE orientation( place->m_rotation + 180.0, DEGREES_T );
2020-11-13 15:15:52 +00:00
if( footprint->GetLayer() != B_Cu )
2012-01-16 21:43:07 +00:00
{
// footprint is on component layer (front)
2020-11-13 15:15:52 +00:00
footprint->Flip( footprint->GetPosition(), false );
2012-01-16 21:43:07 +00:00
}
2020-11-13 15:15:52 +00:00
footprint->SetOrientation( orientation );
2012-01-16 21:43:07 +00:00
}
else
{
// as I write this, the PARSER *is* catching this, so we should never see below:
wxFAIL_MSG( wxT("DSN::PARSER did not catch an illegal side := 'back|front'") );
}
2008-02-07 17:10:12 +00:00
}
}
2008-02-07 06:49:16 +00:00
}
m_routeResolution = m_session->route->GetUnits();
2008-02-07 20:23:58 +00:00
// Walk the NET_OUTs and create tracks and vias anew.
NET_OUTS& net_outs = m_session->route->net_outs;
for( NET_OUTS::iterator net = net_outs.begin(); net!=net_outs.end(); ++net )
2008-02-07 06:49:16 +00:00
{
int netoutCode = 0;
2008-02-07 20:23:58 +00:00
2008-02-09 08:34:45 +00:00
// page 143 of spec says wire's net_id is optional
if( net->net_id.size() )
{
wxString netName = FROM_UTF8( net->net_id.c_str() );
NETINFO_ITEM* netinfo = aBoard->FindNet( netName );
2008-02-09 08:34:45 +00:00
if( netinfo )
2020-12-08 13:02:08 +00:00
netoutCode = netinfo->GetNetCode();
}
WIRES& wires = net->wires;
for( unsigned i = 0; i<wires.size(); ++i )
{
WIRE* wire = &wires[i];
DSN_T shape = wire->m_shape->Type();
if( shape != T_path )
{
/*
* shape == T_polygon is expected from freerouter if you have a zone on a non-
* "power" type layer, i.e. a T_signal layer and the design does a round-trip
* back in as session here. We kept our own zones in the BOARD, so ignore this
* so called 'wire'.
2008-02-29 06:49:34 +00:00
wxString netId = FROM_UTF8( wire->net_id.c_str() );
THROW_IO_ERROR( wxString::Format( _( "Unsupported wire shape: '%s' for net: '%s'" ),
DLEX::GetTokenString(shape).GetData(),
netId.GetData() ) );
2008-02-29 06:49:34 +00:00
*/
}
2008-02-29 06:49:34 +00:00
else
{
PATH* path = (PATH*) wire->m_shape;
2021-06-11 21:07:02 +00:00
for( unsigned pt=0; pt < path->points.size()-1; ++pt )
2008-02-29 06:49:34 +00:00
{
PCB_TRACK* track = makeTRACK( wire, path, pt, netoutCode );
2008-02-29 06:49:34 +00:00
aBoard->Add( track );
}
}
}
WIRE_VIAS& wire_vias = net->wire_vias;
LIBRARY& library = *m_session->route->library;
for( unsigned i=0; i<wire_vias.size(); ++i )
{
2008-02-09 08:34:45 +00:00
int netCode = 0;
// page 144 of spec says wire_via's net_id is optional
if( net->net_id.size() )
{
wxString netName = FROM_UTF8( net->net_id.c_str() );
NETINFO_ITEM* netvia = aBoard->FindNet( netName );
2008-02-09 08:34:45 +00:00
if( netvia )
2020-12-08 13:02:08 +00:00
netCode = netvia->GetNetCode();
2008-02-09 08:34:45 +00:00
}
WIRE_VIA* wire_via = &wire_vias[i];
// example: (via Via_15:8_mil 149000 -71000 )
PADSTACK* padstack = library.FindPADSTACK( wire_via->GetPadstackId() );
if( !padstack )
{
// Dick Feb 29, 2008:
// Freerouter has a bug where it will not round trip all vias. Vias which have
// a (use_via) element will be round tripped. Vias which do not, don't come back
// in in the session library, even though they may be actually used in the
// pre-routed, protected wire_vias. So until that is fixed, create the padstack
// from its name as a work around.
wxString psid( FROM_UTF8( wire_via->GetPadstackId().c_str() ) );
2008-02-09 08:34:45 +00:00
THROW_IO_ERROR( wxString::Format( _( "A wire_via refers to missing padstack '%s'." ),
psid ) );
2008-02-09 08:34:45 +00:00
}
std::shared_ptr<NET_SETTINGS>& netSettings = aBoard->GetDesignSettings().m_NetSettings;
int via_drill_default = netSettings->m_DefaultNetClass->GetViaDrill();
for( unsigned v = 0; v < wire_via->m_vertexes.size(); ++v )
2008-02-09 08:34:45 +00:00
{
PCB_VIA* via = makeVIA( wire_via, padstack, wire_via->m_vertexes[v], netCode,
2021-06-11 21:07:02 +00:00
via_drill_default );
2008-02-12 01:02:53 +00:00
aBoard->Add( via );
2008-02-09 08:34:45 +00:00
}
}
2008-02-07 06:49:16 +00:00
}
2008-02-06 22:32:15 +00:00
}
2008-02-07 06:49:16 +00:00
} // namespace DSN