Skip to main content

UART API

To create an UART device, first call uart_init, passing in an uart_config_t struct. This struct defines the RX/TX pins, the baud rate, and the rx/write_done callbacks.

uart_dev_t uart_init (const uart_config_t *config)​

Initializes UART device. The config argument defines the pins, configuration, and callbacks for the UART device. It contains the following fields:

FieldTypeDescription
rxpin_tThe RX pin (or NO_PIN to disable RX)
txpin_tThe TX pin (or NO_PIN to disable TX)
baud_rateuint32_tThe baud rate (e.g. 115200)
rx_datacallbackCalled for each byte received on the RX pin
write_donecallbackCalled when data transmission on the TX pin has finished
user_datavoid \*Data that will be passed in the first argument of the callbacks

Both of the callbacks (rx_data, write_done) are optional. They all use the user_data pointer as their first argument.

Example:

static void on_uart_rx_data(void *user_data, uint8_t byte) {
  // `byte` is the byte received on the "RX" pin
}

static uint8_t on_uart_write_done(void *user_data) {
  // You can write the chunk of data to transmit here (by calling uart_write).
}

// ...

const uart_config_t uart1 = {
  .tx = pin_init("TX", INPUT_PULLUP),
  .rx = pin_init("RX", INPUT),
  .baud_rate = 115200,
  .rx_data = on_uart_rx_data,
  .write_done = on_uart_write_done,
  .user_data = chip,
};

bool uart_write (uart_dev_t uart, uint8_t *buffer, uint32_t count)​

Write count bytes from the memory pointed to by buffer to the given uart device.
Returns true on success, or false if the UART device is already busy transmitting data from a previous uart_write call (and the new data won't be transmitted).

The data starts transmitting after uart_write returns. Once Wokwi finishes transmitting the data, the write_done callback is called (from the uart_config_t structure that you passed to uart_init).

Simulator examples​