malta_cchip.hh revision 5222:bb733a878f85
1/*
2 * Copyright (c) 2004-2005 The Regents of The University of Michigan
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions are
7 * met: redistributions of source code must retain the above copyright
8 * notice, this list of conditions and the following disclaimer;
9 * redistributions in binary form must reproduce the above copyright
10 * notice, this list of conditions and the following disclaimer in the
11 * documentation and/or other materials provided with the distribution;
12 * neither the name of the copyright holders nor the names of its
13 * contributors may be used to endorse or promote products derived from
14 * this software without specific prior written permission.
15 *
16 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
17 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
18 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
19 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
20 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
21 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
22 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
26 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 *
28 * Authors: Ali Saidi
29 *          Rick Strong
30 */
31
32/** @file
33 * Emulation of the Malta CChip CSRs
34 */
35
36#ifndef __MALTA_CCHIP_HH__
37#define __MALTA_CCHIP_HH__
38
39#include "dev/mips/malta.hh"
40#include "base/range.hh"
41#include "dev/io_device.hh"
42#include "params/MaltaCChip.hh"
43
44/**
45 * Malta CChip CSR Emulation. This device includes all the interrupt
46 * handling code for the chipset.
47 */
48class MaltaCChip : public BasicPioDevice
49{
50  protected:
51    /**
52     * pointer to the malta object.
53     * This is our access to all the other malta
54     * devices.
55     */
56    Malta *malta;
57
58    /**
59     * The dims are device interrupt mask registers.
60     * One exists for each CPU, the DRIR X DIM = DIR
61     */
62    //uint64_t dim[Malta::Max_CPUs];
63
64    /**
65     * The dirs are device interrupt registers.
66     * One exists for each CPU, the DRIR X DIM = DIR
67     */
68    //uint64_t dir[Malta::Max_CPUs];
69
70    /**
71     * This register contains bits for each PCI interrupt
72     * that can occur.
73     */
74    //uint64_t drir;
75
76    /** Indicator of which CPUs have an IPI interrupt */
77    //uint64_t ipint;
78
79    /** Indicator of which CPUs have an RTC interrupt */
80    //uint64_t itint;
81
82  public:
83    typedef MaltaCChipParams Params;
84
85    const Params *
86    params() const
87    {
88        return dynamic_cast<const Params *>(_params);
89    }
90
91    /**
92     * Initialize the Malta CChip by setting all of the
93     * device register to 0.
94     * @param p params struct
95     */
96    MaltaCChip(Params *p);
97
98    virtual Tick read(PacketPtr pkt);
99
100    virtual Tick write(PacketPtr pkt);
101
102    /**
103     * post an RTC interrupt to the CPU
104     */
105    void postRTC();
106
107    /**
108     * post an interrupt to the CPU.
109     * @param interrupt the interrupt number to post (0-7)
110     */
111    void postIntr(uint32_t interrupt);
112
113    /**
114     * clear an interrupt previously posted to the CPU.
115     * @param interrupt the interrupt number to post (0-7)
116     */
117    void clearIntr(uint32_t interrupt);
118
119    /**
120     * post an ipi interrupt  to the CPU.
121     * @param ipintr the cpu number to clear(bitvector)
122     */
123    void clearIPI(uint64_t ipintr);
124
125    /**
126     * clear a timer interrupt previously posted to the CPU.
127     * @param itintr the cpu number to clear(bitvector)
128     */
129    void clearITI(uint64_t itintr);
130
131    /**
132     * request an interrupt be posted to the CPU.
133     * @param ipreq the cpu number to interrupt(bitvector)
134     */
135    void reqIPI(uint64_t ipreq);
136
137
138    /**
139     * Serialize this object to the given output stream.
140     * @param os The stream to serialize to.
141     */
142    virtual void serialize(std::ostream &os);
143
144    /**
145     * Reconstruct the state of this object from a checkpoint.
146     * @param cp The checkpoint use.
147     * @param section The section name of this object
148     */
149    virtual void unserialize(Checkpoint *cp, const std::string &section);
150
151};
152
153#endif // __MALTA_CCHIP_HH__
154