Advanced Configurations services
[USART Exported Functions]

Perform basic configuration of USART for enabling use in Asynchronous Mode (UART)

Note:

In UART mode, the following bits must be kept cleared:

• LINEN bit in the USART_CR2 register,
• CLKEN bit in the USART_CR2 register,
• SCEN bit in the USART_CR3 register,
• IREN bit in the USART_CR3 register,
• HDSEL bit in the USART_CR3 register.

Call of this function is equivalent to following function call sequence :

• Clear LINEN in CR2 using LL_USART_DisableLIN() function
• Clear CLKEN in CR2 using LL_USART_DisableSCLKOutput() function
• Clear SCEN in CR3 using LL_USART_DisableSmartcard() function
• Clear IREN in CR3 using LL_USART_DisableIrda() function
• Clear HDSEL in CR3 using LL_USART_DisableHalfDuplex() function

Other remaining configurations items related to Asynchronous Mode (as Baud Rate, Word length, Parity, ...) should be set using dedicated functions CR2 LINEN LL_USART_ConfigAsyncMode
CR2 CLKEN LL_USART_ConfigAsyncMode
CR3 SCEN LL_USART_ConfigAsyncMode
CR3 IREN LL_USART_ConfigAsyncMode
CR3 HDSEL LL_USART_ConfigAsyncMode

Parameters:

USARTx

USART Instance

Return values:

None

Definition at line 2268 of file stm32l4xx_ll_usart.h.

Perform basic configuration of USART for enabling use in Half Duplex Mode.

Note:

In Half Duplex mode, the following bits must be kept cleared:

• LINEN bit in the USART_CR2 register,
• CLKEN bit in the USART_CR2 register,
• SCEN bit in the USART_CR3 register,
• IREN bit in the USART_CR3 register, This function also sets the UART/USART in Half Duplex mode.

Macro IS_UART_HALFDUPLEX_INSTANCE(USARTx) can be used to check whether or not Half-Duplex mode is supported by the USARTx instance.

Call of this function is equivalent to following function call sequence :

• Clear LINEN in CR2 using LL_USART_DisableLIN() function
• Clear CLKEN in CR2 using LL_USART_DisableSCLKOutput() function
• Clear SCEN in CR3 using LL_USART_DisableSmartcard() function
• Clear IREN in CR3 using LL_USART_DisableIrda() function
• Set HDSEL in CR3 using LL_USART_EnableHalfDuplex() function

Other remaining configurations items related to Half Duplex Mode (as Baud Rate, Word length, Parity, ...) should be set using dedicated functions CR2 LINEN LL_USART_ConfigHalfDuplexMode
CR2 CLKEN LL_USART_ConfigHalfDuplexMode
CR3 HDSEL LL_USART_ConfigHalfDuplexMode
CR3 SCEN LL_USART_ConfigHalfDuplexMode
CR3 IREN LL_USART_ConfigHalfDuplexMode

Parameters:

USARTx

USART Instance

Return values:

None

Definition at line 2382 of file stm32l4xx_ll_usart.h.

Perform basic configuration of USART for enabling use in Irda Mode.

Note:

In IRDA mode, the following bits must be kept cleared:

• LINEN bit in the USART_CR2 register,
• STOP and CLKEN bits in the USART_CR2 register,
• SCEN bit in the USART_CR3 register,
• HDSEL bit in the USART_CR3 register. This function also sets the UART/USART in IRDA mode (IREN bit).

Macro IS_IRDA_INSTANCE(USARTx) can be used to check whether or not IrDA feature is supported by the USARTx instance.

Call of this function is equivalent to following function call sequence :

• Clear LINEN in CR2 using LL_USART_DisableLIN() function
• Clear CLKEN in CR2 using LL_USART_DisableSCLKOutput() function
• Clear SCEN in CR3 using LL_USART_DisableSmartcard() function
• Clear HDSEL in CR3 using LL_USART_DisableHalfDuplex() function
• Configure STOP in CR2 using LL_USART_SetStopBitsLength() function
• Set IREN in CR3 using LL_USART_EnableIrda() function

Other remaining configurations items related to Irda Mode (as Baud Rate, Word length, Power mode, ...) should be set using dedicated functions CR2 LINEN LL_USART_ConfigIrdaMode
CR2 CLKEN LL_USART_ConfigIrdaMode
CR2 STOP LL_USART_ConfigIrdaMode
CR3 SCEN LL_USART_ConfigIrdaMode
CR3 HDSEL LL_USART_ConfigIrdaMode
CR3 IREN LL_USART_ConfigIrdaMode

Parameters:

USARTx

USART Instance

Return values:

None

Definition at line 2465 of file stm32l4xx_ll_usart.h.

Perform basic configuration of USART for enabling use in LIN Mode.

Note:

In LIN mode, the following bits must be kept cleared:

• STOP and CLKEN bits in the USART_CR2 register,
• SCEN bit in the USART_CR3 register,
• IREN bit in the USART_CR3 register,
• HDSEL bit in the USART_CR3 register. This function also set the UART/USART in LIN mode.

Macro IS_UART_LIN_INSTANCE(USARTx) can be used to check whether or not LIN feature is supported by the USARTx instance.

Call of this function is equivalent to following function call sequence :

• Clear CLKEN in CR2 using LL_USART_DisableSCLKOutput() function
• Clear STOP in CR2 using LL_USART_SetStopBitsLength() function
• Clear SCEN in CR3 using LL_USART_DisableSmartcard() function
• Clear IREN in CR3 using LL_USART_DisableIrda() function
• Clear HDSEL in CR3 using LL_USART_DisableHalfDuplex() function
• Set LINEN in CR2 using LL_USART_EnableLIN() function

