Epson S1D13505 Technical Manual page 211

Epson Research and Development
Vancouver Design Center
Note
Note
Note
Programming Notes and Examples
Issue Date: 01/02/05
Return Value: ERR_OK
Example: seRegisterDevice( &HalInfo, &DeviceId);
No S1D13505 registers are changed by calling seRegisterDevice().
seRegisterDevice() MUST be called before any other HAL functions.
int seInitHal(void)
Description: This function initializes the variables used by the HAL library. This function or
seRegisterDevice() must be called once when an application starts.
Normally programmers do not have to concern themselves with seInitHal(). On PC
platforms, seRegisterDevice() automatically calls seInitHal(). Consecutive calls to
seRegisterDevice() will not call seInitHal() again. On non-PC platforms the start-up
code, supplied by Epson, will call seInitHal().However, if support code for a new
operating platform is written the programmer must ensure that seInitHAL is called
prior to calling other HAL functions.
Parameters: None
Return Value: ERR_OK
seSetInit(int DevID)
Description: This routine sets the S1D13505 registers for operation using the default settings.
Initialization of the S1D13505 is a two step process consisting of initializing the
HAL (seInitHal) and initializing the S1D13505 registers (seSetInit). Unlike the
HAL the registers do not necessarily require initialization at program startup and
may be initialized as needed (e.g. 13505PLAY.EXE).
Parameters: DevID
Return Value: ERR_OK
ERR_FAILED- unable to complete operation. Occurs as a result an invalid register
in the HAL_STRUCT.
This function calls seSetDisplayMode() and uses the configuration designated to be the
default by 13505CFG.EXE (wDefaultMode in HAL_STRUCT). The programmer could
call
seSetDisplayMode() directly allowing the selection of any DisplayMode configuration
along with the options of clearing memory and blanking the display (DISP_FIFO_OFF).
It is strongly recommended that the programmer call either seSetInit() or seSetDisplay-
Mode()
after seRegisterDevice() before calling any other HAL functions. If not, the programmer
must manually disable hardware suspend and enable the host interface before accessing
the registers
- operation completed with no problems
- operation completed with no problems
- registered device ID (acquired in seRegisterDevice)
- operation completed with no problems
Page 57
S1D13505
X23A-G-003-07