| CMSIS-Driver Version 2.02 Peripheral Interface for Middleware and Application Code

- CMSIS
- CORE
- Driver
- DSP
- RTOS API
- Pack
- SVD

- Main Page
- Usage and Description
- Reference

All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Content | Data Structures | Typedefs | Functions
Ethernet PHY Interface
Ethernet Interface

Driver API for Ethernet PHY Peripheral (Driver_ETH_PHY.h) More...

## Content
| Ethernet PHY Mode
| Specify operation modes of the Ethernet PHY interface.

## Data Structures
struct | ARM_DRIVER_ETH_PHY
| Access structure of the Ethernet PHY Driver. More...

## Typedefs
typedef int32_t(* | ARM_ETH_PHY_Read_t )(uint8_t phy_addr, uint8_t reg_addr, uint16_t *data)
| Pointer to ARM_ETH_MAC_PHY_Read : Read Ethernet PHY Register.
typedef int32_t(* | ARM_ETH_PHY_Write_t )(uint8_t phy_addr, uint8_t reg_addr, uint16_t data)
| Pointer to ARM_ETH_MAC_PHY_Write : Write Ethernet PHY Register.

## Functions
ARM_DRIVER_VERSION | ARM_ETH_PHY_GetVersion (void)
| Get driver version.
int32_t | ARM_ETH_PHY_Initialize (ARM_ETH_PHY_Read_t fn_read, ARM_ETH_PHY_Write_t fn_write)
| Initialize Ethernet PHY Device.
int32_t | ARM_ETH_PHY_Uninitialize (void)
| De-initialize Ethernet PHY Device.
int32_t | ARM_ETH_PHY_PowerControl (ARM_POWER_STATE state)
| Control Ethernet PHY Device Power.
int32_t | ARM_ETH_PHY_SetInterface (uint32_t interface)
| Set Ethernet Media Interface.
int32_t | ARM_ETH_PHY_SetMode (uint32_t mode)
| Set Ethernet PHY Device Operation mode.
ARM_ETH_LINK_STATE | ARM_ETH_PHY_GetLinkState (void)
| Get Ethernet PHY Device Link state.
ARM_ETH_LINK_INFO | ARM_ETH_PHY_GetLinkInfo (void)
| Get Ethernet PHY Device Link information.

## Description

Driver API for Ethernet PHY Peripheral (Driver_ETH_PHY.h)

The following section describes the Ethernet PHY Interface as defined in the Driver_ETH_PHY.h header file.

## Data Structure Documentation

struct ARM_DRIVER_ETH_PHY

Access structure of the Ethernet PHY Driver.

The functions of the Ethernet PHY are accessed by function pointers exposed by this structure. Refer to Driver Functions for overview information.

Each instance of an Ethernet PHY provides such an access struct. The instance is identified by a postfix number in the symbol name of the access struct, for example:

- Driver_ETH_PHY0 is the name of the access struct of the first instance (no. 0).
- Driver_ETH_PHY1 is the name of the access struct of the second instance (no. 1).

A configuration setting in the middleware allows connecting the middleware to a specific driver instance Driver_ETH_PHYn. The default is 0, which connects a middleware to the first instance of a driver.

### Data Fields
ARM_DRIVER_VERSION(* | GetVersion )(void)
| Pointer to ARM_ETH_PHY_GetVersion : Get driver version.
int32_t(* | Initialize )(ARM_ETH_PHY_Read_t fn_read, ARM_ETH_PHY_Write_t fn_write)
| Pointer to ARM_ETH_PHY_Initialize : Initialize PHY Device.
int32_t(* | Uninitialize )(void)
| Pointer to ARM_ETH_PHY_Uninitialize : De-initialize PHY Device.
int32_t(* | PowerControl )(ARM_POWER_STATE state)
| Pointer to ARM_ETH_PHY_PowerControl : Control PHY Device Power.
int32_t(* | SetInterface )(uint32_t interface)
| Pointer to ARM_ETH_PHY_SetInterface : Set Ethernet Media Interface.
int32_t(* | SetMode )(uint32_t mode)
| Pointer to ARM_ETH_PHY_SetMode : Set Ethernet PHY Device Operation mode.
ARM_ETH_LINK_STATE(* | GetLinkState )(void)
| Pointer to ARM_ETH_PHY_GetLinkState : Get Ethernet PHY Device Link state.
ARM_ETH_LINK_INFO(* | GetLinkInfo )(void)
| Pointer to ARM_ETH_PHY_GetLinkInfo : Get Ethernet PHY Device Link information.

