SWPMI Private Functions

Functions
static void	SWPMI_Transmit_IT (SWPMI_HandleTypeDef *hswpmi)
	Transmit an amount of data in interrupt mode. More...
static void	SWPMI_EndTransmit_IT (SWPMI_HandleTypeDef *hswpmi)
	Wraps up transmission in non-blocking mode. More...
static void	SWPMI_Receive_IT (SWPMI_HandleTypeDef *hswpmi)
	Receive an amount of data in interrupt mode. More...
static void	SWPMI_EndReceive_IT (SWPMI_HandleTypeDef *hswpmi)
	Wraps up reception in non-blocking mode. More...
static void	SWPMI_EndTransmitReceive_IT (SWPMI_HandleTypeDef *hswpmi)
	Wraps up transmission and reception in non-blocking mode. More...
static void	SWPMI_DMATransmitCplt (DMA_HandleTypeDef *hdma)
	DMA SWPMI transmit process complete callback. More...
static void	SWPMI_DMATxHalfCplt (DMA_HandleTypeDef *hdma)
	DMA SWPMI transmit process half complete callback. More...
static void	SWPMI_DMAReceiveCplt (DMA_HandleTypeDef *hdma)
	DMA SWPMI receive process complete callback. More...
static void	SWPMI_DMARxHalfCplt (DMA_HandleTypeDef *hdma)
	DMA SWPMI receive process half complete callback. More...
static void	SWPMI_DMAError (DMA_HandleTypeDef *hdma)
	DMA SWPMI communication error callback. More...
static void	SWPMI_DMAAbortOnError (DMA_HandleTypeDef *hdma)
	DMA SWPMI communication abort callback. More...
static HAL_StatusTypeDef	SWPMI_WaitOnFlagSetUntilTimeout (SWPMI_HandleTypeDef *hswpmi, uint32_t Flag, uint32_t Tickstart, uint32_t Timeout)
	Handle SWPMI Communication Timeout. More...

Detailed Description

Function Documentation

SWPMI_DMAAbortOnError()

static void SWPMI_DMAAbortOnError ( DMA_HandleTypeDef *  hdma )

static

DMA SWPMI communication abort callback.

Parameters

hdma	DMA handle

Return values

None

Definition at line 1880 of file stm32l4xx_hal_swpmi.c.

