EVE_HalDefs.h File Reference

Eve_Hal framework APIs. More...

#include "EVE_GpuTypes.h"
#include "ff.h"

Go to the source code of this file.

Data Structures
struct	EVE_DeviceInfo
struct	EVE_HalParameters
struct	EVE_HalDlState
struct	EVE_HalContext
struct	EVE_HalPlatform

Macros
#define	RAM_ERR_REPORT_MAX   128
#define	EVE_DL_STATE   phost->DlState[phost->DlStateIndex]

Typedefs
typedef enum EVE_MODE_T	EVE_MODE_T
typedef enum EVE_STATUS_T	EVE_STATUS_T
typedef enum EVE_TRANSFER_T	EVE_TRANSFER_T
typedef enum EVE_CHIPID_T	EVE_CHIPID_T
typedef struct EVE_HalContext	EVE_HalContext
typedef bool(*	EVE_Callback) (EVE_HalContext *phost)
typedef int(*	EVE_CoCmdHook) (EVE_HalContext *phost, uint32_t cmd, uint32_t state)
typedef void(*	EVE_ResetCallback) (EVE_HalContext *phost, bool fault)
typedef enum EVE_HOST_T	EVE_HOST_T
typedef struct EVE_DeviceInfo	EVE_DeviceInfo
typedef struct EVE_HalParameters	EVE_HalParameters
typedef struct EVE_HalDlState	EVE_HalDlState
typedef struct EVE_HalPlatform	EVE_HalPlatform

Enumerations
enum	EVE_MODE_T { EVE_MODE_UNKNOWN = 0 , EVE_MODE_I2C , EVE_MODE_SPI }
enum	EVE_STATUS_T {   EVE_STATUS_CLOSED = 0 , EVE_STATUS_OPENED , EVE_STATUS_READING , EVE_STATUS_WRITING ,   EVE_STATUS_ERROR }
enum	EVE_TRANSFER_T { EVE_TRANSFER_NONE = 0 , EVE_TRANSFER_READ , EVE_TRANSFER_WRITE }
enum	EVE_CHIPID_T {   EVE_CHIPID_FT800 = EVE_FT800 , EVE_CHIPID_FT801 = EVE_FT801 , EVE_CHIPID_FT810 = EVE_FT810 , EVE_CHIPID_FT811 = EVE_FT811 ,   EVE_CHIPID_FT812 = EVE_FT812 , EVE_CHIPID_FT813 = EVE_FT813 , EVE_CHIPID_BT880 = EVE_BT880 , EVE_CHIPID_BT881 = EVE_BT881 ,   EVE_CHIPID_BT882 = EVE_BT882 , EVE_CHIPID_BT883 = EVE_BT883 , EVE_CHIPID_BT815 = EVE_BT815 , EVE_CHIPID_BT816 = EVE_BT816 ,   EVE_CHIPID_BT817 = EVE_BT817 , EVE_CHIPID_BT818 = EVE_BT818 }
enum	EVE_HOST_T {   EVE_HOST_UNKNOWN = 0 , EVE_HOST_BT8XXEMU , EVE_HOST_FT4222 , EVE_HOST_MPSSE ,   EVE_HOST_EMBEDDED , EVE_HOST_NB }

Functions
INIT
EVE_HAL_EXPORT EVE_HalPlatform *	EVE_Hal_initialize ()
	Eve_Hal framework initialization.
EVE_HAL_EXPORT void	EVE_Hal_release ()
	Close Eve_Hal framework.
EVE_HAL_EXPORT size_t	EVE_Hal_list ()
	List the available devices.
EVE_HAL_EXPORT void	EVE_Hal_info (EVE_DeviceInfo *deviceInfo, size_t deviceIdx)
	Get info of the specified device. Devices of type EVE_HOST_UNKNOWN should be ignored.
EVE_HAL_EXPORT bool	EVE_Hal_isDevice (EVE_HalContext *phost, size_t deviceIdx)
	Check whether the context is the specified device.
EVE_HAL_EXPORT void	EVE_Hal_defaults (EVE_HalParameters *parameters)
	Setup default parameters for Eve_Hal framework.
EVE_HAL_EXPORT void	EVE_Hal_defaultsEx (EVE_HalParameters *parameters, size_t deviceIdx)
	Setup default parameters for Eve_Hal framework.
EVE_HAL_EXPORT bool	EVE_Hal_open (EVE_HalContext *phost, const EVE_HalParameters *parameters)
	Open the Eve_Hal framework.
EVE_HAL_EXPORT void	EVE_Hal_close (EVE_HalContext *phost)
	Close the Eve_Hal framework.
EVE_HAL_EXPORT void	EVE_Hal_idle (EVE_HalContext *phost)
	Idle handler for Eve_Hal framework.
TRANSFER
EVE_HAL_EXPORT void	EVE_Hal_startTransfer (EVE_HalContext *phost, EVE_TRANSFER_T rw, uint32_t addr)
	Start data transfer to Coprocessor.
EVE_HAL_EXPORT uint8_t	EVE_Hal_transfer8 (EVE_HalContext *phost, uint8_t value)
	Write 8 bits to Coprocessor.
EVE_HAL_EXPORT uint16_t	EVE_Hal_transfer16 (EVE_HalContext *phost, uint16_t value)
	Write 2 bytes to Coprocessor.
EVE_HAL_EXPORT uint32_t	EVE_Hal_transfer32 (EVE_HalContext *phost, uint32_t value)
	Write 4 bytes to Coprocessor.
EVE_HAL_EXPORT void	EVE_Hal_transferMem (EVE_HalContext *phost, uint8_t *result, const uint8_t *buffer, uint32_t size)
	Transfer (read/write) a block data to Coprocessor.
EVE_HAL_EXPORT void	EVE_Hal_transferProgMem (EVE_HalContext *phost, uint8_t *result, eve_progmem_const uint8_t *buffer, uint32_t size)
	Transfer a block data from program memory.
EVE_HAL_EXPORT uint32_t	EVE_Hal_transferString (EVE_HalContext *phost, const char *str, uint32_t index, uint32_t size, uint32_t padMask)
	Transfer a string to EVE platform.
EVE_HAL_EXPORT void	EVE_Hal_endTransfer (EVE_HalContext *phost)
	End data transfer.
EVE_HAL_EXPORT void	EVE_Hal_flush (EVE_HalContext *phost)
	Flush data to Coprocessor.
TRANSFER HELPERS
EVE_HAL_EXPORT uint8_t	EVE_Hal_rd8 (EVE_HalContext *phost, uint32_t addr)
	Read 8 bits from Coprocessor's memory.
EVE_HAL_EXPORT uint16_t	EVE_Hal_rd16 (EVE_HalContext *phost, uint32_t addr)
	Read 2 bytes from Coprocessor's memory.
EVE_HAL_EXPORT uint32_t	EVE_Hal_rd32 (EVE_HalContext *phost, uint32_t addr)
	Read 4 bytes from Coprocessor's memory.
EVE_HAL_EXPORT void	EVE_Hal_rdMem (EVE_HalContext *phost, uint8_t *result, uint32_t addr, uint32_t size)
	Read a block data from Coprocessor's memory.
EVE_HAL_EXPORT void	EVE_Hal_wr8 (EVE_HalContext *phost, uint32_t addr, uint8_t v)
	Write 8 bits to Coprocessor's memory.
EVE_HAL_EXPORT void	EVE_Hal_wr16 (EVE_HalContext *phost, uint32_t addr, uint16_t v)
	Write 2 bytes to Coprocessor's memory.
EVE_HAL_EXPORT void	EVE_Hal_wr32 (EVE_HalContext *phost, uint32_t addr, uint32_t v)
	Write 4 bytes to Coprocessor's memory.
