首次初始化

2026-07-08 10:30:07 +08:00
commit b4423fcfa2
1963 changed files with 898669 additions and 0 deletions
@@ -0,0 +1,99 @@
+#ifndef __ILI9341_H__
+#define __ILI9341_H__
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include "main.h"
+#include "spi.h"
+
+/* 默认竖屏分辨率 */
+#define ILI9341_WIDTH      240
+#define ILI9341_HEIGHT     320
+
+/* ============================================================
+ * LCD 控制引脚
+ *
+ * !!! 重要 !!!
+ * 下面的 LCD_CS_PIN 目前是 GPIO_PIN_12，但 gpio.c 的
+ * MX_GPIO_Init() 里只把 GPIO_PIN_6 配置成了输出（Output_PP）。
+ * GPIO_PIN_12 复位后是 Analog 模式，不是输出，直接
+ * HAL_GPIO_WritePin() 不会对物理引脚产生任何效果。
+ *
+ * 请确认实际硬件接线：
+ *  - 如果 CS 确实接在 PB12，必须在 MX_GPIO_Init() 里把
+ *    GPIO_PIN_12 加入 output push-pull 初始化列表；
+ *  - 如果实际接线仍是 PB6，请把下面的宏改回 GPIO_PIN_6。
+ * 在确认并修复之前，CS 时序不可信，任何"偶发花屏/白屏"的
+ * 排查都应该先排除这个问题。
+ * ============================================================ */
+#define LCD_CS_PORT        GPIOB
+#define LCD_CS_PIN         GPIO_PIN_12
+
+#define LCD_DC_PORT        GPIOB
+#define LCD_DC_PIN         GPIO_PIN_7
+
+#define LCD_RST_PORT       GPIOB
+#define LCD_RST_PIN        GPIO_PIN_8
+
+#define LCD_BL_PORT        GPIOB
+#define LCD_BL_PIN         GPIO_PIN_9
+
+/* RGB565 常用颜色 */
+#define ILI9341_BLACK      0x0000
+#define ILI9341_WHITE      0xFFFF
+#define ILI9341_RED        0xF800
+#define ILI9341_GREEN      0x07E0
+#define ILI9341_BLUE       0x001F
+#define ILI9341_YELLOW     0xFFE0
+#define ILI9341_CYAN       0x07FF
+#define ILI9341_MAGENTA    0xF81F
+#define ILI9341_GRAY       0x8410
+
+typedef void (*ILI9341_DmaDoneCallback)(void *user_data);
+
+void ILI9341_Init(void);
+void ILI9341_SetRotation(uint8_t rotation);
+
+void ILI9341_FillScreen(uint16_t color);
+void ILI9341_DrawPixel(uint16_t x, uint16_t y, uint16_t color);
+void ILI9341_FillRect(uint16_t x, uint16_t y, uint16_t w, uint16_t h, uint16_t color);
+
+void ILI9341_WriteArea(uint16_t x,
+                       uint16_t y,
+                       uint16_t w,
+                       uint16_t h,
+                       const uint16_t *pixels);
+
+void ILI9341_WriteArea_DMA(uint16_t x,
+                           uint16_t y,
+                           uint16_t w,
+                           uint16_t h,
+                           const uint16_t *pixels,
+                           ILI9341_DmaDoneCallback done_cb,
+                           void *user_data);
+
+/*
+ * DMA 看门狗：建议从任务(线程)上下文周期性调用，例如放在
+ * StartDefaultTask 的 for(;;) 循环里、紧跟在 lv_timer_handler()
+ * 之后。绝不能从任何中断服务程序里调用。
+ *
+ * 新实现里 ILI9341_WriteArea_DMA 本身已经通过信号量+超时
+ * 做了同步等待和自恢复，正常情况下不需要这个看门狗介入；
+ * 它只是兜底：万一某次调用路径绕过了 WriteArea_DMA 内部的
+ * 超时保护（例如未来新增的调用方式），仍然能强制恢复 SPI
+ * 状态机，避免 lcd_dma_busy 卡死导致后续所有刷新被永久跳过。
+ *
+ * timeout_ms 建议 150~200ms（要大于 WriteArea_DMA 内部
+ * 100ms 的超时阈值，避免互相打架）。
+ */
+void ILI9341_DMA_Watchdog(uint32_t timeout_ms);
+
+uint16_t ILI9341_Color565(uint8_t r, uint8_t g, uint8_t b);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif