feat: Abstract USART API

BLINKY/G4HELLO/CMakeLists.txt

@@ -38,6 +38,10 @@ target_sources(
 		Core/Src/syscalls.c
 )
 
-target_link_libraries(${GR_PROJECT_NAME}_USER_CODE INTERFACE)
+target_link_libraries(
+	${GR_PROJECT_NAME}_USER_CODE
+	INTERFACE
+		PERIPHERAL_USART_LIB
+)
 
 target_include_directories(${GR_PROJECT_NAME}_USER_CODE INTERFACE Core/Inc)

BLINKY/G4HELLO/Core/Src/main.c

@@ -22,6 +22,7 @@
 /* Private includes ----------------------------------------------------------*/
 /* USER CODE BEGIN Includes */
 #include "Logomatic.h"
+#include "Peripherals/USART/usart.h"
 /* USER CODE END Includes */
 
 /* Private typedef -----------------------------------------------------------*/
@@ -48,13 +49,20 @@
 /* Private function prototypes -----------------------------------------------*/
 void SystemClock_Config(void);
 static void MX_GPIO_Init(void);
-static void MX_LPUART1_UART_Init(void);
 /* USER CODE BEGIN PFP */
 
 /* USER CODE END PFP */
 
 /* Private user code ---------------------------------------------------------*/
 /* USER CODE BEGIN 0 */
+void received_byte_callback(uint8_t byte)
+{
+	LOGOMATIC("Received byte: 0x%02X ('%c')\n", byte, (byte >= 32 && byte <= 126) ? byte : '.');
+
+#ifndef LOGOMATIC_ENABLED
+	byte = byte; // suppress unused variable warning
+#endif
+}
 
 /* Enable ITM for SWO output */
 static void ITM_Enable(void)
@@ -102,9 +110,40 @@ int main(void)
 
 	/* Initialize all configured peripherals */
 	MX_GPIO_Init();
-	MX_LPUART1_UART_Init();
+	// MX_LPUART1_UART_Init();
 	/* USER CODE BEGIN 2 */
-
+	USARTConfig config = {
+	    .instance = LPUART1,
+	    .tx_queue_length = 16,
+	    .on_rx_byte = NULL,
+	    .gpio_port = GPIOA,
+	    .ll_gpio =
+		&(LL_GPIO_InitTypeDef){
+		    .Pin = LL_GPIO_PIN_2 | LL_GPIO_PIN_3,
+		    .Mode = LL_GPIO_MODE_ALTERNATE,
+		    .Alternate = LL_GPIO_AF_12,
+		    .OutputType = LL_GPIO_OUTPUT_PUSHPULL,
+		    .Pull = LL_GPIO_PULL_NO,
+		    .Speed = LL_GPIO_SPEED_FREQ_LOW,
+		},
+	    .ll_lpuart =
+		&(LL_LPUART_InitTypeDef){
+		    .PrescalerValue = LL_LPUART_PRESCALER_DIV1,
+		    .BaudRate = 115200,
+		    .DataWidth = LL_LPUART_DATAWIDTH_8B,
+		    .StopBits = LL_LPUART_STOPBITS_1,
+		    .Parity = LL_LPUART_PARITY_NONE,
+		    .TransferDirection = LL_LPUART_DIRECTION_TX_RX,
+		},
+	};
+	USARTHandle *handle = usart_init_peripheral(&config);
+	for (uint8_t i = 0; i < 30; i++) {
+		LOGOMATIC("sending message over usart... %d\n", i);
+		usart_send(handle, "Hello World!\r\n", 14);
+		LL_mDelay(1000);
+	}
+	LOGOMATIC("USART test messages sent, releasing...\n");
+	usart_release(&handle);
 	/* USER CODE END 2 */
 
 	/* Infinite loop */
@@ -161,76 +200,6 @@ void SystemClock_Config(void)
 	}
 }
 
