binding2.html

vxworks相关论文

</dl>

</dl>

<dd><div class="Item"><a name="97126"> </a><b class="symbol_lc">window.size <br>
</b></div>
<dl class="margin">

<dl class="margin">

<dl class="margin">

<dd><div class="Indent3"><a name="86724"> </a>Set by the function you supply in the <b class="symbol_lc">setWindow</b> member of this structure. TrueFFS uses this member to store the size of the memory window on flash memory. </>
<br>
</dl>

</dl>

</dl>

<dd><div class="Item"><a name="94594"> </a><b class="symbol_lc">window.speed <br>
</b></div>
<dl class="margin">

<dl class="margin">

<dl class="margin">

<dd><div class="Indent3"><a name="94595"> </a>For internal use. You should not have to change the value of this member from your socket component driver. TrueFFS uses this member to store the length of time needed to complete an interaction with the flash device. Initially, TrueFFS sets this to a default value of 250 nano seconds. However, all WRS-supplied MTDs reset it to 120 nano seconds. If you write your own MTD, be sure to reset this member value appropriately in its mapping function. </>
<br>
</dl>

</dl>

</dl>

<dd><div class="Item"><a name="94596"> </a><b class="symbol_lc">window.busWidth <br>
</b></div>
<dl class="margin">

<dl class="margin">

<dl class="margin">

<dd><div class="Indent3"><a name="95880"> </a>For internal use. Do not change the value of this member from your socket component driver. TrueFFS uses this member to record whether the flash device is 8 or 16 bits wide. Initially, TrueFFS sets this to a default value of 16. However, some WRS-supplied MTDs reset it to 8. If you write your own MTD, be sure to reset this member value appropriately in your mapping function. </>
<br>
</dl>

</dl>

</dl>

<dd><div class="Item"><a name="95066"> </a><b class="symbol_lc">cardDetected <br>
</b></div>
<dl class="margin">

<dl class="margin">

<dl class="margin">

<dd><div class="Indent3"><a name="95067"> </a>Initialized by your <i class="textVariable">xxx</i><b class="routine"><i class="routine">Register</i></b><b>(&nbsp;)</b>. This member points to a function that reports whether there is a flash memory card in the PCMCIA slot associated with this device. For non-removable media, this routine should always return TRUE. Internally, TrueFFS for Tornado calls this function every 100 milliseconds to check that flash media is still there. If this function returns FALSE, TrueFFS sets <b class="file">cardChanged</b> to TRUE. </>
<br>
</dl>

</dl>

</dl>

<dd><div class="Item"><a name="93652"> </a><b class="symbol_lc">VccOn</b> </div>
<dl class="margin">

<dl class="margin">

<dl class="margin">

<dd><div class="Indent3"><a name="93653"> </a>Set by your <i class="textVariable">xxx</i><b class="routine"><i class="routine">Register</i></b><b>(&nbsp;)</b>. This member contains a pointer to a function that TrueFFS can call to turn on the operating voltage (Vcc, usually 5 or 3.3 Volts) for the flash memory hardware. When the media is idle, TrueFFS conserves power by turning Vcc off. Prior to making a call that accesses flash memory, TrueFFS uses this function to turn the power back on again. </>
<br>
<dd><div class="Indent3"><a name="99502"> </a>When switching Vcc on, the <b class="symbol_lc">VccOn</b> function must not return until Vcc has stabilized at the proper operating voltage. If necessary, your <b class="symbol_lc">VccOn</b> function should delay execution with an idle loop or with a call to the <b class="routine"><i class="routine">flDelayMsec</i></b><b>(&nbsp;)</b><i class="i"> </i>routine, until the Vcc has stabilized. </>
<br>
<dd><div class="Indent3"><a name="99571"> </a>Prior to accessing the flash device, TrueFFS turns on Vcc. To conserve power, TrueFFS switches Vcc off at the completion of the operation. However, when socket polling is active, a delayed Vcc-off mechanism is used, in which Vcc is turned off only after at least one interval has passed. If several flash-accessing operations are executed in rapid sequence, Vcc remains on during the sequence, and is turned off only when TrueFFS goes into a relatively idle state. </>
<br>
</dl>

</dl>

</dl>

<dd><div class="Item"><a name="93655"> </a><b class="symbol_lc">VccOff</b> </div>
<dl class="margin">

<dl class="margin">

<dl class="margin">

