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

USBHID

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

身份认证购VIP最低享 7 折!

领优惠券(最高得80元）

资源详情

资源推荐

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 table version 1.1

HID Usage Tables 1.12 键盘开发必备

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

hid usage tables

hid usage collection type什么意思

linux hid usage type有哪些，分别是什么含义

linux内核编译时没有hid-hyperv.o文件

linux3.8内核编译时没有hid-hyperv.o文件

hid_map_usage中各个参数的含义

hid_map_usage_clear 怎么使用

hid_map_usage_clear

RAWINPUTDEVICE的usUsage有几种

hidapi hid.dll

tinyusb库具体使用HID的C语言例子

WINDOWS向HID设备发送数据的例子

audio hid 描述符配置 请举例

找不到这两个选项怎么办

会员权益专享

最新资源

audio hid 描述符配置请举例