Chapter 4: Software
Registry Settings for Expansion Devices
Psion Teklogix Omnii HDK User Manual
29
•
PinFunctions
(REG_DWORD): A one-byte value that configures the communication mode
of the dual-purpose GPIO / UART and GPIO / SPI pins for the type of device attached.
Each of the three major expansion ports have eight pins that can be configured to communi-
cate to a GPIO device (General Purpose Input/Output), or to a serial RS-232/UART or SPI
(not available on Omnii XT10) device. If no PinFunctions value is specified, the pins default
to the non-GPIO (serial / SPI) function.
•
To set the communication mode of these pins, set the PinFunctions value according to the
following bit field:
For example, to configure the pins for serial communication, set the PinFunctions value to
0F
.
•
PowerMode
(REG_DWORD): This value determines how and when the device 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 device power is managed by the peripherals driver; the device
is powered off when the computer enters suspend mode and powered on when the computer
resumes activity.
•
Notifications
(REG_DWORD): The notifications registry value determines how the user is
notified about expansion devices.
This value is a bit field as defined in the following table:
Table 4.2 PinFunctions Registry Value Definitions
Bit
Pin Name
Description
0 (LSB)
EXP1_TXD_GPIO0
0 = GPIO pin 0, 1 = Serial TXD
1
EXP1_RXD_GPIO1
0 = GPIO pin 1, 1 = Serial RXD
2
EXP1_CTS_GPIO2
0 = GPIO pin 2, 1 = Serial CTS
3
EXP1_RTS_GPIO3
0 = GPIO pin 3, 1 = Serial RTS
4
EXP1_MOSI_GPIO4
0 = GPIO pin 4, 1 = SPI MOSI
5
EXP1_MISO_GPIO5
0 = GPIO pin 5, 1 = SPI MISO
6
EXP1_SCLK_GPIO6
0 = GPIO pin 6, 1 = SPI SCLK
7 (MSB) EXP1_CS_N_GPIO7
0 = GPIO pin 7, 1 = SPI chip select
The default setting for this value is
2
, which is the recommended setting. Under this setting,
power to the device must be controlled by a loaded device driver or application.
Table 4.3 Notifications Registry Value Definitions
Bit
Functionality
Description
0 (LSB)
Show Icon
This flag displays an icon in the status bar. The
Icon
must be set for this to occur.
1 (MSB) Show Window
Setting this flag causes a “new device” window to be displayed, con-
taining the name and status of the device. The name reported is the
DeviceNameID
registry value (see page 30). If that value does not
exist, the
Name
registry value (see page 28) is used instead. If that also
does not exist, the Device Name from the registry key itself is used.
The default setting for this value is
0
, which displays an icon in the taskbar. The other setting,
which displays a “new device” window, is primarily intended for docking devices.
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: ......