I/O Stream UART

Description

I/O Stream UART.

Overview

UART layer provides a set of standard APIs that can be used with all type of UART interface.

Initialization

Each UART stream type provides its initalization with parameters specific to them.

Data Structures

struct  sl_iostream_uart_t
 I/O Stream UART stream object.
 
struct  sl_iostream_uart_config_t
 I/O Stream UART config.
 
struct  sl_iostream_uart_context_t
 I/O Stream UART context.
 

Functions

sl_status_t sl_iostream_uart_deinit (sl_iostream_uart_t *iostream_uart)
 UART Stream De-init.
 
void sl_iostream_uart_set_auto_cr_lf (sl_iostream_uart_t *iostream_uart, bool on)
 Configure Automatic line conversion.
 
bool sl_iostream_uart_get_auto_cr_lf (sl_iostream_uart_t *iostream_uart)
 Get Automatic line conversion.
 
void sl_iostream_uart_set_rx_energy_mode_restriction (sl_iostream_uart_t *iostream_uart, bool on)
 Add or remove energy mode restriction to enable/disable reception when the system goes to sleep.
 
bool sl_iostream_uart_get_rx_energy_mode_restriction (sl_iostream_uart_t *iostream_uart)
 Get reception energy mode restriction configuration.
 
void sl_iostream_uart_set_read_block (sl_iostream_uart_t *iostream_uart, bool on)
 Configure Read blocking mode.
 
bool sl_iostream_uart_get_read_block (sl_iostream_uart_t *iostream_uart)
 Get read API block configuration.
 

Macros

#define uartFlowControlNone   0
 
#define uartFlowControlSoftware   0xFFFF
 

Function Documentation

◆ sl_iostream_uart_deinit()

sl_status_t sl_iostream_uart_deinit ( sl_iostream_uart_t iostream_uart)
inline

UART Stream De-init.

Parameters
[in]iostream_uartUART context.
Returns
Status result

◆ sl_iostream_uart_set_auto_cr_lf()

void sl_iostream_uart_set_auto_cr_lf ( sl_iostream_uart_t iostream_uart,
bool  on 
)
inline

Configure Automatic line conversion.

Parameters
[in]iostream_uartUART context.
[in]onIf true, automatic LF to CRLF conversion will be enabled.

◆ sl_iostream_uart_get_auto_cr_lf()

bool sl_iostream_uart_get_auto_cr_lf ( sl_iostream_uart_t iostream_uart)
inline

Get Automatic line conversion.

Parameters
[in]iostream_uartUART context.
Returns
Auto-conversion mode.

◆ sl_iostream_uart_set_rx_energy_mode_restriction()

void sl_iostream_uart_set_rx_energy_mode_restriction ( sl_iostream_uart_t iostream_uart,
bool  on 
)
inline

Add or remove energy mode restriction to enable/disable reception when the system goes to sleep.

Parameters
[in]iostream_uartUART context.
[in]onIf true, will be able to receive data when sleeping. i.e it affects the lowest power level that the system can go. Otherwise, it might not be possible to receive data when sleeping.

◆ sl_iostream_uart_get_rx_energy_mode_restriction()

bool sl_iostream_uart_get_rx_energy_mode_restriction ( sl_iostream_uart_t iostream_uart)
inline

Get reception energy mode restriction configuration.

Parameters
[in]iostream_uartUART context.
Returns
Sleep configuration.

◆ sl_iostream_uart_set_read_block()

void sl_iostream_uart_set_read_block ( sl_iostream_uart_t iostream_uart,
bool  on 
)
inline

Configure Read blocking mode.

Parameters
[in]iostream_uartUART context.
[in]onIf false, the read API will be non-blocking. Otherwise the read API will block until data is received.

◆ sl_iostream_uart_get_read_block()

bool sl_iostream_uart_get_read_block ( sl_iostream_uart_t iostream_uart)
inline

Get read API block configuration.

Parameters
[in]iostream_uartUART context.
Returns
Block mode.