EVE_HAL_EXPORT void	EVE_Hal_wrMem (EVE_HalContext *phost, uint32_t addr, const uint8_t *buffer, uint32_t size)
	Write a buffer to Coprocessor's memory.
EVE_HAL_EXPORT void	EVE_Hal_wrProgMem (EVE_HalContext *phost, uint32_t addr, eve_progmem_const uint8_t *buffer, uint32_t size)
	Write a buffer in ProgMem to Coprocessor's memory.
EVE_HAL_EXPORT void	EVE_Hal_wrString (EVE_HalContext *phost, uint32_t addr, const char *str, uint32_t index, uint32_t size, uint32_t padMask)
	Write a string to Coprocessor's memory.
CAPS
static bool	EVE_Hal_isScreenCapacitive (EVE_HalContext *phost)
static bool	EVE_Hal_isScreenResistive (EVE_HalContext *phost)
static bool	EVE_Hal_supportHsf (EVE_HalContext *phost)
static bool	EVE_Hal_supportFlash (EVE_HalContext *phost)
static bool	EVE_Hal_supportCmdB (EVE_HalContext *phost)
static bool	EVE_Hal_supportMediaFifo (EVE_HalContext *phost)
static bool	EVE_Hal_supportVideo (EVE_HalContext *phost)
static bool	EVE_Hal_supportLargeFont (EVE_HalContext *phost)
static EVE_CHIPID_T	EVE_extendedChipId (int chipId)
static int	EVE_shortChipId (EVE_CHIPID_T chipId)
static int	EVE_gen (EVE_CHIPID_T chipId)
UTILITY
EVE_HAL_EXPORT void	EVE_Hal_hostCommand (EVE_HalContext *phost, uint8_t cmd)
	Send a host command to Coprocessor.
EVE_HAL_EXPORT void	EVE_Hal_hostCommandExt3 (EVE_HalContext *phost, uint32_t cmd)
	This API sends a 3byte command to the phost.
EVE_HAL_EXPORT bool	EVE_Hal_powerCycle (EVE_HalContext *phost, bool up)
	Toggle PD_N pin of FT800 board for a power cycle.
EVE_HAL_EXPORT void	EVE_Hal_setSPI (EVE_HalContext *phost, EVE_SPI_CHANNELS_T numchnls, uint8_t numdummy)
	Set number of SPI channel.
EVE_HAL_EXPORT void	EVE_Hal_restoreSPI (EVE_HalContext *phost)
EVE_HAL_EXPORT uint32_t	EVE_Hal_currentFrequency (EVE_HalContext *phost)
	Get current system clock of Coprocessor.
EVE_HAL_EXPORT int32_t	EVE_Hal_clockTrimming (EVE_HalContext *phost, uint32_t lowFreq)
	Trim the internal clock till the measured frequency is within the acceptable range.
HOST
EVE_HAL_EXPORT void	EVE_Host_clockSelect (EVE_HalContext *phost, EVE_PLL_SOURCE_T pllsource)
	Select clock source for Coprocessor.
EVE_HAL_EXPORT void	EVE_Host_pllFreqSelect (EVE_HalContext *phost, EVE_PLL_FREQ_T freq)
	Select system clock for Coprocessor.
EVE_HAL_EXPORT void	EVE_Host_powerModeSwitch (EVE_HalContext *phost, EVE_POWER_MODE_T pwrmode)
	Switch power mode for Coprocessor.
EVE_HAL_EXPORT void	EVE_Host_coreReset (EVE_HalContext *phost)
	Send reset signal to Coprocessor.
EVE_HAL_EXPORT void	EVE_Host_selectSysClk (EVE_HalContext *phost, EVE_81X_PLL_FREQ_T freq)
	Set system clock for Coprocessor.
EVE_HAL_EXPORT void	EVE_Host_powerOffComponents (EVE_HalContext *phost, uint8_t val)
	Power off a component.
EVE_HAL_EXPORT void	EVE_Host_padDriveStrength (EVE_HalContext *phost, EVE_81X_GPIO_DRIVE_STRENGTH_T strength, EVE_81X_GPIO_GROUP_T group)
	Set the drive strength for various pins.
EVE_HAL_EXPORT void	EVE_Host_resetActive (EVE_HalContext *phost)
	Hold the device in reset state.
EVE_HAL_EXPORT void	EVE_Host_resetRemoval (EVE_HalContext *phost)
	Exit reset state, Eve will power on and enter into its default state.
MISC
EVE_HAL_EXPORT uint32_t	EVE_millis ()
	Get clock in miliseond.
EVE_HAL_EXPORT uint64_t	EVE_millis64 ()
	Get clock in miliseond.
EVE_HAL_EXPORT void	EVE_sleep (uint32_t ms)
	Sleep in milisecond.

DEBUG
#define	EVE_Hal_displayMessageZ(phost, str)   EVE_Hal_displayMessage((phost), (str), (uint16_t)strlen((str)))
EVE_HAL_EXPORT void	EVE_Hal_displayMessage (EVE_HalContext *phost, const char *str, uint16_t size)
	Display a fullscreen debug message using TEXT8X8. Uses the back of RAM_G.

Detailed Description

Eve_Hal framework APIs.

This file defines the generic APIs of phost access layer for the FT800 or EVE compatible silicon. Application shall access FT800 or EVE resources over these APIs,regardless of I2C or SPI protocol. In addition, there are some helper functions defined for FT800 coprocessor engine as well as phost commands.

Author

Bridgetek

Date

2018

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 EVE_HalDefs.h.

Macro Definition Documentation

EVE_DL_STATE

#define EVE_DL_STATE   phost->DlState[phost->DlStateIndex]

Definition at line 198 of file EVE_HalDefs.h.

EVE_Hal_displayMessageZ

#define EVE_Hal_displayMessageZ	(		phost,
			str
	)		EVE_Hal_displayMessage((phost), (str), (uint16_t)strlen((str)))

Display a fullscreen debug message using TEXT8X8. Uses the back of RAM_G.

Definition at line 676 of file EVE_HalDefs.h.

RAM_ERR_REPORT_MAX

#define RAM_ERR_REPORT_MAX   128

Definition at line 89 of file EVE_HalDefs.h.

Typedef Documentation

EVE_Callback

typedef bool(* EVE_Callback) (EVE_HalContext *phost)

Definition at line 96 of file EVE_HalDefs.h.

EVE_CHIPID_T

typedef enum EVE_CHIPID_T EVE_CHIPID_T

EVE_CoCmdHook

typedef int(* EVE_CoCmdHook) (EVE_HalContext *phost, uint32_t cmd, uint32_t state)

Hook into coprocessor commands. Return 1 to abort the command. Useful for an optimization routine

Definition at line 99 of file EVE_HalDefs.h.

EVE_DeviceInfo

typedef struct EVE_DeviceInfo EVE_DeviceInfo

EVE_HalContext

typedef struct EVE_HalContext EVE_HalContext

Definition at line 95 of file EVE_HalDefs.h.

EVE_HalDlState

typedef struct EVE_HalDlState EVE_HalDlState

EVE_HalParameters

typedef struct EVE_HalParameters EVE_HalParameters

Hal parameters

EVE_HalPlatform

typedef struct EVE_HalPlatform EVE_HalPlatform

EVE_HOST_T

typedef enum EVE_HOST_T EVE_HOST_T

EVE_MODE_T

typedef enum EVE_MODE_T EVE_MODE_T

EVE_ResetCallback

typedef void(* EVE_ResetCallback) (EVE_HalContext *phost, bool fault)

Hook into coprocessor reset

Definition at line 101 of file EVE_HalDefs.h.

EVE_STATUS_T

typedef enum EVE_STATUS_T EVE_STATUS_T

EVE_TRANSFER_T

typedef enum EVE_TRANSFER_T EVE_TRANSFER_T

Enumeration Type Documentation

EVE_CHIPID_T