#### Field Documentation

ARM_ETH_LINK_INFO(* GetLinkInfo)(void)

Pointer to ARM_ETH_PHY_GetLinkInfo : Get Ethernet PHY Device Link information.

ARM_ETH_LINK_STATE(* GetLinkState)(void)

Pointer to ARM_ETH_PHY_GetLinkState : Get Ethernet PHY Device Link state.

ARM_DRIVER_VERSION(* GetVersion)(void)

Pointer to ARM_ETH_PHY_GetVersion : Get driver version.

int32_t(* Initialize)(ARM_ETH_PHY_Read_t fn_read, ARM_ETH_PHY_Write_t fn_write)

Pointer to ARM_ETH_PHY_Initialize : Initialize PHY Device.

int32_t(* PowerControl)(ARM_POWER_STATE state)

Pointer to ARM_ETH_PHY_PowerControl : Control PHY Device Power.

int32_t(* SetInterface)(uint32_t interface)

Pointer to ARM_ETH_PHY_SetInterface : Set Ethernet Media Interface.

int32_t(* SetMode)(uint32_t mode)

Pointer to ARM_ETH_PHY_SetMode : Set Ethernet PHY Device Operation mode.

int32_t(* Uninitialize)(void)

Pointer to ARM_ETH_PHY_Uninitialize : De-initialize PHY Device.

## Typedef Documentation

ARM_ETH_PHY_Read_t

Pointer to ARM_ETH_MAC_PHY_Read : Read Ethernet PHY Register.

Provides the typedef for the register read function ARM_ETH_MAC_PHY_Read.

Parameter for:

- ARM_ETH_PHY_Initialize

ARM_ETH_PHY_Write_t

Pointer to ARM_ETH_MAC_PHY_Write : Write Ethernet PHY Register.

Provides the typedef for the register write function ARM_ETH_MAC_PHY_Write.

Parameter for:

- ARM_ETH_PHY_Initialize

## Function Documentation

ARM_ETH_LINK_INFO ARM_ETH_PHY_GetLinkInfo | ( | void |  | ) |

Get Ethernet PHY Device Link information.

Returns
  current link parameters ARM_ETH_LINK_INFO

The function ARM_ETH_PHY_GetLinkInfo retrieves information about the current established communication mode (half/full duplex) and communication speed.

Example:

- see Ethernet Interface - Driver Functions

ARM_ETH_LINK_STATE ARM_ETH_PHY_GetLinkState | ( | void |  | ) |

Get Ethernet PHY Device Link state.

Returns
  current link status ARM_ETH_LINK_STATE

The function ARM_ETH_PHY_GetLinkState retrieves the connection status of the physical Ethernet link.

Example:

- see Ethernet Interface - Driver Functions

ARM_DRIVER_VERSION ARM_ETH_PHY_GetVersion | ( | void |  | ) |

Get driver version.

Returns
  ARM_DRIVER_VERSION

Returns version information of the driver implementation in ARM_DRIVER_VERSION

- API version is the version of the CMSIS-Driver specification used to implement this driver.
- Driver version is source code version of the actual driver implementation.

Example:

extern ARM_DRIVER_ETH_PHY Driver_ETH_PHY0;
ARM_DRIVER_ETH_PHY *drv_info;
void setup_ethernet_phy (void) {
ARM_DRIVER_VERSION version;
drv_info = &Driver_ETH_PHY0;
version = drv_info->GetVersion ();
if (version.api < 0x10A) { // requires at minimum API version 1.10 or higher
// error handling
return;
}
}

