Skip to content

Add LTDC display and GT911 touch drivers for STM32H7 boards #407

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
nuraci wants to merge 4 commits into
base: master
Choose a base branch
from
Open

Add LTDC display and GT911 touch drivers for STM32H7 boards #407

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
b244a99
submodule: update lv_binding_micropython for LTDC driver
Mar 26, 2026
54f0af9
Removed tracking for driver/stm32/st_ltdc/board_config.py
Mar 26, 2026
d31b3e7
stm32/st_ltdc: harden init/deinit and validate configuration
Apr 3, 2026
b6fce8e
Update driver/stm32/st_ltdc/modules/st_ltdc.c
nuraci Apr 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
103 changes: 103 additions & 0 deletions driver/stm32/DEV190806042/bsp_ltdc.c
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,103 @@
// LTDC display BSP driver for DEV190806042 board.

#include <stdint.h>
#include <string.h>
#include <stddef.h>
#include <stdbool.h>
#include "boardctrl.h"
#include <stm32h7xx_hal.h>

// HAL MSP initialization for the LTDC peripheral.
// Configures PLL3 for the pixel clock, enables GPIO clocks and maps
// the LTDC alternate-function pins.
void HAL_LTDC_MspInit(LTDC_HandleTypeDef *ltdc_handle) {
GPIO_InitTypeDef gpio = {0};

RCC_PeriphCLKInitTypeDef PeriphClkInitStruct = {0};
PeriphClkInitStruct.PeriphClockSelection = RCC_PERIPHCLK_LTDC;
PeriphClkInitStruct.PLL3.PLL3M = 5;
PeriphClkInitStruct.PLL3.PLL3N = 40;
PeriphClkInitStruct.PLL3.PLL3P = 2;
PeriphClkInitStruct.PLL3.PLL3Q = 4;
PeriphClkInitStruct.PLL3.PLL3R = 4;
PeriphClkInitStruct.PLL3.PLL3RGE = RCC_PLL3VCIRANGE_2;
PeriphClkInitStruct.PLL3.PLL3VCOSEL = RCC_PLL3VCOWIDE;
PeriphClkInitStruct.PLL3.PLL3FRACN = 0;

if (HAL_RCCEx_PeriphCLKConfig(&PeriphClkInitStruct) != HAL_OK) {
boardctrl_fatal_error("HAL_LTDC_MspInit()");
}

if (ltdc_handle->Instance == LTDC) {
// LTDC and GPIO clock enable
__HAL_RCC_GPIOI_CLK_ENABLE();
__HAL_RCC_GPIOJ_CLK_ENABLE();
__HAL_RCC_GPIOK_CLK_ENABLE();
__HAL_RCC_LTDC_CLK_ENABLE();
// Common settings for all LTDC data/sync/clk pins
gpio.Mode = GPIO_MODE_AF_PP;
gpio.Pull = GPIO_NOPULL;
gpio.Speed = GPIO_SPEED_FREQ_VERY_HIGH;
gpio.Alternate = GPIO_AF14_LTDC;

// Port I: CLK, HSYNC, VSYNC, R0
// PI12 = LTDC_HSYNC
// PI13 = LTDC_VSYNC
// PI14 = LTDC_CLK
// PI15 = LTDC_R0
gpio.Pin = GPIO_PIN_12 | GPIO_PIN_13 | GPIO_PIN_14 | GPIO_PIN_15;
HAL_GPIO_Init(GPIOI, &gpio);

// Port J: R1-R7, G0-G4, B0-B3 (PJ0-PJ15, all 16 pins)
// PJ0 = LTDC_R1 PJ1 = LTDC_R2 PJ2 = LTDC_R3
// PJ3 = LTDC_R4 PJ4 = LTDC_R5 PJ5 = LTDC_R6
// PJ6 = LTDC_R7
// PJ7 = LTDC_G0 PJ8 = LTDC_G1 PJ9 = LTDC_G2
// PJ10 = LTDC_G3 PJ11 = LTDC_G4
// PJ12 = LTDC_B0 PJ13 = LTDC_B1 PJ14 = LTDC_B2
// PJ15 = LTDC_B3
gpio.Pin = GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_2 | GPIO_PIN_3 |
GPIO_PIN_4 | GPIO_PIN_5 | GPIO_PIN_6 | GPIO_PIN_7 |
GPIO_PIN_8 | GPIO_PIN_9 | GPIO_PIN_10 | GPIO_PIN_11 |
GPIO_PIN_12 | GPIO_PIN_13 | GPIO_PIN_14 | GPIO_PIN_15;
HAL_GPIO_Init(GPIOJ, &gpio);

// Port K: G5-G7, B4-B7, DE (PK0-PK7)
// PK0 = LTDC_G5 PK1 = LTDC_G6 PK2 = LTDC_G7
// PK3 = LTDC_B4 PK4 = LTDC_B5 PK5 = LTDC_B6
// PK6 = LTDC_B7 PK7 = LTDC_DE
gpio.Pin = GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_2 | GPIO_PIN_3 |
GPIO_PIN_4 | GPIO_PIN_5 | GPIO_PIN_6 | GPIO_PIN_7;
HAL_GPIO_Init(GPIOK, &gpio);
// LTDC interrupt
HAL_NVIC_SetPriority(LTDC_IRQn, 5, 0);
HAL_NVIC_EnableIRQ(LTDC_IRQn);
}
}

