Files
raw-designsandClaude Opus 5 4f9f686d81 refactor: Display-Firmware neutral als P4_Display_Firmware führen
Der Ordner hieß JC_Display_Firmware, bedient seit 1.6.0 aber auch das
Waveshare 7inch DSI LCD (H) am ESP32-P4-Pico. Der Name führte in die Irre.

- JC_Display_Firmware/ -> P4_Display_Firmware/ (samt Sketch, den Arduino
  gleichnamig zum Ordner verlangt)
- Doku/JC-Display_UART-Protokoll.md -> Doku/P4-Display_UART-Protokoll.md,
  Verweise und Titel angepasst
- Verweise in CLAUDE.md, README und Quelltextköpfen nachgezogen

Nur Namen und Pfade, keine Logikänderung. Der Vendor-Ordner
JC_Display_Firmware_7zoll/ behält seinen Namen, ebenso die Bezeichner
JC_PANEL_TYPE/jc_board_bringup im Quelltext.

Enthält außerdem die bereits im Arbeitsverzeichnis liegende, noch nicht
committete Ergänzung des Git-Workflows in CLAUDE.md (PRs über die Gitea-API
statt der hängenden tea-CLI).

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018QoLDQeUh1dCQz7yYZVb4Y
2026-09-01 03:30:42 +02:00

41 lines
1.9 KiB
C

// =====================================================================================
// display_hal.h - Board-/Panel-/Touch-Anbindung (ST7701 / JD9165 / Waveshare-DSI) + LVGL-Glue
// =====================================================================================
// Einziger board-spezifischer Teil. Baut auf der HERSTELLER-LVGL-PORTIERUNG des
// JC4880P443C-I-W auf (1-Demo/arduino_examples/lvgl_v9_sw_rotation):
// - MIPI-DSI ST7701 (480x800), JD9165 (1024x600) oder Waveshare 7" (H) (1280x720)
// - Auswahl ueber JC_PANEL_TYPE
// - GT911- bzw. GT9271-Touch (I2C SDA=7/SCL=8); Backlight GPIO23 bzw. Bridge-Register
// - LVGL laeuft in einem EIGENEN FreeRTOS-Task -> UI-Zugriffe von aussen muessen
// mit hal_lock()/hal_unlock() (= lvgl_port_lock/unlock) geschuetzt werden.
//
// Schalter JC_USE_REAL_PANEL:
// 0 = Stub-Modus (kompiliert OHNE Hersteller-BSP; eigenes minimal-LVGL, rendert ins
// Leere). Zum Testen von Protokoll/UART/Logik am Schreibtisch.
// 1 = echte Hardware: erwartet die Hersteller-BSP-Dateien IM SKETCH-ORDNER:
// pins_config.h, lvgl_port_v9.h/.c, src/lcd/*, src/touch/*
// (aus arduino_examples/lvgl_v9_sw_rotation kopieren). Siehe README.md.
// =====================================================================================
#pragma once
#include "protocol_client.h"
#ifndef JC_USE_REAL_PANEL
#define JC_USE_REAL_PANEL 0
#endif
// Initialisiert LVGL + Panel + Touch und baut das Dashboard auf (ui_init unter Lock).
void hal_init(ProtocolClient* client);
// In loop() aufrufen. Realer Panel-Modus: leer (LVGL hat eigenen Task).
// Stub-Modus: ruft lv_timer_handler().
void hal_loop();
// LVGL-Mutex (im realen Modus zwingend vor jedem UI-Zugriff aus fremden Tasks).
void hal_lock();
void hal_unlock();
// Display-Hintergrundbeleuchtung setzen (0..100 %). Stub-Modus: ohne Wirkung.
void hal_backlight(int percent);