Main Content

UART/USART Write

Write serial data from the Universal Asynchronous Receiver Transmitter (UART/USART) port

  • Library:
  • Embedded Coder Support Package for STMicroelectronics Discovery Boards/STM32F4xx Based Boards

    Embedded Coder Support Package for STMicroelectronics Discovery Boards/STM32F7xx Based Boards

    Embedded Coder Support Package for STMicroelectronics Discovery Boards/STM32G4xx Based Boards

    Embedded Coder Support Package for STMicroelectronics Discovery Boards/STM32H7xx Based Boards

  • UART/USART Write block

Description

Write serial data from the Universal Asynchronous Receiver/ Transmitter (UART/USART) port.

The UART/USART Write block expects the data to be written as an [Nx1] or [1xN] array. Select Specify length of data to write to specify the length of input data to be written to the UART/USART port.

Ports

Input

expand all

The write data sent to the UART/USART port.

Data Types: int8 | uint8 | int16 | uint16 | int32 | uint32 | single | double | Boolean

The length of input data received at UART/USART port.

Dependencies

To enable this port, select the Specify length of input data to write parameter.

Data Types: uint8

Output

expand all

The status port outputs 0 i.e. no error in data reception or Success or any one of the bit values shown in the following table.

The table represents the bits and error associated with it.

Status

Bits1514131211109876543210
Error

X

X

X

X

X

X

ARBE_ERROR

RX_BUSY

TX_BUSY

TX_FAILED

RX_BUFFER_FULL

NOISE_ERROR

FRAME_ERROR

PARITY_ERROR

OVERRUN ERROR

DATA_NOT_AVAILABLE

Port outputs status 7(transmit failed) and 8(transmit busy)which are valid only for UART/USART Write blocks.

  • 0 — requested data length not received

  • 1 — represents overrun error

  • 2 — represents parity error

  • 3 — represents frame error

  • 4 — represents noise error

  • 5 — represents receive buffer full

  • 6 — represents transmit failed

  • 7 — represents transmit busy

  • 8 — represents receive busy

  • 9 — represents auto baud rate error

Dependencies

To enable this port, select the Output status parameter.

Data Types: uint8

Parameters

expand all

Select the UART/USART module for the block.

Select the Specify length of input data to write parameter to enable the port length.

  • On - When you select this parameter, the write operation runs in the Blocking mode. If input data received in the previous time step is sent, the block accepts data from the input port. If the write operation is in progress, the block waits for the data to be sent, and then it accepts data from the input port.

    If the connection between the sending and the receiving host is not established, or if the connection is lost, the data at the input port is dropped.

    If previous byte transmit is already in progress, or the buffer is full (Buffered Mode), input data is not sent.

  • Off - When you clear this parameter, the send operation runs in the Non-blocking mode. When sending data, if the transmission of the input data received in the previous time step is still in progress, the data at the input port at the given time step is dropped.

    If the connection between the sending and the receiving host is not established, or if the connection is lost, the data at the input port is dropped.

Specify the time in seconds for blocking mode.

Dependencies

To enable this parameter, select the Enable blocking mode parameter.

When you select the Output Status parameter, the block configures an output port, Status. The port outputs the status of UART/USART message.

More About

expand all

Version History

Introduced in R2022a