OpenSTA/include/sta/PortDelay.hh

// OpenSTA, Static Timing Analyzer
// Copyright (c) 2020, Parallax Software, Inc.
// 
// 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 3 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, see <https://www.gnu.org/licenses/>.

#pragma once

#include "DisallowCopyAssign.hh"
#include "RiseFallMinMax.hh"
#include "SdcClass.hh"

namespace sta {

class PortDelay;

typedef Vector<PortDelay*> PortDelaySeq;

// set_input_delay arrival, set_output_delay departure
class PortDelay
{
public:
  RiseFallMinMax *delays() { return &delays_; }
  Pin *pin() const { return pin_; }
  PinSet &leafPins() { return leaf_pins_; }
  Clock *clock() const;
  ClockEdge *clkEdge() const { return clk_edge_; }
  bool sourceLatencyIncluded() const;
  void setSourceLatencyIncluded(bool included);
  bool networkLatencyIncluded() const;
  void setNetworkLatencyIncluded(bool included);
  Pin *refPin() const { return ref_pin_; }
  RiseFall *refTransition() const;

protected:
  PortDelay(Pin *pin,
	    ClockEdge *clk_edge,
	    Pin *ref_pin);

  Pin *pin_;
  ClockEdge *clk_edge_;
  bool source_latency_included_;
  bool network_latency_included_;
  Pin *ref_pin_;
  RiseFallMinMax delays_;
  PinSet leaf_pins_;

private:
  DISALLOW_COPY_AND_ASSIGN(PortDelay);
};

class InputDelay : public PortDelay
{
public:
  int index() const { return index_; }

protected:
  InputDelay(Pin *pin,
	     ClockEdge *clk_edge,
	     Pin *ref_pin,
	     int index,
	     Network *network);

private:
  DISALLOW_COPY_AND_ASSIGN(InputDelay);

  int index_;

  friend class Sdc;
};

class OutputDelay : public PortDelay
{
public:

protected:
  OutputDelay(Pin *pin,
	      ClockEdge *clk_edge,
	      Pin *ref_pin,
	      Network *network);

private:
  DISALLOW_COPY_AND_ASSIGN(OutputDelay);

  friend class Sdc;
};

// Prediate used to sort port delays.
class PortDelayLess
{
public:
  explicit PortDelayLess(const Network *network);
  bool operator()(const PortDelay *delay1,
		  const PortDelay *delay2) const;

private:
  const Network *network_;
};

} // namespace