enum EVE_CHIPID_T

Enumerator
EVE_CHIPID_FT800	EVE_FT800
EVE_CHIPID_FT801	EVE_FT801
EVE_CHIPID_FT810	EVE_FT810
EVE_CHIPID_FT811	EVE_FT811
EVE_CHIPID_FT812	EVE_FT812
EVE_CHIPID_FT813	EVE_FT813
EVE_CHIPID_BT880	EVE_BT880
EVE_CHIPID_BT881	EVE_BT881
EVE_CHIPID_BT882	EVE_BT882
EVE_CHIPID_BT883	EVE_BT883
EVE_CHIPID_BT815	EVE_BT815
EVE_CHIPID_BT816	EVE_BT816
EVE_CHIPID_BT817	EVE_BT817
EVE_CHIPID_BT818	EVE_BT818

Definition at line 71 of file EVE_HalDefs.h.

{
    EVE_CHIPID_FT800 = EVE_FT800, 
    EVE_CHIPID_FT801 = EVE_FT801, 
    EVE_CHIPID_FT810 = EVE_FT810, 
    EVE_CHIPID_FT811 = EVE_FT811, 
    EVE_CHIPID_FT812 = EVE_FT812, 
    EVE_CHIPID_FT813 = EVE_FT813, 
    EVE_CHIPID_BT880 = EVE_BT880, 
    EVE_CHIPID_BT881 = EVE_BT881, 
    EVE_CHIPID_BT882 = EVE_BT882, 
    EVE_CHIPID_BT883 = EVE_BT883, 
    EVE_CHIPID_BT815 = EVE_BT815, 
    EVE_CHIPID_BT816 = EVE_BT816, 
    EVE_CHIPID_BT817 = EVE_BT817, 
    EVE_CHIPID_BT818 = EVE_BT818, 
} EVE_CHIPID_T;

EVE_HOST_T

enum EVE_HOST_T

Enumerator
EVE_HOST_UNKNOWN	0
EVE_HOST_BT8XXEMU
EVE_HOST_FT4222
EVE_HOST_MPSSE
EVE_HOST_EMBEDDED
EVE_HOST_NB

Definition at line 131 of file EVE_HalDefs.h.

{
    EVE_HOST_UNKNOWN = 0, 
    EVE_HOST_BT8XXEMU,
    EVE_HOST_FT4222,
    EVE_HOST_MPSSE,
    EVE_HOST_EMBEDDED,
 
    EVE_HOST_NB
} EVE_HOST_T;

EVE_MODE_T

enum EVE_MODE_T

Enumerator
EVE_MODE_UNKNOWN	0
EVE_MODE_I2C
EVE_MODE_SPI

Definition at line 48 of file EVE_HalDefs.h.

{
    EVE_MODE_UNKNOWN = 0, 
    EVE_MODE_I2C,
    EVE_MODE_SPI,
} EVE_MODE_T;

EVE_STATUS_T

enum EVE_STATUS_T

Enumerator
EVE_STATUS_CLOSED	0
EVE_STATUS_OPENED
EVE_STATUS_READING
EVE_STATUS_WRITING
EVE_STATUS_ERROR

Definition at line 55 of file EVE_HalDefs.h.

{
    EVE_STATUS_CLOSED = 0, 
    EVE_STATUS_OPENED,
    EVE_STATUS_READING,
    EVE_STATUS_WRITING,
    EVE_STATUS_ERROR,
} EVE_STATUS_T;

EVE_TRANSFER_T

enum EVE_TRANSFER_T

Enumerator
EVE_TRANSFER_NONE	0
EVE_TRANSFER_READ
EVE_TRANSFER_WRITE

Definition at line 64 of file EVE_HalDefs.h.

{
    EVE_TRANSFER_NONE = 0, 
    EVE_TRANSFER_READ,
    EVE_TRANSFER_WRITE,
} EVE_TRANSFER_T;

Function Documentation

EVE_extendedChipId()

static EVE_CHIPID_T EVE_extendedChipId ( int  chipId )

inlinestatic

Include the EVE generation in the chip ID value to simplify feature set comparisons(BT880 support)

Definition at line 540 of file EVE_HalDefs.h.

{
    switch (chipId & 0xFFFF)
    {
    case EVE_FT800 & 0xFFFF:
    case EVE_FT801 & 0xFFFF:
        return (EVE_CHIPID_T)((chipId & 0xFFFF) | 0x10000);
    case EVE_FT810 & 0xFFFF:
    case EVE_FT811 & 0xFFFF:
    case EVE_FT812 & 0xFFFF:
    case EVE_FT813 & 0xFFFF:
    case EVE_BT880 & 0xFFFF:
    case EVE_BT881 & 0xFFFF:
    case EVE_BT882 & 0xFFFF:
    case EVE_BT883 & 0xFFFF:
        return (EVE_CHIPID_T)((chipId & 0xFFFF) | 0x20000);
    case EVE_BT815 & 0xFFFF:
    case EVE_BT816 & 0xFFFF:
        return (EVE_CHIPID_T)((chipId & 0xFFFF) | 0x30000);
    case EVE_BT817 & 0xFFFF:
    case EVE_BT818 & 0xFFFF:
        return (EVE_CHIPID_T)((chipId & 0xFFFF) | 0x40000);
    default:
        break;
    }
    return (EVE_CHIPID_T)(chipId & 0xFFFF);
}

EVE_gen()

static int EVE_gen ( EVE_CHIPID_T  chipId )

inlinestatic

Definition at line 574 of file EVE_HalDefs.h.

{
    switch (chipId)
    {
    case EVE_FT800:
    case EVE_FT801:
        return EVE1;
    case EVE_FT810:
    case EVE_FT811:
    case EVE_FT812:
    case EVE_FT813:
    case EVE_BT880:
    case EVE_BT881:
    case EVE_BT882:
    case EVE_BT883:
        return EVE2;
    case EVE_BT815:
    case EVE_BT816:
        return EVE3;
    case EVE_BT817:
    case EVE_BT818:
        return EVE4;
    default:
        break;
    }
    return 0;
}

EVE_Hal_clockTrimming()

EVE_HAL_EXPORT int32_t EVE_Hal_clockTrimming	(	EVE_HalContext *	phost,
		uint32_t	lowFreq
	)

Trim the internal clock till the measured frequency is within the acceptable range.

Parameters

phost	Pointer to Hal context
lowFreq	Low frequency target to trim

Returns

int32_t frequency after trim

Definition at line 317 of file EVE_Hal.c.

{
    uint32_t f;
 
    /* Trim the internal clock by increase the REG_TRIM register till the measured frequency is within the acceptable range.*/
    f = EVE_Hal_currentFrequency(phost);
    for (uint8_t i = 0; i < 31 && f < lowFreq; i++)
    {
        EVE_Hal_wr8(phost, REG_TRIM, i); /* increase the REG_TRIM register value automatically increases the internal clock */
        f = EVE_Hal_currentFrequency(phost);
    }
    EVE_Hal_wr32(phost, REG_FREQUENCY, f); /* Set the final frequency to be used for internal operations */
 
    return f;
}

EVE_Hal_close()

EVE_HAL_EXPORT void EVE_Hal_close

(

EVE_HalContext *

phost

)

Close the Eve_Hal framework.

Close a HAL context

Parameters

phost

Pointer to Hal context

Definition at line 116 of file EVE_Hal.c.

{
    if (phost->Status == EVE_STATUS_CLOSED)
    {
        eve_printf_debug("Attempt to close HAL context that is already closed\n");
        return;
    }
 
#ifdef EVE_SUPPORT_MEDIAFIFO
    EVE_Util_closeFile(phost);
#endif
    EVE_HalImpl_close(phost);
    memset(phost, 0, sizeof(EVE_HalContext));
}

EVE_Hal_currentFrequency()

