HID Usage Tables V1.1：USB设备通用标识符规范更新

需积分: 1 10 浏览量更新于2024-06-22 收藏 539KB PDF 举报

HIDUsageTables V1.1 是针对Universal Serial Bus (USB) Human Interface Device (HID) 的官方规范之一，它定义了USB HID 设备中广泛使用的输入设备的通用功能和数据交换模式。该版本发布于1999年4月8日，由包括Brian Bates、Robert Dezmelyk、Robert Ingman等来自多家知名公司如Microsoft、Intel、Logitech等的专家共同贡献。这个版本的主要目标是为USB HID 设备提供一套统一的“Usage Tables”，这些表格定义了各种输入设备的行为，如键盘、鼠标、游戏控制器、条形码扫描器等。每个设备的功能都被分配一个特定的Usage Page ID和Usage Code，这使得设备在USB协议下能被系统正确识别和配置。例如，1.1版本更新了 barcode Usage Page ID，确保了条形码阅读器的正确识别。此外，它还纳入了1.0 HID Specification中的键盘Usage Table，并对多个HID Review Request进行了整合（请求编号16, 34, 38, 40, 41, 42, 43等），反映了业界对于USB HID 设备功能需求的不断演变。 Revision History部分展示了该标准的发展过程，从1.1rc1到1.1rc3，持续对错误进行修正，以适应不断变化的技术环境。通过这些表格，开发者可以参考并遵循这些标准来设计符合USB接口的HID设备，从而实现跨平台的兼容性和无缝交互。 HIDUsageTables V1.1 是USB HID 设备开发的基础文档，它对于理解和构建支持USB设备的驱动程序、设备设计以及操作系统接口至关重要。通过理解和应用这些表格，工程师能够创建出更加高效、一致且用户友好的USB输入设备，推动了现代计算机外设技术的进步。

6 Universal Serial Bus HID Usage Tables

Version 1.1 April 8, 1999

2. The usage description defines the units in which the value will be presented.

If Units are set to Optional or set to None (have not been declared) then an application can assume the usage

represents a dimensionless value. Any application that ignores Units does so at its own risk.

A usage that declares itself to be a measurement of time would specify whether it was seconds or

milliseconds by declaring Units and Unit Exponent prior to the respective Main item declaration. An

example of this is the Flash On Time usage on the LED page, which is described as the duration that the

indicator is illuminated in flash mode. The duration would be qualified by the values of Units and Unit

Exponent.

When declaring Units for a main item, the Logical Minimum, Logical Maximum, Physical Minimum,

Physical Maximum, and Unit Exponent items must also be declared.

In many cases the coordinate system assumes that the values can vary both positively and

negatively from zero (0).

3.4 Usage Types

Usages define a wide variety of device features. However, the way an application treats the data that they

generate falls into a relatively small set of categories. This section provides descriptions of frequently used

types of usages, primarily to save redundant text throughout this document. This list is not an exhaustive list

of the possible usage types. Individual usage pages can declare their own usage types.

Each usage type describes how an application should treat the data generated by the Main item that the

usage is attached to.

Usage type names are followed by an abbreviation that is used in the detailed usage description to identify

the default type of a usage. In some cases usage types do not apply and the detailed description will identify

how the usage is to be interpreted.

There are three basic types of information that are described by usages: controls, collections, and data. In

this context, controls are identified with the state of a device (on/off, enable/disable, and so forth),

collections group related controls and data together, and data comprises the remaining information that is

passed between a device and the host.

Usage types are always considered to be the recommended method of handling a usage.

Consult the usage’s definition to determine whether alternative usage types may apply.

Note

Universal Serial Bus HID Usage Tables 7

Version 1.1 April 8, 1999

3.4.1 Usage Types (Controls)

The following table summarizes the control related usage types.

Table 2: Usage Types (Controls)

Control

Type

Logical

Min

Logical

Max

Flags Signal Operation

–1 1 Relative,

Preferred

State

Edge 1 increments the control’s value.

–1 decrements the control’s value.

–Min Max

Relative,

Preferred

State

Level

n increments the control’s value. –n

decrements the control’s value.

Linear

Control

(LC)

Min Max

Absolute,

Preferred

State

N/A

The value reported by the control is

used directly by the host.

-1 1

Relative,

No Preferred

Edge

1 asserts an On condition.

–1 asserts an Off condition.

0 1 Relative,

Preferred

State

Edge A 0 to 1 transition toggles the current

On/Off state.

On/Off

Control

(OOC)

0 1 Absolute,

No Preferred

Level 1 asserts an On condition.

0 asserts an Off condition.

Momentary

Control

(MC)

0 1 Absolute,

Preferred

State

Level 1 asserts a condition.

0 deasserts the condition.

One Shot

Control

(OSC)

0 1 Relative,

Preferred

State

Edge A 0 to 1 transition triggers an event.

