FlashHelper.c File Reference

Eve's connected flash helper functions. More...

#include "FlashHelper.h"
#include "Gpu_Hal.h"

Go to the source code of this file.

Functions
ft_bool_t	Esd_Calibrate (EVE_HalContext *phost)
	Do calibration.
ft_void_t	Ft_Gpu_HorizontalScanoutFilter (EVE_HalContext *phost, uint32_t physical_W, uint32_t physical_H)
	Adjust for non-sqare pixel panel.
void	App_WrDl_Buffer (Gpu_Hal_Context_t *phost, uint32_t cmd)
	Write DL command to buffer.
void	App_Flush_DL_Buffer (const Gpu_Hal_Context_t *phost)
	Flush DL buffer to Coprocessor.
void	App_Set_DlBuffer_Index (uint32_t index)
	Set DL buffer index.
void	GPU_DLSwap (Gpu_Hal_Context_t *phost, uint8_t DL_Swap_Type)
	API to check the status of previous DLSWAP and perform DLSWAP of new DL Check for the status of previous DLSWAP and if still not done wait for few ms and check again.
void	fadeout (EVE_HalContext *phost)
	Fadeout animation.
void	fadein (EVE_HalContext *phost)
	Fadein animation perform display fadein effect by changing the display PWM from 0 till 100 and finally 128.
void	Fifo_Init (Fifo_t *pFifo, uint32_t StartAddress, uint32_t Length, uint32_t HWReadRegAddress, uint32_t HWWriteRegAddress)
	Init mediafifo.
void	Fifo_Update (Gpu_Hal_Context_t *host, Fifo_t *pFifo)
	update both the read and write pointers
uint32_t	Fifo_Write (Gpu_Hal_Context_t *host, Fifo_t *pFifo, const uint8_t *buffer, uint32_t NumbytetoWrite)
	write and update the write register
void	Fifo_WriteWait (Gpu_Hal_Context_t *host, Fifo_t *pFifo, const uint8_t *buffer, uint32_t Numbyte)
	write and wait for the fifo to be empty. handle cases even if the Numbytes are more than freespace
void	Fifo_Write32 (Gpu_Hal_Context_t *host, Fifo_t *pFifo, uint32_t WriteWord)
	write one word and update the write register
uint32_t	Fifo_GetFreeSpace (Gpu_Hal_Context_t *host, Fifo_t *pFifo)
	get the free space in the fifo
int32_t	FlashHelper_GetSizeMB (Gpu_Hal_Context_t *phost)

Variables
uint32_t	DlBuffer_Index

Detailed Description

Eve's connected flash helper functions.

Author

Tuan Nguyen tuan..nosp@m.nguy.nosp@m.en@br.nosp@m.tchi.nosp@m.p.com

Date

2019

MIT License

Copyright (c) [2019] [Bridgetek Pte Ltd (BRTChip)]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Definition in file FlashHelper.c.

Function Documentation

App_Flush_DL_Buffer()

void App_Flush_DL_Buffer

(

const Gpu_Hal_Context_t *

phost

)

Flush DL buffer to Coprocessor.

Parameters

phost

Pointer to Hal context

Definition at line 471 of file FlashHelper.c.

{
#ifdef  BUFFER_OPTIMIZATION
    if (DlBuffer_Index > 0)
        EVE_Hal_wrMem(phost, RAM_DL, DlBuffer, DlBuffer_Index); /* Not legal on big endian CPU */
#endif
    DlBuffer_Index = 0;
}

App_Set_DlBuffer_Index()

void App_Set_DlBuffer_Index

(

uint32_t

index

)

Set DL buffer index.

Parameters

index

Definition at line 485 of file FlashHelper.c.

{
    DlBuffer_Index = index;
}

App_WrDl_Buffer()

void App_WrDl_Buffer	(	Gpu_Hal_Context_t *	phost,
		uint32_t	cmd
	)

Write DL command to buffer.

Parameters

phost	Pointer to Hal context
cmd	DL command

Definition at line 444 of file FlashHelper.c.

