USB HID Mouse Driver using LPC2148

Sorry, I repost my report descriptor:

static UNS_8 abReportDesc[] = {
  HID_UsagePage(HID_USAGE_PAGE_GENERIC),
  HID_Usage(HID_USAGE_GENERIC_KEYBOARD),
  HID_Collection(HID_Application),
    HID_UsagePage(HID_USAGE_PAGE_KEYBOARD),
    HID_UsageMin(224),
    HID_UsageMax(231),
    HID_LogicalMin(0),
    HID_LogicalMax(1),
    HID_ReportSize(1),
    HID_ReportCount(8),
    HID_Input(HID_Data | HID_Variable | HID_Absolute),
    HID_ReportCount(1),
    HID_ReportSize(8),
    HID_Input(HID_Constant),
    HID_ReportCount(8),
    HID_ReportSize(1),
    HID_UsagePage(HID_USAGE_PAGE_LED),
    HID_UsageMin(1),
    HID_UsageMax(8),
    HID_Output(HID_Data | HID_Variable | HID_Absolute),
    HID_UsagePage(HID_USAGE_PAGE_KEYBOARD),
    HID_UsageMin(0),
    HID_UsageMax(101),
    HID_LogicalMin(0),
    HID_LogicalMax(101),
    HID_ReportSize(8),
    HID_ReportCount(6),
    HID_Input(HID_Data | HID_Array),
  HID_EndCollection,
};

Dear Tsuneo,

Thanks so much for your guidance! I have my PC detects MCB2140 as a USB keyboard and play arround with 2 bytes report in, one for modify keys one for array keys. But I still have one stupid question, need your help!!

Actually, in HID1_11.pdf, there is a report example for a standard keyboard, which the report data is 8 bytes format(1 modify keys, 1 reserve, 6 for array keys). And I see that Windows only has the maximum number of combined keys is 3 or 4, ex: CTRL+ALT+DEL, so I wonder why the standard keyboard has the report in data format is 8, is it redundant??

Please help me clear!
Tuong Nguyen

I don't know if this is relevant to USB but a key press in Windows can use any number of modifiers.

CTRL+ALT+DEL is just the single key DEL with CTRL and ALT as modifiers.

But the next issue is that a keyboard can handle n-key rollover, in which it keeps track of n concurrently pressed characters, and then reports the key releases first when you do release any of the n pressed keys.

So in a game, you may press one key to move forward, while pressing another to slide sideways, while pressing a third key to fire a weapon and potentially a fourth key to aim through a sniper scope. For a gamer, it is important to select a good keyboard that supports a large "n", so it is able to keep track of many concurrently pressed keys.

> so I wonder why the standard keyboard has the report in data format is 8, is it redundant??

Keyboard puts an input report which shows the current status of all keys (snapshot) - not just the key which makes or breaks. Keyboard puts input reports regularly, or just at the timing when any key-down/-up occurs (*1). In either case, the input report is a snapshot of all keys.

The format of the standard input report for keyboard is as follows,

Byte
  0   Modifier keys     bitmap of left and right CTRL, SHIFT, ALT, GUI keys
  1   Reserved
  2   Keycode array[0]  6 byte keycode array for the keys other than modifier
  3   Keycode array[1]
  4   Keycode array[2]
  5   Keycode array[3]
  6   Keycode array[4]
  7   Keycode array[5]

The Modifier keys field holds the ON/OFF status of the modifier keys on each bit, just when the report is made. The Keycode array lists up only the keys which are currently ON, up to six keys - 6-keys rollover (*2).

Comparing the last report and new one, HID host knows make/break of keys.
If a keycode appears in the new report, but not in the last one, the key makes.
If a keycode is shown again in the new report, the key is still pressed.
If a keycode disappears in the new report, the key is released.

Thanking to this format, shooting games on your PC is able to move the hero diagonally, when you push the up and left cursor keys at the same time. Also you can fire while you are moving :-)

I don't know why a reserved byte is there between the modifier and the array. Maybe, they thought more modifier keys may be equipped in future.

(*1) chosen by SET_IDLE requests
(*2) Increasing the array size on the report descriptor, input report can hold more keys. For example, 100-keys rollover :-)

Tsuneo

Dear Tsuneo and Per Westermark,

Thanks so much for your sharing! I think I've got what I need.

Tuong Nguyen