<dd><div class="Indent3"><a name="93656"> </a>Set by your <i class="textVariable">xxx</i><b class="routine"><i class="routine">Register</i></b><b>(&nbsp;)</b>. This member contains a pointer to a function that TrueFFS can call to turn off the operating voltage for the flash memory hardware. When the media is idle, TrueFFS conserves power by turning Vcc off. However, when socket polling is active, Vcc is turned off only after a delay. Thus, if several flags accessing operations are executed in rapid sequence, Vcc is left on during the sequence. Vcc is turned off only when TrueFFS goes into a relatively idle state.</>
<br>
</dl>

</dl>

</dl>

<dd><div class="Item"><a name="93659"> </a><b class="symbol_lc">VppOn</b> </div>
<dl class="margin">

<dl class="margin">

<dl class="margin">

<dd><div class="Indent3"><a name="93660"> </a>Set by your <i class="textVariable">xxx</i><b class="routine"><i class="routine">Register</i></b><b>(&nbsp;)</b>. TrueFFS calls this routine to apply a programming voltage (<b>Vpp</b>, usually 12 Volts) to the flash chip. Because not all flash chips require this voltage, the member is included only if <b class="symbol_lc">SOCKET_12_VOLTS </b>is defined. </>
<br>
<dd><div class="Indent3"><a name="99539"> </a>When switching Vpp on, the <b class="symbol_lc">VppOn</b> function must not return until Vpp has stabilized at the proper voltage. If necessary, your <b class="symbol_lc">VppOn</b> function should delay execution with an idle loop or with a call to the <b class="routine"><i class="routine">flDelayMsec</i></b><b>(&nbsp;)</b><i class="i"> </i>routine, until the Vpp has stabilized. </>
<br>
</dl>

</dl>

</dl>

<dd><div class="Item"><a name="94712"> </a><b class="symbol_lc">VppOff</b> </div>
<dl class="margin">

<dl class="margin">

<dl class="margin">

<dd><div class="Indent3"><a name="94719"> </a>Set by your <i class="textVariable">xxx</i><b class="routine"><i class="routine">Register</i></b><b>(&nbsp;)</b>. TrueFFS calls this routine to turn off a programming voltage (<b>Vpp</b>, usually 12 Volts) to the flash chip. Because not all flash chips require this voltage, the member is included only if <b class="symbol_lc">SOCKET_12_VOLTS </b>is defined. </>
<br>
</dl>

</dl>

</dl>

<dd><div class="Item"><a name="94715"> </a><b class="symbol_lc">initSocket</b> </div>
<dl class="margin">

<dl class="margin">

<dl class="margin">

<dd><div class="Indent3"><a name="93665"> </a>Set by your <i class="textVariable">xxx</i><b class="routine"><i class="routine">Register</i></b><b>(&nbsp;)</b>. TrueFFS calls the function referenced here before it tries to access the socket. TrueFFS uses this function to handle any initialization that is necessary before accessing the socket, especially if that initialization was not possible at socket registration time. For example, if you did no hardware detection at socket registration time or if the flash memory medium is removable, this function should detect the flash memory medium and respond appropriately (including setting <b class="symbol_lc">cardDetected</b> to FALSE) if it is missing. </>
<br>
</dl>

</dl>

</dl>

<dd><div class="Item"><a name="93666"> </a><b class="symbol_lc">setWindow</b> </div>
<dl class="margin">

<dl class="margin">

<dl class="margin">

<dd><div class="Indent3"><a name="101859"> </a>Set by your <i class="textVariable">xxx</i><b class="routine"><i class="routine">Register</i></b><b>(&nbsp;)</b>. TrueFFS calls the function referenced in this member to update key members of the <b class="symbol_lc">window</b> structure included in this <b class="symbol_lc">FLSocket</b> structure. When writing a <b class="symbol_lc">setWindow</b> function for most hardware, you must do the following: <p class="table">
<table border="0" cellpadding="0" cellspacing="0">
<tr valign="top">
<td colspan=1 rowspan=1>
<p class="BodyLeft"><a name="101869"> </a>1.</p>

</td>
<td width="10">&nbsp;</td>

<td colspan=1 rowspan=1>
<p class="BodyLeft"><a name="101871"> </a>Set <b class="symbol_lc">window.baseAddress</b> to the base address in terms of 4K pages, that is, to the base address of the window divided by 4K. This is to guarantee that the base address is page aligned. </p>

</td>
<td width="10">&nbsp;</td>


</tr>
<tr valign="top">
<td colspan=1 rowspan=1>
<p class="BodyLeft"><a name="101873"> </a>2.&nbsp;</p>

</td>
<td width="10">&nbsp;</td>

