S1D13705 Epson Electronics America, Inc., S1D13705 Datasheet - Page 141

• Manufacturer Part Number: S1D13705
• Description: S1d13705 Embedded Memory Lcd Controller
• Manufacturer: Epson Electronics America, Inc.

Epson Research and Development
Vancouver Design Center
9.3 Using the HAL library
9.4 API for 13705HAL
Programming Notes and Examples
Issue Date: 01/02/13
seRegisterDevice
seSetInit
seGetId
seGetHalVersion
seGetLastUsableByte
seGetBytesPerScanline
seGetScreenSize
seDelay
seSetHighPerformance
seSplitInit
seSplitScreen
seVirtInit
seVirtMove
seSetHWRotate
seSetPortraitMethod
Function
Note
To utilize the HAL library, the programmer must include two “.h” files in their code.
“Hal.h” contains the HAL library function prototypes and structure definitions, and
“appcfg.h” contains the instance of the HAL_STRUCT that is defined in “Hal.h” and
configured by 13705CFG.EXE. For a more thorough example of using the HAL see
Section 10.1, “Sample code using the S1D13705 HAL API” on page 66.
This section is a description of the HAL library Application Programmers Interface (API).
Updates and revisions to the HAL may include new functions not included in this documen-
tation.
Many of the HAL library functions have pointers as parameters. The programmer
should be aware that little validation of these pointers is performed, so it is up to the
programmer to ensure that they adhere to the interface and use valid pointers.
Programmers are recommended to use the highest warning levels of their compiler in
order to verify the parameter types.
Registers the S1D13705 parameters with the HAL, calls seInitHal if necessary.
seRegisterDevice MUST be the first HAL function called by an application.
Programs the S1D13705 for use with the default settings, calls seSetDisplayMode to do the
work, clears display memory. Note: either seSetInit or seSetDisplayMode must be called
AFTER calling seRegisterDevice
Interpret the revision code register to determine chip id
Return version information on the HAL library
Determine the offset of the last unreserved usable byte in the display buffer
Determine the number of bytes or memory consumed per scan line in current mode
Determine the height and width of the display surface in pixels
Use the frame rate timing to delay for required seconds (requires registers to be initialized)
Used in color modes less than 8-bpp to toggle the high performance bit on or off
Initialize split screen variables and setup start addresses
Set the size of either the top or bottom screen
Initialize virtual screen mode setting x and y sizes
pan/scroll the virtual screen surface(s)
Set the hardware rotation to either Portrait or Landscape
Call before setting hardware portrait mode to set either Default or Alternate Portrait Mode
Table 9-1: HAL Functions
Advanced HAL Functions:
General HAL Support:
Hardware Rotate:
Initialization:
Description
X27A-G-002-02
S1D13705
Page 49