int32_t ARM_ETH_PHY_Initialize | ( | ARM_ETH_PHY_Read_t | fn_read,
|  | ARM_ETH_PHY_Write_t | fn_write
| ) |  |

Initialize Ethernet PHY Device.

Parameters

  [in] | fn_read | Pointer to ARM_ETH_MAC_PHY_Read
  [in] | fn_write | Pointer to ARM_ETH_MAC_PHY_Write

Returns
  Status Error Codes

The function ARM_ETH_PHY_Initialize initializes the Ethernet PHY interface. It is called when the middleware component starts operation.

The ARM_ETH_PHY_Initialize function performs the following operations:

- Initializes the resources needed for Ethernet PHY peripheral.
- Registers the ARM_ETH_MAC_PHY_Read register read access function.
- Registers the ARM_ETH_MAC_PHY_Write register write access function.

Example:

- see Ethernet Interface - Driver Functions

int32_t ARM_ETH_PHY_PowerControl | ( | ARM_POWER_STATE | state | ) |

Control Ethernet PHY Device Power.

Parameters

  [in] | state | Power state

Returns
  Status Error Codes

Allows you to control the power modes of the Ethernet PHY interface.

state can be:

- ARM_POWER_OFF: Ethernet PHY peripheral is turned off.
- ARM_POWER_FULL: Ethernet PHY peripheral is turned on and fully operational.
- ARM_POWER_LOW: Ethernet PHY peripheral is in low power mode.

If state specifies an unsupported mode, the function returns ARM_DRIVER_ERROR_UNSUPPORTED.

Example:

- see Ethernet Interface - Driver Functions

int32_t ARM_ETH_PHY_SetInterface | ( | uint32_t | interface | ) |

Set Ethernet Media Interface.

Parameters

  [in] | interface | Media Interface type

Returns
  Status Error Codes

The function ARM_ETH_PHY_SetInterface specifies the Media Independent Interface type (ARM_ETH_INTERFACE_xxx) that is used by the interface between Ethernet MAC and Ethernet PHY. The Media Independent Interface type is obtained by the function ARM_ETH_MAC_GetCapabilities.

Example:

- see Ethernet Interface - Driver Functions

int32_t ARM_ETH_PHY_SetMode | ( | uint32_t | mode | ) |

Set Ethernet PHY Device Operation mode.

Parameters

  [in] | mode | Operation Mode

Returns
  Status Error Codes

The function ARM_ETH_PHY_SetMode defines the operation mode of the Ethernet PHY.

Example:

- see Ethernet Interface - Driver Functions

Mode configuration parameters specify bits for speed modes, link modes, checksum, and frame handling.

Mode Parameters: Mode Bits | Description
--- | ---
ARM_ETH_PHY_SPEED_10M | Set the link speed to 10 Mbps
ARM_ETH_PHY_SPEED_100M | Set the link speed to 100 Mbps
ARM_ETH_PHY_SPEED_1G | Set the link speed to 1 Gbps
ARM_ETH_PHY_DUPLEX_HALF | Set the link mode to half duplex link
ARM_ETH_PHY_DUPLEX_FULL | Set the link mode to full duplex link
ARM_ETH_PHY_AUTO_NEGOTIATE | Set the interface to Auto Negotiation mode
ARM_ETH_PHY_LOOPBACK | Set the interface into a Loop-back test mode
ARM_ETH_PHY_ISOLATE | Isolate the PHY interface from MII interface

int32_t ARM_ETH_PHY_Uninitialize | ( | void |  | ) |

De-initialize Ethernet PHY Device.

Returns
  Status Error Codes

The function ARM_ETH_PHY_Uninitialize de-initializes the resources of Ethernet PHY interface.

It is called when the middleware component stops operation and releases the software resources used by the interface.