length_delay_calculation.h

Go to the documentation of this file.

/*
 * This program source code file is part of KiCad, a free EDA CAD application.
 *
 * Copyright The 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
 */
 
#ifndef PCBNEW_LENGTH_DELAY_CALCULATION_H
#define PCBNEW_LENGTH_DELAY_CALCULATION_H
 
#include "time_domain_parameters_iface.h"
#include "time_domain_parameters_user_defined.h"
 
#include <board_design_settings.h>
#include <connectivity/connectivity_data.h>
#include <length_delay_calculation/length_delay_calculation_item.h>
#include <unordered_set>
 
class BOARD;

struct LENGTH_DELAY_STATS
{
    // Generic statistics
    int NumPads{ 0 };
    int NumVias{ 0 };
 
    // Space domain statistics
    int                                              ViaLength{ 0 };
    int64_t                                          TrackLength{ 0 };
    int                                              PadToDieLength{ 0 };
    std::unique_ptr<std::map<PCB_LAYER_ID, int64_t>> LayerLengths;

    int64_t TotalLength() const { return ViaLength + TrackLength + PadToDieLength; }
 
    // Time domain statistics
    int64_t                                          ViaDelay{ 0 };
    int64_t                                          TrackDelay{ 0 };
    int64_t                                          PadToDieDelay{ 0 };
    std::unique_ptr<std::map<PCB_LAYER_ID, int64_t>> LayerDelays;

    int64_t TotalDelay() const { return ViaDelay + TrackDelay + PadToDieDelay; }
};
 

struct PATH_OPTIMISATIONS
{
    bool OptimiseViaLayers = false;

    bool MergeTracks = false;

    bool OptimiseTracesInPads = false;

    bool InferViaInPad = false;
};
 

enum class LENGTH_DELAY_LAYER_OPT
{
    NO_LAYER_DETAIL,
    WITH_LAYER_DETAIL
};
 

enum class LENGTH_DELAY_DOMAIN_OPT
{
    NO_DELAY_DETAIL,
    WITH_DELAY_DETAIL
};
 

class LENGTH_DELAY_CALCULATION
{
public:
    explicit LENGTH_DELAY_CALCULATION( BOARD* aBoard ) :
            m_board( aBoard ),
            m_timeDomainParameters( std::make_unique<TIME_DOMAIN_PARAMETERS_USER_DEFINED>( aBoard, this ) )
    {
    }

    int64_t CalculateLength( std::vector<LENGTH_DELAY_CALCULATION_ITEM>& aItems, PATH_OPTIMISATIONS aOptimisations,
                             const PAD* aStartPad = nullptr, const PAD* aEndPad = nullptr ) const;

    int64_t CalculateDelay( std::vector<LENGTH_DELAY_CALCULATION_ITEM>& aItems, PATH_OPTIMISATIONS aOptimisations,
                            const PAD* aStartPad = nullptr, const PAD* aEndPad = nullptr ) const;

    LENGTH_DELAY_STATS
    CalculateLengthDetails( std::vector<LENGTH_DELAY_CALCULATION_ITEM>& aItems, PATH_OPTIMISATIONS aOptimisations,
                            const PAD* aStartPad = nullptr, const PAD* aEndPad = nullptr,
                            LENGTH_DELAY_LAYER_OPT  aLayerOpt = LENGTH_DELAY_LAYER_OPT::NO_LAYER_DETAIL,
                            LENGTH_DELAY_DOMAIN_OPT aDomain = LENGTH_DELAY_DOMAIN_OPT::NO_DELAY_DETAIL ) const;

    int64_t CalculatePropagationDelayForShapeLineChain( const SHAPE_LINE_CHAIN&             aShape,
                                                        const TIME_DOMAIN_GEOMETRY_CONTEXT& aCtx ) const;

    int64_t CalculateLengthForDelay( int64_t aDesiredDelay, const TIME_DOMAIN_GEOMETRY_CONTEXT& aCtx ) const;

    static void OptimiseTraceInPad( SHAPE_LINE_CHAIN& aLine, const PAD* aPad, PCB_LAYER_ID aPcbLayer );

    LENGTH_DELAY_CALCULATION_ITEM GetLengthCalculationItem( const BOARD_CONNECTED_ITEM* aBoardItem ) const;

    void SetTimeDomainParametersProvider( std::unique_ptr<TIME_DOMAIN_PARAMETERS_IFACE>&& aProvider );

    void SynchronizeTimeDomainProperties() const;

    int StackupHeight( PCB_LAYER_ID aFirstLayer, PCB_LAYER_ID aSecondLayer ) const;
 
protected:
    BOARD* m_board;

    std::unique_ptr<TIME_DOMAIN_PARAMETERS_IFACE> m_timeDomainParameters;

    enum class MERGE_POINT
    {
        START,
        END
    };

    static void optimiseTracesInPads( const std::vector<LENGTH_DELAY_CALCULATION_ITEM*>& aPads,
                                      const std::vector<LENGTH_DELAY_CALCULATION_ITEM*>& aLines );

    static void clipLineToPad( SHAPE_LINE_CHAIN& aLine, const PAD* aPad, PCB_LAYER_ID aLayer, bool aForward = true );

    static void
    optimiseViaLayers( const std::vector<LENGTH_DELAY_CALCULATION_ITEM*>&                            aVias,
                       std::vector<LENGTH_DELAY_CALCULATION_ITEM*>&                                  aLines,
                       std::map<VECTOR2I, std::unordered_set<LENGTH_DELAY_CALCULATION_ITEM*>>&       aLinesPositionMap,
                       const std::map<VECTOR2I, std::unordered_set<LENGTH_DELAY_CALCULATION_ITEM*>>& aPadsPositionMap );

    static void mergeLines( std::vector<LENGTH_DELAY_CALCULATION_ITEM*>&                            aLines,
                            std::map<VECTOR2I, std::unordered_set<LENGTH_DELAY_CALCULATION_ITEM*>>& aLinesPositionMap );

    static void mergeShapeLineChains( SHAPE_LINE_CHAIN& aPrimary, const SHAPE_LINE_CHAIN& aSecondary,
                                      MERGE_POINT aMergePoint );

    void inferViaInPad( const PAD* aPad, const LENGTH_DELAY_CALCULATION_ITEM& aItem,
                        LENGTH_DELAY_STATS& aDetails ) const;
};
 
#endif //PCBNEW_LENGTH_DELAY_CALCULATION_H