S1D13704 Epson Electronics America, Inc., S1D13704 Datasheet - Page 143

• Manufacturer Part Number: S1D13704
• Description: LCD Controller
• Manufacturer: Epson Electronics America, Inc.

Epson Research and Development
Vancouver Design Center
9 Hardware Abstraction Layer (HAL)
9.1 Introduction
9.2 API for 13704HAL
9.2.1 Initialization
Programming Notes and Examples
Issue Date: 01/02/12
Note
The HAL is a processor independent programming library provided by Epson with support
for several different computing platforms. The HAL was developed to aid implementation
of internal test programs and provides an easy, consistent method of programming
S1D1350x, S1D1370x, and S1D1380x products on different processor platforms.
The HAL keeps sample code simpler, although end programmers may find the HAL
functions to be limited in their scope, and may wish to ignore the HAL.
The following is a description of the HAL library. Updates and revisions to the HAL may
include new functions not included in the following documentation.
The original design philosophy of the HAL was that function return values would be status
of the call. Most functions simple return ERR_OK. If a value had to be returned then a
pointer of the appropriate type was passed to the function.
The following section describes the HAL functions dealing with S1D13704 initialization.
Typically a programmer has only to concern themselves with calls to seRegisterDevice()
and seSetInit().
int seRegisterDevice(const LPHAL_STRUC lpHalInfo, int * pDevID)
Description:
Parameters:
Return Value: ERR_OK
No S1D13704 registers are changed by calling seRegisterDevice().
Registers the S1D13704 device parameters with the HAL library. The device param-
eters have been configured with address range, register values, desired frame rate,
etc., and have been saved in the HAL_STRUCT structure pointed to by lpHalInfo.
lpHalInfo
pDevice
ERR_UNKNOWN_DEVICE - the HAL was unable to find an S1D13704.
- pointer to HAL_STRUCT information structure
- pointer to the integer to receive the device ID
- operation completed with no problems
X26A-G-002-03
S1D13704
Page 47