2 * Copyright (c) 2010, 2012-2013, 2015-2021 ARM Limited
5 * The license below extends only to copyright in the software and shall
6 * not be construed as granting a license to any other intellectual
7 * property including but not limited to intellectual property relating
8 * to a hardware implementation of the functionality of the software
9 * licensed hereunder. You may use the software subject to the license
10 * terms below provided that you ensure that this notice is replicated
11 * unmodified and in its entirety in all distributions of the software,
12 * modified or unmodified, in source code or in binary form.
14 * Copyright (c) 2002-2005 The Regents of The University of Michigan
15 * All rights reserved.
17 * Redistribution and use in source and binary forms, with or without
18 * modification, are permitted provided that the following conditions are
19 * met: redistributions of source code must retain the above copyright
20 * notice, this list of conditions and the following disclaimer;
21 * redistributions in binary form must reproduce the above copyright
22 * notice, this list of conditions and the following disclaimer in the
23 * documentation and/or other materials provided with the distribution;
24 * neither the name of the copyright holders nor the names of its
25 * contributors may be used to endorse or promote products derived from
26 * this software without specific prior written permission.
28 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
29 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
30 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
31 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
32 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
33 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
34 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
35 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
36 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
37 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
38 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
41 #ifndef __ARCH_ARM_SYSTEM_HH__
42 #define __ARCH_ARM_SYSTEM_HH__
48 #include "kern/linux/events.hh"
49 #include "params/ArmSystem.hh"
50 #include "sim/full_system.hh"
51 #include "sim/sim_object.hh"
52 #include "sim/system.hh"
59 class ArmSystem : public System
63 * True if this system implements the Security Extensions
65 const bool _haveSecurity;
68 * True if this system implements the Large Physical Address Extension
73 * True if this system implements the virtualization Extensions
75 const bool _haveVirtualization;
78 * True if this system implements the Crypto Extension
80 const bool _haveCrypto;
83 * Pointer to the Generic Timer wrapper.
85 GenericTimer *_genericTimer;
89 * Pointer to the Power Controller (if any)
91 FVPBasePwrCtrl *_pwrCtrl;
94 * Reset address (ARMv8)
99 * True if the register width of the highest implemented exception level is
105 * Supported physical address range in bits if the highest implemented
106 * exception level is 64 bits (ARMv8)
108 const uint8_t _physAddrRange64;
111 * True if ASID is 16 bits in AArch64 (ARMv8)
113 const bool _haveLargeAsid64;
116 * True if system implements the transactional memory extension (TME)
121 * True if SVE is implemented (ARMv8)
125 /** SVE vector length at reset, in quadwords */
126 const unsigned _sveVL;
129 * True if LSE is implemented (ARMv8.1)
133 /** True if FEAT_VHE (Virtualization Host Extensions) is implemented */
136 /** True if Priviledge Access Never is implemented */
137 const unsigned _havePAN;
139 /** True if Secure EL2 is implemented */
140 const unsigned _haveSecEL2;
143 * True if the Semihosting interface is enabled.
145 ArmSemihosting *const semihosting;
148 static constexpr Addr PageBytes = ArmISA::PageBytes;
149 static constexpr Addr PageShift = ArmISA::PageShift;
151 typedef ArmSystemParams Params;
155 return dynamic_cast<const Params &>(_params);
158 ArmSystem(const Params &p);
160 /** true if this a multiprocessor system */
163 /** Returns true if this system implements the Security Extensions */
164 bool haveSecurity() const { return _haveSecurity; }
166 /** Returns true if this system implements the Large Physical Address
168 bool haveLPAE() const { return _haveLPAE; }
170 /** Returns true if this system implements the virtualization
173 bool haveVirtualization() const { return _haveVirtualization; }
175 /** Returns true if this system implements the Crypto
178 bool haveCrypto() const { return _haveCrypto; }
180 /** Sets the pointer to the Generic Timer. */
182 setGenericTimer(GenericTimer *generic_timer)
184 _genericTimer = generic_timer;
187 /** Sets the pointer to the GIC. */
188 void setGIC(BaseGic *gic) { _gic = gic; }
190 /** Sets the pointer to the Power Controller */
191 void setPowerController(FVPBasePwrCtrl *pwr_ctrl)
196 /** Get a pointer to the system's generic timer model */
197 GenericTimer *getGenericTimer() const { return _genericTimer; }
199 /** Get a pointer to the system's GIC */
200 BaseGic *getGIC() const { return _gic; }
202 /** Get a pointer to the system's power controller */
203 FVPBasePwrCtrl *getPowerController() const { return _pwrCtrl; }
205 /** Returns true if the register width of the highest implemented exception
206 * level is 64 bits (ARMv8) */
207 bool highestELIs64() const { return _highestELIs64; }
209 /** Returns the highest implemented exception level */
210 ArmISA::ExceptionLevel
215 if (_haveVirtualization)
220 /** Returns the reset address if the highest implemented exception level is
222 Addr resetAddr() const { return _resetAddr; }
223 void setResetAddr(Addr addr) { _resetAddr = addr; }
225 /** Returns true if ASID is 16 bits in AArch64 (ARMv8) */
226 bool haveLargeAsid64() const { return _haveLargeAsid64; }
228 /** Returns true if this system implements the transactional
229 * memory extension (ARMv9)
231 bool haveTME() const { return _haveTME; }
233 /** Returns true if SVE is implemented (ARMv8) */
234 bool haveSVE() const { return _haveSVE; }
236 /** Returns the SVE vector length at reset, in quadwords */
237 unsigned sveVL() const { return _sveVL; }
239 /** Returns true if LSE is implemented (ARMv8.1) */
240 bool haveLSE() const { return _haveLSE; }
242 /** Returns true if Virtualization Host Extensions is implemented */
243 bool haveVHE() const { return _haveVHE; }
245 /** Returns true if Priviledge Access Never is implemented */
246 bool havePAN() const { return _havePAN; }
248 /** Returns true if Priviledge Access Never is implemented */
249 bool haveSecEL2() const { return _haveSecEL2; }
251 /** Returns the supported physical address range in bits if the highest
252 * implemented exception level is 64 bits (ARMv8) */
253 uint8_t physAddrRange64() const { return _physAddrRange64; }
255 /** Returns the supported physical address range in bits */
257 physAddrRange() const
260 return _physAddrRange64;
266 /** Returns the physical address mask */
267 Addr physAddrMask() const { return mask(physAddrRange()); }
269 /** Is Arm Semihosting support enabled? */
270 bool haveSemihosting() const { return semihosting != nullptr; }
273 * Returns a valid ArmSystem pointer if using ARM ISA, it fails
277 getArmSystem(ThreadContext *tc)
280 return static_cast<ArmSystem *>(tc->getSystemPtr());
283 /** Returns true if the system of a specific thread context implements the
284 * Security Extensions
286 static bool haveSecurity(ThreadContext *tc);
288 /** Returns true if the system of a specific thread context implements the
289 * virtualization Extensions
291 static bool haveVirtualization(ThreadContext *tc);
293 /** Returns true if the system of a specific thread context implements the
294 * Large Physical Address Extension
296 static bool haveLPAE(ThreadContext *tc);
298 /** Returns true if the register width of the highest implemented exception
299 * level for the system of a specific thread context is 64 bits (ARMv8)
301 static bool highestELIs64(ThreadContext *tc);
303 /** Returns the highest implemented exception level for the system of a
304 * specific thread context
306 static ArmISA::ExceptionLevel highestEL(ThreadContext *tc);
308 /** Return true if the system implements a specific exception level */
309 static bool haveEL(ThreadContext *tc, ArmISA::ExceptionLevel el);
311 /** Returns true if the system of a specific thread context implements the
312 * transactional memory extension (TME)
314 static bool haveTME(ThreadContext *tc);
316 /** Returns the reset address if the highest implemented exception level
317 * for the system of a specific thread context is 64 bits (ARMv8)
319 static Addr resetAddr(ThreadContext *tc);
321 /** Returns the supported physical address range in bits for the system of a
322 * specific thread context
324 static uint8_t physAddrRange(ThreadContext *tc);
326 /** Returns the physical address mask for the system of a specific thread
329 static Addr physAddrMask(ThreadContext *tc);
331 /** Returns true if ASID is 16 bits for the system of a specific thread
332 * context while in AArch64 (ARMv8) */
333 static bool haveLargeAsid64(ThreadContext *tc);
335 /** Is Arm Semihosting support enabled? */
336 static bool haveSemihosting(ThreadContext *tc);
338 /** Make a Semihosting call from aarch64 */
339 static bool callSemihosting64(ThreadContext *tc, bool gem5_ops=false);
341 /** Make a Semihosting call from aarch32 */
342 static bool callSemihosting32(ThreadContext *tc, bool gem5_ops=false);
344 /** Make a Semihosting call from either aarch64 or aarch32 */
345 static bool callSemihosting(ThreadContext *tc, bool gem5_ops=false);
347 /** Make a call to notify the power controller of STANDBYWFI assertion */
348 static void callSetStandByWfi(ThreadContext *tc);
350 /** Make a call to notify the power controller of STANDBYWFI deassertion */
351 static void callClearStandByWfi(ThreadContext *tc);
354 * Notify the power controller of WAKEREQUEST assertion. Returns true
355 * if WAKEREQUEST is enabled as a power-on mechanism, and the core is now
356 * powered, false otherwise
358 static bool callSetWakeRequest(ThreadContext *tc);
360 /** Notify the power controller of WAKEREQUEST deassertion */
361 static void callClearWakeRequest(ThreadContext *tc);