Functions
BaseType_t	tesaiot_display_init (void)
	Sole public entry — creates the GFX task before the scheduler starts; compare against pdPASS.
void	tesaiot_display_task (void *arg)
	The GFX task body — never create it, never call it.

Variables
volatile uint8_t	tesaiot_display_ready
	Tri-state bring-up flag: 0 pending, 1 display + IPC, 2 IPC-only headless.

Detailed Description

Header: tesaiot_display.h. Implementation: archived tesaiot_display.c (libbento_cm55.a). Owns GFXSS, vg_lite and LVGL bring-up, the display and touch I2C bus, the GFX task, and — because it runs the IPC prologue before the display — the whole CM55 boot ordering (see the ipc_core reference).

Variant: mtb-mpy and mtb-only

tesaiot_display_ready is tri-state

0 = pending, 1 = display + IPC up, 2 = IPC-only headless (the panel failed but the IPC path came up). Both shipped callers test == 0, so a headless board proceeds. Testing for == 1 would hang a consumer on a board with a dark panel — which after a debugger reset every board is.

Function Documentation

◆ tesaiot_display_init()

BaseType_t tesaiot_display_init ( void )

Sole public entry — creates the GFX task before the scheduler starts; compare against pdPASS.

Contract: Required order: cybsp_init() then __enable_irq() then this — the GFXSS DC/GPU ISRs are wired during task startup, so interrupts must be on first. Called from main() before vTaskStartScheduler(): it creates the GFX task, it does not run it. Compare the return against pdPASS, not CY_RSLT_SUCCESS. The template hard-fails into distinct LED loops (LED1 = cybsp_init failed, LED2 = this failed) so the two are visually distinct. It is the sole public entry: it creates the GFX task with xTaskCreate(tesaiot_display_task, ...) and stores the handle in rtos_cm55_gfx_task_handle (tesaiot_display.c:210-213). The task brings up IPC before the display so IPC survives a display failure — which is why tesaiot_display_ready has the value 2.

Variant: mtb-mpy and mtb-only

int main(void)
{
    cy_rslt_t result;
 
#if TESAIOT_ENABLE_FACE_RUNTIME && TESAIOT_ENABLE_FACE_RUNTIME_BOOT
    /* Alternate boot mode: launch native Face-ID runtime. */
    if (face_mode_runtime_requested()) {
        face_mode_launch_runtime();
    }
#endif
 
    /* Initialize the device and board peripherals */
    result = cybsp_init();
    if (CY_RSLT_SUCCESS != result)
    {
        for (;;) {
            Cy_GPIO_Inv(CYBSP_USER_LED1_PORT, CYBSP_USER_LED1_PIN);
            Cy_SysLib_Delay(50);
        }
    }
 
    /* Enable global interrupts */
    __enable_irq();
 
    /* GFX task: GFXSS/LVGL init + IPC + sensorhub UI */
    BaseType_t xResult = tesaiot_display_init();
    if (pdPASS != xResult) {
        for (;;) {
            Cy_GPIO_Inv(CYBSP_USER_LED2_PORT, CYBSP_USER_LED2_PIN);
            Cy_SysLib_Delay(50);
        }
    }

◆ tesaiot_display_task()

void tesaiot_display_task ( void * arg )

The GFX task body — never create it, never call it.

Contract: The GFX task body. Referenced only as the xTaskCreate argument inside tesaiot_display_init() (tesaiot_display.c:211). Anti-example: never create it yourself, never call it — a second GFX task means two LVGL owners, two IPC prologues and a double cm55_ipc_communication_setup(). Consumers call tesaiot_display_init() and nothing else.

Variant: mtb-mpy and mtb-only

Example (authored — no shipped call site)

/* Hand-written externs matching dist/cm55_core/include/tesaiot_display.h
 * (included here as declarations only, to keep the example free of that
 * header's display include chain): */
extern BaseType_t tesaiot_display_init(void);
extern void tesaiot_display_task(void *arg);
 
__attribute__((used))
static void bento_ex_tesaiot_display_task(void)
{
    /* WRONG:
     *   xTaskCreate(tesaiot_display_task, "gfx2", 4096, NULL, 1, NULL);
     *   tesaiot_display_task(NULL);          // never returns, no init
     *
     * RIGHT — the one public entry, from main() pre-scheduler: */
    if (tesaiot_display_init() != pdPASS) {   /* pdPASS, not CY_RSLT_*    */
        /* distinct LED failure loop in shipped main(); do not continue
         * into vTaskStartScheduler() pretending the display exists */
        return;
    }
}

Variable Documentation