2418416_en-US

[#1]

Example S32K344 LPSPI LCD-PAR-S035 FRDM S32DS 3.6.6 RTD 7.0.1

*   Detailed Description:
*
*   This project provides a minimal bring-up and reference example for the LCD-PAR-S035
*   display and GT911 capacitive touchscreen on the S32K344. It includes standalone LCD
*   and touchscreen diagnostic modes, together with an LVGL demonstration mode.
*
*   The display is controlled through the LPSPI interface using the ST7796S
*   display controller driver. The touchscreen is controlled through the LPI2C
*   interface and uses GPIO signals for interrupt and reset control.
*
*   The original LCD, DBI and touchscreen drivers were obtained from an NXP
*   App Code Hub MCUXpresso SDK example and adapted to the S32K3 RTD
*   environment. The project also integrates LVGL 9.4 as the graphical user
*   interface library.
*
*   The application mode is selected at compile time using the APP_MODE macro
*   defined in this file. It allows the user to select a standalone display
*   test, a standalone touchscreen test or the complete LVGL demonstration.
*   Only one application mode shall be selected for each build.
*
*   A graphical application can be designed using NXP GUI Guider 2.0.1.
*   GUI Guider is configured for LVGL 9.4.0. The contents of the GUI Guider
*   "generated" and "custom" output directories can be copied directly into
*   the corresponding gui_guider directories in this project. After replacing
*   the generated output, the project shall be rebuilt to include the updated
*   screens, widgets, events and custom callbacks.
*
*   Installed packages for S32 Design Studio 3.6.6:
*
*       SW32K3_S32M27x_RTD_R23-11_7.0.1_D2603_DesignStudio_updatesite.zip
*
*   Software Sources:
*
*       NXP App Code Hub demo:
*       https://github.com/nxp-appcodehub/dm-https-lcd-led-demo
*
*       LVGL release/v9.4:
*       https://github.com/lvgl/lvgl/tree/release/v9.4
*
*       NXP GUI Guider 2.0.1:
*       https://www.nxp.com/webapp/Download?colCode=GUI-GUIDER-INSTALLER-2.0.1-WIN&appType=license
*
*   Hardware:
*
*       FRDM-A-S32K344:
*           Remove jumper JP11 when using an external debugger.
*
*       LCD-PAR-S035:
*           Set SW1 to 111.
*
*   Board Connections:
*
*   +------------------+----------------------+-----------------+-------------------+------------------------------+
*   | FRDM-A-S32K344   | MCU Signal           | LCD-PAR-S035    | LCD-PAR-S035      | Function                     |
*   | Connector        |                      | Signal          | Connector         |                              |
*   +------------------+----------------------+-----------------+-------------------+------------------------------+
*   | J2-20            | PTC27 / GPIO         | TP_INT          | J5-12             | Touch interrupt, active low  |
*   | J2-19            | PTC7 / LPI2C1_SCL    | TP_SCL          | J5-8              | Touchscreen I2C clock        |
*   | J2-17            | PTC6 / LPI2C1_SDA    | TP_SDA          | J5-6              | Touchscreen I2C data         |
*   | J2-13            | GND                  | GND             | J5-4              | Signal ground                |
*   | J2-11            | PTB14 / LPSPI1_SCK   | LCD_WR          | J5-5              | LCD SPI clock                |
*   | J2-9             | PTB15 / LPSPI1_SIN   | LCD_RD          | Not connected     | SPI data from LCD            |
*   | J2-7             | PTB16 / LPSPI1_SOUT  | LCD_MOSI        | J5-9              | SPI data to LCD              |
*   | J2-5             | PTB17 / GPIO         | LCD_CS          | J5-11             | LCD chip select, active low  |
*   | J2-3             | PTC10 / GPIO         | LCD_D_C         | J5-7              | Command low, data high       |
*   | J2-1             | PTC11 / GPIO         | LCD_RST         | J5-10             | LCD reset, active low        |
*   | JA3-3            | VDD_HV_A             | VCC             | J5-1 or J5-2      | 3.3 V supply                 |
*   | JA3-13 or JA3-15 | GND                  | GND             | J5-3              | Power ground                 |
*   +------------------+----------------------+-----------------+-------------------+------------------------------+
*
*   Project Files:
*
*   Format:
*       File or directory - Description - Source - License
*
*   |   lvgl_app.c/.h
*   |       LVGL application layer
*   |       Created for this project
*   |       NXP proprietary license
*   |
*   |   lv_conf.h
*   |       Project-specific LVGL configuration
*   |       Derived from the LVGL v9.4.0 configuration template
*   |       MIT License
*   |
*   |   lv_port.c/.h
*   |       LVGL initialization and S32K3 port layer
*   |       Created for this project
*   |       NXP proprietary license
*   |
*   |   main.c
*   |       Application entry point and compile-time mode selection
*   |       Created for this project
*   |       NXP proprietary license
*   |
*   +---gui_guider
*   |   +---custom
*   |   |       User callbacks and custom GUI logic
*   |   |       GUI Guider 2.0.1 output
*   |   |       NXP proprietary license
*   |   |
*   |   \---generated
*   |           Generated screens, widgets and events
*   |           GUI Guider 2.0.1 output
*   |           NXP proprietary license
*   |
*   +---lcdc
*   |       fsl_st7796s.c/.h
*   |           ST7796S LCD controller driver
*   |           NXP App Code Hub demo
*   |           BSD-3-Clause License
*   |
*   +---lcd_par_s035
*   |       lcd_par_s035.c/.h
*   |           LCD-PAR-S035 board and display integration
*   |           Created for this project
*   |           NXP proprietary license
*   |
*   |       lcd_par_s035_config.h
*   |           LCD-PAR-S035 project configuration
*   |           Created for this project
*   |           NXP proprietary license
*   |
*   +---lvgl
*   |   \---src
*   |           LVGL 9.4 graphics library
*   |           LVGL release/v9.4
*   |           MIT License
*   |
*   +---platform
*   |       display_compat.h
*   |           MCUXpresso SDK and S32K3 RTD compatibility definitions
*   |           Created for this project
*   |           NXP proprietary license
*   |
*   |       fsl_dbi.c/.h
*   |           Generic display bus interface implementation
*   |           NXP App Code Hub demo
*   |           BSD-3-Clause License
*   |
*   |       lcd_dbi_s32k3.c/.h
*   |           S32K3 DBI transport implementation using LPSPI
*   |           Created for this project
*   |           NXP proprietary license
*   |
*   |       lcd_platform.c/.h
*   |           S32K344 board and platform abstraction
*   |           Created for this project
*   |           NXP proprietary license
*   |
*   \---touchpanel
*           fsl_gt911.c/.h
*               GT911 touchscreen controller driver
*               NXP App Code Hub demo
*               BSD-3-Clause License
*
*           gt911_s32k3.c/.h
*               S32K3 adaptation using LPI2C and GPIO
*               Created for this project
*               NXP proprietary license
*
*   ----------------------------------------------------------------------------
*   Test Hardware:   FRDM-A-S32K344, schematic revision B
*   MCU:             S32K344
*   Display:         LCD-PAR-S035 with ST7796S controller
*   Touchscreen:     GT911 capacitive touchscreen controller
*   Debugger:        Lauterbach TRACE32
*   Build Target:    internal_FLASH