ETH HAL module driver. This file provides firmware functions to manage the following functionalities of the Ethernet (ETH) peripheral: More...
#include "stm32h7xx_hal.h"
Detailed Description

ETH HAL module driver. This file provides firmware functions to manage the following functionalities of the Ethernet (ETH) peripheral:
Author
MCD Application Team
Initialization and deinitialization functions
IO operation functions
Peripheral Control functions
Peripheral State and Errors functions
Attention
This software is licensed under terms that can be found in the LICENSE file in the root directory of this software component. If no LICENSE file comes with this software, it is provided AS-IS.
==============================================================================
                  ##### How to use this driver #####
==============================================================================
   [..]
   The ETH HAL driver can be used as follows:

    (#)Declare a ETH_HandleTypeDef handle structure, for example:
       ETH_HandleTypeDef  heth;

    (#)Fill parameters of Init structure in heth handle

    (#)Call HAL_ETH_Init() API to initialize the Ethernet peripheral (MAC, DMA, ...)

    (#)Initialize the ETH low level resources through the HAL_ETH_MspInit() API:
        (##) Enable the Ethernet interface clock using
              (+++)  __HAL_RCC_ETH1MAC_CLK_ENABLE()
              (+++)  __HAL_RCC_ETH1TX_CLK_ENABLE()
              (+++)  __HAL_RCC_ETH1RX_CLK_ENABLE()

        (##) Initialize the related GPIO clocks
        (##) Configure Ethernet pinout
        (##) Configure Ethernet NVIC interrupt (in Interrupt mode)

    (#) Ethernet data reception is asynchronous, so call the following API
        to start the listening mode:
        (##) HAL_ETH_Start():
             This API starts the MAC and DMA transmission and reception process,
             without enabling end of transfer interrupts, in this mode user
             has to poll for data reception by calling HAL_ETH_ReadData()
        (##) HAL_ETH_Start_IT():
             This API starts the MAC and DMA transmission and reception process,
             end of transfer interrupts are enabled in this mode,
             HAL_ETH_RxCpltCallback() will be executed when an Ethernet packet is received

    (#) When data is received user can call the following API to get received data:
        (##) HAL_ETH_ReadData(): Read a received packet

    (#) For transmission path, two APIs are available:
       (##) HAL_ETH_Transmit(): Transmit an ETH frame in blocking mode
       (##) HAL_ETH_Transmit_IT(): Transmit an ETH frame in interrupt mode,
            HAL_ETH_TxCpltCallback() will be executed when end of transfer occur

    (#) Communication with an external PHY device:
       (##) HAL_ETH_ReadPHYRegister(): Read a register from an external PHY
       (##) HAL_ETH_WritePHYRegister(): Write data to an external RHY register

    (#) Configure the Ethernet MAC after ETH peripheral initialization
        (##) HAL_ETH_GetMACConfig(): Get MAC actual configuration into ETH_MACConfigTypeDef
        (##) HAL_ETH_SetMACConfig(): Set MAC configuration based on ETH_MACConfigTypeDef

    (#) Configure the Ethernet DMA after ETH peripheral initialization
        (##) HAL_ETH_GetDMAConfig(): Get DMA actual configuration into ETH_DMAConfigTypeDef
        (##) HAL_ETH_SetDMAConfig(): Set DMA configuration based on ETH_DMAConfigTypeDef

    (#) Configure the Ethernet PTP after ETH peripheral initialization
        (##) Define HAL_ETH_USE_PTP to use PTP APIs.
        (##) HAL_ETH_PTP_GetConfig(): Get PTP actual configuration into ETH_PTP_ConfigTypeDef
        (##) HAL_ETH_PTP_SetConfig(): Set PTP configuration based on ETH_PTP_ConfigTypeDef
        (##) HAL_ETH_PTP_GetTime(): Get Seconds and Nanoseconds for the Ethernet PTP registers
        (##) HAL_ETH_PTP_SetTime(): Set Seconds and Nanoseconds for the Ethernet PTP registers
        (##) HAL_ETH_PTP_AddTimeOffset(): Add Seconds and Nanoseconds offset for the Ethernet PTP registers
        (##) HAL_ETH_PTP_InsertTxTimestamp(): Insert Timestamp in transmission
        (##) HAL_ETH_PTP_GetTxTimestamp(): Get transmission timestamp
        (##) HAL_ETH_PTP_GetRxTimestamp(): Get reception timestamp

    -@- The ARP offload feature is not supported in this driver.

    -@- The PTP offload feature is not supported in this driver.

*** Callback registration ***
=============================================

The compilation define  USE_HAL_ETH_REGISTER_CALLBACKS when set to 1
allows the user to configure dynamically the driver callbacks.
Use Function HAL_ETH_RegisterCallback() to register an interrupt callback.

Function HAL_ETH_RegisterCallback() allows to register following callbacks:
  (+) TxCpltCallback   : Tx Complete Callback.
  (+) RxCpltCallback   : Rx Complete Callback.
  (+) ErrorCallback    : Error Callback.
  (+) PMTCallback      : Power Management Callback
  (+) EEECallback      : EEE Callback.
  (+) WakeUpCallback   : Wake UP Callback
  (+) MspInitCallback  : MspInit Callback.
  (+) MspDeInitCallback: MspDeInit Callback.

This function takes as parameters the HAL peripheral handle, the Callback ID
and a pointer to the user callback function.

For specific callbacks RxAllocateCallback use dedicated register callbacks:
respectively HAL_ETH_RegisterRxAllocateCallback().

For specific callbacks RxLinkCallback use dedicated register callbacks:
respectively HAL_ETH_RegisterRxLinkCallback().

For specific callbacks TxFreeCallback use dedicated register callbacks:
respectively HAL_ETH_RegisterTxFreeCallback().

For specific callbacks TxPtpCallback use dedicated register callbacks:
respectively HAL_ETH_RegisterTxPtpCallback().

Use function HAL_ETH_UnRegisterCallback() to reset a callback to the default
weak function.
HAL_ETH_UnRegisterCallback takes as parameters the HAL peripheral handle,
and the Callback ID.
This function allows to reset following callbacks:
  (+) TxCpltCallback   : Tx Complete Callback.
  (+) RxCpltCallback   : Rx Complete Callback.
  (+) ErrorCallback    : Error Callback.
  (+) PMTCallback      : Power Management Callback
  (+) EEECallback      : EEE Callback.
  (+) WakeUpCallback   : Wake UP Callback
  (+) MspInitCallback  : MspInit Callback.
  (+) MspDeInitCallback: MspDeInit Callback.

For specific callbacks RxAllocateCallback use dedicated unregister callbacks:
respectively HAL_ETH_UnRegisterRxAllocateCallback().

For specific callbacks RxLinkCallback use dedicated unregister callbacks:
respectively HAL_ETH_UnRegisterRxLinkCallback().

For specific callbacks TxFreeCallback use dedicated unregister callbacks:
respectively HAL_ETH_UnRegisterTxFreeCallback().

For specific callbacks TxPtpCallback use dedicated unregister callbacks:
respectively HAL_ETH_UnRegisterTxPtpCallback().

By default, after the HAL_ETH_Init and when the state is HAL_ETH_STATE_RESET
all callbacks are set to the corresponding weak functions:
examples HAL_ETH_TxCpltCallback(), HAL_ETH_RxCpltCallback().
Exception done for MspInit and MspDeInit functions that are
reset to the legacy weak function in the HAL_ETH_Init/ HAL_ETH_DeInit only when
these callbacks are null (not registered beforehand).
if not, MspInit or MspDeInit are not null, the HAL_ETH_Init/ HAL_ETH_DeInit
keep and use the user MspInit/MspDeInit callbacks (registered beforehand)

Callbacks can be registered/unregistered in HAL_ETH_STATE_READY state only.
Exception done MspInit/MspDeInit that can be registered/unregistered
in HAL_ETH_STATE_READY or HAL_ETH_STATE_RESET state,
thus registered (user) MspInit/DeInit callbacks can be used during the Init/DeInit.
In that case first register the MspInit/MspDeInit user callbacks
using HAL_ETH_RegisterCallback() before calling HAL_ETH_DeInit
or HAL_ETH_Init function.

When The compilation define USE_HAL_ETH_REGISTER_CALLBACKS is set to 0 or
not defined, the callback registration feature is not available and all callbacks
are set to the corresponding weak functions.