Extended Peripheral Control functions. More...

Functions
HAL_StatusTypeDef	HAL_USARTEx_EnableSlaveMode (USART_HandleTypeDef *husart)
	Enable the SPI slave mode.
HAL_StatusTypeDef	HAL_USARTEx_DisableSlaveMode (USART_HandleTypeDef *husart)
	Disable the SPI slave mode.
HAL_StatusTypeDef	HAL_USARTEx_ConfigNSS (USART_HandleTypeDef *husart, uint32_t NSSConfig)
	Configure the Slave Select input pin (NSS).
HAL_StatusTypeDef	HAL_USARTEx_EnableFifoMode (USART_HandleTypeDef *husart)
	Enable the FIFO mode.
HAL_StatusTypeDef	HAL_USARTEx_DisableFifoMode (USART_HandleTypeDef *husart)
	Disable the FIFO mode.
HAL_StatusTypeDef	HAL_USARTEx_SetTxFifoThreshold (USART_HandleTypeDef *husart, uint32_t Threshold)
	Set the TXFIFO threshold.
HAL_StatusTypeDef	HAL_USARTEx_SetRxFifoThreshold (USART_HandleTypeDef *husart, uint32_t Threshold)
	Set the RXFIFO threshold.

Detailed Description

Extended Peripheral Control functions.

 ===============================================================================
                      ##### Peripheral Control functions #####
 ===============================================================================
    [..] This section provides the following functions:
     (+) HAL_USARTEx_EnableSPISlaveMode() API enables the SPI slave mode
     (+) HAL_USARTEx_DisableSPISlaveMode() API disables the SPI slave mode
     (+) HAL_USARTEx_ConfigNSS API configures the Slave Select input pin (NSS)
     (+) HAL_USARTEx_EnableFifoMode() API enables the FIFO mode
     (+) HAL_USARTEx_DisableFifoMode() API disables the FIFO mode
     (+) HAL_USARTEx_SetTxFifoThreshold() API sets the TX FIFO threshold
     (+) HAL_USARTEx_SetRxFifoThreshold() API sets the RX FIFO threshold

Function Documentation

HAL_StatusTypeDef HAL_USARTEx_ConfigNSS	(	USART_HandleTypeDef *	husart,
		uint32_t	NSSConfig
	)

Configure the Slave Select input pin (NSS).

Note:: Software NSS management: SPI slave will always be selected and NSS input pin will be ignored.; Hardware NSS management: the SPI slave selection depends on NSS input pin. The slave is selected when NSS is low and deselected when NSS is high.

Parameters:

husart	USART handle.
NSSConfig	NSS configuration. This parameter can be one of the following values: USART_NSS_HARD USART_NSS_SOFT

Return values:

HAL status

Definition at line 270 of file stm32h7xx_hal_usart_ex.c.

References __HAL_USART_DISABLE, assert_param, HAL_USART_STATE_BUSY, HAL_USART_STATE_READY, __USART_HandleTypeDef::Instance, IS_USART_NSS, and __USART_HandleTypeDef::State.

HAL_StatusTypeDef HAL_USARTEx_DisableFifoMode ( USART_HandleTypeDef * husart )

Disable the FIFO mode.

Parameters:

husart USART handle.

Return values:

HAL status

Definition at line 349 of file stm32h7xx_hal_usart_ex.c.

References __HAL_USART_DISABLE, assert_param, __USART_HandleTypeDef::FifoMode, HAL_USART_STATE_BUSY, HAL_USART_STATE_READY, __USART_HandleTypeDef::Instance, __USART_HandleTypeDef::State, and USART_FIFOMODE_DISABLE.

HAL_StatusTypeDef HAL_USARTEx_DisableSlaveMode ( USART_HandleTypeDef * husart )

Disable the SPI slave mode.

Parameters:

husart USART handle.

Return values:

HAL status

Definition at line 222 of file stm32h7xx_hal_usart_ex.c.