EVE_HAL_EXPORT uint32_t EVE_Hal_currentFrequency

(

EVE_HalContext *

phost

)

Get current system clock of Coprocessor.

Parameters

phost

Pointer to Hal context

Returns

uint32_t Frequency of Coprocessor

Definition at line 650 of file EVE_HalImpl_FT9XX.c.

{
    uint32_t t0;
    uint32_t t1;
    int32_t r = 15625;
 
    t0 = EVE_Hal_rd32(phost, REG_CLOCK); /* t0 read */
 
    __asm__(
        "   move.l  $r0,%0               \n\t"
        "   mul.l   $r0,$r0,100          \n\t"
        "1:                              \n\t"
        "   sub.l   $r0,$r0,3            \n\t" /* Subtract the loop time = 4 cycles */
        "   cmp.l   $r0,0                \n\t" /* Check that the counter is equal to 0 */
        "   jmpc    gt, 1b               \n\t"
        : /* Outputs */
        : "r"(r) /* Inputs */
        : "$r0"); /* Using */
 
    t1 = EVE_Hal_rd32(phost, REG_CLOCK); /* t1 read */
    return ((t1 - t0) << 6); /* bitshift 6 places is the same as multiplying 64 */
}

EVE_Hal_defaults()

EVE_HAL_EXPORT void EVE_Hal_defaults

(

EVE_HalParameters *

parameters

)

Setup default parameters for Eve_Hal framework.

Get the default configuration parameters

Parameters

parameters

Pointer to EVE_HalParameters

Definition at line 78 of file EVE_Hal.c.

{
    EVE_Hal_defaultsEx(parameters, -1);
}

EVE_Hal_defaultsEx()

EVE_HAL_EXPORT void EVE_Hal_defaultsEx	(	EVE_HalParameters *	parameters,
		size_t	deviceIdx
	)

Setup default parameters for Eve_Hal framework.

Get the default configuration parameters. Use deviceIdx to choose the connected device, or set to -1 to get the first available device.

Parameters

parameters	Pointer to EVE_HalParameters
deviceIdx

Definition at line 89 of file EVE_Hal.c.

{
    memset(parameters, 0, sizeof(EVE_HalParameters));
    eve_assert_do(EVE_HalImpl_defaults(parameters, deviceIdx));
}

EVE_Hal_displayMessage()

EVE_HAL_EXPORT void EVE_Hal_displayMessage	(	EVE_HalContext *	phost,
		const char *	str,
		uint16_t	size
	)

Display a fullscreen debug message using TEXT8X8. Uses the back of RAM_G.

Display a fullscreen debug message using TEXT8X8. Uses the back of RAM_G.

Parameters

phost	Pointer to Hal context
str	Error message to show
size	Size of the message

Definition at line 486 of file EVE_Hal.c.

{
    uint32_t round = ((size + 31U) & ~31U);
    uint32_t addr = RAM_G + RAM_G_SIZE - round;
    uint32_t dl = 0;
 
    /* Abuse back of RAM_G to store error */
    /* May invalidate user data... */
    EVE_Hal_wrMem(phost, addr, (uint8_t *)str, size);
 
    /* Empty remaining space after text */
    EVE_Hal_startTransfer(phost, EVE_TRANSFER_WRITE, addr + size);
    for (uint32_t i = size; i < round; ++i)
        EVE_Hal_transfer8(phost, 0);
    EVE_Hal_endTransfer(phost);
 
    /* Generate bluescreen */
    EVE_Hal_wr32(phost, RAM_DL + ((dl++) << 2), CLEAR_COLOR_RGB(0x00, 0x20, 0x40));
    EVE_Hal_wr32(phost, RAM_DL + ((dl++) << 2), CLEAR(1, 1, 1));
    EVE_Hal_wr32(phost, RAM_DL + ((dl++) << 2), BITMAP_HANDLE(15)); /* Scratch handle will reset anyway after reset */
    EVE_Hal_wr32(phost, RAM_DL + ((dl++) << 2), BITMAP_SOURCE(addr));
    EVE_Hal_wr32(phost, RAM_DL + ((dl++) << 2), BITMAP_SIZE_H(0, 0));
    EVE_Hal_wr32(phost, RAM_DL + ((dl++) << 2), BITMAP_SIZE(NEAREST, BORDER, BORDER, 256, (round >> 2)));
    EVE_Hal_wr32(phost, RAM_DL + ((dl++) << 2), BITMAP_LAYOUT_H(0, 0));
    EVE_Hal_wr32(phost, RAM_DL + ((dl++) << 2), BITMAP_LAYOUT(TEXT8X8, 32, (round >> 2)));
    EVE_Hal_wr32(phost, RAM_DL + ((dl++) << 2), BEGIN(BITMAPS));
    EVE_Hal_wr32(phost, RAM_DL + ((dl++) << 2), VERTEX2II(32, 32, 15, 0));
#if ENABLE_ERR_REPORT
    EVE_Hal_wr32(phost, RAM_DL + ((dl++) << 2), BITMAP_SOURCE(RAM_ERR_REPORT));
    EVE_Hal_wr32(phost, RAM_DL + ((dl++) << 2), VERTEX2II(32, 96, 15, 0));
#endif
    EVE_Hal_wr32(phost, RAM_DL + ((dl++) << 2), DISPLAY());
    EVE_Hal_wr8(phost, REG_DLSWAP, DLSWAP_FRAME);
}

EVE_Hal_endTransfer()

EVE_HAL_EXPORT void EVE_Hal_endTransfer

(

EVE_HalContext *

phost

)

End data transfer.

Parameters

phost

Pointer to Hal context

Definition at line 291 of file EVE_HalImpl_FT9XX.c.

{
    eve_assert(phost->Status == EVE_STATUS_READING || phost->Status == EVE_STATUS_WRITING);
 
    spi_close(SPIM, phost->SpiCsPin);
    phost->Status = EVE_STATUS_OPENED;
}

EVE_Hal_flush()

EVE_HAL_EXPORT void EVE_Hal_flush

(

EVE_HalContext *

phost

)

Flush data to Coprocessor.

Flush any pending write transfers

Parameters

phost

Pointer to Hal context

Definition at line 304 of file EVE_HalImpl_FT9XX.c.

{
    eve_assert(phost->Status == EVE_STATUS_OPENED);
    /* no-op */
}

EVE_Hal_hostCommand()

EVE_HAL_EXPORT void EVE_Hal_hostCommand	(	EVE_HalContext *	phost,
		uint8_t	cmd
	)

Send a host command to Coprocessor.

Parameters

phost	Pointer to Hal context
cmd	Command to send

Definition at line 544 of file EVE_HalImpl_FT9XX.c.

{
    eve_assert(phost->Status == EVE_STATUS_OPENED);
 
    uint8_t hcmd[4] = { 0 };
    hcmd[0] = cmd;
    hcmd[1] = 0;
    hcmd[2] = 0;
    hcmd[3] = 0;
 
    spi_open(SPIM, phost->SpiCsPin);
    spi_writen(SPIM, hcmd, 3);
    spi_close(SPIM, phost->SpiCsPin);
}

EVE_Hal_hostCommandExt3()

EVE_HAL_EXPORT void EVE_Hal_hostCommandExt3	(	EVE_HalContext *	phost,
		uint32_t	cmd
	)

This API sends a 3byte command to the phost.

This API sends a 3byte command to the phost

Parameters

phost	Pointer to Hal context
cmd	Command to send

Definition at line 565 of file EVE_HalImpl_FT9XX.c.

{
    eve_assert(phost->Status == EVE_STATUS_OPENED);
 
    uint8_t hcmd[4] = { 0 };
    hcmd[0] = cmd & 0xff;
    hcmd[1] = (cmd >> 8) & 0xff;
    hcmd[2] = (cmd >> 16) & 0xff;
    hcmd[3] = 0;
 
    spi_open(SPIM, phost->SpiCsPin);
    spi_writen(SPIM, hcmd, 3);
    spi_close(SPIM, phost->SpiCsPin);
}