{
  SWPMI_HandleTypeDef* hswpmi = ( SWPMI_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;

  /* Update handle */
  hswpmi->RxXferCount = 0U;
  hswpmi->TxXferCount = 0U;
  hswpmi->State= HAL_SWPMI_STATE_READY;

#if (USE_HAL_SWPMI_REGISTER_CALLBACKS == 1)
  hswpmi->ErrorCallback(hswpmi);
#else
  HAL_SWPMI_ErrorCallback(hswpmi);
#endif
}

SWPMI_DMAError()

static void SWPMI_DMAError ( DMA_HandleTypeDef *  hdma )

static

DMA SWPMI communication error callback.

Parameters

hdma	DMA handle

Return values

None

Definition at line 1858 of file stm32l4xx_hal_swpmi.c.

{
  SWPMI_HandleTypeDef* hswpmi = ( SWPMI_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;

  /* Update handle */
  hswpmi->RxXferCount = 0U;
  hswpmi->TxXferCount = 0U;
  hswpmi->State= HAL_SWPMI_STATE_READY;
  hswpmi->ErrorCode |= HAL_SWPMI_ERROR_DMA;

#if (USE_HAL_SWPMI_REGISTER_CALLBACKS == 1)
  hswpmi->ErrorCallback(hswpmi);
#else
  HAL_SWPMI_ErrorCallback(hswpmi);
#endif
}

SWPMI_DMAReceiveCplt()

static void SWPMI_DMAReceiveCplt ( DMA_HandleTypeDef *  hdma )

static

DMA SWPMI receive process complete callback.

Parameters

hdma	DMA handle

Return values

None

Definition at line 1807 of file stm32l4xx_hal_swpmi.c.

{
  SWPMI_HandleTypeDef* hswpmi = ( SWPMI_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;

  /* DMA Normal mode*/
  if((hdma->Instance->CCR & DMA_CCR_CIRC) == 0U)
  {
    hswpmi->RxXferCount = 0U;

    /* Disable the DMA transfer for the receiver request by setting the RXDMA bit
    in the SWPMI CR register */
    CLEAR_BIT(hswpmi->Instance->CR, SWPMI_CR_RXDMA);

    /* Check if a transmit Process is ongoing or not */
    if(hswpmi->State == HAL_SWPMI_STATE_BUSY_TX_RX)
    {
      hswpmi->State = HAL_SWPMI_STATE_BUSY_TX;
    }
    else
    {
      hswpmi->State = HAL_SWPMI_STATE_READY;
    }
  }
#if (USE_HAL_SWPMI_REGISTER_CALLBACKS == 1)
  hswpmi->RxCpltCallback(hswpmi);
#else
  HAL_SWPMI_RxCpltCallback(hswpmi);
#endif
}

SWPMI_DMARxHalfCplt()

static void SWPMI_DMARxHalfCplt ( DMA_HandleTypeDef *  hdma )

static

DMA SWPMI receive process half complete callback.

Parameters

hdma	DMA handle

Return values

None

Definition at line 1842 of file stm32l4xx_hal_swpmi.c.

{
  SWPMI_HandleTypeDef* hswpmi = (SWPMI_HandleTypeDef*)((DMA_HandleTypeDef*)hdma)->Parent;

#if (USE_HAL_SWPMI_REGISTER_CALLBACKS == 1)
  hswpmi->RxHalfCpltCallback(hswpmi);
#else
  HAL_SWPMI_RxHalfCpltCallback(hswpmi);
#endif
}

SWPMI_DMATransmitCplt()

static void SWPMI_DMATransmitCplt ( DMA_HandleTypeDef *  hdma )

static

DMA SWPMI transmit process complete callback.

Parameters

hdma	DMA handle

Return values

None

Definition at line 1725 of file stm32l4xx_hal_swpmi.c.

{
  SWPMI_HandleTypeDef* hswpmi = ( SWPMI_HandleTypeDef* )((DMA_HandleTypeDef* )hdma)->Parent;
  uint32_t tickstart;

  /* DMA Normal mode*/
  if((hdma->Instance->CCR & DMA_CCR_CIRC) == 0U)
  {
    hswpmi->TxXferCount = 0U;

    /* Disable the DMA transfer for transmit request by setting the TXDMA bit
    in the SWPMI CR register */
    CLEAR_BIT(hswpmi->Instance->CR, SWPMI_CR_TXDMA);

    /* Init tickstart for timeout managment*/
    tickstart = HAL_GetTick();

    /* Wait the TXBEF */
    if(SWPMI_WaitOnFlagSetUntilTimeout(hswpmi, SWPMI_FLAG_TXBEF, tickstart, SWPMI_TIMEOUT_VALUE) != HAL_OK)
    {
      /* Timeout occurred */
      hswpmi->ErrorCode |= HAL_SWPMI_ERROR_TXBEF_TIMEOUT;

#if (USE_HAL_SWPMI_REGISTER_CALLBACKS == 1)
      hswpmi->ErrorCallback(hswpmi);
#else
      HAL_SWPMI_ErrorCallback(hswpmi);
#endif
    }
    else
    {
      /* No Timeout */
      /* Check if a receive process is ongoing or not */
      if(hswpmi->State == HAL_SWPMI_STATE_BUSY_TX_RX)
      {
        hswpmi->State = HAL_SWPMI_STATE_BUSY_RX;
      }
      else
      {
        hswpmi->State = HAL_SWPMI_STATE_READY;
      }

#if (USE_HAL_SWPMI_REGISTER_CALLBACKS == 1)
      hswpmi->TxCpltCallback(hswpmi);
#else
      HAL_SWPMI_TxCpltCallback(hswpmi);
#endif
    }
  }
  /* DMA Circular mode */
  else
  {
#if (USE_HAL_SWPMI_REGISTER_CALLBACKS == 1)
    hswpmi->TxCpltCallback(hswpmi);
#else
    HAL_SWPMI_TxCpltCallback(hswpmi);
#endif
  }
}

SWPMI_DMATxHalfCplt()

static void SWPMI_DMATxHalfCplt ( DMA_HandleTypeDef *  hdma )

static

DMA SWPMI transmit process half complete callback.

Parameters

hdma	DMA handle

Return values

None

Definition at line 1790 of file stm32l4xx_hal_swpmi.c.

{
  SWPMI_HandleTypeDef* hswpmi = (SWPMI_HandleTypeDef*)((DMA_HandleTypeDef*)hdma)->Parent;

#if (USE_HAL_SWPMI_REGISTER_CALLBACKS == 1)
  hswpmi->TxHalfCpltCallback(hswpmi);
#else
  HAL_SWPMI_TxHalfCpltCallback(hswpmi);
#endif
}

SWPMI_EndReceive_IT()

static void SWPMI_EndReceive_IT ( SWPMI_HandleTypeDef *  hswpmi )

static

Wraps up reception in non-blocking mode.

Parameters

hswpmi

SWPMI handle

Return values

None

Definition at line 1675 of file stm32l4xx_hal_swpmi.c.

{
  /* Clear the SWPMI Receive buffer full Flag */
  WRITE_REG(hswpmi->Instance->ICR, SWPMI_FLAG_RXBFF);
  /* Disable the all SWPMI Receive Interrupts  */
  CLEAR_BIT(hswpmi->Instance->IER, SWPMI_IT_RIE | SWPMI_IT_RXBERIE | SWPMI_IT_RXOVRIE | SWPMI_IT_RXBFIE);

  /* Check if a transmit Process is ongoing or not */
  if(hswpmi->State == HAL_SWPMI_STATE_BUSY_TX_RX)
  {
    hswpmi->State = HAL_SWPMI_STATE_BUSY_TX;
  }
  else
  {
    hswpmi->State = HAL_SWPMI_STATE_READY;
  }
}

SWPMI_EndTransmit_IT()

static void SWPMI_EndTransmit_IT ( SWPMI_HandleTypeDef *  hswpmi )

static

Wraps up transmission in non-blocking mode.

Parameters

hswpmi

SWPMI handle

Return values

None

Definition at line 1614 of file stm32l4xx_hal_swpmi.c.

{
  /* Clear the SWPMI Transmit buffer empty Flag */
  WRITE_REG(hswpmi->Instance->ICR, SWPMI_FLAG_TXBEF);
  /* Disable the all SWPMI Transmit Interrupts  */
  CLEAR_BIT(hswpmi->Instance->IER, SWPMI_IT_TIE | SWPMI_IT_TXUNRIE | SWPMI_IT_TXBEIE);

  /* Check if a receive Process is ongoing or not */
  if(hswpmi->State == HAL_SWPMI_STATE_BUSY_TX_RX)
  {
    hswpmi->State = HAL_SWPMI_STATE_BUSY_RX;
  }
  else
  {
    hswpmi->State = HAL_SWPMI_STATE_READY;
  }

#if (USE_HAL_SWPMI_REGISTER_CALLBACKS == 1)
  hswpmi->TxCpltCallback(hswpmi);
#else
  HAL_SWPMI_TxCpltCallback(hswpmi);
#endif
}

SWPMI_EndTransmitReceive_IT()

static void SWPMI_EndTransmitReceive_IT ( SWPMI_HandleTypeDef *  hswpmi )

static

Wraps up transmission and reception in non-blocking mode.

Parameters

hswpmi

SWPMI handle

Return values

None

Definition at line 1698 of file stm32l4xx_hal_swpmi.c.

{
  /* Clear the SWPMI Transmission Complete Flag */
  WRITE_REG(hswpmi->Instance->ICR, SWPMI_FLAG_TCF);
  /* Disable the SWPMI Transmission  Complete Interrupt */
  CLEAR_BIT(hswpmi->Instance->IER, SWPMI_IT_TCIE);

  /* Check if a receive Process is ongoing or not */
  if(hswpmi->State == HAL_SWPMI_STATE_BUSY_TX_RX)
  {
    hswpmi->State = HAL_SWPMI_STATE_BUSY_RX;
  }
  else if(hswpmi->State == HAL_SWPMI_STATE_BUSY_TX)
  {
    hswpmi->State = HAL_SWPMI_STATE_READY;
  }
  else
  {
    /* nothing to do */
  }
}

SWPMI_Receive_IT()

static void SWPMI_Receive_IT ( SWPMI_HandleTypeDef *  hswpmi )

static

Receive an amount of data in interrupt mode.

Note

Function called under interruption only, once interruptions have been enabled by HAL_SWPMI_Receive_IT()

Parameters

hswpmi

SWPMI handle

Return values

None

Definition at line 1644 of file stm32l4xx_hal_swpmi.c.

{
  HAL_SWPMI_StateTypeDef tmp_state = hswpmi->State;

  if((tmp_state == HAL_SWPMI_STATE_BUSY_RX) || (tmp_state == HAL_SWPMI_STATE_BUSY_TX_RX))
  {
    *hswpmi->pRxBuffPtr = (uint32_t)(hswpmi->Instance->RDR);
    hswpmi->pRxBuffPtr++;

    --hswpmi->RxXferCount;
    if(hswpmi->RxXferCount == 0U)
    {
      /* Wait for RXBFF flag to update state */
#if (USE_HAL_SWPMI_REGISTER_CALLBACKS == 1)
      hswpmi->RxCpltCallback(hswpmi);
#else
      HAL_SWPMI_RxCpltCallback(hswpmi);
#endif
    }
  }
  else
  {
    /* nothing to do */
  }
}

SWPMI_Transmit_IT()

static void SWPMI_Transmit_IT ( SWPMI_HandleTypeDef *  hswpmi )

static

Transmit an amount of data in interrupt mode.

Note

Function called under interruption only, once interruptions have been enabled by HAL_SWPMI_Transmit_IT()

Parameters

hswpmi

SWPMI handle

Return values

None

Definition at line 1585 of file stm32l4xx_hal_swpmi.c.

{
  HAL_SWPMI_StateTypeDef tmp_state = hswpmi->State;

  if ((tmp_state == HAL_SWPMI_STATE_BUSY_TX) || (tmp_state == HAL_SWPMI_STATE_BUSY_TX_RX))
  {
    if(hswpmi->TxXferCount == 0U)
    {
      /* Disable the SWPMI TXE and Underrun Interrupts */
      CLEAR_BIT(hswpmi->Instance->IER, (SWPMI_IT_TIE | SWPMI_IT_TXUNRIE));
    }
    else
    {
      hswpmi->Instance->TDR = (uint32_t)*hswpmi->pTxBuffPtr;
      hswpmi->pTxBuffPtr++;
      hswpmi->TxXferCount--;
    }
  }
  else
  {
    /* nothing to do */
  }
}

SWPMI_WaitOnFlagSetUntilTimeout()

static HAL_StatusTypeDef SWPMI_WaitOnFlagSetUntilTimeout ( SWPMI_HandleTypeDef *  hswpmi, uint32_t  Flag, uint32_t  Tickstart, uint32_t  Timeout  )

static

Handle SWPMI Communication Timeout.

Parameters

hswpmi	SWPMI handle
Flag	specifies the SWPMI flag to check.
Tickstart	Tick start value
Timeout	timeout duration.

Return values

HAL

status

Definition at line 1904 of file stm32l4xx_hal_swpmi.c.

{
  HAL_StatusTypeDef status = HAL_OK;

  /* Wait until flag is set */
  while(!(HAL_IS_BIT_SET(hswpmi->Instance->ISR, Flag)))
  {
    /* Check for the Timeout */
    if ((((HAL_GetTick() - Tickstart) >  Timeout) && (Timeout != HAL_MAX_DELAY)) || (Timeout == 0U))
    {
      /* Set the SWPMI state ready to be able to start again the process */
      hswpmi->State = HAL_SWPMI_STATE_READY;

      status = HAL_TIMEOUT;
      break;
    }
  }

  return status;
}