Epson S1D13706 - Initialization

Epson Research and Development
Page 65
Vancouver Design Center
Programming Notes and Examples S1D13706
Issue Date: 01/02/23 X31B-G-003-03
10.2 Initialization
Initialization functions are normally the first functions in the HAL library that an appli-
cation calls. These routines return information about the controller and prepare the HAL
library for use.
int seRegisterDevice(const LPHAL_STRUC lpHalInfo)
Description
: This function registers the S1D13706 device parameters with the HAL library. The device
parameters include such items as address range, register values, desired frame rate, etc.
These parameters are stored in the HAL_STRUCT structure pointed to by lpHalInfo.
Additionally this routine allocates system memory as address space for accessing registers
and the display buffer.
Parameters:
lpHalInfo A pointer to a HAL_STRUCT structure. This structure
must be filled with appropriate values prior to calling
seRegisterDevice.
Return Value:
ERR_OK operation completed with no problems
ERR_UNKNOWN_DEVICE The HAL was unable to locate the S1D13706.
ERR_FAILED The HAL was unable to map S1D13706 display memory
to the host platform.
In addition, on Win32 platforms, the following two error values may be returned:
ERR_PCI_DRIVER_- The HAL was unable to locate file SED13XX.VXD
NOT_FOUND
ERR_PCI_BRIDGE_- The driver file SED13XX.VXD was unable to locate the
ADAPTER_NOT_FOUND PCI bridge adapter board attached to the evaluation board.
Note
seRegisterDevice() MUST be called before any other HAL functions.