EVE_Hal_idle()

EVE_HAL_EXPORT void EVE_Hal_idle

(

EVE_HalContext *

phost

)

Idle handler for Eve_Hal framework.

Idle. Call regularly to update frequently changing internal state. This is also called while waiting for cmd, in addition to the user idle callback

Parameters

phost

Pointer to Hal context

Definition at line 136 of file EVE_Hal.c.

{
    EVE_HalImpl_idle(phost);
}

EVE_Hal_info()

EVE_HAL_EXPORT void EVE_Hal_info	(	EVE_DeviceInfo *	deviceInfo,
		size_t	deviceIdx
	)

Get info of the specified device. Devices of type EVE_HOST_UNKNOWN should be ignored.

Get info of the specified device. Devices of type EVE_HOST_UNKNOWN should be ignored

Parameters

deviceInfo
deviceIdx

Definition at line 87 of file EVE_HalImpl_FT9XX.c.

{
    memset(deviceInfo, 0, sizeof(EVE_DeviceInfo));
    strcpy_s(deviceInfo->DisplayName, sizeof(deviceInfo->DisplayName), "FT9XX");
    strcpy_s(deviceInfo->SerialNumber, sizeof(deviceInfo->SerialNumber), "FT9XX");
    deviceInfo->Host = EVE_HOST_EMBEDDED;
}

EVE_Hal_initialize()

EVE_HAL_EXPORT EVE_HalPlatform * EVE_Hal_initialize

(

)

Eve_Hal framework initialization.

Initialize HAL platform

Returns

EVE_HalPlatform* Poniter to EVE_HalPlatform struct

Definition at line 52 of file EVE_Hal.c.

{
    EVE_Mcu_initialize();
    EVE_Millis_initialize();
    EVE_HalImpl_initialize();
    return &g_HalPlatform;
}

EVE_Hal_isDevice()

EVE_HAL_EXPORT bool EVE_Hal_isDevice	(	EVE_HalContext *	phost,
		size_t	deviceIdx
	)

Check whether the context is the specified device.

Check whether the context is the specified device

Parameters

phost	Pointer to Hal context
deviceIdx

Returns

true True if ok

false False if error

Definition at line 103 of file EVE_HalImpl_FT9XX.c.

{
    return true;
}

EVE_Hal_isScreenCapacitive()

static bool EVE_Hal_isScreenCapacitive ( EVE_HalContext *  phost )

inlinestatic

Screen based on chip id. This function compiles as a constant on single supported chipid target

Definition at line 473 of file EVE_HalDefs.h.

{
    return (EVE_CHIPID & 0x01) == 0x01;
}

EVE_Hal_isScreenResistive()

static bool EVE_Hal_isScreenResistive ( EVE_HalContext *  phost )

inlinestatic

Screen based on chip id. This function compiles as a constant on single supported chipid target

Definition at line 479 of file EVE_HalDefs.h.

{
    return !EVE_Hal_isScreenCapacitive(phost);
}

EVE_Hal_list()

EVE_HAL_EXPORT size_t EVE_Hal_list

(

)

List the available devices.

List the available devices

Definition at line 76 of file EVE_HalImpl_FT9XX.c.

{
    return 1;
}

EVE_Hal_open()

EVE_HAL_EXPORT bool EVE_Hal_open	(	EVE_HalContext *	phost,
		const EVE_HalParameters *	parameters
	)

Open the Eve_Hal framework.

Opens a new HAL context using the specified parameters

Parameters

phost	Pointer to Hal context
parameters	Pointer to EVE_HalParameters

Returns

true True if ok

false False if error

Definition at line 103 of file EVE_Hal.c.

{
    memset(phost, 0, sizeof(EVE_HalContext));
    phost->UserContext = parameters->UserContext;
    phost->CbCmdWait = parameters->CbCmdWait;
    return EVE_HalImpl_open(phost, parameters);
}

EVE_Hal_powerCycle()

EVE_HAL_EXPORT bool EVE_Hal_powerCycle	(	EVE_HalContext *	phost,
		bool	up
	)

Toggle PD_N pin of FT800 board for a power cycle.

Toggle PD_N pin of FT800 board for a power cycle. Returns false on failure

Parameters

phost	Pointer to Hal context
up	Up or Down

Returns

true True if ok

false False if error

Definition at line 588 of file EVE_HalImpl_FT9XX.c.

{
    if (up)
    {
        gpio_write(phost->PowerDownPin, 0);
        EVE_sleep(20);
        setSPI(phost, EVE_SPI_SINGLE_CHANNEL, 1);
        gpio_write(phost->PowerDownPin, 1);
        EVE_sleep(20);
    }
    else
    {
        gpio_write(phost->PowerDownPin, 1);
        EVE_sleep(20);
        gpio_write(phost->PowerDownPin, 0);
        EVE_sleep(20);
    }
    return true;
}

EVE_Hal_rd16()

EVE_HAL_EXPORT uint16_t EVE_Hal_rd16	(	EVE_HalContext *	phost,
		uint32_t	addr
	)

Read 2 bytes from Coprocessor's memory.

Parameters

phost	Pointer to Hal context
addr	Address to be read

Returns

uint16_t Data from Coprocessor

Definition at line 173 of file EVE_Hal.c.

{
    uint16_t value;
    EVE_Hal_startTransfer(phost, EVE_TRANSFER_READ, addr);
    value = EVE_Hal_transfer16(phost, 0);
    EVE_Hal_endTransfer(phost);
    return value;
}

EVE_Hal_rd32()

EVE_HAL_EXPORT uint32_t EVE_Hal_rd32	(	EVE_HalContext *	phost,
		uint32_t	addr
	)

Read 4 bytes from Coprocessor's memory.

Parameters

phost	Pointer to Hal context
addr	Address to be read

Returns

uint16_t Data from Coprocessor

Definition at line 189 of file EVE_Hal.c.

{
    uint32_t value;
    EVE_Hal_startTransfer(phost, EVE_TRANSFER_READ, addr);
    value = EVE_Hal_transfer32(phost, 0);
    EVE_Hal_endTransfer(phost);
    return value;
}

EVE_Hal_rd8()

EVE_HAL_EXPORT uint8_t EVE_Hal_rd8	(	EVE_HalContext *	phost,
		uint32_t	addr
	)

Read 8 bits from Coprocessor's memory.

Parameters

phost	Pointer to Hal context
addr	Address to be read

Returns

uint8_t Data from Coprocessor

Definition at line 157 of file EVE_Hal.c.

{
    uint8_t value;
    EVE_Hal_startTransfer(phost, EVE_TRANSFER_READ, addr);
    value = EVE_Hal_transfer8(phost, 0);
    EVE_Hal_endTransfer(phost);
    return value;
}

EVE_Hal_rdMem()

EVE_HAL_EXPORT void EVE_Hal_rdMem	(	EVE_HalContext *	phost,
		uint8_t *	result,
		uint32_t	addr,
		uint32_t	size
	)

Read a block data from Coprocessor's memory.

Parameters

phost	Pointer to Hal context
result	Buffer where data write to
addr	Address to bbe read
size	Size to be read

Definition at line 206 of file EVE_Hal.c.

{
    EVE_Hal_startTransfer(phost, EVE_TRANSFER_READ, addr);
    EVE_Hal_transferMem(phost, result, NULL, size);
    EVE_Hal_endTransfer(phost);
}

EVE_Hal_release()

EVE_HAL_EXPORT void EVE_Hal_release

(

)

Close Eve_Hal framework.

Release HAL platform

Definition at line 64 of file EVE_Hal.c.

