text: /******************************************************************************
   *  Copyright (c) 2016, Xilinx, Inc.
   *  All rights reserved.
   * 
   *  Redistribution and use in source and binary forms, with or without 
   *  modification, are permitted provided that the following conditions are met:
   *
   *  1.  Redistributions of source code must retain the above copyright notice, 
   *     this list of conditions and the following disclaimer.
   *
   *  2.  Redistributions in binary form must reproduce the above copyright 
   *      notice, this list of conditions and the following disclaimer in the 
   *      documentation and/or other materials provided with the distribution.
   *
   *  3.  Neither the name of the copyright holder nor the names of its 
   *      contributors may be used to endorse or promote products derived from 
   *      this software without specific prior written permission.
   *
   *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
   *  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, 
   *  THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 
   *  PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR 
   *  CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 
   *  EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 
   *  PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
   *  OR BUSINESS INTERRUPTION). HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 
   *  WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 
   *  OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 
   *  ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
   *
   *****************************************************************************/
  /******************************************************************************
   *
   *
   * @file pmod_io_switch_selftest.c
   *
   * Self testing module for the Pmod IO switch.
   *
   * <pre>
   * MODIFICATION HISTORY:
   *
   * Ver   Who  Date     Changes
   * ----- --- ------- -----------------------------------------------
   * 1.00a pp  04/29/16 release
   *
   * </pre>
   *
   *****************************************************************************/
   
  /***************************** Include Files *******************************/
  #include "pmod_io_switch.h"
  #include "xparameters.h"
  #include "stdio.h"
  #include "xil_io.h"
  
  /************************** Constant Definitions ***************************/
  #define READ_WRITE_MUL_FACTOR 0x10
  
  /************************** Function Definitions ***************************/
  /**
   *
   * Run a self-test on the driver/device. Note this may be a destructive test 
   * if resets of the device are performed.
   *
   * If the hardware system is not built correctly, this function may never
   * return to the caller.
   *
   * @param   baseaddr_p is the base address of the PMOD_IO_SWITCH_IP instance.
   *
   * @return
   *
   *    - XST_SUCCESS   if all self-test code passed
   *    - XST_FAILURE   if any self-test code failed
   *
   * @note    Caching must be turned off for this function to work.
   * @note    Test may fail if data memory and device are not on the same bus.
   *
   */
   
  XStatus PMOD_IO_SWITCH_IP_Reg_SelfTest(void * baseaddr_p)
  {
      u32 baseaddr;
      int w_i;
      int r_i;
      int Index;
  
      baseaddr = (u32) baseaddr_p;
  
      xil_printf("******************************\n\r");
      xil_printf("* User Peripheral Self Test\n\r");
      xil_printf("******************************\n\n\r");
  
      /*
       * Write to user logic slave module register(s) and read back
       */
      xil_printf("User logic slave module test...\n\r");
  
      for (w_i = 0 ; w_i < 4; w_i++){
          PMOD_IO_SWITCH_IP_mWriteReg (baseaddr, w_i*4, 
                          (w_i+1)*READ_WRITE_MUL_FACTOR);
      }
      for (r_i = 0 ; r_i < 4; r_i++){
          if ( PMOD_IO_SWITCH_IP_mReadReg (baseaddr, r_i*4) != 
              (r_i+1)*READ_WRITE_MUL_FACTOR){
              xil_printf("Error reading register at address %x\n", 
                          (int)baseaddr + r_i*4);
              return XST_FAILURE;
          }
      }
  
      xil_printf("   - slave register write/read passed\n\n\r");
  
      return XST_SUCCESS;
  }
  