f20ccd3175
This patch updates the doxygen for the drivers axivdma, can, canps ,devcfg , bram to include .h files in the listof files provided in the index.html file. Signed-off-by: Kedareswara rao Appana <appanad@xilinx.com>
77 lines
4.6 KiB
HTML
Executable file
77 lines
4.6 KiB
HTML
Executable file
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
|
|
<title>
|
|
Xilinx Driver bram v4_0: bram v4_0
|
|
</title>
|
|
<link href="doxygen_kalyanidocs/doc/css/driver_api_doxygen.css" rel="stylesheet" type="text/css">
|
|
</head>
|
|
<h3 class="PageHeader">Xilinx Processor IP Library</h3>
|
|
<hl>Software Drivers</hl>
|
|
<hr class="whs1">
|
|
|
|
<!-- Generated by Doxygen 1.6.1 -->
|
|
<div class="navigation" id="top">
|
|
<div class="tabs">
|
|
<ul>
|
|
<li class="current"><a href="index.html"><span>Main Page</span></a></li>
|
|
<li><a href="annotated.html"><span>Classes</span></a></li>
|
|
<li><a href="files.html"><span>Files</span></a></li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
<div class="contents">
|
|
<h1>bram v4_0</h1><p>If ECC is not enabled, this driver exists only to allow the tools to create a memory test application and to populate xparameters.h with memory range constants. In this case there is no source code.</p>
|
|
<p>If ECC is enabled, this file contains the software API definition of the Xilinx BRAM Interface Controller (<a class="el" href="struct_x_bram.html">XBram</a>) device driver.</p>
|
|
<p>The Xilinx BRAM controller is a soft IP core designed for Xilinx FPGAs and contains the following general features:</p>
|
|
<ul>
|
|
<li>LMB v2.0 bus interfaces with byte enable support</li>
|
|
<li>Used in conjunction with bram_block peripheral to provide fast BRAM memory solution for MicroBlaze ILMB and DLMB ports</li>
|
|
<li>Supports byte, half-word, and word transfers</li>
|
|
<li>Supports optional BRAM error correction and detection.</li>
|
|
</ul>
|
|
<p>The driver provides interrupt management functions. Implementation of interrupt handlers is left to the user. Refer to the provided interrupt example in the examples directory for details.</p>
|
|
<p>This driver is intended to be RTOS and processor independent. Any needs for dynamic memory management, threads or thread mutual exclusion, virtual memory, or cache control must be satisfied by the layer above this driver.</p>
|
|
<p><b>Initialization & Configuration</b></p>
|
|
<p>The <a class="el" href="struct_x_bram___config.html">XBram_Config</a> structure is used by the driver to configure itself. This configuration structure is typically created by the tool-chain based on HW build properties.</p>
|
|
<p>To support multiple runtime loading and initialization strategies employed by various operating systems, the driver instance can be initialized as follows:</p>
|
|
<ul>
|
|
<li>XBram_CfgInitialize(InstancePtr, CfgPtr, EffectiveAddr) - Uses a configuration structure provided by the caller. If running in a system with address translation, the provided virtual memory base address replaces the physical address present in the configuration structure.</li>
|
|
</ul>
|
|
<dl class="note"><dt><b>Note:</b></dt><dd></dd></dl>
|
|
<p>This API utilizes 32 bit I/O to the BRAM registers. With less than 32 bits, the unused bits from registers are read as zero and written as don't cares.</p>
|
|
<pre>
|
|
MODIFICATION HISTORY:</pre><pre> Ver Who Date Changes
|
|
----- ---- -------- -----------------------------------------------
|
|
3.00a sa 05/11/10 Added ECC support
|
|
3.01a sa 01/13/12 Changed Selftest API from
|
|
XBram_SelfTest(XBram *InstancePtr) to
|
|
<a class="el" href="xbram__selftest_8c.html#aedbdefb6cda5c212f03271143ccf7a98">XBram_SelfTest(XBram *InstancePtr, u8 IntMask)</a> and
|
|
fixed a problem with interrupt generation for CR 639274
|
|
Modified Selftest example to return XST_SUCCESS when
|
|
ECC is not enabled and return XST_FAILURE when ECC is
|
|
enabled and Control Base Address is zero (CR 636581)
|
|
Modified Selftest to use correct CorrectableCounterBits
|
|
for CR 635655
|
|
Updated to check CorrectableFailingDataRegs in the case
|
|
of LMB BRAM.
|
|
Added CorrectableFailingDataRegs and
|
|
UncorrectableFailingDataRegs to the config structure to
|
|
distinguish between AXI BRAM and LMB BRAM.
|
|
These registers are not present in the current version of
|
|
the AXI BRAM Controller.
|
|
3.02a sa 04/16/12 Added test of byte and halfword read-modify-write
|
|
3.02a sa 04/16/12 Modified driver tcl to sort the address parameters
|
|
to support both xps and vivado designs.
|
|
3.02a adk 24/4/13 Modified the tcl file to avoid warnings
|
|
when ecc is disabled cr:705002.
|
|
3.03a bss 05/22/13 Added Xil_DCacheFlushRange in <a class="el" href="xbram__selftest_8c.html">xbram_selftest.c</a> to
|
|
flush the Cache after writing to BRAM in InjectErrors
|
|
API(CR #719011)
|
|
4.0 adk 19/12/13 Updated as per the New Tcl API's
|
|
</pre> </div>
|
|
<p class="Copyright">
|
|
Copyright © 1995-2014 Xilinx, Inc. All rights reserved.
|
|
</p>
|
|
</body>
|
|
</html>
|