{
#ifdef BUFFER_OPTIMIZATION  
    /* Copy the command instruction into buffer */
    uint32_t* pBuffcmd;
    /* Prevent buffer overflow */
    if (DlBuffer_Index < DL_SIZE)
    {
        pBuffcmd = (uint32_t*)&DlBuffer[DlBuffer_Index];
        *pBuffcmd = cmd;
    }
    else
    {
        printf("DlBuffer overflow\n");
    }
#else
    EVE_Hal_wr32(phost, (RAM_DL + DlBuffer_Index), cmd);
#endif
    /* Increment the command index */
    DlBuffer_Index += CMD_SIZE;
}

Esd_Calibrate()

ft_bool_t Esd_Calibrate

(

EVE_HalContext *

phost

)

Do calibration.

Returns

ft_bool_t True on successfull or otherwise

Definition at line 42 of file FlashHelper.c.

{
    ft_uint32_t result;
    ft_uint32_t transMatrix[6];
#if defined(EVE_SUPPORT_CAPACITIVE)
    EVE_Hal_wr8(phost, REG_CTOUCH_EXTENDED, CTOUCH_MODE_COMPATIBILITY);
#else
    EVE_Hal_wr8(phost, REG_TOUCH_ADC_MODE, ADC_DIFFERENTIAL);
#endif
 
    eve_printf_debug("App_CoPro_Widget_Calibrate: Start\n");
 
    EVE_CoCmd_dlStart(phost);
    EVE_Cmd_wr32(phost, CLEAR_COLOR_RGB(64, 64, 64));
    EVE_Cmd_wr32(phost, CLEAR(1, 1, 1));
    EVE_Cmd_wr32(phost, COLOR_RGB(0xff, 0xff, 0xff));
 
    EVE_CoCmd_text(phost, (uint16_t)(phost->Width / 2), (uint16_t)(phost->Height / 2), 27, OPT_CENTER, "Please Tap on the dot");
 
    result = EVE_CoCmd_calibrate(phost);
    EVE_Cmd_waitFlush(phost);
 
    eve_printf_debug("App_CoPro_Widget_Calibrate: End\n");
 
    // Print the configured values
    EVE_Hal_rdMem(phost, (ft_uint8_t*)transMatrix, REG_TOUCH_TRANSFORM_A, 4 * 6); //read all the 6 coefficients
    eve_printf_debug("Touch screen transform values are A 0x%x,B 0x%x,C 0x%x,D 0x%x,E 0x%x, F 0x%x\n",
        transMatrix[0], transMatrix[1], transMatrix[2], transMatrix[3], transMatrix[4], transMatrix[5]);
 
    return result != 0;
}

fadein()

void fadein

(

EVE_HalContext *

phost

)

Fadein animation perform display fadein effect by changing the display PWM from 0 till 100 and finally 128.

Parameters

phost

Pointer to Hal context

Definition at line 542 of file FlashHelper.c.

{
    for (int8_t i = 0; i <= 100; i += 3)
    {
        EVE_Hal_wr8(phost, REG_PWM_DUTY, i);
        EVE_sleep(2);//sleep for 2 ms
    }
    /* Finally make the PWM 100% */
    uint8_t i = 128;
    EVE_Hal_wr8(phost, REG_PWM_DUTY, i);
}

fadeout()

void fadeout

(

EVE_HalContext *

phost

)

Fadeout animation.

Parameters

phost

Pointer to Hal context

Definition at line 527 of file FlashHelper.c.

{
    for (int8_t i = 100; i >= 0; i -= 3)
    {
        EVE_Hal_wr8(phost, REG_PWM_DUTY, i);
        EVE_sleep(2);//sleep for 2 ms
    }
}

Fifo_GetFreeSpace()

uint32_t Fifo_GetFreeSpace	(	Gpu_Hal_Context_t *	host,
		Fifo_t *	pFifo
	)

get the free space in the fifo

Parameters

host	Pointer to Hal context
pFifo	Fifo pointer

Returns

uint32_t

Definition at line 701 of file FlashHelper.c.