// HAL MSP de-initialization for the LTDC peripheral.
// Resets the LTDC block, disables its clock and de-initializes all
// associated GPIO pins.
void HAL_LTDC_MspDeInit(LTDC_HandleTypeDef *ltdc_handle) {
if (ltdc_handle->Instance == LTDC) {
__HAL_RCC_LTDC_FORCE_RESET();
__HAL_RCC_LTDC_RELEASE_RESET();
HAL_NVIC_DisableIRQ(LTDC_IRQn);
__HAL_RCC_LTDC_CLK_DISABLE();
// De-init Port I LTDC pins
HAL_GPIO_DeInit(GPIOI, GPIO_PIN_12 | GPIO_PIN_13 |
GPIO_PIN_14 | GPIO_PIN_15);

// De-init Port J - all 16 LTDC pins
HAL_GPIO_DeInit(GPIOJ, GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_2 | GPIO_PIN_3 |
GPIO_PIN_4 | GPIO_PIN_5 | GPIO_PIN_6 | GPIO_PIN_7 |
GPIO_PIN_8 | GPIO_PIN_9 | GPIO_PIN_10 | GPIO_PIN_11 |
GPIO_PIN_12 | GPIO_PIN_13 | GPIO_PIN_14 | GPIO_PIN_15);

// De-init Port K LTDC pins
HAL_GPIO_DeInit(GPIOK, GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_2 | GPIO_PIN_3 |
GPIO_PIN_4 | GPIO_PIN_5 | GPIO_PIN_6 | GPIO_PIN_7);
}
}


105 changes: 105 additions & 0 deletions driver/stm32/FK743M5-XIH6/bsp_ltdc.c
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,105 @@
// LTDC display BSP driver for FK743M5-XIH6 board.

#include <stdint.h>
#include <string.h>
#include <stddef.h>
#include <stdbool.h>
#include "boardctrl.h"
#include <stm32h7xx_hal.h>