{
    eve_assert_ex(g_HalPlatform.OpenedDevices == 0, "HAL context still open\n");
    EVE_HalImpl_release();
    EVE_Millis_release();
    EVE_Mcu_release();
    memset(&g_HalPlatform, 0, sizeof(EVE_HalPlatform));
}

EVE_Hal_restoreSPI()

EVE_HAL_EXPORT void EVE_Hal_restoreSPI

(

EVE_HalContext *

phost

)

Restore platform to previously configured EVE SPI channel mode

Definition at line 636 of file EVE_HalImpl_FT9XX.c.

{
    if (EVE_CHIPID < EVE_FT810)
        return;
 
    setSPI(phost, phost->SpiChannels, phost->SpiDummyBytes);
}

EVE_Hal_setSPI()

EVE_HAL_EXPORT void EVE_Hal_setSPI	(	EVE_HalContext *	phost,
		EVE_SPI_CHANNELS_T	numchnls,
		uint8_t	numdummy
	)

Set number of SPI channel.

Switch EVE to different SPI channel mode

Parameters

phost	Pointer to Hal context
numchnls	Number of channel
numdummy	Number of dummy bytes

Definition at line 615 of file EVE_HalImpl_FT9XX.c.

{
    if (EVE_CHIPID < EVE_FT810)
        return;
 
    uint8_t writebyte = 0;
 
    if ((numchnls > EVE_SPI_QUAD_CHANNEL) || (numdummy > 2) || (numdummy < 1))
        return; // error
 
    // Switch EVE to multi channel SPI mode
    writebyte = numchnls;
    if (numdummy == 2)
        writebyte |= EVE_SPI_TWO_DUMMY_BYTES;
    EVE_Hal_wr8(phost, REG_SPI_WIDTH, writebyte);
    EVE_Hal_flush(phost);
 
    // Switch FT9XX to multi channel SPI mode
    setSPI(phost, numchnls, numdummy);
}

EVE_Hal_startTransfer()

EVE_HAL_EXPORT void EVE_Hal_startTransfer	(	EVE_HalContext *	phost,
		EVE_TRANSFER_T	rw,
		uint32_t	addr
	)

Start data transfer to Coprocessor.

Parameters

phost	Pointer to Hal context
rw	Read or Write
addr	Address to read/write

Definition at line 257 of file EVE_HalImpl_FT9XX.c.

{
    eve_assert(phost->Status == EVE_STATUS_OPENED);
 
    if (rw == EVE_TRANSFER_READ)
    {
        eve_assert(3 + phost->SpiDummyBytes <= 5);
        uint8_t spidata[5]; // FIXME: phost->SpiDummyBytes // ?
        spidata[0] = (addr >> 16);
        spidata[1] = (addr >> 8);
        spidata[2] = addr & 0xff;
        spi_open(SPIM, phost->SpiCsPin);
        spi_writen(SPIM, spidata, 3 + phost->SpiDummyBytes);
        phost->Status = EVE_STATUS_READING;
    }
    else
    {
        uint8_t spidata[4];
        spidata[0] = (0x80 | (addr >> 16));
        spidata[1] = (addr >> 8);
        spidata[2] = addr;
 
        spi_open(SPIM, phost->SpiCsPin);
        spi_writen(SPIM, spidata, 3);
 
        phost->Status = EVE_STATUS_WRITING;
    }
}

EVE_Hal_supportCmdB()

static bool EVE_Hal_supportCmdB ( EVE_HalContext *  phost )

inlinestatic

Definition at line 502 of file EVE_HalDefs.h.

{
#ifdef EVE_SUPPORT_CMDB
    return EVE_CHIPID >= EVE_FT810;
#else
    return false;
#endif
}

EVE_Hal_supportFlash()

static bool EVE_Hal_supportFlash ( EVE_HalContext *  phost )

inlinestatic

Definition at line 493 of file EVE_HalDefs.h.

{
#ifdef EVE_SUPPORT_FLASH
    return EVE_CHIPID >= EVE_BT815;
#else
    return false;
#endif
}

EVE_Hal_supportHsf()

static bool EVE_Hal_supportHsf ( EVE_HalContext *  phost )

inlinestatic

Definition at line 484 of file EVE_HalDefs.h.

{
#ifdef EVE_SUPPORT_HSF
    return EVE_CHIPID >= EVE_BT817;
#else
    return false;
#endif
}

EVE_Hal_supportLargeFont()

static bool EVE_Hal_supportLargeFont ( EVE_HalContext *  phost )

inlinestatic

Definition at line 529 of file EVE_HalDefs.h.

{
#ifdef EVE_SUPPORT_LARGEFONT
    return EVE_CHIPID >= EVE_FT810 // FT810 and up, except BT88X range
        && !(EVE_CHIPID >= EVE_BT880 && EVE_CHIPID <= EVE_BT883);
#else
    return false;
#endif
}

EVE_Hal_supportMediaFifo()

static bool EVE_Hal_supportMediaFifo ( EVE_HalContext *  phost )

inlinestatic

Definition at line 511 of file EVE_HalDefs.h.

{
#ifdef EVE_SUPPORT_MEDIAFIFO
    return EVE_CHIPID >= EVE_FT810;
#else
    return false;
#endif
}

EVE_Hal_supportVideo()

static bool EVE_Hal_supportVideo ( EVE_HalContext *  phost )

inlinestatic

Definition at line 520 of file EVE_HalDefs.h.

{
#ifdef EVE_SUPPORT_VIDEO
    return EVE_CHIPID >= EVE_FT810;
#else
    return false;
#endif
}

EVE_Hal_transfer16()

EVE_HAL_EXPORT uint16_t EVE_Hal_transfer16	(	EVE_HalContext *	phost,
		uint16_t	value
	)

Write 2 bytes to Coprocessor.

Parameters

phost	Pointer to Hal context
value	Value to write

Returns

uint16_t Number of bytes transfered

Definition at line 374 of file EVE_HalImpl_FT9XX.c.

{
    uint8_t buffer[2];
    if (phost->Status == EVE_STATUS_READING)
    {
        rdBuffer(phost, buffer, 2);
        return (uint16_t)buffer[0]
            | (uint16_t)buffer[1] << 8;
    }
    else
    {
        buffer[0] = value & 0xFF;
        buffer[1] = value >> 8;
        wrBuffer(phost, buffer, 2);
        return 0;
    }
}

EVE_Hal_transfer32()

EVE_HAL_EXPORT uint32_t EVE_Hal_transfer32	(	EVE_HalContext *	phost,
		uint32_t	value
	)

Write 4 bytes to Coprocessor.

Parameters

phost	Pointer to Hal context
value	Value to write

Returns

uint32_t Number of bytes transfered

Definition at line 399 of file EVE_HalImpl_FT9XX.c.

{
    uint8_t buffer[4];
    if (phost->Status == EVE_STATUS_READING)
    {
        rdBuffer(phost, buffer, 4);
        return (uint32_t)buffer[0]
            | (uint32_t)buffer[1] << 8
            | (uint32_t)buffer[2] << 16
            | (uint32_t)buffer[3] << 24;
    }
    else
    {
        buffer[0] = value & 0xFF;
        buffer[1] = (value >> 8) & 0xFF;
        buffer[2] = (value >> 16) & 0xFF;
        buffer[3] = value >> 24;
        wrBuffer(phost, buffer, 4);
        return 0;
    }
}

EVE_Hal_transfer8()

EVE_HAL_EXPORT uint8_t EVE_Hal_transfer8	(	EVE_HalContext *	phost,
		uint8_t	value
	)

Write 8 bits to Coprocessor.

Parameters

phost	Pointer to Hal context
value	Value to write

Returns

uint8_t Number of bytes transfered

Definition at line 362 of file EVE_HalImpl_FT9XX.c.

{
    return transfer8(phost, value);
}

EVE_Hal_transferMem()