A 1 to 0 transition must occur before

another event can be triggered.

Re-trigger

Control

(RTC)

0 1 Absolute,

Preferred

State

Level 1 triggers an event. When an event

completes, if the value is 1 then the

event will be triggered again.

3.4.1.1 Linear Control (LC)

In many cases, a control of a linear value is implemented as a pair of increment/decrement buttons, a jog

wheel, or a linear control such as a knob or a slide.

When implemented as an increment/decrement control, the two buttons must be translated into a single, 2-bit

signed value and declared as a Relative Main item with a Report Size equal to 2, where –1 decrements the

value, +1 increments it, and no change occurs when 0 is asserted.

A jog wheel is normally implemented as a spring-loaded knob that returns to a fixed center position when

released. This control reports a single value of two or more bits which are reported as a signed value and

declared as a Relative Main item where –n decrements the value, +n increments it, and no change occurs

when 0 is asserted. A jog wheel control is implemented with a resolution of +/–n, where the offset of the

knob from the center position is proportional to the reported value. The Report Size must be declared large

enough to contain the signed value n.

When implemented as a linear knob or slide, the control must be declared as an Absolute Main item. For an

example, see Section A.1, “Volume Control,” in Appendix A, “Usage Examples.”

8 Universal Serial Bus HID Usage Tables

Version 1.1 April 8, 1999

3.4.1.2 On/Off Control (OOC)

An On/Off Control can be implemented in any of the following ways:

• Two buttons, On and Off. The two buttons are encoded into a 2-bit signed value and declared as

a Relative, No Preferred Main item with Logical Minimum and Logical Maximum of –1 and 1,

respectively. The transition from 0 to –1 generates an Off condition and the transition from 0 to +1

generates an On condition. No change occurs when 0 is asserted.