-/**
- * @brief LPUART1 Initialization Function
- * @param None
- * @retval None
- */
-static void MX_LPUART1_UART_Init(void)
-{
-
-	/* USER CODE BEGIN LPUART1_Init 0 */
-
-	/* USER CODE END LPUART1_Init 0 */
-
-	LL_LPUART_InitTypeDef LPUART_InitStruct = {0};
-
-	LL_GPIO_InitTypeDef GPIO_InitStruct = {0};
-
-	LL_RCC_SetLPUARTClockSource(LL_RCC_LPUART1_CLKSOURCE_PCLK1);
-
-	/* Peripheral clock enable */
-	LL_APB1_GRP2_EnableClock(LL_APB1_GRP2_PERIPH_LPUART1);
-
-	LL_AHB2_GRP1_EnableClock(LL_AHB2_GRP1_PERIPH_GPIOA);
-	/**LPUART1 GPIO Configuration
-	PA2   ------> LPUART1_TX (ST-LINK VCP)
-	PA3   ------> LPUART1_RX (ST-LINK VCP)
-	*/
-	GPIO_InitStruct.Pin = LL_GPIO_PIN_2;
-	GPIO_InitStruct.Mode = LL_GPIO_MODE_ALTERNATE;
-	GPIO_InitStruct.Speed = LL_GPIO_SPEED_FREQ_LOW;
-	GPIO_InitStruct.OutputType = LL_GPIO_OUTPUT_PUSHPULL;
-	GPIO_InitStruct.Pull = LL_GPIO_PULL_NO;
-	GPIO_InitStruct.Alternate = LL_GPIO_AF_12;
-	LL_GPIO_Init(GPIOA, &GPIO_InitStruct);
-
-	GPIO_InitStruct.Pin = LL_GPIO_PIN_3;
-	GPIO_InitStruct.Mode = LL_GPIO_MODE_ALTERNATE;
-	GPIO_InitStruct.Speed = LL_GPIO_SPEED_FREQ_LOW;
-	GPIO_InitStruct.OutputType = LL_GPIO_OUTPUT_PUSHPULL;
-	GPIO_InitStruct.Pull = LL_GPIO_PULL_NO;
-	GPIO_InitStruct.Alternate = LL_GPIO_AF_12;
-	LL_GPIO_Init(GPIOA, &GPIO_InitStruct);
-
-	/* USER CODE BEGIN LPUART1_Init 1 */
-
-	/* USER CODE END LPUART1_Init 1 */
-	LPUART_InitStruct.PrescalerValue = LL_LPUART_PRESCALER_DIV1;
-	LPUART_InitStruct.BaudRate = 115200;
-	LPUART_InitStruct.DataWidth = LL_LPUART_DATAWIDTH_8B;
-	LPUART_InitStruct.StopBits = LL_LPUART_STOPBITS_1;
-	LPUART_InitStruct.Parity = LL_LPUART_PARITY_NONE;
-	LPUART_InitStruct.TransferDirection = LL_LPUART_DIRECTION_TX_RX;
-	LL_LPUART_Init(LPUART1, &LPUART_InitStruct);
-	LL_LPUART_SetTXFIFOThreshold(LPUART1, LL_LPUART_FIFOTHRESHOLD_1_8);
-	LL_LPUART_SetRXFIFOThreshold(LPUART1, LL_LPUART_FIFOTHRESHOLD_1_8);
-	LL_LPUART_DisableFIFO(LPUART1);
-	LL_LPUART_SetWakeUpMethod(LPUART1, LL_LPUART_WAKEUP_IDLELINE);
-
-	/* USER CODE BEGIN WKUPType LPUART1 */
-
-	/* USER CODE END WKUPType LPUART1 */
-
-	LL_LPUART_Enable(LPUART1);
-
-	/* Polling LPUART1 initialisation */
-	while ((!(LL_LPUART_IsActiveFlag_TEACK(LPUART1))) || (!(LL_LPUART_IsActiveFlag_REACK(LPUART1)))) {}
-	/* USER CODE BEGIN LPUART1_Init 2 */
-
-	/* USER CODE END LPUART1_Init 2 */
-}
-
 /**
  * @brief GPIO Initialization Function
  * @param None

Lib/Peripherals/USART/common.cmake

@@ -2,6 +2,8 @@ add_library(PERIPHERAL_USART_LIB INTERFACE)
 
 target_sources(PERIPHERAL_USART_LIB INTERFACE ${CMAKE_CURRENT_LIST_DIR}/usart.c)
 
+target_link_libraries(PERIPHERAL_USART_LIB INTERFACE CircularBuffer_Lib)
+
 # Make headers accessible as #include "Peripherals/USART/usart.h"
 target_include_directories(
 	PERIPHERAL_USART_LIB