€•r      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ"/translations/zh_CN/hid/hid-sensor”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ"/translations/zh_TW/hid/hid-sensor”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ"/translations/it_IT/hid/hid-sensor”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ"/translations/ja_JP/hid/hid-sensor”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ"/translations/ko_KR/hid/hid-sensor”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ"/translations/sp_SP/hid/hid-sensor”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒHID Sensors Framework”h]”hŒHID Sensors Framework”…””}”(hh¨hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hh£hžhhŸŒ</var/lib/git/docbuild/linux/Documentation/hid/hid-sensor.rst”h KubhŒ	paragraph”“”)”}”(hŒãHID sensor framework provides necessary interfaces to implement sensor drivers,
which are connected to a sensor hub. The sensor hub is a HID device and it provides
a report descriptor conforming to HID 1.12 sensor usage tables.”h]”hŒãHID sensor framework provides necessary interfaces to implement sensor drivers,
which are connected to a sensor hub. The sensor hub is a HID device and it provides
a report descriptor conforming to HID 1.12 sensor usage tables.”…””}”(hh¹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubh¸)”}”(hX¢  Description from the HID 1.12 "HID Sensor Usages" specification:
"Standardization of HID usages for sensors would allow (but not require) sensor
hardware vendors to provide a consistent Plug And Play interface at the USB boundary,
thereby enabling some operating systems to incorporate common device drivers that
could be reused between vendors, alleviating any need for the vendors to provide
the drivers themselves."”h]”hXª  Description from the HID 1.12 â€œHID Sensor Usagesâ€ specification:
â€œStandardization of HID usages for sensors would allow (but not require) sensor
hardware vendors to provide a consistent Plug And Play interface at the USB boundary,
thereby enabling some operating systems to incorporate common device drivers that
could be reused between vendors, alleviating any need for the vendors to provide
the drivers themselves.â€”…””}”(hhÇhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubh¸)”}”(hX  This specification describes many usage IDs, which describe the type of sensor
and also the individual data fields. Each sensor can have variable number of
data fields. The length and order is specified in the report descriptor. For
example a part of report descriptor can look like::”h]”hX  This specification describes many usage IDs, which describe the type of sensor
and also the individual data fields. Each sensor can have variable number of
data fields. The length and order is specified in the report descriptor. For
example a part of report descriptor can look like:”…””}”(hhÕhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubhŒliteral_block”“”)”}”(hX     INPUT(1)[INPUT]
 ..
    Field(2)
      Physical(0020.0073)
      Usage(1)
        0020.045f
      Logical Minimum(-32767)
      Logical Maximum(32767)
      Report Size(8)
      Report Count(1)
      Report Offset(16)
      Flags(Variable Absolute)
..
..”h]”hX     INPUT(1)[INPUT]
 ..
    Field(2)
      Physical(0020.0073)
      Usage(1)
        0020.045f
      Logical Minimum(-32767)
      Logical Maximum(32767)
      Report Size(8)
      Report Count(1)
      Report Offset(16)
      Flags(Variable Absolute)
