Subversion Repositories openrisc_2011-10-31

// ----------------------------------------------------------------------------
 
// TAP DR-Scan action: definition
 
// Copyright (C) 2009  Embecosm Limited <info@embecosm.com>
 
// Contributor Jeremy Bennett <jeremy.bennett@embecosm.com>
 
// This file is part of the Embecosm cycle accurate SystemC JTAG library.
 
// This program is free software: you can redistribute it and/or modify it
// under the terms of the GNU Lesser 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 Lesser General Public
// License for more details.
 
// You should have received a copy of the GNU Lesser General Public License
// along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
// The C/C++ parts of this program are commented throughout in a fashion
// suitable for processing with Doxygen.
 
// ----------------------------------------------------------------------------
 
// $Id$
 
 
#ifndef TAP_ACTION_DR_SCAN__H
#define TAP_ACTION_DR_SCAN__H
 
#include <stdint.h>
 
#include "TapAction.h"
#include "TapStateMachine.h"
 
 
//! Class to represent a TAP DR-Scan action.
 
//! JTAG data registers can be huge and are represented generically as arrays
//! of uint64_t. However for efficiency versions of methods are provided based
//! on a single uint64_t.
 
//! The SystemC classes for large unsigned ints are fabulously inefficient in
//! the reference implementation, so are not used here.
 
class TapActionDRScan
  : public TapAction
{
public:
 
  // Constructors and destructor
  TapActionDRScan (sc_core::sc_event *_doneEvent,
		   uint64_t           _dRegInArray[],
		   int                _dRegSize);
  TapActionDRScan (sc_core::sc_event *_doneEvent,
		   uint64_t           _dRegIn,
		   int                _dRegSize);
  TapActionDRScan (sc_core::sc_event *_doneEvent,
		   uint64_t           _dRegInArray[],
		   int                _dRegSize,
		   int                _goToPauseState,
		   int                _bitsBeforePauseState);
  TapActionDRScan (sc_core::sc_event *_doneEvent,
		   uint64_t           _dRegIn,
		   int                _dRegSize,
		   int                _goToPauseState,
		   int                _bitsBeforePauseState);
  ~TapActionDRScan ();
 
  // Get the shifted out value
  void      getDRegOut (uint64_t  dRegArray[]);
  uint64_t  getDRegOut ();
 
 
protected:
 
  // Process the action for IR-Scan
  bool  process (TapStateMachine *tapStateMachine,
		 bool            &tdi,
		 bool             tdo,
		 bool            &tms);
 
 
private:
 
  //! Number of bits in the data register
  int  dRegBitSize;
 
  //! Number of uint64_t words in the data register
  int  dRegWordSize;
 
  //! Mask for top word in multi-word register
  uint64_t  topMask;
 
  //! The value being shifted in
  uint64_t *dRegInArray;
 
  //! The value being shifted in (small version optimization)
  uint64_t  dRegIn;
 
  //! The value shifted out
  uint64_t *dRegOutArray;
 
  //! The value being shifted out (small version optimization)
  uint64_t  dRegOut;
 
  //! Should we go to PAUSE state and poll tdo during operation?
  int goToPauseState;
 
  //! Number of bits to shift before going to PAUSE state and polling tdo
  int bitsBeforePause;
 
  int pauseStateCount;
 
  //! Bits shifted so far
  int  bitsShifted;
 
  //! Where we are in the Shift-DR process
  enum {
    SHIFT_DR_PREPARING,
    SHIFT_DR_SHIFTING,
    SHIFT_DR_SHIFTING_BEFORE_PAUSE,
    SHIFT_DR_SHIFTING_PAUSE,
    SHIFT_DR_EXIT2,
    SHIFT_DR_SHIFTING_AFTER_PAUSE,
    SHIFT_DR_UPDATING
  } dRScanState;
 
  // Utilities to shift the bottom bit out and top bit in
  bool  shiftDRegOut ();
  void  shiftDRegIn (bool  bitIn);
 
};	// TapActionDRScan
 
#endif	// TAP_ACTION_DR_SCAN__H