drivers/input/i8042prt/i8042prt.h

   1 #ifndef _I8042PRT_PCH_
   2 #define _I8042PRT_PCH_
   3
   4 #include <ntifs.h>
   5 #include <kbdmou.h>
   6 #include <ntdd8042.h>
   7
   8 /*-----------------------------------------------------
   9  * Structures
  10  * --------------------------------------------------*/
  11
  12 #define I8042PRT_TAG '2408'
  13
  14 typedef enum
  15 {
  16         dsStopped,
  17         dsStarted,
  18         dsPaused,
  19         dsRemoved,
  20         dsSurpriseRemoved
  21 } DEVICE_STATE;
  22
  23 typedef struct _I8042_SETTINGS
  24 {
  25         /* Registry settings */
  26         ULONG KeyboardDataQueueSize;           /* done */
  27         UNICODE_STRING KeyboardDeviceBaseName;
  28         ULONG MouseDataQueueSize;              /* done */
  29         ULONG MouseResolution;
  30         ULONG MouseSynchIn100ns;
  31         ULONG NumberOfButtons;
  32         UNICODE_STRING PointerDeviceBaseName;
  33         ULONG PollStatusIterations;            /* done */
  34         ULONG OverrideKeyboardType;
  35         ULONG OverrideKeyboardSubtype;
  36         ULONG PollingIterations;               /* done */
  37         ULONG PollingIterationsMaximum;
  38         ULONG ResendIterations;                /* done */
  39         ULONG SampleRate;
  40         ULONG CrashOnCtrlScroll;               /* done */
  41 } I8042_SETTINGS, *PI8042_SETTINGS;
  42
  43 typedef enum _MOUSE_TIMEOUT_STATE
  44 {
  45         NoChange,
  46         TimeoutStart,
  47         TimeoutCancel
  48 } MOUSE_TIMEOUT_STATE, *PMOUSE_TIMEOUT_STATE;
  49
  50 typedef struct _INTERRUPT_DATA
  51 {
  52         PKINTERRUPT Object;
  53         ULONG Vector;
  54         KIRQL Dirql;
  55         KINTERRUPT_MODE InterruptMode;
  56         BOOLEAN ShareInterrupt;
  57         KAFFINITY Affinity;
  58 } INTERRUPT_DATA, *PINTERRUPT_DATA;
  59
  60 #define WHEEL_DELTA 120
  61
  62 struct _I8042_KEYBOARD_EXTENSION;
  63 typedef struct _I8042_KEYBOARD_EXTENSION *PI8042_KEYBOARD_EXTENSION;
  64 struct _I8042_MOUSE_EXTENSION;
  65 typedef struct _I8042_MOUSE_EXTENSION *PI8042_MOUSE_EXTENSION;
  66
  67 /* PORT_DEVICE_EXTENSION.Flags */
  68 #define KEYBOARD_PRESENT     0x01 /* A keyboard is attached */
  69 #define KEYBOARD_CONNECTED   0x02 /* Keyboard received IOCTL_INTERNAL_KEYBOARD_CONNECT */
  70 #define KEYBOARD_STARTED     0x04 /* Keyboard FDO received IRP_MN_START_DEVICE */
  71 #define KEYBOARD_INITIALIZED 0x08 /* Keyboard interrupt is connected */
  72 #define MOUSE_PRESENT        0x10 /* A mouse is attached */
  73 #define MOUSE_CONNECTED      0x20 /* Mouse received IOCTL_INTERNAL_MOUSE_CONNECT */
  74 #define MOUSE_STARTED        0x40 /* Mouse FDO received IRP_MN_START_DEVICE */
  75 #define MOUSE_INITIALIZED    0x80 /* Mouse interrupt is connected */
  76
  77 typedef struct _PORT_DEVICE_EXTENSION
  78 {
  79         PUCHAR DataPort;    /* Usually 0x60 */
  80         PUCHAR ControlPort; /* Usually 0x64 */
  81         I8042_SETTINGS Settings;
  82         ULONG Flags;
  83
  84         PI8042_KEYBOARD_EXTENSION KeyboardExtension;
  85         INTERRUPT_DATA KeyboardInterrupt;
  86         PI8042_MOUSE_EXTENSION MouseExtension;
  87         INTERRUPT_DATA MouseInterrupt;
  88         PKINTERRUPT HighestDIRQLInterrupt;
  89         KSPIN_LOCK SpinLock;
  90         KIRQL HighestDirql;
  91
  92         OUTPUT_PACKET Packet;
  93         ULONG PacketResends;
  94         BOOLEAN PacketComplete;
  95         NTSTATUS PacketResult;
  96         UCHAR PacketBuffer[16];
  97         UCHAR PacketPort;
  98
  99         PIRP CurrentIrp;
 100         PDEVICE_OBJECT CurrentIrpDevice;
 101 } PORT_DEVICE_EXTENSION, *PPORT_DEVICE_EXTENSION;
 102
 103 typedef struct _I8042_DRIVER_EXTENSION
 104 {
 105         UNICODE_STRING RegistryPath;
 106
 107         PORT_DEVICE_EXTENSION Port;
 108         LIST_ENTRY DeviceListHead;
 109         KSPIN_LOCK DeviceListLock;
 110 } I8042_DRIVER_EXTENSION, *PI8042_DRIVER_EXTENSION;
 111
 112 typedef enum _I8042_DEVICE_TYPE
 113 {
 114         Unknown,
 115         Keyboard,
 116         Mouse,
 117         PhysicalDeviceObject
 118 } I8042_DEVICE_TYPE, *PI8042_DEVICE_TYPE;
 119
 120 typedef struct _FDO_DEVICE_EXTENSION
 121 {
 122         I8042_DEVICE_TYPE Type;
 123         // Linkage in I8042_DRIVER_EXTENSION.DeviceListHead
 124         LIST_ENTRY ListEntry;
 125         // Associated device object (FDO)
 126         PDEVICE_OBJECT Fdo;
 127         // Associated device object (PDO)
 128         PDEVICE_OBJECT Pdo;
 129         // Lower device object
 130         PDEVICE_OBJECT LowerDevice;
 131         // Current state of the driver
 132         DEVICE_STATE PnpState;
 133
 134         PPORT_DEVICE_EXTENSION PortDeviceExtension;
 135 } FDO_DEVICE_EXTENSION, *PFDO_DEVICE_EXTENSION;
 136
 137 typedef struct _I8042_KEYBOARD_EXTENSION
 138 {
 139         FDO_DEVICE_EXTENSION Common;
 140         CONNECT_DATA KeyboardData;
 141         INTERNAL_I8042_HOOK_KEYBOARD KeyboardHook; /* FIXME: IsrWritePort ignored */
 142         KDPC DpcKeyboard;
 143
 144         KEYBOARD_ATTRIBUTES KeyboardAttributes;
 145
 146         KEYBOARD_INDICATOR_PARAMETERS KeyboardIndicators;
 147
 148         KEYBOARD_SCAN_STATE KeyboardScanState;
 149         BOOLEAN KeyComplete;
 150         PKEYBOARD_INPUT_DATA KeyboardBuffer;
 151         ULONG KeysInBuffer;
 152
 153         /* Power keys items */
 154         ULONG ReportedCaps;
 155         ULONG NewCaps;
 156         ULONG LastPowerKey;
 157         UNICODE_STRING PowerInterfaceName;
 158         PIO_WORKITEM PowerWorkItem;
 159         PIRP PowerIrp;
 160
 161         /* Debug items */
 162         ULONG ComboPosition;
 163         PIO_WORKITEM DebugWorkItem;
 164         BOOLEAN TabPressed;
 165 } I8042_KEYBOARD_EXTENSION;
 166
 167 typedef enum _I8042_MOUSE_TYPE
 168 {
 169         GenericPS2,
 170         Intellimouse,
 171         IntellimouseExplorer,
 172         Ps2pp
 173 } I8042_MOUSE_TYPE, *PI8042_MOUSE_TYPE;
 174
 175 typedef struct _I8042_MOUSE_EXTENSION
 176 {
 177         FDO_DEVICE_EXTENSION Common;
 178         CONNECT_DATA MouseData;
 179         INTERNAL_I8042_HOOK_MOUSE MouseHook;
 180         KDPC DpcMouse;
 181
 182         MOUSE_ATTRIBUTES MouseAttributes;
 183
 184         MOUSE_STATE MouseState;
 185         BOOLEAN MouseComplete;
 186         MOUSE_RESET_SUBSTATE MouseResetState;
 187         PMOUSE_INPUT_DATA MouseBuffer;
 188         ULONG MouseInBuffer;
 189         USHORT MouseButtonState;
 190         ULARGE_INTEGER MousePacketStartTime;
 191
 192         KTIMER TimerMouseTimeout;
 193         KDPC DpcMouseTimeout;
 194         MOUSE_TIMEOUT_STATE MouseTimeoutState;
 195         BOOLEAN MouseTimeoutActive;
 196
 197         UCHAR MouseLogiBuffer[3];
 198         I8042_MOUSE_TYPE MouseType;
 199 } I8042_MOUSE_EXTENSION;
 200
 201 typedef struct _I8042_HOOK_WORKITEM
 202 {
 203         PIO_WORKITEM WorkItem;
 204         PIRP Irp;
 205 } I8042_HOOK_WORKITEM, *PI8042_HOOK_WORKITEM;
 206
 207 /*-----------------------------------------------------
 208  * Some defines
 209  * --------------------------------------------------*/
 210
 211 #define MAX(a, b) ((a) >= (b) ? (a) : (b))
 212
 213 #define KEYBOARD_POWER_CODE 0x5E
 214 #define KEYBOARD_SLEEP_CODE 0x5F
 215 #define KEYBOARD_WAKE_CODE  0x63
 216
 217 /*-----------------------------------------------------
 218  * Controller commands
 219  * --------------------------------------------------*/
 220
 221 #define KBD_READ_MODE      0x20
 222 #define KBD_WRITE_MODE     0x60
 223 #define MOUSE_ENAB         0xA8
 224 #define MOUSE_LINE_TEST    0xA9
 225 #define CTRL_SELF_TEST     0xAA
 226 #define CTRL_WRITE_MOUSE   0xD4
 227
 228 /*-----------------------------------------------------
 229  * Keyboard commands
 230  * --------------------------------------------------*/
 231
 232 #define KBD_CMD_SET_LEDS   0xED
 233 #define KBD_CMD_GET_ID     0xF2
 234
 235 /*-----------------------------------------------------
 236  * Keyboard responses
 237  * --------------------------------------------------*/
 238
 239 #define KBD_SELF_TEST_OK   0x55
 240 #define KBD_ACK            0xFA
 241 #define KBD_NACK           0xFC
 242 #define KBD_RESEND         0xFE
 243
 244 /*-----------------------------------------------------
 245  * Controller status register bits
 246  * --------------------------------------------------*/
 247
 248 #define KBD_OBF            0x01
 249 #define KBD_IBF            0x02
 250 #define MOU_OBF            0x20
 251 #define KBD_PERR           0x80
 252
 253 /*-----------------------------------------------------
 254  * Controller command byte bits
 255  * --------------------------------------------------*/
 256
 257 #define CCB_KBD_INT_ENAB   0x01
 258 #define CCB_MOUSE_INT_ENAB 0x02
 259 #define CCB_SYSTEM_FLAG    0x04
 260 #define CCB_KBD_DISAB      0x10
 261 #define CCB_MOUSE_DISAB    0x20
 262 #define CCB_TRANSLATE      0x40
 263
 264 /*-----------------------------------------------------
 265  * LED bits
 266  * --------------------------------------------------*/
 267
 268 #define KBD_LED_SCROLL     0x01
 269 #define KBD_LED_NUM        0x02
 270 #define KBD_LED_CAPS       0x04
 271
 272 /*-----------------------------------------------------
 273  * Mouse commands
 274  * --------------------------------------------------*/
 275
 276 #define MOU_ENAB           0xF4
 277 #define MOU_CMD_RESET      0xFF
 278
 279 /*-----------------------------------------------------
 280  * Mouse responses
 281  * --------------------------------------------------*/
 282
 283 #define MOUSE_ACK          0xFA
 284 #define MOUSE_ERROR        0xFC
 285 #define MOUSE_NACK         0xFE
 286
 287 /*-----------------------------------------------------
 288  * Prototypes
 289  * --------------------------------------------------*/
 290
 291 /* createclose.c */
 292
 293 IO_WORKITEM_ROUTINE i8042SendHookWorkItem;
 294
 295 DRIVER_DISPATCH i8042Create;
 296
 297 DRIVER_DISPATCH i8042Cleanup;
 298
 299 DRIVER_DISPATCH i8042Close;
 300
 301 /* keyboard.c */
 302
 303 NTSTATUS NTAPI
 304 i8042SynchWritePortKbd(
 305         IN PVOID Context,
 306         IN UCHAR Value,
 307         IN BOOLEAN WaitForAck);
 308
 309 DRIVER_STARTIO i8042KbdStartIo;
 310
 311 DRIVER_DISPATCH i8042KbdDeviceControl;
 312
 313 DRIVER_DISPATCH i8042KbdInternalDeviceControl;
 314
 315 KSERVICE_ROUTINE i8042KbdInterruptService;
 316
 317 /* i8042prt.c */
 318
 319 DRIVER_ADD_DEVICE i8042AddDevice;
 320
 321 BOOLEAN
 322 i8042PacketIsr(
 323         IN PPORT_DEVICE_EXTENSION DeviceExtension,
 324         IN UCHAR Output);
 325
 326 NTSTATUS
 327 i8042StartPacket(
 328         IN PPORT_DEVICE_EXTENSION DeviceExtension,
 329         IN PFDO_DEVICE_EXTENSION FdoDeviceExtension,
 330         IN PUCHAR Bytes,
 331         IN ULONG ByteCount,
 332         IN PIRP Irp);
 333
 334 /* misc.c */
 335
 336 DRIVER_DISPATCH ForwardIrpAndForget;
 337
 338 DRIVER_DISPATCH ForwardIrpAndWait;
 339
 340 NTSTATUS
 341 DuplicateUnicodeString(
 342         IN ULONG Flags,
 343         IN PCUNICODE_STRING SourceString,
 344         OUT PUNICODE_STRING DestinationString);
 345
 346 /* mouse.c */
 347
 348 VOID
 349 i8042MouHandle(
 350         IN PI8042_MOUSE_EXTENSION DeviceExtension,
 351         IN UCHAR Output);
 352
 353 VOID
 354 i8042MouHandleButtons(
 355         IN PI8042_MOUSE_EXTENSION DeviceExtension,
 356         IN USHORT Mask);
 357
 358 NTSTATUS
 359 i8042MouInitialize(
 360         IN PI8042_MOUSE_EXTENSION DeviceExtension);
 361
 362 DRIVER_DISPATCH i8042MouInternalDeviceControl;
 363
 364 KSERVICE_ROUTINE i8042MouInterruptService;
 365
 366 /* pnp.c */
 367
 368 BOOLEAN
 369 i8042ChangeMode(
 370         IN PPORT_DEVICE_EXTENSION DeviceExtension,
 371         IN UCHAR FlagsToDisable,
 372         IN UCHAR FlagsToEnable);
 373
 374 DRIVER_DISPATCH i8042Pnp;
 375
 376 /* ps2pp.c */
 377 VOID
 378 i8042MouHandlePs2pp(
 379         IN PI8042_MOUSE_EXTENSION DeviceExtension,
 380         IN UCHAR Input);
 381
 382 /* readwrite.c */
 383
 384 VOID
 385 i8042Flush(
 386         IN PPORT_DEVICE_EXTENSION DeviceExtension);
 387
 388 BOOLEAN
 389 i8042IsrWritePort(
 390         IN PPORT_DEVICE_EXTENSION DeviceExtension,
 391         IN UCHAR Value,
 392         IN UCHAR SelectCmd OPTIONAL);
 393
 394 NTSTATUS
 395 i8042ReadData(
 396         IN PPORT_DEVICE_EXTENSION DeviceExtension,
 397         IN UCHAR StatusFlags,
 398         OUT PUCHAR Data);
 399 #define i8042ReadKeyboardData(DeviceExtension, Data) \
 400         i8042ReadData(DeviceExtension, KBD_OBF, Data)
 401 #define i8042ReadMouseData(DeviceExtension, Data) \
 402         i8042ReadData(DeviceExtension, MOU_OBF, Data)
 403
 404 NTSTATUS
 405 i8042ReadDataWait(
 406         IN PPORT_DEVICE_EXTENSION DeviceExtension,
 407         OUT PUCHAR Data);
 408
 409 NTSTATUS
 410 i8042ReadStatus(
 411         IN PPORT_DEVICE_EXTENSION DeviceExtension,
 412         OUT PUCHAR Status);
 413
 414 NTSTATUS NTAPI
 415 i8042SynchReadPort(
 416         IN PVOID Context,
 417         OUT PUCHAR Value,
 418         IN BOOLEAN WaitForAck);
 419
 420 NTSTATUS NTAPI
 421 i8042SynchWritePort(
 422         IN PPORT_DEVICE_EXTENSION DeviceExtension,
 423         IN UCHAR Port,
 424         IN UCHAR Value,
 425         IN BOOLEAN WaitForAck);
 426
 427 BOOLEAN
 428 i8042Write(
 429         IN PPORT_DEVICE_EXTENSION DeviceExtension,
 430         IN PUCHAR addr,
 431         IN UCHAR data);
 432
 433 /* registry.c */
 434
 435 NTSTATUS
 436 ReadRegistryEntries(
 437         IN PUNICODE_STRING RegistryPath,
 438         OUT PI8042_SETTINGS Settings);
 439
 440 #endif /* _I8042PRT_PCH_ */