Dewant Katare / lwip-eth_lab4

lab practicals

arch/lpc_phy.h@0:f4db29eb9e47, 2012-06-22 (annotated)

Committer:
mbed_official
Date:
Fri Jun 22 09:32:29 2012 +0000
Revision:
0:f4db29eb9e47
Child:
3:dd8b8f5b449a
Initial import from NXP lwip_lpc: http://sw.lpcware.com/index.php?p=lwip_lpc.git&a=snapshot&h=7b84446afe97af955acad1d720696a0de73ab7cf&fmt=zip

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbed_official 0:f4db29eb9e47 1 /**********************************************************************
mbed_official 0:f4db29eb9e47 2 * $Id$ lpc_phy.h 2011-11-20
mbed_official 0:f4db29eb9e47 3 *//**
mbed_official 0:f4db29eb9e47 4 * @file lpc_phy.h
mbed_official 0:f4db29eb9e47 5 * @brief Common PHY definitions used with all PHYs
mbed_official 0:f4db29eb9e47 6 * @version 1.0
mbed_official 0:f4db29eb9e47 7 * @date 20 Nov. 2011
mbed_official 0:f4db29eb9e47 8 * @author NXP MCU SW Application Team
mbed_official 0:f4db29eb9e47 9 *
mbed_official 0:f4db29eb9e47 10 * Copyright(C) 2011, NXP Semiconductor
mbed_official 0:f4db29eb9e47 11 * All rights reserved.
mbed_official 0:f4db29eb9e47 12 *
mbed_official 0:f4db29eb9e47 13 ***********************************************************************
mbed_official 0:f4db29eb9e47 14 * Software that is described herein is for illustrative purposes only
mbed_official 0:f4db29eb9e47 15 * which provides customers with programming information regarding the
mbed_official 0:f4db29eb9e47 16 * products. This software is supplied "AS IS" without any warranties.
mbed_official 0:f4db29eb9e47 17 * NXP Semiconductors assumes no responsibility or liability for the
mbed_official 0:f4db29eb9e47 18 * use of the software, conveys no license or title under any patent,
mbed_official 0:f4db29eb9e47 19 * copyright, or mask work right to the product. NXP Semiconductors
mbed_official 0:f4db29eb9e47 20 * reserves the right to make changes in the software without
mbed_official 0:f4db29eb9e47 21 * notification. NXP Semiconductors also make no representation or
mbed_official 0:f4db29eb9e47 22 * warranty that such application will be suitable for the specified
mbed_official 0:f4db29eb9e47 23 * use without further testing or modification.
mbed_official 0:f4db29eb9e47 24 **********************************************************************/
mbed_official 0:f4db29eb9e47 25
mbed_official 0:f4db29eb9e47 26 #ifndef __LPC_PHY_H_
mbed_official 0:f4db29eb9e47 27 #define __LPC_PHY_H_
mbed_official 0:f4db29eb9e47 28
mbed_official 0:f4db29eb9e47 29 #include "lwip/opt.h"
mbed_official 0:f4db29eb9e47 30 #include "lwip/err.h"
mbed_official 0:f4db29eb9e47 31 #include "lwip/netif.h"
mbed_official 0:f4db29eb9e47 32
mbed_official 0:f4db29eb9e47 33 #ifdef __cplusplus
mbed_official 0:f4db29eb9e47 34 extern "C"
mbed_official 0:f4db29eb9e47 35 {
mbed_official 0:f4db29eb9e47 36 #endif
mbed_official 0:f4db29eb9e47 37
mbed_official 0:f4db29eb9e47 38 /* These PHY functions are usually part of the EMAC driver */
mbed_official 0:f4db29eb9e47 39
mbed_official 0:f4db29eb9e47 40 /** \brief Phy status update state machine
mbed_official 0:f4db29eb9e47 41 *
mbed_official 0:f4db29eb9e47 42 * This function provides a state machine for maintaining the PHY
mbed_official 0:f4db29eb9e47 43 * status without blocking. It must be occasionally called for the
mbed_official 0:f4db29eb9e47 44 * PHY status to be maintained.
mbed_official 0:f4db29eb9e47 45 *
mbed_official 0:f4db29eb9e47 46 * \param[in] netif NETIF structure
mbed_official 0:f4db29eb9e47 47 */
mbed_official 0:f4db29eb9e47 48 s32_t lpc_phy_sts_sm(struct netif *netif);
mbed_official 0:f4db29eb9e47 49
mbed_official 0:f4db29eb9e47 50 /** \brief Initialize the PHY
mbed_official 0:f4db29eb9e47 51 *
mbed_official 0:f4db29eb9e47 52 * This function initializes the PHY. It will block until complete.
mbed_official 0:f4db29eb9e47 53 * This function is called as part of the EMAC driver
mbed_official 0:f4db29eb9e47 54 * initialization. Configuration of the PHY at startup is
mbed_official 0:f4db29eb9e47 55 * controlled by setting up configuration defines in lpc_phy.h.
mbed_official 0:f4db29eb9e47 56 *
mbed_official 0:f4db29eb9e47 57 * \param[in] netif NETIF structure
mbed_official 0:f4db29eb9e47 58 * \param[in] rmii If set, configures the PHY for RMII mode
mbed_official 0:f4db29eb9e47 59 * \return ERR_OK if the setup was successful, otherwise ERR_TIMEOUT
mbed_official 0:f4db29eb9e47 60 */
mbed_official 0:f4db29eb9e47 61 err_t lpc_phy_init(struct netif *netif, int rmii);
mbed_official 0:f4db29eb9e47 62
mbed_official 0:f4db29eb9e47 63 /** \brief Write a value via the MII link (non-blocking)
mbed_official 0:f4db29eb9e47 64 *
mbed_official 0:f4db29eb9e47 65 * This function will write a value on the MII link interface to a PHY
mbed_official 0:f4db29eb9e47 66 * or a connected device. The function will return immediately without
mbed_official 0:f4db29eb9e47 67 * a status. Status needs to be polled later to determine if the write
mbed_official 0:f4db29eb9e47 68 * was successful.
mbed_official 0:f4db29eb9e47 69 *
mbed_official 0:f4db29eb9e47 70 * \param[in] PhyReg PHY register to write to
mbed_official 0:f4db29eb9e47 71 * \param[in] Value Value to write
mbed_official 0:f4db29eb9e47 72 */
mbed_official 0:f4db29eb9e47 73 void lpc_mii_write_noblock(u32_t PhyReg, u32_t Value);
mbed_official 0:f4db29eb9e47 74
mbed_official 0:f4db29eb9e47 75 /** \brief Write a value via the MII link (blocking)
mbed_official 0:f4db29eb9e47 76 *
mbed_official 0:f4db29eb9e47 77 * This function will write a value on the MII link interface to a PHY
mbed_official 0:f4db29eb9e47 78 * or a connected device. The function will block until complete.
mbed_official 0:f4db29eb9e47 79 *
mbed_official 0:f4db29eb9e47 80 * \param[in] PhyReg PHY register to write to
mbed_official 0:f4db29eb9e47 81 * \param[in] Value Value to write
mbed_official 0:f4db29eb9e47 82 * \returns 0 if the write was successful, otherwise !0
mbed_official 0:f4db29eb9e47 83 */
mbed_official 0:f4db29eb9e47 84 err_t lpc_mii_write(u32_t PhyReg, u32_t Value);
mbed_official 0:f4db29eb9e47 85
mbed_official 0:f4db29eb9e47 86 /** \brief Reads current MII link busy status
mbed_official 0:f4db29eb9e47 87 *
mbed_official 0:f4db29eb9e47 88 * This function will return the current MII link busy status and is meant to
mbed_official 0:f4db29eb9e47 89 * be used with non-blocking functions for monitor PHY status such as
mbed_official 0:f4db29eb9e47 90 * connection state.
mbed_official 0:f4db29eb9e47 91 *
mbed_official 0:f4db29eb9e47 92 * \returns !0 if the MII link is busy, otherwise 0
mbed_official 0:f4db29eb9e47 93 */
mbed_official 0:f4db29eb9e47 94 u32_t lpc_mii_is_busy(void);
mbed_official 0:f4db29eb9e47 95
mbed_official 0:f4db29eb9e47 96 /** \brief Starts a read operation via the MII link (non-blocking)
mbed_official 0:f4db29eb9e47 97 *
mbed_official 0:f4db29eb9e47 98 * This function returns the current value in the MII data register. It is
mbed_official 0:f4db29eb9e47 99 * meant to be used with the non-blocking oeprations. This value should
mbed_official 0:f4db29eb9e47 100 * only be read after a non-block read command has been issued and the
mbed_official 0:f4db29eb9e47 101 * MII status has been determined to be good.
mbed_official 0:f4db29eb9e47 102 *
mbed_official 0:f4db29eb9e47 103 * \returns The current value in the MII value register
mbed_official 0:f4db29eb9e47 104 */
mbed_official 0:f4db29eb9e47 105 u32_t lpc_mii_read_data(void);
mbed_official 0:f4db29eb9e47 106
mbed_official 0:f4db29eb9e47 107 /** \brief Starts a read operation via the MII link (non-blocking)
mbed_official 0:f4db29eb9e47 108 *
mbed_official 0:f4db29eb9e47 109 * This function will start a read operation on the MII link interface
mbed_official 0:f4db29eb9e47 110 * from a PHY or a connected device. The function will not block and
mbed_official 0:f4db29eb9e47 111 * the status mist be polled until complete. Once complete, the data
mbed_official 0:f4db29eb9e47 112 * can be read.
mbed_official 0:f4db29eb9e47 113 *
mbed_official 0:f4db29eb9e47 114 * \param[in] PhyReg PHY register to read from
mbed_official 0:f4db29eb9e47 115 */
mbed_official 0:f4db29eb9e47 116 err_t lpc_mii_read(u32_t PhyReg, u32_t *data);
mbed_official 0:f4db29eb9e47 117
mbed_official 0:f4db29eb9e47 118 /** \brief Read a value via the MII link (blocking)
mbed_official 0:f4db29eb9e47 119 *
mbed_official 0:f4db29eb9e47 120 * This function will read a value on the MII link interface from a PHY
mbed_official 0:f4db29eb9e47 121 * or a connected device. The function will block until complete.
mbed_official 0:f4db29eb9e47 122 *
mbed_official 0:f4db29eb9e47 123 * \param[in] PhyReg PHY register to read from
mbed_official 0:f4db29eb9e47 124 * \param[in] data Pointer to where to save data read via MII
mbed_official 0:f4db29eb9e47 125 * \returns 0 if the read was successful, otherwise !0
mbed_official 0:f4db29eb9e47 126 */
mbed_official 0:f4db29eb9e47 127 void lpc_mii_read_noblock(u32_t PhyReg);
mbed_official 0:f4db29eb9e47 128
mbed_official 0:f4db29eb9e47 129 /**
mbed_official 0:f4db29eb9e47 130 * This function provides a method for the PHY to setup the EMAC
mbed_official 0:f4db29eb9e47 131 * for the PHY negotiated duplex mode.
mbed_official 0:f4db29eb9e47 132 *
mbed_official 0:f4db29eb9e47 133 * @param[in] full_duplex 0 = half duplex, 1 = full duplex
mbed_official 0:f4db29eb9e47 134 */
mbed_official 0:f4db29eb9e47 135 void lpc_emac_set_duplex(int full_duplex);
mbed_official 0:f4db29eb9e47 136
mbed_official 0:f4db29eb9e47 137 /**
mbed_official 0:f4db29eb9e47 138 * This function provides a method for the PHY to setup the EMAC
mbed_official 0:f4db29eb9e47 139 * for the PHY negotiated bit rate.
mbed_official 0:f4db29eb9e47 140 *
mbed_official 0:f4db29eb9e47 141 * @param[in] mbs_100 0 = 10mbs mode, 1 = 100mbs mode
mbed_official 0:f4db29eb9e47 142 */
mbed_official 0:f4db29eb9e47 143 void lpc_emac_set_speed(int mbs_100);
mbed_official 0:f4db29eb9e47 144
mbed_official 0:f4db29eb9e47 145 #ifdef __cplusplus
mbed_official 0:f4db29eb9e47 146 }
mbed_official 0:f4db29eb9e47 147 #endif
mbed_official 0:f4db29eb9e47 148
mbed_official 0:f4db29eb9e47 149 #endif /* __LPC_PHY_H_ */
mbed_official 0:f4db29eb9e47 150
mbed_official 0:f4db29eb9e47 151 /* --------------------------------- End Of File ------------------------------ */