335 lines
10 KiB
C++
335 lines
10 KiB
C++
/************************/
|
|
/* file class_equipot.h */
|
|
/************************/
|
|
|
|
/*
|
|
* Classes to handle info on nets
|
|
*/
|
|
|
|
#ifndef __CLASSES_NETINFO__
|
|
#define __CLASSES_NETINFO__
|
|
|
|
#include "class_netclass.h"
|
|
|
|
// Forward declaration:
|
|
class NETINFO_ITEM;
|
|
|
|
|
|
/* Class RATSNEST_ITEM: describes a ratsnest line: a straight line connecting 2 pads */
|
|
/*****************************/
|
|
/* flags for a RATSNEST_ITEM */
|
|
/*****************************/
|
|
#define CH_VISIBLE 1 /* affichage permanent demande */
|
|
#define CH_UNROUTABLE 2 /* non route par l'autorouteur */
|
|
#define CH_ROUTE_REQ 4 /* doit etre route par l'autorouteur */
|
|
#define CH_ACTIF 8 /* chevelu non encore routé */
|
|
#define LOCAL_RATSNEST_ITEM 0x8000 /* indique un chevelu reliant 2 pins d'un meme
|
|
* module pour le calcul des chevelus relatifs a 1 seul module */
|
|
|
|
class RATSNEST_ITEM
|
|
{
|
|
private:
|
|
int m_NetCode; // netcode ( = 1.. n , 0 is the value used for not connected items)
|
|
|
|
public:
|
|
int m_Status; // State: see previous defines (CH_ ...)
|
|
D_PAD* m_PadStart; // pointer to the starting pad
|
|
D_PAD* m_PadEnd; // pointer to ending pad
|
|
int m_Lenght; // lenght of the line (temporary used in some calculations)
|
|
|
|
/* constructor */
|
|
RATSNEST_ITEM();
|
|
|
|
/**
|
|
* Function GetNet
|
|
* @return int - the net code.
|
|
*/
|
|
int GetNet() const
|
|
{
|
|
return m_NetCode;
|
|
}
|
|
|
|
|
|
void SetNet( int aNetCode )
|
|
{
|
|
m_NetCode = aNetCode;
|
|
}
|
|
|
|
|
|
/** function Draw
|
|
*/
|
|
void Draw( WinEDA_DrawPanel* panel, wxDC* DC, int aDrawMode, const wxPoint& offset );
|
|
};
|
|
|
|
/***************************************************************/
|
|
/******************* class NETINFO *****************************/
|
|
/***************************************************************/
|
|
|
|
|
|
class NETINFO_LIST
|
|
{
|
|
private:
|
|
BOARD* m_Parent;
|
|
std::vector<NETINFO_ITEM*> m_NetBuffer; // nets buffer list (name, design constraints ..
|
|
|
|
public:
|
|
std::vector<D_PAD*> m_PadsFullList; // Entry for a sorted pad list (used in ratsnest calculations)
|
|
|
|
public:
|
|
NETINFO_LIST( BOARD* aParent );
|
|
~NETINFO_LIST();
|
|
|
|
/** Function GetItem
|
|
* @param aNetcode = netcode to identify a given NETINFO_ITEM
|
|
* @return a NETINFO_ITEM pointer to the selected NETINFO_ITEM by its netcode, or NULL if not found
|
|
*/
|
|
NETINFO_ITEM* GetNetItem( int aNetcode );
|
|
|
|
/** Function GetCount()
|
|
* @return the number of nets ( always >= 1 )
|
|
* becuse the first net is the "not connected" net and always exists
|
|
*/
|
|
unsigned GetNetsCount() { return m_NetBuffer.size(); }
|
|
|
|
/**
|
|
* Function Append
|
|
* adds \a aNewElement to the end of the list.
|
|
*/
|
|
void AppendNet( NETINFO_ITEM* aNewElement );
|
|
|
|
/** Function DeleteData
|
|
* delete the list of nets (and free memory)
|
|
*/
|
|
void DeleteData();
|
|
|
|
/** Function BuildListOfNets
|
|
* Build or rebuild the list of NETINFO_ITEM m_NetBuffer
|
|
* The list is sorted by names.
|
|
*/
|
|
void BuildListOfNets();
|
|
|
|
/** Function GetPadsCount
|
|
* @return the number of pads in board
|
|
*/
|
|
unsigned GetPadsCount()
|
|
{
|
|
return m_PadsFullList.size();
|
|
}
|
|
|
|
|
|
/** Function GetPad
|
|
* @return the pad idx from m_PadsFullList
|
|
*/
|
|
D_PAD* GetPad( unsigned aIdx )
|
|
{
|
|
if( aIdx < m_PadsFullList.size() )
|
|
return m_PadsFullList[aIdx];
|
|
else
|
|
return NULL;
|
|
}
|
|
|
|
|
|
private:
|
|
|
|
/** Function Build_Pads_Full_List
|
|
* Create the pad list
|
|
* initialise:
|
|
* m_Pads (list of pads)
|
|
* set m_Status_Pcb = LISTE_PAD_OK;
|
|
* and clear for all pads in list the m_SubRatsnest member;
|
|
* clear m_Pcb->m_FullRatsnest
|
|
*/
|
|
void Build_Pads_Full_List();
|
|
};
|
|
|
|
/** class NETINFO_ITEM
|
|
* @info This class handle the data relative to a given net
|
|
*/
|
|
|
|
class NETINFO_ITEM
|
|
{
|
|
private:
|
|
int m_NetCode; // this is a number equivalent to the net name
|
|
// Used for fast comparisons in rastnest and DRC computations.
|
|
wxString m_Netname; // Full net name like /mysheet/mysubsheet/vout used by eeschema
|
|
wxString m_ShortNetname; // short net name, like vout from /mysheet/mysubsheet/vout
|
|
wxString m_NetClassName; /* Net Class name. if void this is equivalent to "default" (the first
|
|
* item of the net classes list
|
|
*/
|
|
NET_DESIGN_PARAMS m_NetParams; // values of net classes parameters
|
|
|
|
|
|
public:
|
|
int m_NbNodes; // Pads count for this net
|
|
int m_NbLink; // Ratsnets count for this net
|
|
int m_NbNoconn; // Ratsnets remaining to route count
|
|
int m_Flag; // used in some calculations. Had no special meaning
|
|
std::vector <D_PAD*> m_ListPad; // List of pads connected to this net
|
|
unsigned m_RatsnestStartIdx; /* Starting point of ratsnests of this net (included)
|
|
* in a general buffer of ratsnest (a vector<RATSNEST_ITEM*> buffer)
|
|
*/
|
|
unsigned m_RatsnestEndIdx; // Ending point of ratsnests of this net (excluded) in this buffer
|
|
|
|
NETINFO_ITEM( BOARD_ITEM* aParent );
|
|
~NETINFO_ITEM();
|
|
|
|
|
|
/** Functions SetClassParameters
|
|
* copy the class parameters in the locale buffer m_NetParams
|
|
*/
|
|
void SetClassParameters(const NET_DESIGN_PARAMS& aParams )
|
|
{
|
|
m_NetParams = aParams;
|
|
}
|
|
|
|
/** Functions SetClass
|
|
* copy the class Name and class parmeters
|
|
*/
|
|
void SetClass(const NETCLASS& aNetclass )
|
|
{
|
|
m_NetParams = aNetclass.m_NetParams;
|
|
m_NetClassName = aNetclass.m_Name;
|
|
}
|
|
|
|
/** Functions GetClassName
|
|
* @return the class Name
|
|
*/
|
|
wxString GetClassName( ) const
|
|
{
|
|
return m_NetClassName;
|
|
}
|
|
|
|
/** function GetTracksWidth()
|
|
* @return the "default" value for tracks thickness used to route this net
|
|
*/
|
|
int GetTracksWidth()
|
|
{
|
|
return m_NetParams.m_TracksWidth;
|
|
}
|
|
|
|
|
|
/** Function GetTracksMinWidth()
|
|
* @return the Minimum value for tracks thickness (used in DRC)
|
|
*/
|
|
int GetTracksMinWidth()
|
|
{
|
|
return m_NetParams.m_TracksMinWidth = 150;
|
|
}
|
|
|
|
|
|
/** Function
|
|
* @return the "Default" value for vias sizes used to route this net
|
|
*/
|
|
int GetViasSize()
|
|
{
|
|
return m_NetParams.m_ViasSize;
|
|
}
|
|
|
|
|
|
/** Function GetViasMinSize()
|
|
* @return the Minimum value for vias sizes (used in DRC)
|
|
*/
|
|
int GetViasMinSize()
|
|
{
|
|
return m_NetParams.m_ViasMinSize;
|
|
}
|
|
|
|
|
|
/** Function GetClearance()
|
|
* @return the "Default" clearance when routing
|
|
*/
|
|
int GetClearance()
|
|
{
|
|
return m_NetParams.m_Clearance;
|
|
}
|
|
|
|
|
|
/** Function GetMinClearance()
|
|
* @return the Minimum value for clearance (used in DRC)
|
|
*/
|
|
int GetMinClearance()
|
|
{
|
|
return m_NetParams.m_MinClearance;
|
|
}
|
|
|
|
|
|
/* Reading and writing data on files */
|
|
int ReadDescr( FILE* File, int* LineNum );
|
|
|
|
/**
|
|
* Function Save
|
|
* writes the data structures for this object out to a FILE in "*.brd" format.
|
|
* @param aFile The FILE to write to.
|
|
* @return bool - true if success writing else false.
|
|
*/
|
|
bool Save( FILE* aFile ) const;
|
|
|
|
|
|
/** function Draw
|
|
* @todo we actually could show a NET, simply show all the tracks and pads or net name on pad and vias
|
|
*/
|
|
void Draw( WinEDA_DrawPanel* panel, wxDC* DC, int aDrawMode, const wxPoint& offset );
|
|
|
|
|
|
/**
|
|
* Function GetNet
|
|
* @return int - the netcode
|
|
*/
|
|
int GetNet() const { return m_NetCode; }
|
|
void SetNet( int aNetCode ) { m_NetCode = aNetCode; }
|
|
|
|
int GetNodesCount() const { return m_ListPad.size(); }
|
|
|
|
/**
|
|
* Function GetNetname
|
|
* @return const wxString * , a pointer to the full netname
|
|
*/
|
|
wxString GetNetname() const { return m_Netname; }
|
|
|
|
/**
|
|
* Function GetShortNetname
|
|
* @return const wxString * , a pointer to the short netname
|
|
*/
|
|
wxString GetShortNetname() const { return m_ShortNetname; }
|
|
|
|
/**
|
|
* Function SetNetname
|
|
* @param const wxString : the new netname
|
|
*/
|
|
void SetNetname( const wxString& aNetname );
|
|
|
|
|
|
/**
|
|
* Function DisplayInfo
|
|
* has knowledge about the frame and how and where to put status information
|
|
* about this object into the frame's message panel.
|
|
* Is virtual from EDA_BaseStruct.
|
|
* @param frame A WinEDA_DrawFrame in which to print status information.
|
|
*/
|
|
void DisplayInfo( WinEDA_DrawFrame* frame );
|
|
};
|
|
|
|
|
|
/****************************************************************/
|
|
/* description d'un point de piste pour le suivi des connexions */
|
|
/****************************************************************/
|
|
#define START_ON_PAD 0x10
|
|
#define END_ON_PAD 0x20
|
|
#define START_ON_TRACK 0x40
|
|
#define END_ON_TRACK 0x80
|
|
|
|
|
|
/* Status bit (OR'ed bits) for class BOARD member .m_Status_Pcb */
|
|
enum StatusPcbFlags {
|
|
LISTE_PAD_OK = 1, /* Pad list is Ok */
|
|
LISTE_RATSNEST_ITEM_OK = 2, /* General Rastnest is Ok */
|
|
RATSNEST_ITEM_LOCAL_OK = 4, /* current MODULE rastnest is Ok */
|
|
CONNEXION_OK = 8, /* Bit indicant que la liste des connexions existe */
|
|
NET_CODES_OK = 0x10, /* Bit indicant que les netcodes sont OK ( pas de modif
|
|
* de noms de net */
|
|
DO_NOT_SHOW_GENERAL_RASTNEST = 0x20 /* Do not display the general rastnest (used in module moves) */
|
|
};
|
|
|
|
|
|
#endif // __CLASSES_NETINFO__
|