summaryrefslogtreecommitdiff
path: root/src/mem/ruby/storebuffer/storebuffer.hh
blob: 67555f48ff87ea200cf40abff9864f1d707804fe (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
/*
 * Copyright (c) 1999-2008 Mark D. Hill and David A. Wood
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are
 * met: redistributions of source code must retain the above copyright
 * notice, this list of conditions and the following disclaimer;
 * redistributions in binary form must reproduce the above copyright
 * notice, this list of conditions and the following disclaimer in the
 * documentation and/or other materials provided with the distribution;
 * neither the name of the copyright holders nor the names of its
 * contributors may be used to endorse or promote products derived from
 * this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

#ifndef _STOREBUFFER_H_
#define _STOREBUFFER_H_

#include <map>
#include <deque>

#include "config/ruby_tso_checker.hh"
#include "mem/ruby/storebuffer/hfa.hh"
#include "mem/ruby/libruby.hh"

#if RUBY_TSO_CHECKER
#include "TsoCheckerCmd.hh"
#endif

/**
 *  Status for write buffer accesses. The Write buffer can hit in fastpath, be full, or
 *     successfully enqueue the store request
 */
enum storebuffer_status_t { WB_FULL, WB_OK, WB_FLUSHING };

/**
 *  Status of a load match
 */
enum load_match { NO_MATCH, PARTIAL_MATCH, FULL_MATCH };

struct SBEntry {
  struct RubyRequest m_request;
#if RUBY_TSO_CHECKER
  Tso::TsoCheckerCmd * m_next_ptr;
#endif
  SBEntry(struct RubyRequest request, void * ptr)
      : m_request(request)
    {
#if RUBY_TSO_CHECKER
        m_next_ptr = (Tso::TsoCheckerCmd*) ptr;
#endif
    }
};

class StoreBuffer {
 public:
  ///Constructor
  /// Note that the size of the Write Buffer is determined by the WRITE_BUFFER_SIZE config parameter
  StoreBuffer(uint32 id, uint32 block_bits, int storebuffer_size);

  /// Register hitcallback back to CPU
  void registerHitCallback(void (*hit_callback)(int64_t request_id));

  /// Destructor
  ~StoreBuffer();

  ///Adds a store entry to the write buffer
  void addToStoreBuffer(struct RubyRequest request);

  ///Flushes the entire write buffer
  void flushStoreBuffer();

  ///A pseq object calls this when Ruby completes our request
  void complete(uint64_t);

  /// Returns ID. If ID == -2, HIT, else it's an ID to wait on
  int64_t handleLoad(struct RubyRequest request);

  /// Used by all load insts to check whether it hits to any entry in the WB. If so, the WB is flushed
  load_match checkForLoadHit(struct RubyRequest request);

  /// Used to fill the load in case of FULL_MATCH
  void returnMatchedData(struct RubyRequest request);

  /// Issue next store in line
  void issueNextStore();

  /// prints out the contents of the Write Buffer
  void print();

#if RUBY_TSO_CHECKER
  /// if load completes before store, insert correctly to be issued to TSOChecker
  void insertTsoLL(Tso::TsoCheckerCmd * cmd);
#endif

  /// Returns flag indicating whether we are using the write buffer
  bool useStoreBuffer() { return m_use_storebuffer; }

  bool storeBufferFull() { return m_storebuffer_full; }

  bool storeBufferFlushing() { return m_storebuffer_flushing; }

 private:
  /// id of this write buffer (one per sequencer object)
  uint32          m_id;

  /// number of bytes in cacheline
  uint32          m_block_size;

  /// the size of the write buffer
  uint32          m_storebuffer_size;

  /// mask to strip off non-cache line bits
  pa_t            m_block_mask;

  /// list of store requests in the write buffer
  deque <struct SBEntry> buffer;

  /// the current length of the write buffer
  uint32          m_buffer_size;

  /// whether we want to simulate the write buffer or not:
  bool            m_use_storebuffer;

  /// indicates whether the write buffer is full or not
  bool            m_storebuffer_full;

  /// indicates that we are currently flushing the write buffer
  bool            m_storebuffer_flushing;

  /// indicates that automatic issue is stalled and the next store to be added should issue itself
  bool            m_stalled_issue;

  /// RubyPort to make requests to
  RubyPortHandle  m_port;

  /// HitCallback to CPU
  void            (*m_hit_callback)(int64_t);

  /// Map the request id to rubyrequest
  map<uint64_t, struct RubyRequest> outstanding_requests;

  /// current instruction counter
  uint64_t iseq;


  /// input into tso counter
  uint64_t tso_iseq;
};

#endif