Other remaining configurations items related to LIN Mode (as Baud Rate, Word length, LIN Break Detection Length, ...) should be set using dedicated functions CR2 CLKEN LL_USART_ConfigLINMode
CR2 STOP LL_USART_ConfigLINMode
CR2 LINEN LL_USART_ConfigLINMode
CR3 IREN LL_USART_ConfigLINMode
CR3 SCEN LL_USART_ConfigLINMode
CR3 HDSEL LL_USART_ConfigLINMode

Parameters:

USARTx

USART Instance

Return values:

None

Definition at line 2344 of file stm32l4xx_ll_usart.h.

Perform basic configuration of USART for enabling use in Multi processor Mode (several USARTs connected in a network, one of the USARTs can be the master, its TX output connected to the RX inputs of the other slaves USARTs).

Note:

In MultiProcessor mode, the following bits must be kept cleared:

• LINEN bit in the USART_CR2 register,
• CLKEN bit in the USART_CR2 register,
• SCEN bit in the USART_CR3 register,
• IREN bit in the USART_CR3 register,
• HDSEL bit in the USART_CR3 register.

Call of this function is equivalent to following function call sequence :

• Clear LINEN in CR2 using LL_USART_DisableLIN() function
• Clear CLKEN in CR2 using LL_USART_DisableSCLKOutput() function
• Clear SCEN in CR3 using LL_USART_DisableSmartcard() function
• Clear IREN in CR3 using LL_USART_DisableIrda() function
• Clear HDSEL in CR3 using LL_USART_DisableHalfDuplex() function

Other remaining configurations items related to Multi processor Mode (as Baud Rate, Wake Up Method, Node address, ...) should be set using dedicated functions CR2 LINEN LL_USART_ConfigMultiProcessMode
CR2 CLKEN LL_USART_ConfigMultiProcessMode
CR3 SCEN LL_USART_ConfigMultiProcessMode
CR3 HDSEL LL_USART_ConfigMultiProcessMode
CR3 IREN LL_USART_ConfigMultiProcessMode

Parameters:

USARTx

USART Instance

Return values:

None

Definition at line 2503 of file stm32l4xx_ll_usart.h.

Perform basic configuration of USART for enabling use in Smartcard Mode.

Note:

In Smartcard mode, the following bits must be kept cleared:

• LINEN bit in the USART_CR2 register,
• IREN bit in the USART_CR3 register,
• HDSEL bit in the USART_CR3 register. This function also configures Stop bits to 1.5 bits and sets the USART in Smartcard mode (SCEN bit). Clock Output is also enabled (CLKEN).

Macro IS_SMARTCARD_INSTANCE(USARTx) can be used to check whether or not Smartcard feature is supported by the USARTx instance.

Call of this function is equivalent to following function call sequence :

• Clear LINEN in CR2 using LL_USART_DisableLIN() function
• Clear IREN in CR3 using LL_USART_DisableIrda() function
• Clear HDSEL in CR3 using LL_USART_DisableHalfDuplex() function
• Configure STOP in CR2 using LL_USART_SetStopBitsLength() function
• Set CLKEN in CR2 using LL_USART_EnableSCLKOutput() function
• Set SCEN in CR3 using LL_USART_EnableSmartcard() function

Other remaining configurations items related to Smartcard Mode (as Baud Rate, Word length, Parity, ...) should be set using dedicated functions CR2 LINEN LL_USART_ConfigSmartcardMode
CR2 STOP LL_USART_ConfigSmartcardMode
CR2 CLKEN LL_USART_ConfigSmartcardMode
CR3 HDSEL LL_USART_ConfigSmartcardMode
CR3 SCEN LL_USART_ConfigSmartcardMode

Parameters:

USARTx

USART Instance

Return values:

None

Definition at line 2422 of file stm32l4xx_ll_usart.h.

Perform basic configuration of USART for enabling use in Synchronous Mode.

Note:

In Synchronous mode, the following bits must be kept cleared:

• LINEN bit in the USART_CR2 register,
• SCEN bit in the USART_CR3 register,
• IREN bit in the USART_CR3 register,
• HDSEL bit in the USART_CR3 register. This function also sets the USART in Synchronous mode.

Macro IS_USART_INSTANCE(USARTx) can be used to check whether or not Synchronous mode is supported by the USARTx instance.

Call of this function is equivalent to following function call sequence :

• Clear LINEN in CR2 using LL_USART_DisableLIN() function
• Clear IREN in CR3 using LL_USART_DisableIrda() function
• Clear SCEN in CR3 using LL_USART_DisableSmartcard() function
• Clear HDSEL in CR3 using LL_USART_DisableHalfDuplex() function
• Set CLKEN in CR2 using LL_USART_EnableSCLKOutput() function

Other remaining configurations items related to Synchronous Mode (as Baud Rate, Word length, Parity, Clock Polarity, ...) should be set using dedicated functions CR2 LINEN LL_USART_ConfigSyncMode
CR2 CLKEN LL_USART_ConfigSyncMode
CR3 SCEN LL_USART_ConfigSyncMode
CR3 IREN LL_USART_ConfigSyncMode
CR3 HDSEL LL_USART_ConfigSyncMode

Parameters:

USARTx

USART Instance

Return values:

None

Definition at line 2304 of file stm32l4xx_ll_usart.h.