import { _ as _export_sfc, c as createElementBlock, o as openBlock, a8 as createStaticVNode } from "./chunks/framework.Cauyuiy8.js"; const __pageData = JSON.parse('{"title":"UART Driver","description":"","frontmatter":{},"headers":[],"relativePath":"drivers/uart.md","filePath":"drivers/uart.md","lastUpdated":null}'); const _sfc_main = { name: "drivers/uart.md" }; const _hoisted_1 = /* @__PURE__ */ createStaticVNode('

UART Driver ​

The UART drivers used in QMK have a set of common functions to allow portability between MCUs.

Currently, this driver does not support enabling hardware flow control (the RTS and CTS pins) if available, but may do so in future.

Usage ​

In most cases, the UART driver code is automatically included if you are using a feature or driver which requires it.

However, if you need to use the driver standalone, add the following to your rules.mk:

make
UART_DRIVER_REQUIRED = yes

You can then call the UART API by including uart.h in your code.

AVR Configuration ​

No special setup is required - just connect the RX and TX pins of your UART device to the opposite pins on the MCU:

MCUTXRXCTSRTS
ATmega16/32U2D3D2D7D6
ATmega16/32U4D3D2D5B7
AT90USB64/128D3D2n/an/a
ATmega32AD1D0n/an/a
ATmega328/PD1D0n/an/a

ChibiOS/ARM Configuration ​

You'll need to determine which pins can be used for UART -- as an example, STM32 parts generally have multiple UART peripherals, labeled USART1, USART2, USART3 etc.

To enable UART, modify your board's mcuconf.h to enable the peripheral you've chosen, for example:

c
#pragma once\n\n#include_next <mcuconf.h>\n\n#undef STM32_SERIAL_USE_USART2\n#define STM32_SERIAL_USE_USART2 TRUE

Configuration-wise, you'll need to set up the peripheral as per your MCU's datasheet -- the defaults match the pins for a Proton-C, i.e. STM32F303.

config.h OverrideDescriptionDefault
UART_DRIVERUSART peripheral to use - USART1 -> SD1, USART2 -> SD2 etc.SD1
UART_TX_PINThe pin to use for TXA9
UART_TX_PAL_MODEThe alternate function mode for TX7
UART_RX_PINThe pin to use for RXA10
UART_RX_PAL_MODEThe alternate function mode for RX7
UART_CTS_PINThe pin to use for CTSA11
UART_CTS_PAL_MODEThe alternate function mode for CTS7
UART_RTS_PINThe pin to use for RTSA12
UART_RTS_PAL_MODEThe alternate function mode for RTS7

API ​

void uart_init(uint32_t baud) ​

Initialize the UART driver. This function must be called only once, before any of the below functions can be called.

Arguments ​

void uart_write(uint8_t data) ​

Transmit a single byte.

Arguments ​

uint8_t uart_read(void) ​

Receive a single byte.

Return Value ​

The byte read from the receive buffer. This function will block if the buffer is empty (ie. no data to read).

void uart_transmit(const uint8_t *data, uint16_t length) ​

Transmit multiple bytes.

Arguments ​

void uart_receive(char *data, uint16_t length) ​

Receive multiple bytes.

Arguments ​

bool uart_available(void) ​

Return whether the receive buffer contains data. Call this function to determine if uart_read() will return data immediately.

Return Value ​

true if there is data available to read.

', 47); const _hoisted_48 = [ _hoisted_1 ]; function _sfc_render(_ctx, _cache, $props, $setup, $data, $options) { return openBlock(), createElementBlock("div", null, _hoisted_48); } const uart = /* @__PURE__ */ _export_sfc(_sfc_main, [["render", _sfc_render]]); export { __pageData, uart as default };