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