EVE_HAL_EXPORT void EVE_Hal_transferMem	(	EVE_HalContext *	phost,
		uint8_t *	result,
		const uint8_t *	buffer,
		uint32_t	size
	)

Transfer (read/write) a block data to Coprocessor.

Parameters

phost	Pointer to Hal context
result	Buffer to get data transfered, NULL when write
buffer	Buffer where data is transfered, NULL when read
size	Size of buffer

Definition at line 429 of file EVE_HalImpl_FT9XX.c.

{
    if (!size)
        return;
 
    if (result && buffer)
    {
        /* not implemented */
        eve_debug_break();
    }
    else if (result)
    {
        rdBuffer(phost, result, size);
    }
    else if (buffer)
    {
        wrBuffer(phost, buffer, size);
    }
}

EVE_Hal_transferProgMem()

EVE_HAL_EXPORT void EVE_Hal_transferProgMem	(	EVE_HalContext *	phost,
		uint8_t *	result,
		eve_progmem_const uint8_t *	buffer,
		uint32_t	size
	)

Transfer a block data from program memory.

Parameters

phost	Pointer to Hal context
result	Buffer to get data transfered, NULL when write
buffer	Buffer where data is transfered, NULL when read
size	Size of buffer

Definition at line 457 of file EVE_HalImpl_FT9XX.c.

{
    if (!size)
        return;
 
    if (result && buffer)
    {
        /* not implemented */
        eve_debug_break();
    }
    else if (result)
    {
        /* not implemented */
        eve_debug_break();
    }
    else if (buffer)
    {
        eve_assert(!((uintptr_t)buffer & 0x3)); // must be 32-bit aligned
        eve_assert(!(size & 0x3)); // must be 32-bit aligned
        eve_progmem_const uint32_t *buf32 = (eve_progmem_const uint32_t *)(void eve_progmem_const *)buffer;
        size >>= 2;
        while (size--)
        {
            uint32_t value = *(buf32++);
            wrBuffer(phost, (uint8_t *)(&value), 4);
        }
    }
}

EVE_Hal_transferString()

EVE_HAL_EXPORT uint32_t EVE_Hal_transferString	(	EVE_HalContext *	phost,
		const char *	str,
		uint32_t	index,
		uint32_t	size,
		uint32_t	padMask
	)

Transfer a string to EVE platform.

Parameters

phost	Pointer to Hal context
str	String to transfer
index	Start position in the string
size	Size of string
padMask	Padding mask

Returns

uint32_t Numer of bytes transfered

Definition at line 496 of file EVE_HalImpl_FT9XX.c.

{
    if (!size)
    {
        /* TODO: Support different padding options */
        eve_assert(padMask == 0x3);
        EVE_Hal_transfer32(phost, 0);
        return 4;
    }
 
    eve_assert(size <= EVE_CMD_STRING_MAX);
    uint32_t transferred = 0;
    if (phost->Status == EVE_STATUS_WRITING)
    {
        transferred += (uint32_t)strnlen(str, size) + 1;
        eve_assert(str[transferred - 1] == '\0');
        wrBuffer(phost, (uint8_t *)str, transferred);
        if (transferred & padMask)
        {
            uint32_t pad = 4 - (transferred & padMask);
            uint8_t padding[4] = { 0 };
            wrBuffer(phost, padding, pad);
            transferred += pad;
            eve_assert(!(transferred & 0x3));
        }
    }
    else
    {
        /* not implemented */
        eve_debug_break();
    }
    return transferred;
}

EVE_Hal_wr16()

EVE_HAL_EXPORT void EVE_Hal_wr16	(	EVE_HalContext *	phost,
		uint32_t	addr,
		uint16_t	v
	)

Write 2 bytes to Coprocessor's memory.

Parameters

phost	Pointer to Hal context
addr	Address to be write
v	Value to write

Definition at line 234 of file EVE_Hal.c.

{
    EVE_Hal_startTransfer(phost, EVE_TRANSFER_WRITE, addr);
    EVE_Hal_transfer16(phost, v);
    EVE_Hal_endTransfer(phost);
}

EVE_Hal_wr32()

EVE_HAL_EXPORT void EVE_Hal_wr32	(	EVE_HalContext *	phost,
		uint32_t	addr,
		uint32_t	v
	)

Write 4 bytes to Coprocessor's memory.

Parameters

phost	Pointer to Hal context
addr	Address to be write
v	Value to write

Definition at line 248 of file EVE_Hal.c.

{
    EVE_Hal_startTransfer(phost, EVE_TRANSFER_WRITE, addr);
    EVE_Hal_transfer32(phost, v);
    EVE_Hal_endTransfer(phost);
}

EVE_Hal_wr8()

EVE_HAL_EXPORT void EVE_Hal_wr8	(	EVE_HalContext *	phost,
		uint32_t	addr,
		uint8_t	v
	)

Write 8 bits to Coprocessor's memory.

Parameters

phost	Pointer to Hal context
addr	Address to be write
v	Value to write

Definition at line 220 of file EVE_Hal.c.

{
    EVE_Hal_startTransfer(phost, EVE_TRANSFER_WRITE, addr);
    EVE_Hal_transfer8(phost, v);
    EVE_Hal_endTransfer(phost);
}

EVE_Hal_wrMem()

EVE_HAL_EXPORT void EVE_Hal_wrMem	(	EVE_HalContext *	phost,
		uint32_t	addr,
		const uint8_t *	buffer,
		uint32_t	size
	)

Write a buffer to Coprocessor's memory.

Parameters

phost	Pointer to Hal context
addr	Address to be write
buffer	Data to be write
size	Size of buffer

Definition at line 263 of file EVE_Hal.c.

{
    EVE_Hal_startTransfer(phost, EVE_TRANSFER_WRITE, addr);
    EVE_Hal_transferMem(phost, NULL, buffer, size);
    EVE_Hal_endTransfer(phost);
}

EVE_Hal_wrProgMem()

EVE_HAL_EXPORT void EVE_Hal_wrProgMem	(	EVE_HalContext *	phost,
		uint32_t	addr,
		eve_progmem_const uint8_t *	buffer,
		uint32_t	size
	)

Write a buffer in ProgMem to Coprocessor's memory.

Parameters

phost	Pointer to Hal context
addr	Address to be write
buffer	Data to be write
size	Size of buffer

Definition at line 278 of file EVE_Hal.c.

{
    EVE_Hal_startTransfer(phost, EVE_TRANSFER_WRITE, addr);
    EVE_Hal_transferProgMem(phost, NULL, buffer, size);
    EVE_Hal_endTransfer(phost);
}

EVE_Hal_wrString()

EVE_HAL_EXPORT void EVE_Hal_wrString	(	EVE_HalContext *	phost,
		uint32_t	addr,
		const char *	str,
		uint32_t	index,
		uint32_t	size,
		uint32_t	padMask
	)

Write a string to Coprocessor's memory.

Parameters

phost	Pointer to Hal context
addr	Address to be write
str	String to be write
index	Start postion in the string
size	Size of the string
padMask	Padding mask

Definition at line 295 of file EVE_Hal.c.

{
    EVE_Hal_startTransfer(phost, EVE_TRANSFER_WRITE, addr);
    EVE_Hal_transferString(phost, str, index, size, padMask);
    EVE_Hal_endTransfer(phost);
}

EVE_Host_clockSelect()

EVE_HAL_EXPORT void EVE_Host_clockSelect	(	EVE_HalContext *	phost,
		EVE_PLL_SOURCE_T	pllsource
	)

Select clock source for Coprocessor.

Parameters

phost	Pointer to Hal context
pllsource	Clock source

Definition at line 347 of file EVE_Hal.c.

{
    EVE_Hal_hostCommand(phost, (uint8_t)pllsource);
}

EVE_Host_coreReset()