{
    uint32_t FreeSpace = 0;
 
    Fifo_Update(host, pFifo);
 
    if (pFifo->fifo_wp >= pFifo->fifo_rp)
    {
        FreeSpace = pFifo->fifo_len - pFifo->fifo_wp + pFifo->fifo_rp;
    }
    else
    {
        FreeSpace = pFifo->fifo_rp - pFifo->fifo_wp;
    }
 
    if (FreeSpace >= 4)
    {
        FreeSpace -= 4;//make sure 1 word space is maintained between rd and wr pointers
    }
    return FreeSpace;
}

Fifo_Init()

void Fifo_Init	(	Fifo_t *	pFifo,
		uint32_t	StartAddress,
		uint32_t	Length,
		uint32_t	HWReadRegAddress,
		uint32_t	HWWriteRegAddress
	)

Init mediafifo.

Parameters

pFifo	Fifo pointer
StartAddress	Address on RAM_G
Length	Fifo length
HWReadRegAddress	REG_MEDIAFIFO_READ
HWWriteRegAddress	REG_MEDIAFIFO_WRITE

Definition at line 563 of file FlashHelper.c.

{
    /* update the context parameters */
    pFifo->fifo_buff = StartAddress;
    pFifo->fifo_len = Length;
    pFifo->fifo_rp = pFifo->fifo_wp = 0;
 
    /* update the hardware register addresses - specific to FT800 series chips */
    pFifo->HW_Read_Reg = HWReadRegAddress;
    pFifo->HW_Write_Reg = HWWriteRegAddress;
}

Fifo_Update()

void Fifo_Update	(	Gpu_Hal_Context_t *	host,
		Fifo_t *	pFifo
	)

update both the read and write pointers

Parameters

host	Pointer to Hal context
pFifo	Fifo poiner

Definition at line 581 of file FlashHelper.c.

{
    pFifo->fifo_rp = EVE_Hal_rd32(host, pFifo->HW_Read_Reg);
}

Fifo_Write()

uint32_t Fifo_Write	(	Gpu_Hal_Context_t *	host,
		Fifo_t *	pFifo,
		const uint8_t *	buffer,
		uint32_t	NumbytetoWrite
	)

write and update the write register

Parameters

host	Pointer to Hal context
pFifo	Fifo pointer
buffer
NumbytetoWrite

Returns

uint32_t

Definition at line 595 of file FlashHelper.c.

{
    uint32_t FreeSpace = Fifo_GetFreeSpace(host, pFifo);
    uint32_t TotalBytes = NumbytetoWrite;
 
    if (NumbytetoWrite > FreeSpace)
    {
        /* update the read pointer and get the free space */
        Fifo_Update(host, pFifo);
        FreeSpace = Fifo_GetFreeSpace(host, pFifo);
 
        if (NumbytetoWrite > FreeSpace)
        {
            TotalBytes = FreeSpace;
        }
    }
 
    /* sanity check */
    if (TotalBytes <= 0)
    {
        return 0;//error condition
    }
    /* check for the loopback conditions */
    if ((pFifo->fifo_wp + (int32_t)TotalBytes) >= pFifo->fifo_len)
    {
        uint32_t partialchunk = pFifo->fifo_len - pFifo->fifo_wp;
        uint32_t secpartialchunk = TotalBytes - partialchunk;
 
        EVE_Hal_wrMem(host, pFifo->fifo_buff + pFifo->fifo_wp, buffer, partialchunk);
        if (secpartialchunk > 0)
        {
            EVE_Hal_wrMem(host, pFifo->fifo_buff, buffer + partialchunk, secpartialchunk);
        }
        pFifo->fifo_wp = secpartialchunk;
 
    }
    else
    {
        EVE_Hal_wrMem(host, pFifo->fifo_buff + pFifo->fifo_wp, buffer, TotalBytes);
        pFifo->fifo_wp += TotalBytes;
    }
 
    /* update the write pointer address in write register */
    EVE_Hal_wr32(host, pFifo->HW_Write_Reg, pFifo->fifo_wp);
 
    return TotalBytes;
}

Fifo_Write32()

void Fifo_Write32	(	Gpu_Hal_Context_t *	host,
		Fifo_t *	pFifo,
		uint32_t	WriteWord
	)

write one word and update the write register

Parameters

host	Pointer to Hal context
pFifo	Fifo pointer
WriteWord	Word to write

Definition at line 689 of file FlashHelper.c.