// HAL MSP initialization for the LTDC peripheral.
// Configures PLL3 for the pixel clock, enables GPIO clocks and maps
// the LTDC alternate-function pins.
void HAL_LTDC_MspInit(LTDC_HandleTypeDef *ltdc_handle) {
GPIO_InitTypeDef gpio = {0};

RCC_PeriphCLKInitTypeDef PeriphClkInitStruct = {0};
PeriphClkInitStruct.PeriphClockSelection = RCC_PERIPHCLK_LTDC;
PeriphClkInitStruct.PLL3.PLL3M = 5;
PeriphClkInitStruct.PLL3.PLL3N = 40;
PeriphClkInitStruct.PLL3.PLL3P = 2;
PeriphClkInitStruct.PLL3.PLL3Q = 4;
PeriphClkInitStruct.PLL3.PLL3R = 4;
PeriphClkInitStruct.PLL3.PLL3RGE = RCC_PLL3VCIRANGE_2;
PeriphClkInitStruct.PLL3.PLL3VCOSEL = RCC_PLL3VCOWIDE;
PeriphClkInitStruct.PLL3.PLL3FRACN = 0;

if (HAL_RCCEx_PeriphCLKConfig(&PeriphClkInitStruct) != HAL_OK) {
boardctrl_fatal_error("HAL_LTDC_MspInit()");
}

if (ltdc_handle->Instance == LTDC) {
// LTDC and GPIO clock enable
__HAL_RCC_GPIOG_CLK_ENABLE();
__HAL_RCC_GPIOH_CLK_ENABLE();
__HAL_RCC_GPIOI_CLK_ENABLE();
__HAL_RCC_GPIOJ_CLK_ENABLE();
__HAL_RCC_GPIOK_CLK_ENABLE();
__HAL_RCC_LTDC_CLK_ENABLE();
// Common settings for all LTDC data/sync/clk pins
gpio.Mode = GPIO_MODE_AF_PP;
gpio.Pull = GPIO_NOPULL;
gpio.Speed = GPIO_SPEED_FREQ_HIGH;

// GPIOG: G3 = LCD_G3
gpio.Pin = GPIO_PIN_10; // PG10 = LCD_G3
gpio.Alternate = GPIO_AF9_LTDC;
HAL_GPIO_Init(GPIOG, &gpio);

// GPIOH: PH4=G5
gpio.Pin = GPIO_PIN_4;
gpio.Alternate = GPIO_AF9_LTDC;
HAL_GPIO_Init(GPIOH, &gpio);

// GPIOH: PH15=G4
gpio.Pin = GPIO_PIN_15;
gpio.Alternate = GPIO_AF14_LTDC;
HAL_GPIO_Init(GPIOH, &gpio);

// GPIOI: PI12=HSYNC PI13=VSYNC PI14=CLK PI15=R0
gpio.Pin = GPIO_PIN_12 | GPIO_PIN_13 | GPIO_PIN_14 | GPIO_PIN_15;
gpio.Alternate = GPIO_AF14_LTDC;
HAL_GPIO_Init(GPIOI, &gpio);

// GPIOJ: PJ0..PJ9 and PJ12..PJ15
// R1=PJ0 R2=PJ1 R3=PJ2 R4=PJ3 R5=PJ4 R6=PJ5 R7=PJ6
// G0=PJ7 G1=PJ8 G2=PJ9
// B0=PJ12 B1=PJ13 B2=PJ14 B3=PJ15
gpio.Pin = GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_2 | GPIO_PIN_3 |
GPIO_PIN_4 | GPIO_PIN_5 | GPIO_PIN_6 | GPIO_PIN_7 |
GPIO_PIN_8 | GPIO_PIN_9 |
GPIO_PIN_12 | GPIO_PIN_13 | GPIO_PIN_14 | GPIO_PIN_15;
HAL_GPIO_Init(GPIOJ, &gpio);

// GPIOK: PK1=G6 PK2=G7 PK3=B4 PK4=B5 PK5=B6 PK6=B7 PK7=DE
gpio.Pin = GPIO_PIN_1 | GPIO_PIN_2 | GPIO_PIN_3 |
GPIO_PIN_4 | GPIO_PIN_5 | GPIO_PIN_6 | GPIO_PIN_7;
HAL_GPIO_Init(GPIOK, &gpio);
// LTDC interrupt
HAL_NVIC_SetPriority(LTDC_IRQn, 5, 0);
HAL_NVIC_EnableIRQ(LTDC_IRQn);
}
}

// HAL MSP de-initialization for the LTDC peripheral.
// Resets the LTDC block, disables its clock and de-initializes all
// associated GPIO pins.
void HAL_LTDC_MspDeInit(LTDC_HandleTypeDef *ltdc_handle) {
if (ltdc_handle->Instance == LTDC) {
__HAL_RCC_LTDC_FORCE_RESET();
__HAL_RCC_LTDC_RELEASE_RESET();
HAL_NVIC_DisableIRQ(LTDC_IRQn);
__HAL_RCC_LTDC_CLK_DISABLE();
HAL_GPIO_DeInit(GPIOG, GPIO_PIN_10);
HAL_GPIO_DeInit(GPIOH, GPIO_PIN_4 | GPIO_PIN_15);
HAL_GPIO_DeInit(GPIOI, GPIO_PIN_12 | GPIO_PIN_13 | GPIO_PIN_14 | GPIO_PIN_15);
HAL_GPIO_DeInit(GPIOJ, GPIO_PIN_0 | GPIO_PIN_1 | GPIO_PIN_2 | GPIO_PIN_3 |
GPIO_PIN_4 | GPIO_PIN_5 | GPIO_PIN_6 | GPIO_PIN_7 |
GPIO_PIN_8 | GPIO_PIN_9 |
GPIO_PIN_12 | GPIO_PIN_13 | GPIO_PIN_14 | GPIO_PIN_15);
HAL_GPIO_DeInit(GPIOK, GPIO_PIN_1 | GPIO_PIN_2 | GPIO_PIN_3 |
GPIO_PIN_4 | GPIO_PIN_5 | GPIO_PIN_6 | GPIO_PIN_7);
}
}