<td colspan=1 rowspan=1>
<p class="BodyLeft"><a name="101875"> </a>Call <b class="routine"><i class="routine">flSetWindowSize</i></b><b>(&nbsp;)</b>and specify the window size in 4K units (<b class="symbol_lc">window.baseAddress</b>). Internally, the call to <b class="routine"><i class="routine">flSetWindowSize</i></b><b>(&nbsp;)</b>sets <b class="symbol_lc">window.size</b> and <b class="symbol_lc">window.base</b> for you.</p>

</td>
<td width="10">&nbsp;</td>


</tr>

<tr valign="middle">
<td colspan="20">

</td>
</tr>
</table>
</p>
</>
<br>
<dd><div class="Indent3"><a name="101864"> </a>TrueFFS assumes that it has exclusive access to the window. That is, after it sets one of these window characteristics, it does not expect your application to directly change any of them, and could crash  if you do. An exception to this is the mapping register. Because TrueFFS always reestablishes this register when it accesses flash memory, your application may map the window for purposes other than TrueFFS. However, you must not do this from an interrupt routine.</>
<br>
<dd><div class="Indent3"><a name="99673"> </a>On systems with multiple socket drivers (to handle multiple flash devices), make sure that the window base address is different for each socket. In addition, you must take window size into account and verify that the windows do not overlap. </>
<br>
</dl>

</dl>

</dl>

<dd><div class="Item"><a name="93668"> </a><b class="symbol_lc">setMappingContext <br>
</b></div>
<dl class="margin">

<dl class="margin">

<dl class="margin">

<dd><div class="Indent3"><a name="93669"> </a>Set by your <i class="textVariable">xxx</i><b class="routine"><i class="routine">Register</i></b><b>(&nbsp;)</b>. This member contains a pointer to a function that TrueFFS can call to set the window mapping register. Because board-resident flash arrays usually map the entire flash into RAM, they do not need this function. The known exception to is the flash array associated with the <b class="file">ss5</b> BSP. Flash cards in the PCMCIA slot can use this function to access a mapping register that moves the effective flash address into the host's memory window (see the <b class="file">pc386</b> and <b class="file">pc486</b> BSPs). </>
<br>
</dl>

</dl>

</dl>

<dd><div class="Item"><a name="93670"> </a><b class="symbol_lc">getAndClearCardChangeIndicator <br>
</b></div>
<dl class="margin">

<dl class="margin">

<dl class="margin">

<dd><div class="Indent3"><a name="93671"> </a>Set by your <i class="textVariable">xxx</i><b class="routine"><i class="routine">Register</i></b><b>(&nbsp;)</b>. This function reads the hardware card-change indication and clears it. It serves as a basis for detecting media-change events. If you have no such hardware capability, set this function pointer to NULL.</>
<br>
</dl>

</dl>

</dl>

<dd><div class="Item"><a name="93672"> </a><b class="symbol_lc">writeProtected <br>
</b></div>
<dl class="margin">

<dl class="margin">

<dl class="margin">

<dd><div class="Indent3"><a name="93673"> </a>Set by your <i class="textVariable">xxx</i><b class="routine"><i class="routine">Register</i></b><b>(&nbsp;)</b>. This member contains a pointer to a function that TrueFFS can call to get the current state of the media's write-protect switch (if available). </>
<br>
</dl>

</dl>

</dl>

<dd><div class="Item"><a name="97795"> </a><b class="symbol_lc">freeSocket</b> </div>
<dl class="margin">

<dl class="margin">

<dl class="margin">

<dd><div class="Indent3"><a name="97796"> </a>Set by your <i class="textVariable">xxx</i><b class="routine"><i class="routine">Register</i></b><b>(&nbsp;)</b>. This member contains a pointer to a function that TrueFFS can call to free the resources reserved internally to the socket driver. </>
<br>
</dl>

</dl>

</dl>

</dl>

</dl>


<a name="foot"><hr></a>

<p class="FootnoteNumberMarker">1:&nbsp;
<span class="Footnote"><a name="95164"> </a>If you are not writing an MTD, you can ignore the member descriptions provided for the <b class="symbol_lc">FLFlash</b> structure and skip ahead to the description of the <b class="symbol_lc">FLSocket</b> structure. </span>

<p class="navbar" align="right"><a href="index.html"><img border="0" alt="[Contents]" src="icons/contents.gif"></a></a><a href="binding.html"><img border="0" alt="[Top]" src="icons/top.gif"></a><a href="binding1.html"><img border="0" alt="[Prev]" src="icons/prev.gif"></a><a href="binding3.html"><img border="0" alt="[Next]" src="icons/next.gif"></a></p>

</body>

</html>
<!---
by WRS Documentation (), Wind River Systems, Inc.
    conversion tool:  Quadralay WebWorks Publisher 4.0.11
    template:         CSS Template, Jan 1998 - Jefro --->