2 general hal support, General hal support – Epson S1D13705 User Manual

Page 146

Advertising
background image

Page 52

Epson Research and Development

Vancouver Design Center

S1D13705

Programming Notes and Examples

X27A-G-002-03

Issue Date: 02/01/22

9.4.2 General HAL Support

Functions in this group do not fit into any specific category of support. They provide a
miscellaneous range of support for working with the S1D13705

int seGetId(int * pId)

Description: Reads the S1D13705 revision code register to determine the chip product and

revisions. The interpreted value is returned in pID.

Parameters: pId

- pointer to an integer which will receive the controller ID.

S1D13705 values returned in pID are:
- ID_S1D13705_REV0
- ID_UNKNOWN

Other HAL libraries will return their respective controller IDs upon detection of
their controller.

Return Value: ERR_OK

- operation completed with no problems

ERR_UNKNOWN_DEVICE - the HAL was unable to identify the display
controller. Returned when pID returns ID_UNKNOWN.

void seGetHalVersion(const char ** pVersion, const char ** pStatus,
const char **pStatusRevision)

Description: Retrieves the HAL library version. The return pointers are all to ASCII strings. A

typical return would be: *pVersion == “1.01” (HAL version 1.01),*pStatus == “B”
(The 'B' is the beta designator), *pStatusRevision == “5”. The programmer need
only create pointers of const char type to pass as parameters (see Example below).

Parameters: pVersion

- Pointer to string to return the version in.
- must point to an allocated string of size VER_SIZE

pStatus

- Pointer to a string to return the release status in.
- must point to an allocated string of size STATUS_SIZE

pStatusRevision - Pointer to return the current revision of status.

- must point to an allocated string of size STAT_REV_SIZE

Return Value: None

Example:

const char *pVersion, *pStatus, *pStatusRevision;
seGetHalVersion( &pVersion, &pStatus, &pStatusRevision);

Advertising