Extended Peripheral Peripheral Control functions

SMARTCARD control functions. More...

Functions
HAL_StatusTypeDef	HAL_SMARTCARDEx_EnableFifoMode (SMARTCARD_HandleTypeDef *hsmartcard)
	Enable the FIFO mode. More...
HAL_StatusTypeDef	HAL_SMARTCARDEx_DisableFifoMode (SMARTCARD_HandleTypeDef *hsmartcard)
	Disable the FIFO mode. More...
HAL_StatusTypeDef	HAL_SMARTCARDEx_SetTxFifoThreshold (SMARTCARD_HandleTypeDef *hsmartcard, uint32_t Threshold)
	Set the TXFIFO threshold. More...
HAL_StatusTypeDef	HAL_SMARTCARDEx_SetRxFifoThreshold (SMARTCARD_HandleTypeDef *hsmartcard, uint32_t Threshold)
	Set the RXFIFO threshold. More...

Detailed Description

SMARTCARD control functions.

 ===============================================================================
                      ##### Peripheral Control functions #####
 ===============================================================================
    [..]
    This subsection provides a set of functions allowing to control the SMARTCARD.
     (+) HAL_SMARTCARDEx_EnableFifoMode() API enables the FIFO mode
     (+) HAL_SMARTCARDEx_DisableFifoMode() API disables the FIFO mode
     (+) HAL_SMARTCARDEx_SetTxFifoThreshold() API sets the TX FIFO threshold
     (+) HAL_SMARTCARDEx_SetRxFifoThreshold() API sets the RX FIFO threshold

Function Documentation

HAL_SMARTCARDEx_DisableFifoMode()

HAL_StatusTypeDef HAL_SMARTCARDEx_DisableFifoMode

(

SMARTCARD_HandleTypeDef *

hsmartcard

)

Disable the FIFO mode.

Parameters

hsmartcard

SMARTCARD handle.

Return values

HAL

status

Definition at line 302 of file stm32l4xx_hal_smartcard_ex.c.

{
  uint32_t tmpcr1;

  /* Check parameters */
  assert_param(IS_UART_FIFO_INSTANCE(hsmartcard->Instance));

  /* Process Locked */
  __HAL_LOCK(hsmartcard);

  hsmartcard->gState = HAL_SMARTCARD_STATE_BUSY;

  /* Save actual SMARTCARD configuration */
  tmpcr1 = READ_REG(hsmartcard->Instance->CR1);

  /* Disable SMARTCARD */
  __HAL_SMARTCARD_DISABLE(hsmartcard);

  /* Enable FIFO mode */
  CLEAR_BIT(tmpcr1, USART_CR1_FIFOEN);
  hsmartcard->FifoMode = SMARTCARD_FIFOMODE_DISABLE;

  /* Restore SMARTCARD configuration */
  WRITE_REG(hsmartcard->Instance->CR1, tmpcr1);

  hsmartcard->gState = HAL_SMARTCARD_STATE_READY;

  /* Process Unlocked */
  __HAL_UNLOCK(hsmartcard);

  return HAL_OK;
}

HAL_SMARTCARDEx_EnableFifoMode()

HAL_StatusTypeDef HAL_SMARTCARDEx_EnableFifoMode

(

SMARTCARD_HandleTypeDef *

hsmartcard

)

Enable the FIFO mode.

Parameters

hsmartcard

SMARTCARD handle.

Return values

HAL

status

Definition at line 261 of file stm32l4xx_hal_smartcard_ex.c.

{
  uint32_t tmpcr1;

  /* Check parameters */
  assert_param(IS_UART_FIFO_INSTANCE(hsmartcard->Instance));

  /* Process Locked */
  __HAL_LOCK(hsmartcard);

  hsmartcard->gState = HAL_SMARTCARD_STATE_BUSY;

  /* Save actual SMARTCARD configuration */
  tmpcr1 = READ_REG(hsmartcard->Instance->CR1);

  /* Disable SMARTCARD */
  __HAL_SMARTCARD_DISABLE(hsmartcard);

  /* Enable FIFO mode */
  SET_BIT(tmpcr1, USART_CR1_FIFOEN);
  hsmartcard->FifoMode = SMARTCARD_FIFOMODE_ENABLE;

  /* Restore SMARTCARD configuration */
  WRITE_REG(hsmartcard->Instance->CR1, tmpcr1);

  /* Determine the number of data to process during RX/TX ISR execution */
  SMARTCARDEx_SetNbDataToProcess(hsmartcard);

  hsmartcard->gState = HAL_SMARTCARD_STATE_READY;

  /* Process Unlocked */
  __HAL_UNLOCK(hsmartcard);

  return HAL_OK;
}