{
    Fifo_WriteWait(host, pFifo, (uint8_t*)&WriteWord, 4);
}

Fifo_WriteWait()

void Fifo_WriteWait	(	Gpu_Hal_Context_t *	host,
		Fifo_t *	pFifo,
		const uint8_t *	buffer,
		uint32_t	Numbyte
	)

write and wait for the fifo to be empty. handle cases even if the Numbytes are more than freespace

Parameters

host	Pointer to Hal context
pFifo	Fifo pointer
buffer
Numbyte

Definition at line 659 of file FlashHelper.c.

{
    uint32_t TotalBytes = Numbyte;
    uint32_t currchunk = 0;
    uint32_t FreeSpace;
    const uint8_t* pbuff = buffer;
    /* blocking call, manage to check for the error case and break in case of error */
    while (TotalBytes > 0)
    {
        currchunk = TotalBytes;
        FreeSpace = Fifo_GetFreeSpace(host, pFifo);
        if (currchunk > FreeSpace)
        {
            currchunk = FreeSpace;
        }
 
        Fifo_Write(host, pFifo, pbuff, currchunk);
        pbuff += currchunk;
        TotalBytes -= currchunk;
 
    }
}

FlashHelper_GetSizeMB()

int32_t FlashHelper_GetSizeMB

(

Gpu_Hal_Context_t *

phost

)

Definition at line 723 of file FlashHelper.c.

{
    uint8_t status = Gpu_Hal_Rd8(phost, REG_FLASH_STATUS);
 
    if (status == FLASH_STATUS_DETACHED)
    {
        Gpu_CoCmd_FlashAttach(phost);
        App_Flush_Co_Buffer(phost);
        Gpu_Hal_WaitCmdfifo_empty(phost);
        status = Gpu_Hal_Rd8(phost, REG_FLASH_STATUS);
 
        if (FLASH_STATUS_BASIC != status)
        {
            printf("Error, Flash is not able to attach\n");
            return -1;
        }
    }
    int32_t size = Gpu_Hal_Rd32(phost, REG_FLASH_SIZE);
 
    return size;
}

Ft_Gpu_HorizontalScanoutFilter()

ft_void_t Ft_Gpu_HorizontalScanoutFilter	(	EVE_HalContext *	phost,
		uint32_t	physical_W,
		uint32_t	physical_H
	)

Adjust for non-sqare pixel panel.

Parameters

phost	Pointer to Hal context
physical_W	Panel width in inches
physical_H	Panel height in inches

Returns

ft_void_t

Definition at line 385 of file FlashHelper.c.

                                                                                                          {
    uint32_t eve_W = phost->Width;
    uint32_t eve_H = phost->Height;
    uint32_t logical_W = eve_H * physical_W / physical_H;
 
    // Configure panel
    EVE_Hal_wr32(phost, REG_HSIZE, logical_W);
    EVE_CoCmd_hsf(phost, eve_W);
}

GPU_DLSwap()

void GPU_DLSwap	(	Gpu_Hal_Context_t *	phost,
		uint8_t	DL_Swap_Type
	)

API to check the status of previous DLSWAP and perform DLSWAP of new DL Check for the status of previous DLSWAP and if still not done wait for few ms and check again.

Parameters

phost	Pointer to Hal context
DL_Swap_Type	DL list swap type

Definition at line 497 of file FlashHelper.c.

{
    uint8_t Swap_Type = DLSWAP_FRAME;
    uint8_t Swap_Done = DLSWAP_FRAME;
 
    if (DL_Swap_Type == DLSWAP_LINE)
    {
        Swap_Type = DLSWAP_LINE;
    }
 
    /* Perform a new DL swap */
    EVE_Hal_wr8(phost, REG_DLSWAP, Swap_Type);
 
    /* Wait till the swap is done */
    while (Swap_Done)
    {
        Swap_Done = EVE_Hal_rd8(phost, REG_DLSWAP);
 
        if (DLSWAP_DONE != Swap_Done)
        {
            EVE_sleep(10);//wait for 10ms
        }
    }
}

Variable Documentation

DlBuffer_Index

uint32_t DlBuffer_Index

Definition at line 432 of file FlashHelper.c.