General Hal Support - Epson S1D13505 Technical Manual

Page 58

11.5.1 General HAL Support

S1D13505
X23A-G-003-07
int seSetDisplayMode(int DevID, int DisplayMode, int flags)
Description: This routine sets the S1D13505 registers according to the values contained in the
HAL_STRUCT register section.
Setting all the registers means that timing, display surface dimensions, and all other
aspects of chip operation are set with this call, including loading default values into
the color Look-Up Tables (LUTs).
Parameters: DevID
DisplayMode- the HAL_STRUCT register set to use:
flags
Return Value: ERR_OK
ERR_FAILED - unable to complete operation. Occurs as a result of an invalid
See Also: seDisplayFifo() - for enabling/disabling the FIFO.
Example: seSetDisplayMode(DevID, DISP_MODE_LCD, CLEAR_MEM |
DISP_FIFO_OFF);
The above example will initialize for the LCD, and then clear display buffer memory
and blank the screen. The advantage to this approach is that afterwards the appli-
cation can write to the display without showing the image until memory is
completely updated; the application would then call seDisplayFIFO(DevID, ON).
Note
See note from seSetInit().
General HAL support covers the miscellaneous functions. There is usually no more than
one or two functions devoted to any particular aspect of S1D13505 operation.
int seGetId(int DevID, int * pId)
Description: Reads the S1D13505 revision code register to determine the chip product and
revisions. The interpreted value is returned in pID.
Parameters: DevID
pId
- a valid registered device ID
DISP_MODE_LCD,
DISP_MODE_CRT, or
DISP_MODE_SIMULTANEOUS
- Can be set to one or more flags. Each flag added by using the
logical OR command. Do not add mutually exclusive flags.
Flags can be set to 0 to use defaults.
DONT_CLEAR_MEM (default) - do not clear memory
CLEAR_MEM - clear display buffer memory
DISP_FIFO_OFF - turn off display FIFO
(blank screen except for cursor or ink layer)
DISP_FIFO_ON (default) - turn on display FIFO
- no problems encountered
register in the HAL_STRUCT.
- registered device ID
- pointer to the int to receive the controller ID.
Epson Research and Development
Vancouver Design Center
Programming Notes and Examples
Issue Date: 01/02/05