EVE_HAL_EXPORT void EVE_Host_coreReset

(

EVE_HalContext *

phost

)

Send reset signal to Coprocessor.

Parameters

phost

Pointer to Hal context

Definition at line 379 of file EVE_Hal.c.

{
    EVE_Hal_hostCommand(phost, EVE_CORE_RESET);
}

EVE_Host_padDriveStrength()

EVE_HAL_EXPORT void EVE_Host_padDriveStrength	(	EVE_HalContext *	phost,
		EVE_81X_GPIO_DRIVE_STRENGTH_T	strength,
		EVE_81X_GPIO_GROUP_T	group
	)

Set the drive strength for various pins.

Parameters

phost	Pointer to Hal context
strength	Drive strength
group	Pin group to set

Definition at line 453 of file EVE_Hal.c.

{
    EVE_Hal_hostCommandExt3(phost, (uint32_t)0x70 | (group << 8) | (strength << 8));
}

EVE_Host_pllFreqSelect()

EVE_HAL_EXPORT void EVE_Host_pllFreqSelect	(	EVE_HalContext *	phost,
		EVE_PLL_FREQ_T	freq
	)

Select system clock for Coprocessor.

Parameters

phost	Pointer to Hal context
freq	Frequency to set

Definition at line 358 of file EVE_Hal.c.

{
    EVE_Hal_hostCommand(phost, (uint8_t)freq);
}

EVE_Host_powerModeSwitch()

EVE_HAL_EXPORT void EVE_Host_powerModeSwitch	(	EVE_HalContext *	phost,
		EVE_POWER_MODE_T	pwrmode
	)

Switch power mode for Coprocessor.

Parameters

phost	Pointer to Hal context
pwrmode	Power mode

Definition at line 369 of file EVE_Hal.c.

{
    EVE_Hal_hostCommand(phost, (uint8_t)pwrmode);
}

EVE_Host_powerOffComponents()

EVE_HAL_EXPORT void EVE_Host_powerOffComponents	(	EVE_HalContext *	phost,
		uint8_t	val
	)

Power off a component.

Parameters

phost	Pointer to Hal context
val	Component number

Definition at line 441 of file EVE_Hal.c.

{
    EVE_Hal_hostCommandExt3(phost, (uint32_t)0x49 | (val << 8));
}

EVE_Host_resetActive()

EVE_HAL_EXPORT void EVE_Host_resetActive

(

EVE_HalContext *

phost

)

Hold the device in reset state.

Parameters

phost

Pointer to Hal context

Definition at line 463 of file EVE_Hal.c.

{
    EVE_Hal_hostCommandExt3(phost, EVE_81X_RESET_ACTIVE);
}

EVE_Host_resetRemoval()

EVE_HAL_EXPORT void EVE_Host_resetRemoval

(

EVE_HalContext *

phost

)

Exit reset state, Eve will power on and enter into its default state.

Parameters

phost

Pointer to Hal context

Definition at line 473 of file EVE_Hal.c.

{
    EVE_Hal_hostCommandExt3(phost, EVE_81X_RESET_REMOVAL);
}

EVE_Host_selectSysClk()

EVE_HAL_EXPORT void EVE_Host_selectSysClk	(	EVE_HalContext *	phost,
		EVE_81X_PLL_FREQ_T	freq
	)

Set system clock for Coprocessor.

This API can only be called when PLL is stopped(SLEEP mode). For compatibility, set frequency to the EVE_GPU_12MHZ option in the EVE_SETPLLSP1_T table.

Parameters

phost	Pointer to Hal context
freq	Frequency to set

Definition at line 390 of file EVE_Hal.c.

{
#if (EVE_SUPPORT_CHIPID >= EVE_FT810)
    if (EVE_CHIPID >= EVE_FT810)
    {
#if (EVE_SUPPORT_CHIPID >= EVE_BT815)
        if (EVE_SYSCLK_84M == freq)
            EVE_Hal_hostCommandExt3(phost, (uint32_t)0x61 | (0x80 << 8) | (0x07 << 8));
        else
#endif
            if (EVE_SYSCLK_72M == freq)
            EVE_Hal_hostCommandExt3(phost, (uint32_t)0x61 | (0x40 << 8) | (0x06 << 8));
        else if (EVE_SYSCLK_60M == freq)
            EVE_Hal_hostCommandExt3(phost, (uint32_t)0x61 | (0x40 << 8) | (0x05 << 8));
        else if (EVE_SYSCLK_48M == freq)
            EVE_Hal_hostCommandExt3(phost, (uint32_t)0x61 | (0x40 << 8) | (0x04 << 8));
        else if (EVE_SYSCLK_36M == freq)
            EVE_Hal_hostCommandExt3(phost, (uint32_t)0x61 | (0x03 << 8));
        else if (EVE_SYSCLK_24M == freq)
            EVE_Hal_hostCommandExt3(phost, (uint32_t)0x61 | (0x02 << 8));
        else if (EVE_SYSCLK_DEFAULT == freq) //default clock
            EVE_Hal_hostCommandExt3(phost, 0x61);
    }
    else
#endif
    {
        switch (freq)
        {
        case EVE_SYSCLK_24M:
            EVE_Host_pllFreqSelect(phost, EVE_PLL_24M);
            break;
        case EVE_SYSCLK_36M:
            EVE_Host_pllFreqSelect(phost, EVE_PLL_36M);
            break;
        default:
            eve_printf_debug("Invalid sys clk frequency selected (%i)\n", (int)freq);
            /* no break */
        case EVE_SYSCLK_48M:
            EVE_Host_pllFreqSelect(phost, EVE_PLL_48M);
            break;
        }
    }
}

EVE_millis()

EVE_HAL_EXPORT uint32_t EVE_millis

(

)

Get clock in miliseond.

Need to ensure that below api is called at least once in 6.5 seconds duration for FT900 platform as this module doesnt use timer for context update global counter to loopback after ~49.71 days

Returns

uint32_t Clock number

Definition at line 842 of file EVE_HalImpl_FT9XX.c.

{
#if defined(PANL_APPLET)
    uint32_t ms = panl_timer_get_time();
    if ((uint64_t)ms < s_TotalMilliseconds)
        s_TotalMilliseconds64 += (1 << 32);
    s_TotalMilliseconds = ms;
    s_TotalMilliseconds64 = (s_TotalMilliseconds64 & ~0xFFFFFFFFULL) | (uint64_t)ms;
#endif
    return s_TotalMilliseconds;
}

EVE_millis64()

EVE_HAL_EXPORT uint64_t EVE_millis64

(

)

Get clock in miliseond.

Need to ensure that below api is called at least once in 6.5 seconds duration for FT900 platform as this module doesnt use timer for context update global counter to loopback after ~49.71 days

Returns

uint32_t Clock number

Definition at line 862 of file EVE_HalImpl_FT9XX.c.

{
#if defined(PANL_APPLET)
    uint32_t ms = panl_timer_get_time();
    if ((uint64_t)ms < s_TotalMilliseconds)
        s_TotalMilliseconds64 += (1 << 32);
    s_TotalMilliseconds = ms;
    s_TotalMilliseconds64 = (s_TotalMilliseconds64 & ~0xFFFFFFFFULL) | (uint64_t)ms;
#endif
    return s_TotalMilliseconds64;
}

EVE_shortChipId()

static int EVE_shortChipId ( EVE_CHIPID_T  chipId )

inlinestatic

Remove EVE generation from the chip ID

Definition at line 569 of file EVE_HalDefs.h.

{
    return chipId & 0xFFFF;
}

EVE_sleep()

EVE_HAL_EXPORT void EVE_sleep

(

uint32_t

ms

)

Sleep in milisecond.

Parameters

ms	Milisecond

Definition at line 895 of file EVE_HalImpl_FT9XX.c.

{
    delayms(ms);
}