..
..”…””}”hhåsbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1hãhŸh¶h Khh£hžhubh¸)”}”(hX`  The report is indicating "sensor page (0x20)" contains an accelerometer-3D (0x73).
This accelerometer-3D has some fields. Here for example field 2 is motion intensity
(0x045f) with a logical minimum value of -32767 and logical maximum of 32767. The
order of fields and length of each field is important as the input event raw
data will use this format.”h]”hXd  The report is indicating â€œsensor page (0x20)â€ contains an accelerometer-3D (0x73).
This accelerometer-3D has some fields. Here for example field 2 is motion intensity
(0x045f) with a logical minimum value of -32767 and logical maximum of 32767. The
order of fields and length of each field is important as the input event raw
data will use this format.”…””}”(hhõhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K#hh£hžhubh¢)”}”(hhh]”(h§)”}”(hŒImplementation”h]”hŒImplementation”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj  hžhhŸh¶h K+ubh¸)”}”(hXU  This specification defines many different types of sensors with different sets of
data fields. It is difficult to have a common input event to user space applications,
for different sensors. For example an accelerometer can send X,Y and Z data, whereas
an ambient light sensor can send illumination data.
So the implementation has two parts:”h]”hXU  This specification defines many different types of sensors with different sets of
data fields. It is difficult to have a common input event to user space applications,
for different sensors. For example an accelerometer can send X,Y and Z data, whereas
an ambient light sensor can send illumination data.
So the implementation has two parts:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K-hj  hžhubhŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒCore HID driver”h]”h¸)”}”(hj+  h]”hŒCore HID driver”…””}”(hj-  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K3hj)  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j'  hj$  hžhhŸh¶h Nubj(  )”}”(hŒ3Individual sensor processing part (sensor drivers)
”h]”h¸)”}”(hŒ2Individual sensor processing part (sensor drivers)”h]”hŒ2Individual sensor processing part (sensor drivers)”…””}”(hjD  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K4hj@  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j'  hj$  hžhhŸh¶h Nubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1j"  hŸh¶h K3hj  hžhubh¢)”}”(hhh]”(h§)”}”(hŒCore driver”h]”hŒCore driver”…””}”(hjc  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj`  hžhhŸh¶h K7ubh¸)”}”(hŒáThe core driver (hid-sensor-hub) registers as a HID driver. It parses
report descriptors and identifies all the sensors present. It adds an MFD device
with name HID-SENSOR-xxxx (where xxxx is usage id from the specification).”h]”hŒáThe core driver (hid-sensor-hub) registers as a HID driver. It parses
report descriptors and identifies all the sensors present. It adds an MFD device
with name HID-SENSOR-xxxx (where xxxx is usage id from the specification).”…””}”(hjq  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K8hj`  hžhubh¸)”}”(hŒFor example:”h]”hŒFor example:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K<hj`  hžhubh¸)”}”(hŒ?HID-SENSOR-200073 is registered for an Accelerometer 3D driver.”h]”hŒ?HID-SENSOR-200073 is registered for an Accelerometer 3D driver.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K>hj`  hžhubh¸)”}”(hŒäSo if any driver with this name is inserted, then the probe routine for that
function will be called. So an accelerometer processing driver can register
with this name and will be probed if there is an accelerometer-3D detected.”h]”hŒäSo if any driver with this name is inserted, then the probe routine for that
function will be called. So an accelerometer processing driver can register
with this name and will be probed if there is an accelerometer-3D detected.”…””}”(hj›  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K@hj`  hžhubh¸)”}”(hŒØThe core driver provides a set of APIs which can be used by the processing
drivers to register and get events for that usage id. Also it provides parsing
functions, which get and set each input/feature/output report.”h]”hŒØThe core driver provides a set of APIs which can be used by the processing
drivers to register and get events for that usage id. Also it provides parsing
functions, which get and set each input/feature/output report.”…””}”(hj©  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KDhj`  hžhubeh}”(h]”Œcore-driver”ah ]”h"]”Œcore driver”ah$]”h&]”uh1h¡hj  hžhhŸh¶h K7ubh¢)”}”(hhh]”(h§)”}”(hŒ2Individual sensor processing part (sensor drivers)”h]”hŒ2Individual sensor processing part (sensor drivers)”…””}”(hjÂ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj¿  hžhhŸh¶h KIubh¸)”}”(hŒîThe processing driver will use an interface provided by the core driver to parse
the report and get the indexes of the fields and also can get events. This driver
can use IIO interface to use the standard ABI defined for a type of sensor.”h]”hŒîThe processing driver will use an interface provided by the core driver to parse
the report and get the indexes of the fields and also can get events. This driver
can use IIO interface to use the standard ABI defined for a type of sensor.”…””}”(hjÐ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KKhj¿  hžhubeh}”(h]”Œ0individual-sensor-processing-part-sensor-drivers”ah ]”h"]”Œ2individual sensor processing part (sensor drivers)”ah$]”h&]”uh1h¡hj  hžhhŸh¶h KIubeh}”(h]”Œimplementation”ah ]”h"]”Œimplementation”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K+ubh¢)”}”(hhh]”(h§)”}”(hŒCore driver Interface”h]”hŒCore driver Interface”…””}”(hjñ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjî  hžhhŸh¶h KQubh¸)”}”(hŒCallback structure::”h]”hŒCallback structure:”…””}”(hjÿ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KShjî  hžhubhä)”}”(hX  Each processing driver can use this structure to set some callbacks.
      int (*suspend)(..): Callback when HID suspend is received
      int (*resume)(..): Callback when HID resume is received
      int (*capture_sample)(..): Capture a sample for one of its data fields
      int (*send_event)(..): One complete event is received which can have
                             multiple data fields.”h]”hX  Each processing driver can use this structure to set some callbacks.
      int (*suspend)(..): Callback when HID suspend is received
      int (*resume)(..): Callback when HID resume is received
      int (*capture_sample)(..): Capture a sample for one of its data fields
      int (*send_event)(..): One complete event is received which can have
                             multiple data fields.”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”hóhôuh1hãhŸh¶h KUhjî  hžhubh¸)”}”(hŒRegistration functions::”h]”hŒRegistration functions:”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K\hjî  hžhubhä)”}”(hŒ±int sensor_hub_register_callback(struct hid_sensor_hub_device *hsdev,
                      u32 usage_id,
                      struct hid_sensor_hub_callbacks *usage_callback):”h]”hŒ±int sensor_hub_register_callback(struct hid_sensor_hub_device *hsdev,
                      u32 usage_id,
                      struct hid_sensor_hub_callbacks *usage_callback):”…””}”hj)  sbah}”(h]”h ]”h"]”h$]”h&]”hóhôuh1hãhŸh¶h K^hjî  hžhubh¸)”}”(hŒURegisters callbacks for a usage id. The callback functions are not allowed
to sleep::”h]”hŒTRegisters callbacks for a usage id. The callback functions are not allowed
to sleep:”…””}”(hj7  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kbhjî  hžhubhä)”}”(hŒhint sensor_hub_remove_callback(struct hid_sensor_hub_device *hsdev,
                      u32 usage_id):”h]”hŒhint sensor_hub_remove_callback(struct hid_sensor_hub_device *hsdev,
                      u32 usage_id):”…””}”hjE  sbah}”(h]”h ]”h"]”h$]”h&]”hóhôuh1hãhŸh¶h Kfhjî  hžhubh¸)”}”(hŒ!Removes callbacks for a usage id.”h]”hŒ!Removes callbacks for a usage id.”…””}”(hjS  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kihjî  hžhubh¸)”}”(hŒParsing function::”h]”hŒParsing function:”…””}”(hja  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Klhjî  hžhubhä)”}”(hŒåint sensor_hub_input_get_attribute_info(struct hid_sensor_hub_device *hsdev,
                      u8 type,
                      u32 usage_id, u32 attr_usage_id,
                      struct hid_sensor_hub_attribute_info *info);”h]”hŒåint sensor_hub_input_get_attribute_info(struct hid_sensor_hub_device *hsdev,
                      u8 type,
                      u32 usage_id, u32 attr_usage_id,
                      struct hid_sensor_hub_attribute_info *info);”…””}”hjo  sbah}”(h]”h ]”h"]”h$]”h&]”hóhôuh1hãhŸh¶h Knhjî  hžhubh¸)”}”(hX  A processing driver can look for some field of interest and check if it exists
in a report descriptor. If it exists it will store necessary information
so that fields can be set or get individually.
These indexes avoid searching every time and getting field index to get or set.”h]”hX  A processing driver can look for some field of interest and check if it exists
in a report descriptor. If it exists it will store necessary information
so that fields can be set or get individually.
These indexes avoid searching every time and getting field index to get or set.”…””}”(hj}  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kshjî  hžhubh¸)”}”(hŒSet Feature report::”h]”hŒSet Feature report:”…””}”(hj‹  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kyhjî  hžhubhä)”}”(hŒint sensor_hub_set_feature(struct hid_sensor_hub_device *hsdev, u32 report_id,
                      u32 field_index, s32 value);”h]”hŒint sensor_hub_set_feature(struct hid_sensor_hub_device *hsdev, u32 report_id,
                      u32 field_index, s32 value);”…””}”hj™  sbah}”(h]”h ]”h"]”h$]”h&]”hóhôuh1hãhŸh¶h K{hjî  hžhubh¸)”}”(hŒïThis interface is used to set a value for a field in feature report. For example
if there is a field report_interval, which is parsed by a call to
sensor_hub_input_get_attribute_info before, then it can directly set that
individual field::”h]”hŒîThis interface is used to set a value for a field in feature report. For example
if there is a field report_interval, which is parsed by a call to
sensor_hub_input_get_attribute_info before, then it can directly set that
individual field:”…””}”(hj§  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K~hjî  hžhubhä)”}”(hŒ‚int sensor_hub_get_feature(struct hid_sensor_hub_device *hsdev, u32 report_id,
                      u32 field_index, s32 *value);”h]”hŒ‚int sensor_hub_get_feature(struct hid_sensor_hub_device *hsdev, u32 report_id,
                      u32 field_index, s32 *value);”…””}”hjµ  sbah}”(h]”h ]”h"]”h$]”h&]”hóhôuh1hãhŸh¶h K„hjî  hžhubh¸)”}”(hŒóThis interface is used to get a value for a field in input report. For example
if there is a field report_interval, which is parsed by a call to
sensor_hub_input_get_attribute_info before, then it can directly get that
individual field value::”h]”hŒòThis interface is used to get a value for a field in input report. For example
if there is a field report_interval, which is parsed by a call to
sensor_hub_input_get_attribute_info before, then it can directly get that
individual field value:”…””}”(hjÃ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K‡hjî  hžhubhä)”}”(hŒ©int sensor_hub_input_attr_get_raw_value(struct hid_sensor_hub_device *hsdev,
                      u32 usage_id,
                      u32 attr_usage_id, u32 report_id);”h]”hŒ©int sensor_hub_input_attr_get_raw_value(struct hid_sensor_hub_device *hsdev,
                      u32 usage_id,
                      u32 attr_usage_id, u32 report_id);”…””}”hjÑ  sbah}”(h]”h ]”h"]”h$]”h&]”hóhôuh1hãhŸh¶h Khjî  hžhubh¸)”}”(hXp  This is used to get a particular field value through input reports. For example
accelerometer wants to poll X axis value, then it can call this function with
the usage id of X axis. HID sensors can provide events, so this is not necessary
to poll for any field. If there is some new sample, the core driver will call
registered callback function to process the sample.”h]”hXp  This is used to get a particular field value through input reports. For example
accelerometer wants to poll X axis value, then it can call this function with
the usage id of X axis. HID sensors can provide events, so this is not necessary
to poll for any field. If there is some new sample, the core driver will call
registered callback function to process the sample.”…””}”(hjß  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K‘hjî  hžhubhŒ
transition”“”)”}”(hŒ
----------”h]”h}”(h]”h ]”h"]”h$]”h&]”uh1jí  hŸh¶h K˜hjî  hžhubh¢)”}”(hhh]”(h§)”}”(hŒHID Custom and generic Sensors”h]”hŒHID Custom and generic Sensors”…””}”(hjü  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjù  hžhhŸh¶h K›ubh¸)”}”(hX«  HID Sensor specification defines two special sensor usage types. Since they
don't represent a standard sensor, it is not possible to define using Linux IIO
type interfaces.
The purpose of these sensors is to extend the functionality or provide a
way to obfuscate the data being communicated by a sensor. Without knowing the
mapping between the data and its encapsulated form, it is difficult for
an application/driver to determine what data is being communicated by the sensor.
This allows some differentiating use cases, where vendor can provide applications.
Some common use cases are debug other sensors or to provide some events like
keyboard attached/detached or lid open/close.”h]”hX­  HID Sensor specification defines two special sensor usage types. Since they
donâ€™t represent a standard sensor, it is not possible to define using Linux IIO
type interfaces.
The purpose of these sensors is to extend the functionality or provide a
way to obfuscate the data being communicated by a sensor. Without knowing the
mapping between the data and its encapsulated form, it is difficult for
an application/driver to determine what data is being communicated by the sensor.
This allows some differentiating use cases, where vendor can provide applications.
Some common use cases are debug other sensors or to provide some events like
keyboard attached/detached or lid open/close.”…””}”(hj
  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kžhjù  hžhubh¸)”}”(hŒ‰To allow application to utilize these sensors, here they are exported using sysfs
attribute groups, attributes and misc device interface.”h]”hŒ‰To allow application to utilize these sensors, here they are exported using sysfs
attribute groups, attributes and misc device interface.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K©hjù  hžhubh¸)”}”(hŒ,An example of this representation on sysfs::”h]”hŒ+An example of this representation on sysfs:”…””}”(hj&  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K¬hjù  hžhubhä)”}”(hXp  /sys/devices/pci0000:00/INT33C2:00/i2c-0/i2c-INT33D1:00/0018:8086:09FA.0001/HID-SENSOR-2000e1.6.auto$ tree -R
.
â”‚Â Â  â”œâ”€â”€  enable_sensor
â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-0-200316
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-0-200316-maximum
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-0-200316-minimum
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-0-200316-name
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-0-200316-size
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-0-200316-unit-expo
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-0-200316-units
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-0-200316-value
â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-1-200201
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-1-200201-maximum
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-1-200201-minimum
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-1-200201-name
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-1-200201-size
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-1-200201-unit-expo
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-1-200201-units
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-1-200201-value
â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-0-200201
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-0-200201-maximum
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-0-200201-minimum
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-0-200201-name
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-0-200201-size
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-0-200201-unit-expo
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-0-200201-units
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-0-200201-value
â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-1-200202
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-1-200202-maximum
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-1-200202-minimum
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-1-200202-name
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-1-200202-size
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-1-200202-unit-expo
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-1-200202-units
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-1-200202-value”h]”hXp  /sys/devices/pci0000:00/INT33C2:00/i2c-0/i2c-INT33D1:00/0018:8086:09FA.0001/HID-SENSOR-2000e1.6.auto$ tree -R
.
â”‚Â Â  â”œâ”€â”€  enable_sensor
â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-0-200316
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-0-200316-maximum
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-0-200316-minimum
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-0-200316-name
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-0-200316-size
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-0-200316-unit-expo
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-0-200316-units
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-0-200316-value
â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-1-200201
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-1-200201-maximum
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-1-200201-minimum
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-1-200201-name
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-1-200201-size
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-1-200201-unit-expo
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-1-200201-units
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ feature-1-200201-value
â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-0-200201
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-0-200201-maximum
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-0-200201-minimum
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-0-200201-name
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-0-200201-size
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-0-200201-unit-expo
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-0-200201-units
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-0-200201-value
â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-1-200202
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-1-200202-maximum
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-1-200202-minimum
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-1-200202-name
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-1-200202-size
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-1-200202-unit-expo
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-1-200202-units
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ input-1-200202-value”…””}”hj4  sbah}”(h]”h ]”h"]”h$]”h&]”hóhôuh1hãhŸh¶h K®hjù  hžhubh¸)”}”(hŒÑHere there is a custom sensor with four fields: two feature and two inputs.
Each field is represented by a set of attributes. All fields except the "value"
are read only. The value field is a read-write field.”h]”hŒÕHere there is a custom sensor with four fields: two feature and two inputs.
Each field is represented by a set of attributes. All fields except the â€œvalueâ€
are read only. The value field is a read-write field.”…””}”(hjB  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KÒhjù  hžhubh¸)”}”(hŒ	Example::”h]”hŒExample:”…””}”(hjP  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KÖhjù  hžhubhä)”}”(hX  /sys/bus/platform/devices/HID-SENSOR-2000e1.6.auto/feature-0-200316$ grep -r . *
feature-0-200316-maximum:6
feature-0-200316-minimum:0
feature-0-200316-name:property-reporting-state
feature-0-200316-size:1
feature-0-200316-unit-expo:0
feature-0-200316-units:25
feature-0-200316-value:1”h]”hX  /sys/bus/platform/devices/HID-SENSOR-2000e1.6.auto/feature-0-200316$ grep -r . *
feature-0-200316-maximum:6
feature-0-200316-minimum:0
feature-0-200316-name:property-reporting-state
feature-0-200316-size:1
feature-0-200316-unit-expo:0
feature-0-200316-units:25
feature-0-200316-value:1”…””}”hj^  sbah}”(h]”h ]”h"]”h$]”h&]”hóhôuh1hãhŸh¶h KØhjù  hžhubh¢)”}”(hhh]”(h§)”}”(hŒHow to enable such sensor?”h]”hŒHow to enable such sensor?”…””}”(hjo  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjl  hžhhŸh¶h Kâubh¸)”}”(hŒVBy default sensor can be power gated. To enable sysfs attribute "enable" can be
used::”h]”hŒYBy default sensor can be power gated. To enable sysfs attribute â€œenableâ€ can be
used:”…””}”(hj}  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kähjl  hžhubhä)”}”(hŒ$ echo 1 > enable_sensor”h]”hŒ$ echo 1 > enable_sensor”…””}”hj‹  sbah}”(h]”h ]”h"]”h$]”h&]”hóhôuh1hãhŸh¶h Kçhjl  hžhubh¸)”}”(hŒŽOnce enabled and powered on, sensor can report value using HID reports.
These reports are pushed using misc device interface in a FIFO order::”h]”hŒOnce enabled and powered on, sensor can report value using HID reports.
These reports are pushed using misc device interface in a FIFO order:”…””}”(hj™  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kéhjl  hžhubhä)”}”(hŒ/dev$ tree | grep HID-SENSOR-2000e1.6.auto
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ 10:53 -> ../HID-SENSOR-2000e1.6.auto
â”‚Â Â  â”œâ”€â”€  HID-SENSOR-2000e1.6.auto”h]”hŒ/dev$ tree | grep HID-SENSOR-2000e1.6.auto
â”‚Â Â  â”‚Â Â  â”‚Â Â  â”œâ”€â”€ 10:53 -> ../HID-SENSOR-2000e1.6.auto
â”‚Â Â  â”œâ”€â”€  HID-SENSOR-2000e1.6.auto”…””}”hj§  sbah}”(h]”h ]”h"]”h$]”h&]”hóhôuh1hãhŸh¶h Kìhjl  hžhubh¸)”}”(hŒEach report can be of variable length preceded by a header. This header
consists of a 32-bit usage id, 64-bit time stamp and 32-bit length field of raw
data.”h]”hŒEach report can be of variable length preceded by a header. This header
consists of a 32-bit usage id, 64-bit time stamp and 32-bit length field of raw
data.”…””}”(hjµ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kðhjl  hžhubeh}”(h]”Œhow-to-enable-such-sensor”ah ]”h"]”Œhow to enable such sensor?”ah$]”h&]”uh1h¡hjù  hžhhŸh¶h Kâubeh}”(h]”Œhid-custom-and-generic-sensors”ah ]”h"]”Œhid custom and generic sensors”ah$]”h&]”uh1h¡hjî  hžhhŸh¶h K›ubeh}”(h]”Œcore-driver-interface”ah ]”h"]”Œcore driver interface”ah$]”h&]”uh1h¡hh£hžhhŸh¶h KQubeh}”(h]”Œhid-sensors-framework”ah ]”h"]”Œhid sensors framework”ah$]”h&]”uh1h¡hhhžhhŸh¶h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h¶uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¦NŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h¶Œ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jà  jÝ  jë  jè  j¼  j¹  jã  jà  jØ  jÕ  jÐ  jÍ  jÈ  jÅ  uŒ	nametypes”}”(jà  ‰jë  ‰j¼  ‰jã  ‰jØ  ‰jÐ  ‰jÈ  ‰uh}”(jÝ  h£jè  j  j¹  j`  jà  j¿  jÕ  jî  jÍ  jù  jÅ  jl  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.