piread.c 1.85 KB

/*====================================================================
 * piread.c
 *
 * Copyright 1995, Silicon Graphics, Inc.
 * All Rights Reserved.
 *
 * This is UNPUBLISHED PROPRIETARY SOURCE CODE of Silicon Graphics,
 * Inc.; the contents of this file may not be disclosed to third
 * parties, copied or duplicated in any form, in whole or in part,
 * without the prior written permission of Silicon Graphics, Inc.
 *
 * RESTRICTED RIGHTS LEGEND:
 * Use, duplication or disclosure by the Government is subject to
 * restrictions as set forth in subdivision (c)(1)(ii) of the Rights
 * in Technical Data and Computer Software clause at DFARS
 * 252.227-7013, and/or in similar or successor clauses in the FAR,
 * DOD or NASA FAR Supplement. Unpublished - rights reserved under the
 * Copyright Laws of the United States.
 *====================================================================*/

/**************************************************************************
 *
 *  $Revision: 1.1.1.2 $
 *  $Date: 2002/10/29 08:06:43 $
 *  $Source: /root/leakn64/depot/rf/sw/n64os20l/libultra/nintendo/pi/piread.c,v $
 *
 **************************************************************************/

#include "osint.h"
#include "piint.h"
#include "rcp.h"


/*
 * Name:   osPiReadIo
 *
 * Description:
 *	Perform a 32-bit programmed IO read from PI device address space with
 *	mutual exclusion support. This is a blocked IO operation.
 *
 * Globals Referenced: 
 *	None
 */
s32	
osPiReadIo(u32 devAddr, u32 *data)
{

    register s32 ret;

#ifdef _DEBUG
    /* Ensure that address is 32-bit aligned */
    if (devAddr & 0x3) {
	__osError(ERR_OSPIREADIO, 1, devAddr);
	return(-1);
    }
#endif

    /* Block to get resource token */
    __osPiGetAccess();

    ret = __osPiRawReadIo(devAddr, data);

    /* Return resource token */
    __osPiRelAccess();

    return(ret);

}  /* osPiReadIo */