Device Driver Registry Keys - Psion EP10 User Manual

Chapter 3: Software
Peripheral Registry Settings
• PowerMode (REG_DWORD): This value determines how and when the peripheral hardware is powered
by the peripherals driver. The possible values are 1 (Auto) and 2 (Manual). If the power mode is set to
Auto, the peripheral power is managed by the peripherals driver; the peripheral is powered off when
the computer enters suspend mode and powered on when the computer resumes activity.
The default setting for this value is 2, which is the recommended setting. Under this setting, power to the peripheral
must be controlled by a loaded device driver or application.
• Notifications (REG_DWORD): The notifications registry value determines how the user is notified
about peripherals.
This value is a bit field as defined in the following table:
Table 3.1
Bit
0 (LSB)
1 (MSB)
The default setting for this value is 0.
• LoadFlags (REG_DWORD): The load flags specify the functionality required by the attached peripheral,
and therefore the device driver (e.g. USB, UART, etc.) that needs to be loaded to support the periph-
eral. The LoadFlags value is treated as a bit field, as defined in the following table:
Table 3.2
Bit
0 (LSB)
1
2
3
4
5 (MSB)
If this flag is not specified, any custom device drivers required by the peripheral must be specified in
the driver registry subkey (see
• Icon (REG_DWORD): This is the Resource ID of the icon to be displayed for this peripheral in the status
bar. Currently, icons can only be loaded from Psion DLLs.
• DeviceNameID (REG_DWORD): This is the Resource ID of the name string to be displayed in the "New
Device" window. Currently, the name string can only be loaded from Psion DLLs.
3.4.1.1

Device Driver Registry Keys

If the peripheral requires an additional driver to be loaded, registry keys need to be created to specify the
information for the driver. As a rule, docking peripherals do not require additional drivers, nor do many USB
peripherals. For peripherals that do require an additional driver to be loaded, follow these steps:
Within the device registry key, add a "driver" subkey. For example:
[HKLM\Drivers\BuiltIn\Peripherals\devices\4\1\driver]
16
Psion EP10 HDK User Manual
Notifications Registry Value Definitions
Functionality
No Notification No notification is displayed.
Notification Setting this flag causes a "new device" pop-up to be displayed, containing the
Enabled name and status of the peripheral. The name reported is the DeviceNameID
registry value. If that value does not exist, the Name registry value is used
instead. If that also does not exist, the Device Name from the registry key itself
is used.
LoadFlags Registry Value Definitions
Functionality
Reserved
USB Host This flag indicates a peripheral that requires USB Host functionality. When this bit
is set, the USB hub and ports are powered and enabled for the docking connector.
This bit must be set for any docking peripheral with a USB Host connector.
Reserved
Reserved
USB OTG This flag is required for docking peripherals with USB On-The-Go functionality.
Dock Power Out The connected peripheral requires power from the battery.
Section 3.4.1.1: "Device Driver Registry
Description
Description
Keys").