Chapter 4: Software
Registry Settings for Expansion Devices
28
Psion Teklogix Omnii HDK User Manual
4.4.1.1 Device Information Registry Keys
This section describes the registry keys required by the peripherals driver to identify and define
the behaviour of expansion devices. The parent key for all of the device-specific subkeys is:
Within that key, create a subkey (if it does not already exist) for the type of connector that the
device will attach to. The connector types are defined in the following table:
1
WWAN is not available on Omnii XT10, and is included here for development on future products.
For example, the registry keys that describe devices connecting to the expansion port would be
stored in the subkey:
Within the connector type subkey create a further subkey using the Device ID reported by the
device. For devices that attach to the docking connector, an integer value based on a resistor ID in
the device is used for identification. For example, the Device Name (resistor ID) for the desktop
dock device is 18, therefore the correct registry key for parameters pertaining to that device is:
For all expansion devices with EEPROMs, the Device Name is a concatenation of the
Manufacturer
and
Model
fields in the EEPROM (see Section 8.3.1: “Common EEPROM
Fields” for more details). For example, if an end-cap expansion device manufactured by
Psion Teklogix with the model field defined as “Endcap” was connected to the end-cap expansion
port, the correct registry key for parameters pertaining to that device would be:
Device Registry Values
Within the subkey for the specific device, add the following device registry values:
•
Name
(REG_SZ): A descriptive name for the device.
•
ConnectorId
(REG_DWORD): An optional field that restricts a device to be recognized only
on a specific expansion slot. The possible values are
0
(Expansion Port 1),
1
(Expansion Port
2) and
2
(Expansion Port 3).
If this field is not specified, the device will be recognized on all logical connectors with the
same Connector Type (e.g. if the Connector Type of the device is 0, it will be recognized on
all expansion ports).
[HKLM\Drivers\BuiltIn\Peripherals\devices]
Table 4.1 Connector Type Definitions
Subkey
Number
Connector Type
0
Expansion Port
1
WWAN
1
2
GPS
4
Docking
[HKLM\Drivers\BuiltIn\Peripherals\devices\0]
[HKLM\Drivers\BuiltIn\Peripherals\devices\4\18]
[HKLM\Drivers\BuiltIn\Peripherals\devices\0\Psion Teklogix Endcap]
Note: Because the model and manufacturer fields in the EEPROM are used as part of the registry
key, they cannot contain any characters that are not permitted in registry key names (null,
backslash, etc.).
Summary of Contents for OMNii HDK XT10
Page 4: ......
Page 10: ......
Page 12: ......
Page 18: ......
Page 20: ......
Page 24: ......
Page 26: ......
Page 32: ......
Page 72: ......
Page 90: ......
Page 92: ......
Page 116: ......
Page 124: ......
Page 126: ......
Page 130: ......
Page 132: ......
Page 154: ......
Page 168: ......
Page 170: ......
Page 182: ......
Page 184: ......
Page 188: ......