132 changes: 132 additions & 0 deletions driver/stm32/STM32H7_CORE/bsp_ltdc.c
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,132 @@
// LTDC display BSP driver for STM32H7_CORE boards.

#include <stdint.h>
#include <string.h>
#include <stddef.h>
#include <stdbool.h>
#include "boardctrl.h"
#include <stm32h7xx_hal.h>

// HAL MSP initialization for the LTDC peripheral.
// Configures PLL3 for the pixel clock, enables GPIO clocks and maps
// the LTDC alternate-function pins.
void HAL_LTDC_MspInit(LTDC_HandleTypeDef *ltdc_handle) {
GPIO_InitTypeDef GPIO_InitStruct = {0};

RCC_PeriphCLKInitTypeDef PeriphClkInitStruct = {0};
PeriphClkInitStruct.PeriphClockSelection = RCC_PERIPHCLK_LTDC;
PeriphClkInitStruct.PLL3.PLL3M = 5;
PeriphClkInitStruct.PLL3.PLL3N = 40;
PeriphClkInitStruct.PLL3.PLL3P = 2;
PeriphClkInitStruct.PLL3.PLL3Q = 4;
PeriphClkInitStruct.PLL3.PLL3R = 4;
PeriphClkInitStruct.PLL3.PLL3RGE = RCC_PLL3VCIRANGE_2;
PeriphClkInitStruct.PLL3.PLL3VCOSEL = RCC_PLL3VCOWIDE;
PeriphClkInitStruct.PLL3.PLL3FRACN = 0;

if (HAL_RCCEx_PeriphCLKConfig(&PeriphClkInitStruct) != HAL_OK) {
boardctrl_fatal_error("HAL_LTDC_MspInit()");
}

if (ltdc_handle->Instance == LTDC) {
// LTDC and GPIO clock enable
__HAL_RCC_LTDC_CLK_ENABLE();
__HAL_RCC_GPIOD_CLK_ENABLE();
__HAL_RCC_GPIOI_CLK_ENABLE();
__HAL_RCC_GPIOE_CLK_ENABLE();
__HAL_RCC_GPIOF_CLK_ENABLE();
__HAL_RCC_GPIOH_CLK_ENABLE();
__HAL_RCC_GPIOG_CLK_ENABLE();
__HAL_RCC_GPIOA_CLK_ENABLE();

GPIO_InitStruct.Mode = GPIO_MODE_AF_PP;
GPIO_InitStruct.Pull = GPIO_NOPULL;
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_VERY_HIGH;

GPIO_InitStruct.Pin = GPIO_PIN_9 | GPIO_PIN_10 | GPIO_PIN_0 | GPIO_PIN_1
| GPIO_PIN_2 | GPIO_PIN_5 | GPIO_PIN_6 | GPIO_PIN_7;
GPIO_InitStruct.Alternate = GPIO_AF14_LTDC;
HAL_GPIO_Init(GPIOI, &GPIO_InitStruct);

GPIO_InitStruct.Pin = GPIO_PIN_10;
GPIO_InitStruct.Alternate = GPIO_AF14_LTDC;
HAL_GPIO_Init(GPIOF, &GPIO_InitStruct);

GPIO_InitStruct.Pin = GPIO_PIN_9 | GPIO_PIN_10 | GPIO_PIN_11 | GPIO_PIN_12
| GPIO_PIN_13 | GPIO_PIN_15;
GPIO_InitStruct.Alternate = GPIO_AF14_LTDC;
HAL_GPIO_Init(GPIOH, &GPIO_InitStruct);

GPIO_InitStruct.Pin = GPIO_PIN_6 | GPIO_PIN_7;
GPIO_InitStruct.Alternate = GPIO_AF14_LTDC;
HAL_GPIO_Init(GPIOG, &GPIO_InitStruct);

GPIO_InitStruct.Pin = GPIO_PIN_8;
GPIO_InitStruct.Alternate = GPIO_AF13_LTDC;
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

#if defined(BOARD_V10)
GPIO_InitStruct.Pin = GPIO_PIN_10 | GPIO_PIN_12;
GPIO_InitStruct.Alternate = GPIO_AF9_LTDC;
HAL_GPIO_Init(GPIOG, &GPIO_InitStruct);
#else
GPIO_InitStruct.Pin = GPIO_PIN_2;
GPIO_InitStruct.Alternate = GPIO_AF14_LTDC;
HAL_GPIO_Init(GPIOA, &GPIO_InitStruct);

GPIO_InitStruct.Pin = GPIO_PIN_5 | GPIO_PIN_6;
GPIO_InitStruct.Alternate = GPIO_AF14_LTDC;
HAL_GPIO_Init(GPIOE, &GPIO_InitStruct);

GPIO_InitStruct.Pin = GPIO_PIN_6;
GPIO_InitStruct.Alternate = GPIO_AF14_LTDC;
HAL_GPIO_Init(GPIOD, &GPIO_InitStruct);

GPIO_InitStruct.Pin = GPIO_PIN_4 | GPIO_PIN_14;
GPIO_InitStruct.Alternate = GPIO_AF14_LTDC;
HAL_GPIO_Init(GPIOH, &GPIO_InitStruct);

GPIO_InitStruct.Pin = GPIO_PIN_12 | GPIO_PIN_13 | GPIO_PIN_14;
GPIO_InitStruct.Alternate = GPIO_AF14_LTDC;
HAL_GPIO_Init(GPIOG, &GPIO_InitStruct);

GPIO_InitStruct.Pin = GPIO_PIN_4;
GPIO_InitStruct.Alternate = GPIO_AF14_LTDC;
HAL_GPIO_Init(GPIOI, &GPIO_InitStruct);
#endif
// LTDC interrupt
HAL_NVIC_SetPriority(LTDC_IRQn, 5, 0);
HAL_NVIC_EnableIRQ(LTDC_IRQn);
}
}