References __HAL_USART_DISABLE, assert_param, HAL_USART_STATE_BUSY, HAL_USART_STATE_READY, __USART_HandleTypeDef::Instance, __USART_HandleTypeDef::SlaveMode, __USART_HandleTypeDef::State, and USART_SLAVEMODE_DISABLE.

HAL_StatusTypeDef HAL_USARTEx_EnableFifoMode ( USART_HandleTypeDef * husart )

Enable the FIFO mode.

Parameters:

husart USART handle.

Return values:

HAL status

Definition at line 308 of file stm32h7xx_hal_usart_ex.c.

References __HAL_USART_DISABLE, assert_param, __USART_HandleTypeDef::FifoMode, HAL_USART_STATE_BUSY, HAL_USART_STATE_READY, __USART_HandleTypeDef::Instance, __USART_HandleTypeDef::State, USART_FIFOMODE_ENABLE, and USARTEx_SetNbDataToProcess().

HAL_StatusTypeDef HAL_USARTEx_EnableSlaveMode ( USART_HandleTypeDef * husart )

Enable the SPI slave mode.

Note:: When the USART operates in SPI slave mode, it handles data flow using the serial interface clock derived from the external SCLK signal provided by the external master SPI device.; In SPI slave mode, the USART must be enabled before starting the master communications (or between frames while the clock is stable). Otherwise, if the USART slave is enabled while the master is in the middle of a frame, it will become desynchronized with the master.; The data register of the slave needs to be ready before the first edge of the communication clock or before the end of the ongoing communication, otherwise the SPI slave will transmit zeros.

Parameters:

husart USART handle.

Return values:

HAL status

Definition at line 174 of file stm32h7xx_hal_usart_ex.c.

References __HAL_USART_DISABLE, __HAL_USART_ENABLE, assert_param, HAL_USART_STATE_BUSY, HAL_USART_STATE_READY, __USART_HandleTypeDef::Instance, __USART_HandleTypeDef::SlaveMode, __USART_HandleTypeDef::State, and USART_SLAVEMODE_ENABLE.

HAL_StatusTypeDef HAL_USARTEx_SetRxFifoThreshold	(	USART_HandleTypeDef *	husart,
		uint32_t	Threshold
	)

Set the RXFIFO threshold.

Parameters:

husart	USART handle.
Threshold	RX FIFO threshold value This parameter can be one of the following values: USART_RXFIFO_THRESHOLD_1_8 USART_RXFIFO_THRESHOLD_1_4 USART_RXFIFO_THRESHOLD_1_2 USART_RXFIFO_THRESHOLD_3_4 USART_RXFIFO_THRESHOLD_7_8 USART_RXFIFO_THRESHOLD_8_8

Return values:

HAL status

Definition at line 444 of file stm32h7xx_hal_usart_ex.c.

References __HAL_USART_DISABLE, assert_param, HAL_USART_STATE_BUSY, HAL_USART_STATE_READY, __USART_HandleTypeDef::Instance, IS_USART_RXFIFO_THRESHOLD, __USART_HandleTypeDef::State, and USARTEx_SetNbDataToProcess().

HAL_StatusTypeDef HAL_USARTEx_SetTxFifoThreshold	(	USART_HandleTypeDef *	husart,
		uint32_t	Threshold
	)

Set the TXFIFO threshold.

Parameters:

husart	USART handle.
Threshold	TX FIFO threshold value This parameter can be one of the following values: USART_TXFIFO_THRESHOLD_1_8 USART_TXFIFO_THRESHOLD_1_4 USART_TXFIFO_THRESHOLD_1_2 USART_TXFIFO_THRESHOLD_3_4 USART_TXFIFO_THRESHOLD_7_8 USART_TXFIFO_THRESHOLD_8_8

Return values:

HAL status

Definition at line 395 of file stm32h7xx_hal_usart_ex.c.

References __HAL_USART_DISABLE, assert_param, HAL_USART_STATE_BUSY, HAL_USART_STATE_READY, __USART_HandleTypeDef::Instance, IS_USART_TXFIFO_THRESHOLD, __USART_HandleTypeDef::State, and USARTEx_SetNbDataToProcess().

Functions

Detailed Description

Function Documentation