]> git.sur5r.net Git - freertos/blob
a378b2e332acc4c894e40ccbbfc2390bed7669cd
[freertos] /
1 /******************************************************************************
2 *
3 * (c) Copyright 2010-14 Xilinx, Inc. All rights reserved.
4 *
5 * This file contains confidential and proprietary information of Xilinx, Inc.
6 * and is protected under U.S. and international copyright and other
7 * intellectual property laws.
8 *
9 * DISCLAIMER
10 * This disclaimer is not a license and does not grant any rights to the
11 * materials distributed herewith. Except as otherwise provided in a valid
12 * license issued to you by Xilinx, and to the maximum extent permitted by
13 * applicable law: (1) THESE MATERIALS ARE MADE AVAILABLE "AS IS" AND WITH ALL
14 * FAULTS, AND XILINX HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS, EXPRESS,
15 * IMPLIED, OR STATUTORY, INCLUDING BUT NOT LIMITED TO WARRANTIES OF
16 * MERCHANTABILITY, NON-INFRINGEMENT, OR FITNESS FOR ANY PARTICULAR PURPOSE;
17 * and (2) Xilinx shall not be liable (whether in contract or tort, including
18 * negligence, or under any other theory of liability) for any loss or damage
19 * of any kind or nature related to, arising under or in connection with these
20 * materials, including for any direct, or any indirect, special, incidental,
21 * or consequential loss or damage (including loss of data, profits, goodwill,
22 * or any type of loss or damage suffered as a result of any action brought by
23 * a third party) even if such damage or loss was reasonably foreseeable or
24 * Xilinx had been advised of the possibility of the same.
25 *
26 * CRITICAL APPLICATIONS
27 * Xilinx products are not designed or intended to be fail-safe, or for use in
28 * any application requiring fail-safe performance, such as life-support or
29 * safety devices or systems, Class III medical devices, nuclear facilities,
30 * applications related to the deployment of airbags, or any other applications
31 * that could lead to death, personal injury, or severe property or
32 * environmental damage (individually and collectively, "Critical
33 * Applications"). Customer assumes the sole risk and liability of any use of
34 * Xilinx products in Critical Applications, subject only to applicable laws
35 * and regulations governing limitations on product liability.
36 *
37 * THIS COPYRIGHT NOTICE AND DISCLAIMER MUST BE RETAINED AS PART OF THIS FILE
38 * AT ALL TIMES.
39 *
40 ******************************************************************************/
41 /*****************************************************************************/
42 /**
43 *
44 * @file xiicps_selftest.c
45 *
46 * This component contains the implementation of selftest functions for the
47 * XIicPs driver component.
48 *
49 * <pre>
50 * MODIFICATION HISTORY:
51 *
52 * Ver   Who    Date     Changes
53 * ----- ------ -------- ---------------------------------------------
54 * 1.00a drg/jz 01/30/10 First release
55 * 1.00a sdm    09/22/11 Removed unused code
56 * </pre>
57 *
58 ******************************************************************************/
59
60 /***************************** Include Files *********************************/
61
62 #include "xiicps.h"
63
64 /************************** Constant Definitions *****************************/
65
66 #define REG_TEST_VALUE    0x00000005
67
68 /**************************** Type Definitions *******************************/
69
70
71 /***************** Macros (Inline Functions) Definitions *********************/
72
73
74 /************************** Function Prototypes ******************************/
75
76
77 /************************** Variable Definitions *****************************/
78
79
80 /*****************************************************************************/
81 /**
82 *
83 * Runs a self-test on the driver/device. The self-test is destructive in that
84 * a reset of the device is performed in order to check the reset values of
85 * the registers and to get the device into a known state.
86 *
87 * Upon successful return from the self-test, the device is reset.
88 *
89 * @param        InstancePtr is a pointer to the XIicPs instance.
90 *
91 * @return
92 *               - XST_SUCCESS if successful.
93 *               - XST_REGISTER_ERROR indicates a register did not read or write
94 *               correctly
95 *
96 * @note         None.
97 *
98 ******************************************************************************/
99 int XIicPs_SelfTest(XIicPs *InstancePtr)
100 {
101
102         Xil_AssertNonvoid(InstancePtr != NULL);
103         Xil_AssertNonvoid(InstancePtr->IsReady == XIL_COMPONENT_IS_READY);
104
105         /*
106          * All the IIC registers should be in their default state right now.
107          */
108         if ((XIICPS_CR_RESET_VALUE !=
109                  XIicPs_ReadReg(InstancePtr->Config.BaseAddress,
110                                   XIICPS_CR_OFFSET)) ||
111                 (XIICPS_TO_RESET_VALUE !=
112                  XIicPs_ReadReg(InstancePtr->Config.BaseAddress,
113                                   XIICPS_TIME_OUT_OFFSET)) ||
114                 (XIICPS_IXR_ALL_INTR_MASK !=
115                  XIicPs_ReadReg(InstancePtr->Config.BaseAddress,
116                                   XIICPS_IMR_OFFSET))) {
117                 return XST_FAILURE;
118         }
119
120         XIicPs_Reset(InstancePtr);
121
122         /*
123          * Write, Read then write a register
124          */
125         XIicPs_WriteReg(InstancePtr->Config.BaseAddress,
126                           XIICPS_SLV_PAUSE_OFFSET, REG_TEST_VALUE);
127
128         if (REG_TEST_VALUE != XIicPs_ReadReg(InstancePtr->Config.BaseAddress,
129                                                    XIICPS_SLV_PAUSE_OFFSET)) {
130                 return XST_FAILURE;
131         }
132
133         XIicPs_WriteReg(InstancePtr->Config.BaseAddress,
134                           XIICPS_SLV_PAUSE_OFFSET, 0);
135
136         XIicPs_Reset(InstancePtr);
137
138         return XST_SUCCESS;
139 }
140