// HAL MSP de-initialization for the LTDC peripheral.
// Resets the LTDC block, disables its clock and de-initializes all
// associated GPIO pins.
void HAL_LTDC_MspDeInit(LTDC_HandleTypeDef *ltdc_handle) {
if (ltdc_handle->Instance == LTDC) {
__HAL_RCC_LTDC_FORCE_RESET();
__HAL_RCC_LTDC_RELEASE_RESET();
HAL_NVIC_DisableIRQ(LTDC_IRQn);
__HAL_RCC_LTDC_CLK_DISABLE();

HAL_GPIO_DeInit(GPIOI, GPIO_PIN_9 | GPIO_PIN_10 | GPIO_PIN_0 | GPIO_PIN_1
| GPIO_PIN_2 | GPIO_PIN_5 | GPIO_PIN_6 | GPIO_PIN_7);
HAL_GPIO_DeInit(GPIOF, GPIO_PIN_10);
HAL_GPIO_DeInit(GPIOH, GPIO_PIN_9 | GPIO_PIN_10 | GPIO_PIN_11 | GPIO_PIN_12
| GPIO_PIN_13 | GPIO_PIN_15);
HAL_GPIO_DeInit(GPIOA, GPIO_PIN_8);
HAL_GPIO_DeInit(GPIOG, GPIO_PIN_6 | GPIO_PIN_7);

#if defined(BOARD_V10)
HAL_GPIO_DeInit(GPIOG, GPIO_PIN_10 | GPIO_PIN_12);
#else
HAL_GPIO_DeInit(GPIOA, GPIO_PIN_2);
HAL_GPIO_DeInit(GPIOE, GPIO_PIN_5 | GPIO_PIN_6);
HAL_GPIO_DeInit(GPIOD, GPIO_PIN_6);
HAL_GPIO_DeInit(GPIOH, GPIO_PIN_4 | GPIO_PIN_14);
HAL_GPIO_DeInit(GPIOG, GPIO_PIN_12 | GPIO_PIN_13 | GPIO_PIN_14);
HAL_GPIO_DeInit(GPIOI, GPIO_PIN_4);
#endif
}
}
Loading
Loading