1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<HTML>
3<HEAD>
4<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 7.0.0.0 for Windows">
6<META http-equiv="Content-Style-Type" content="text/css">
7<TITLE>IC_LockdownRange</TITLE>
8<LINK rel="stylesheet" href="../../css/nitro.css" type="text/css">
9</HEAD>
10<BODY>
11<H1 align="left">IC_LockdownRange <IMG src="../../image/NTR.gif" align="middle"><IMG src="../../image/TWL.gif" align="middle"></H1>
12<H2>Syntax</H2>
13<DL>
14  <DD>
15<PRE><CODE>#include &lt;nitro/os.h&gt;</CODE></PRE>
16  <PRE><CODE>void IC_LockdownRange( const void* startAddr, u32 nBytes );</CODE>
17</PRE>
18</DL>
19<H2>Arguments</H2>
20<TABLE border="1" width="100%">
21  <TBODY>
22    <TR>
23<TD width="13%"><EM><STRONG>startAddr</STRONG></EM></TD>
24<TD width="87%">Lowest address in the region to be locked down</TD>
25    </TR>
26    <TR>
27<TD width="13%"><EM><STRONG>nBytes</STRONG></EM></TD>
28<TD width="87%">Number of bytes of the region to be locked down (maximum is 2 KB)</TD>
29    </TR>
30  </TBODY>
31</TABLE>
32<H2>Return Values</H2>
33<P>None.</P>
34<H2>Description</H2>
35<P>This function locks the contents of the instruction cache that is hit by the specified region so that the cache won't be discarded.</P>
36<P>However, because the cache is locked in blocks of 2KB, each time this function is called, the area that can be used as cache is reduced by 2KB, boosting the miss rate. The function can lock down a maximum of three blocks of instruction cache.</P>
37<P><B><I>startAddr</I></B> is rounded down to the closest 32-byte boundary. The sum of <CODE>startAddr</CODE> plus <CODE>nBytes</CODE> is rounded up to the closest 32-byte boundary.</P>
38
39<h2>Internal Operation</h2>
40<P>This function operates registers 7 and 9 of the system control coprocessor.</P>
41<P>While the specified data is being loaded into the cache, interrupts are disabled internally.</P>
42<P>If this function is used, it will be assigned to ITCM.</P>
43
44
45<H2>See Also</H2>
46<P><CODE><A href="IC_PrefetchRange.html">IC_PrefetchRange</A><BR> <A href="IC_Unlockdown.html">IC_Unlockdown</A><BR> <A href="IC_UnlockdownAll.html">IC_UnlockdownAll</A></CODE></P>
47
48<H2>Revision History</H2>
49<P>
502005/11/14 Changed the type of <em><strong><code>startAddr</code></strong></em> to <code>const void*</code>.<br>2005/01/21 Added a description of the lockdown block. <BR>2003/12/22 Initial version.</P>
51<hr><p>CONFIDENTIAL</p></body>
52</HTML>