• A single button that toggles the On/Off state each time it is pressed. (single throw momentary

switch The single button is encoded into a 1-bit unsigned value and declared as an Relative,

Preferred Main item with a Logical Minimum and Logical Maximum of 0 and 1, respectively.

The transition from 0 to 1 toggles the current On/Off state. No change occurs on the 1 to 0

transition.

• A toggle switch that maintains the On/Off state mechanically. (toggle switch) This control is

encoded into a 1-bit unsigned value and declared as an Absolute, No Preferred Main item with a

Logical Minimum and Logical Maximum of 0 and 1, respectively. The assertion of 1 generates an

On condition and the assertion of 0 generates an Off condition.

3.4.1.3 Momentary Control (MC)

A Momentary Control is a basic push button. A Momentary Control is encoded into a 1-bit value and

declared as an Absolute, Preferred Main item with a Logical Minimum and Logical Maximum of 0 and 1,

respectively. A value of 1 generates an asserted condition and 0 generates a non-asserted condition. An

example is a mouse button.

3.4.1.4 One Shot Control (OSC)

A One Shot Control is a push button that triggers a single event or action. A One Shot Control is encoded

into a 1-bit value and declared as a Relative, Preferred Main item with a Logical Minimum and Logical

Maximum of 0 and 1, respectively. A 0 to 1 transition initiates an event. Nothing occurs on a 1 to 0

transition but it is required before another event can occur. An example is degauss.

3.4.1.5 Re-Trigger Control (RTC)

A Re-Trigger Control is a push button that triggers a repeating event as long as it is asserted. A Re-Trigger

Control is encoded into a 1-bit value and declared as an Absolute, Preferred Main item with a Logical

Minimum and Logical Maximum of 0 and 1, respectively. A 0 to 1 transition initiates the first event. When

each event terminates, if the control is still asserted (1) then another event will occur. An example is an auto-

repeat fire button.

3.4.2 Usage Types (Data)

The following table summarizes the data-related usage types.

Table 3: Usage Types (Data)

Type Flags Description

Selector (Sel) Array Contained in a Named Array (NAry).

Static Value (SV) Constant, Variable, Absolute A read-only multiple-bit value.

Static Flag (SF) Constant, Variable, Absolute A read-only single-bit value.

Dynamic Value (DV) Data, Variable, Absolute A read/write multiple-bit value.

Dynamic Flag (DF) Data, Variable, Absolute A read/write single-bit value.

Universal Serial Bus HID Usage Tables 9

Version 1.1 April 8, 1999

3.4.2.1 Selector (Sel)

Selectors come in three forms:

• One selection of a set. Radio buttons are a mechanically linked set of buttons where one selection

is always valid. This is a perfect example of the “one selection of a set” form. A radio button set is

defined by a Main item with the Array flag set and the Report Count set to 1. The index returned

in the array field corresponds to the pressed button (or selection). A usage must be declared for

each selection. The array field never returns an index of NULL because one usage is always valid.

An example is Stat Not Ready on the Alphanumeric Display page.

• N selections of a set. More than one selection (button) can be valid at a time. Multiple selections

can be returned to the system at one time in a multi-byte array. The “n selections of a set” form is

defined by a Main item with the Array flag set and the Report Count set to n, where n is the

number of selections that can be reported in a single report. An example is a keyboard.

• Any selection of a set. The control is implemented as a set of bit fields in which each bit represents

a single selection. This control is defined by a Main item with the Variable flag set and the Report

Size equal to 1. The Report Count will be equal to the number of selections in the set.

Selectors therefore can be implemented in a number of ways: Array[1] (one selection of a set), Array[n] (n

selections of a set), or bitmap (any selection of a set).

Optionally, the array field or set can be named by wrapping a set of Selectors in a logical collection with a

usage attached to it. For details, see Section 3.4.3.1, “Named Array (NAry).”

3.4.2.2 Static Value (SV)

Static values are used to declare a fixed features in a device. They are defined as Constant and treated as

read-only information. Therefore, asserting this field in a Set_Report command has no defined effect.

3.4.2.3 Static Flag (SF)

Static flags are used to declare the existence of a fixed feature in a device. If a Static Flag usage is found in a

Report descriptor then the field must be read to determine whether the feature identified by the flag exists.

A value of 1 indicates existence and a value of 0 indicates non-existence. The absence of a Static Flag usage

implies that the flag is false or the feature defined by the flag is not supported by the device. A Static Flag

must be declared as a Constant. To be accessible by applications, a Static Flag must have a usage assigned to

it.

Static Flags are typically declared in a Feature report as a single-bit field where the value is always read as

1. Attempting to modify this field in a Set_Report command has no effect on a Static Flag.

3.4.2.4 Dynamic Flag (DF)

Dynamic Flags are used to declare the existence of a host-controllable feature in a device. The absence of a

Dynamic Flag usage implies that the flag is false or the feature defined by the flag is not supported by the

device.

Dynamic Flags are typically declared in a report as a single-bit field, where a value of 1 returned by the

device indicates that the feature is enabled. The assertion of 1 by the host will cause the feature to be evoked

and the assertion of 0 indicates that the feature is to be disabled or ignored if the feature is a one-time event

(such as Degauss or Clear Display). A Dynamic Flag Main item must be declared as Data.

10 Universal Serial Bus HID Usage Tables

Version 1.1 April 8, 1999

3.4.2.5 Dynamic Value (DV)

A Dynamic Value is an n-bit field that contains a value associated with a control. The associated Main item

will have the Data and Variable flags set. A Dynamic Value Main item must be declared as Data.

More advanced devices may allow a usage declared as a Static type to be Dynamic. Always

check the Constant/Data flag in an Input, Output or Feature Main item.

3.4.3 Usage Types (Collection)

The following table summarizes the collection-related usage types.

Table 4: Usage Types (Collection)

Type Collection Type Definition

Named Array

(NAry)

Logical A collection that encompasses an array

definition, naming the array set or the field

created by the array.

Application Collection

(CA)

Application

Applies a name to a top level collection

which the operating system uses to identify

a device and possibly remap to a legacy

API.

Logical Collection

(CL)

Logical A logical collection of items.

Physical Collection

(CP)

Physical A physical collection of items.

Usage Switch

(US)

Logical Modifies the purpose or function of the

usages (controls) that it contains.

Usage Modifier

(UM)

Logical Modifies the purpose or function of the

usages (controls) that contains it.

3.4.3.1 Named Array (NAry)

To simplify for an application the process of finding a set of selectors, whether defined as an Array Field or

a bitmap, the set of selectors can be named by wrapping them in a logical collection and applying a usage to

the collection. Usages applied in this way are called Named Array usages. For an example, see Section A.4,

“Named Array Field,” in Appendix A, “Usage Examples.”

3.4.3.2 Collection Application (CA)

The Collection Application usage type identifies usages that are used only in application-level collections.

An application collection identifies a HID device or a functional subset of a complex device. An operating

system uses the usage associated with this collection to link the device to its controlling application or

driver. Common examples are a keyboard or mouse. A keyboard with an integrated pointing device could

contain two different application collections.

Data reports cannot span application collections.

3.4.3.3 Collection Logical (CL)

The Collection Logical usage type identifies a usage applied to a logical collection. Logical collections can

be used to further define the purpose of the items or controls that they contain.

Note

剩余127页未读，继续阅读

lxztyf

粉丝: 2
资源: 29

HID Usage Tables V1.1：USB设备通用标识符规范更新

HID Usage Tables

中文版-HID-Usage-Tables-v1.12

USB HID Usage Tables Version 1.1 官方标准详解

HID Usage Tables V1.12

USB HID Usage Tables v1.12：设备类定义与参考

USB HID Usage Tables详解：理解报告描述符的关键

USB HID USAGE TABLE.pdf

USB HID 相关标准文档集合。

基于HID协议的USB人机交互设备的接口设计

蓝牙HID人机接口规范

最新资源