HAL_SMARTCARDEx_SetRxFifoThreshold()

HAL_StatusTypeDef HAL_SMARTCARDEx_SetRxFifoThreshold	(	SMARTCARD_HandleTypeDef *	hsmartcard,
		uint32_t	Threshold
	)

Set the RXFIFO threshold.

Parameters

hsmartcard	SMARTCARD handle.
Threshold	RX FIFO threshold value This parameter can be one of the following values: SMARTCARD_RXFIFO_THRESHOLD_1_8 SMARTCARD_RXFIFO_THRESHOLD_1_4 SMARTCARD_RXFIFO_THRESHOLD_1_2 SMARTCARD_RXFIFO_THRESHOLD_3_4 SMARTCARD_RXFIFO_THRESHOLD_7_8 SMARTCARD_RXFIFO_THRESHOLD_8_8

Return values

HAL

status

Definition at line 397 of file stm32l4xx_hal_smartcard_ex.c.

{
  uint32_t tmpcr1;

  /* Check parameters */
  assert_param(IS_UART_FIFO_INSTANCE(hsmartcard->Instance));
  assert_param(IS_SMARTCARD_RXFIFO_THRESHOLD(Threshold));

  /* Process Locked */
  __HAL_LOCK(hsmartcard);

  hsmartcard->gState = HAL_SMARTCARD_STATE_BUSY;

  /* Save actual SMARTCARD configuration */
  tmpcr1 = READ_REG(hsmartcard->Instance->CR1);

  /* Disable SMARTCARD */
  __HAL_SMARTCARD_DISABLE(hsmartcard);

  /* Update RX threshold configuration */
  MODIFY_REG(hsmartcard->Instance->CR3, USART_CR3_RXFTCFG, Threshold);

  /* Determine the number of data to process during RX/TX ISR execution */
  SMARTCARDEx_SetNbDataToProcess(hsmartcard);

  /* Restore SMARTCARD configuration */
  MODIFY_REG(hsmartcard->Instance->CR1, USART_CR1_UE, tmpcr1);

  hsmartcard->gState = HAL_SMARTCARD_STATE_READY;

  /* Process Unlocked */
  __HAL_UNLOCK(hsmartcard);

  return HAL_OK;
}

HAL_SMARTCARDEx_SetTxFifoThreshold()

HAL_StatusTypeDef HAL_SMARTCARDEx_SetTxFifoThreshold	(	SMARTCARD_HandleTypeDef *	hsmartcard,
		uint32_t	Threshold
	)

Set the TXFIFO threshold.

Parameters

hsmartcard	SMARTCARD handle.
Threshold	TX FIFO threshold value This parameter can be one of the following values: SMARTCARD_TXFIFO_THRESHOLD_1_8 SMARTCARD_TXFIFO_THRESHOLD_1_4 SMARTCARD_TXFIFO_THRESHOLD_1_2 SMARTCARD_TXFIFO_THRESHOLD_3_4 SMARTCARD_TXFIFO_THRESHOLD_7_8 SMARTCARD_TXFIFO_THRESHOLD_8_8

Return values

HAL

status

Definition at line 348 of file stm32l4xx_hal_smartcard_ex.c.

{
  uint32_t tmpcr1;

  /* Check parameters */
  assert_param(IS_UART_FIFO_INSTANCE(hsmartcard->Instance));
  assert_param(IS_SMARTCARD_TXFIFO_THRESHOLD(Threshold));

  /* Process Locked */
  __HAL_LOCK(hsmartcard);

  hsmartcard->gState = HAL_SMARTCARD_STATE_BUSY;

  /* Save actual SMARTCARD configuration */
  tmpcr1 = READ_REG(hsmartcard->Instance->CR1);

  /* Disable SMARTCARD */
  __HAL_SMARTCARD_DISABLE(hsmartcard);

  /* Update TX threshold configuration */
  MODIFY_REG(hsmartcard->Instance->CR3, USART_CR3_TXFTCFG, Threshold);

  /* Determine the number of data to process during RX/TX ISR execution */
  SMARTCARDEx_SetNbDataToProcess(hsmartcard);

  /* Restore SMARTCARD configuration */
  MODIFY_REG(hsmartcard->Instance->CR1, USART_CR1_UE, tmpcr1);

  hsmartcard->gState = HAL_SMARTCARD_STATE_READY;

  /* Process Unlocked */
  __HAL_UNLOCK(hsmartcard);

  return HAL_OK;
}