€•Ì¶Œsphinx.addnodes”Œdocument”“”)”}”(Œ rawsource”Œ”Œchildren”]”(Œ translations”Œ LanguagesNode”“”)”}”(hhh]”(hŒ pending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ refdomain”Œstd”Œreftype”Œdoc”Œ reftarget”Œ&/translations/zh_CN/input/devices/alps”Œmodname”NŒ classname”NŒ refexplicit”ˆuŒtagname”hhh ubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ&/translations/zh_TW/input/devices/alps”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ&/translations/it_IT/input/devices/alps”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ&/translations/ja_JP/input/devices/alps”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ&/translations/ko_KR/input/devices/alps”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ&/translations/pt_BR/input/devices/alps”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ refdomain”h)Œreftype”h+Œ reftarget”Œ&/translations/sp_SP/input/devices/alps”Œmodname”NŒ classname”NŒ refexplicit”ˆuh1hhh ubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h hhŒ _document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒALPS Touchpad Protocol”h]”hŒALPS Touchpad Protocol”…””}”(hh¼h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhh·h²hh³Œ@/var/lib/git/docbuild/linux/Documentation/input/devices/alps.rst”h´Kubh¶)”}”(hhh]”(h»)”}”(hŒ Introduction”h]”hŒ Introduction”…””}”(hhÎh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhhËh²hh³hÊh´KubhŒ paragraph”“”)”}”(hŒˆCurrently the ALPS touchpad driver supports seven protocol versions in use by ALPS touchpads, called versions 1, 2, 3, 4, 5, 6, 7 and 8.”h]”hŒˆCurrently the ALPS touchpad driver supports seven protocol versions in use by ALPS touchpads, called versions 1, 2, 3, 4, 5, 6, 7 and 8.”…””}”(hhÞh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´KhhËh²hubhÝ)”}”(hXëSince roughly mid-2010 several new ALPS touchpads have been released and integrated into a variety of laptops and netbooks. These new touchpads have enough behavior differences that the alps_model_data definition table, describing the properties of the different versions, is no longer adequate. The design choices were to re-define the alps_model_data table, with the risk of regression testing existing devices, or isolate the new devices outside of the alps_model_data table. The latter design choice was made. The new touchpad signatures are named: "Rushmore", "Pinnacle", and "Dolphin", which you will see in the alps.c code. For the purposes of this document, this group of ALPS touchpads will generically be called "new ALPS touchpads".”h]”hXûSince roughly mid-2010 several new ALPS touchpads have been released and integrated into a variety of laptops and netbooks. These new touchpads have enough behavior differences that the alps_model_data definition table, describing the properties of the different versions, is no longer adequate. The design choices were to re-define the alps_model_data table, with the risk of regression testing existing devices, or isolate the new devices outside of the alps_model_data table. The latter design choice was made. The new touchpad signatures are named: “Rushmoreâ€, “Pinnacleâ€, and “Dolphinâ€, which you will see in the alps.c code. For the purposes of this document, this group of ALPS touchpads will generically be called “new ALPS touchpadsâ€.”…””}”(hhìh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K hhËh²hubhÝ)”}”(hX"We experimented with probing the ACPI interface _HID (Hardware ID)/_CID (Compatibility ID) definition as a way to uniquely identify the different ALPS variants but there did not appear to be a 1:1 mapping. In fact, it appeared to be an m:n mapping between the _HID and actual hardware type.”h]”hX"We experimented with probing the ACPI interface _HID (Hardware ID)/_CID (Compatibility ID) definition as a way to uniquely identify the different ALPS variants but there did not appear to be a 1:1 mapping. In fact, it appeared to be an m:n mapping between the _HID and actual hardware type.”…””}”(hhúh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´KhhËh²hubeh}”(h]”Œ introduction”ah ]”h"]”Œ introduction”ah$]”h&]”uh1hµhh·h²hh³hÊh´Kubh¶)”}”(hhh]”(h»)”}”(hŒ Detection”h]”hŒ Detection”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjh²hh³hÊh´KubhÝ)”}”(hŒùAll ALPS touchpads should respond to the "E6 report" command sequence: E8-E6-E6-E6-E9. An ALPS touchpad should respond with either 00-00-0A or 00-00-64 if no buttons are pressed. The bits 0-2 of the first byte will be 1s if some buttons are pressed.”h]”hŒýAll ALPS touchpads should respond to the “E6 report†command sequence: E8-E6-E6-E6-E9. An ALPS touchpad should respond with either 00-00-0A or 00-00-64 if no buttons are pressed. The bits 0-2 of the first byte will be 1s if some buttons are pressed.”…””}”(hj!h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´Khjh²hubhÝ)”}”(hŒÖIf the E6 report is successful, the touchpad model is identified using the "E7 report" sequence: E8-E7-E7-E7-E9. The response is the model signature and is matched against known models in the alps_model_data_array.”h]”hŒÚIf the E6 report is successful, the touchpad model is identified using the “E7 report†sequence: E8-E7-E7-E7-E9. The response is the model signature and is matched against known models in the alps_model_data_array.”…””}”(hj/h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K$hjh²hubhÝ)”}”(hŒîFor older touchpads supporting protocol versions 3 and 4, the E7 report model signature is always 73-02-64. To differentiate between these versions, the response from the "Enter Command Mode" sequence must be inspected as described below.”h]”hŒòFor older touchpads supporting protocol versions 3 and 4, the E7 report model signature is always 73-02-64. To differentiate between these versions, the response from the “Enter Command Mode†sequence must be inspected as described below.”…””}”(hj=h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K(hjh²hubhÝ)”}”(hŒ‰The new ALPS touchpads have an E7 signature of 73-03-50 or 73-03-0A but seem to be better differentiated by the EC Command Mode response.”h]”hŒ‰The new ALPS touchpads have an E7 signature of 73-03-50 or 73-03-0A but seem to be better differentiated by the EC Command Mode response.”…””}”(hjKh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K-hjh²hubeh}”(h]”Œ detection”ah ]”h"]”Œ detection”ah$]”h&]”uh1hµhh·h²hh³hÊh´Kubh¶)”}”(hhh]”(h»)”}”(hŒ Command Mode”h]”hŒ Command Mode”…””}”(hjdh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjah²hh³hÊh´K1ubhÝ)”}”(hXeProtocol versions 3 and 4 have a command mode that is used to read and write one-byte device registers in a 16-bit address space. The command sequence EC-EC-EC-E9 places the device in command mode, and the device will respond with 88-07 followed by a third byte. This third byte can be used to determine whether the devices uses the version 3 or 4 protocol.”h]”hXeProtocol versions 3 and 4 have a command mode that is used to read and write one-byte device registers in a 16-bit address space. The command sequence EC-EC-EC-E9 places the device in command mode, and the device will respond with 88-07 followed by a third byte. This third byte can be used to determine whether the devices uses the version 3 or 4 protocol.”…””}”(hjrh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K3hjah²hubhÝ)”}”(hŒITo exit command mode, PSMOUSE_CMD_SETSTREAM (EA) is sent to the touchpad.”h]”hŒITo exit command mode, PSMOUSE_CMD_SETSTREAM (EA) is sent to the touchpad.”…””}”(hj€h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K9hjah²hubhÝ)”}”(hX5While in command mode, register addresses can be set by first sending a specific command, either EC for v3 devices or F5 for v4 devices. Then the address is sent one nibble at a time, where each nibble is encoded as a command with optional data. This encoding differs slightly between the v3 and v4 protocols.”h]”hX5While in command mode, register addresses can be set by first sending a specific command, either EC for v3 devices or F5 for v4 devices. Then the address is sent one nibble at a time, where each nibble is encoded as a command with optional data. This encoding differs slightly between the v3 and v4 protocols.”…””}”(hjŽh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K;hjah²hubhÝ)”}”(hXXOnce an address has been set, the addressed register can be read by sending PSMOUSE_CMD_GETINFO (E9). The first two bytes of the response contains the address of the register being read, and the third contains the value of the register. Registers are written by writing the value one nibble at a time using the same encoding used for addresses.”h]”hXXOnce an address has been set, the addressed register can be read by sending PSMOUSE_CMD_GETINFO (E9). The first two bytes of the response contains the address of the register being read, and the third contains the value of the register. Registers are written by writing the value one nibble at a time using the same encoding used for addresses.”…””}”(hjœh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´KAhjah²hubhÝ)”}”(hXµFor the new ALPS touchpads, the EC command is used to enter command mode. The response in the new ALPS touchpads is significantly different, and more important in determining the behavior. This code has been separated from the original alps_model_data table and put in the alps_identify function. For example, there seem to be two hardware init sequences for the "Dolphin" touchpads as determined by the second byte of the EC response.”h]”hX¹For the new ALPS touchpads, the EC command is used to enter command mode. The response in the new ALPS touchpads is significantly different, and more important in determining the behavior. This code has been separated from the original alps_model_data table and put in the alps_identify function. For example, there seem to be two hardware init sequences for the “Dolphin†touchpads as determined by the second byte of the EC response.”…””}”(hjªh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´KGhjah²hubeh}”(h]”Œ command-mode”ah ]”h"]”Œ command mode”ah$]”h&]”uh1hµhh·h²hh³hÊh´K1ubh¶)”}”(hhh]”(h»)”}”(hŒ Packet Format”h]”hŒ Packet Format”…””}”(hjÃh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjÀh²hh³hÊh´KPubhÝ)”}”(hŒ9In the following tables, the following notation is used::”h]”hŒ8In the following tables, the following notation is used:”…””}”(hjÑh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´KRhjÀh²hubhŒ literal_block”“”)”}”(hŒ'CAPITALS = stick, miniscules = touchpad”h]”hŒ'CAPITALS = stick, miniscules = touchpad”…””}”hjásbah}”(h]”h ]”h"]”h$]”h&]”Œ xml:space”Œpreserve”uh1jßh³hÊh´KThjÀh²hubhÝ)”}”(hŒ~?'s can have different meanings on different models, such as wheel rotation, extra buttons, stick buttons on a dualpoint, etc.”h]”hŒ€?’s can have different meanings on different models, such as wheel rotation, extra buttons, stick buttons on a dualpoint, etc.”…””}”(hjñh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´KVhjÀh²hubeh}”(h]”Œ packet-format”ah ]”h"]”Œ packet format”ah$]”h&]”uh1hµhh·h²hh³hÊh´KPubh¶)”}”(hhh]”(h»)”}”(hŒPS/2 packet format”h]”hŒPS/2 packet format”…””}”(hj h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjh²hh³hÊh´KZubjà)”}”(hŒ‰byte 0: 0 0 YSGN XSGN 1 M R L byte 1: X7 X6 X5 X4 X3 X2 X1 X0 byte 2: Y7 Y6 Y5 Y4 Y3 Y2 Y1 Y0”h]”hŒ‰byte 0: 0 0 YSGN XSGN 1 M R L byte 1: X7 X6 X5 X4 X3 X2 X1 X0 byte 2: Y7 Y6 Y5 Y4 Y3 Y2 Y1 Y0”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”jïjðuh1jßh³hÊh´K^hjh²hubhÝ)”}”(hŒ6Note that the device never signals overflow condition.”h]”hŒ6Note that the device never signals overflow condition.”…””}”(hj&h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´Kbhjh²hubhÝ)”}”(hŒ¹For protocol version 2 devices when the trackpoint is used, and no fingers are on the touchpad, the M R L bits signal the combined status of both the pointingstick and touchpad buttons.”h]”hŒ¹For protocol version 2 devices when the trackpoint is used, and no fingers are on the touchpad, the M R L bits signal the combined status of both the pointingstick and touchpad buttons.”…””}”(hj4h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´Kdhjh²hubeh}”(h]”Œps-2-packet-format”ah ]”h"]”Œps/2 packet format”ah$]”h&]”uh1hµhh·h²hh³hÊh´KZubh¶)”}”(hhh]”(h»)”}”(hŒ'ALPS Absolute Mode - Protocol Version 1”h]”hŒ'ALPS Absolute Mode - Protocol Version 1”…””}”(hjMh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjJh²hh³hÊh´Kiubjà)”}”(hXbyte 0: 1 0 0 0 1 x9 x8 x7 byte 1: 0 x6 x5 x4 x3 x2 x1 x0 byte 2: 0 ? ? l r ? fin ges byte 3: 0 ? ? ? ? y9 y8 y7 byte 4: 0 y6 y5 y4 y3 y2 y1 y0 byte 5: 0 z6 z5 z4 z3 z2 z1 z0”h]”hXbyte 0: 1 0 0 0 1 x9 x8 x7 byte 1: 0 x6 x5 x4 x3 x2 x1 x0 byte 2: 0 ? ? l r ? fin ges byte 3: 0 ? ? ? ? y9 y8 y7 byte 4: 0 y6 y5 y4 y3 y2 y1 y0 byte 5: 0 z6 z5 z4 z3 z2 z1 z0”…””}”hj[sbah}”(h]”h ]”h"]”h$]”h&]”jïjðuh1jßh³hÊh´KmhjJh²hubeh}”(h]”Œ%alps-absolute-mode-protocol-version-1”ah ]”h"]”Œ'alps absolute mode - protocol version 1”ah$]”h&]”uh1hµhh·h²hh³hÊh´Kiubh¶)”}”(hhh]”(h»)”}”(hŒ'ALPS Absolute Mode - Protocol Version 2”h]”hŒ'ALPS Absolute Mode - Protocol Version 2”…””}”(hjth²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjqh²hh³hÊh´Kuubjà)”}”(hXbyte 0: 1 ? ? ? 1 PSM PSR PSL byte 1: 0 x6 x5 x4 x3 x2 x1 x0 byte 2: 0 x10 x9 x8 x7 ? fin ges byte 3: 0 y9 y8 y7 1 M R L byte 4: 0 y6 y5 y4 y3 y2 y1 y0 byte 5: 0 z6 z5 z4 z3 z2 z1 z0”h]”hXbyte 0: 1 ? ? ? 1 PSM PSR PSL byte 1: 0 x6 x5 x4 x3 x2 x1 x0 byte 2: 0 x10 x9 x8 x7 ? fin ges byte 3: 0 y9 y8 y7 1 M R L byte 4: 0 y6 y5 y4 y3 y2 y1 y0 byte 5: 0 z6 z5 z4 z3 z2 z1 z0”…””}”hj‚sbah}”(h]”h ]”h"]”h$]”h&]”jïjðuh1jßh³hÊh´Kyhjqh²hubhÝ)”}”(hX5Protocol Version 2 DualPoint devices send standard PS/2 mouse packets for the DualPoint Stick. The M, R and L bits signal the combined status of both the pointingstick and touchpad buttons, except for Dell dualpoint devices where the pointingstick buttons get reported separately in the PSM, PSR and PSL bits.”h]”hX5Protocol Version 2 DualPoint devices send standard PS/2 mouse packets for the DualPoint Stick. The M, R and L bits signal the combined status of both the pointingstick and touchpad buttons, except for Dell dualpoint devices where the pointingstick buttons get reported separately in the PSM, PSR and PSL bits.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K€hjqh²hubeh}”(h]”Œ%alps-absolute-mode-protocol-version-2”ah ]”h"]”Œ'alps absolute mode - protocol version 2”ah$]”h&]”uh1hµhh·h²hh³hÊh´Kuubh¶)”}”(hhh]”(h»)”}”(hŒ-Dualpoint device -- interleaved packet format”h]”hŒ-Dualpoint device -- interleaved packet format”…””}”(hj©h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj¦h²hh³hÊh´K‡ubjà)”}”(hX¯byte 0: 1 1 0 0 1 1 1 1 byte 1: 0 x6 x5 x4 x3 x2 x1 x0 byte 2: 0 x10 x9 x8 x7 0 fin ges byte 3: 0 0 YSGN XSGN 1 1 1 1 byte 4: X7 X6 X5 X4 X3 X2 X1 X0 byte 5: Y7 Y6 Y5 Y4 Y3 Y2 Y1 Y0 byte 6: 0 y9 y8 y7 1 m r l byte 7: 0 y6 y5 y4 y3 y2 y1 y0 byte 8: 0 z6 z5 z4 z3 z2 z1 z0”h]”hX¯byte 0: 1 1 0 0 1 1 1 1 byte 1: 0 x6 x5 x4 x3 x2 x1 x0 byte 2: 0 x10 x9 x8 x7 0 fin ges byte 3: 0 0 YSGN XSGN 1 1 1 1 byte 4: X7 X6 X5 X4 X3 X2 X1 X0 byte 5: Y7 Y6 Y5 Y4 Y3 Y2 Y1 Y0 byte 6: 0 y9 y8 y7 1 m r l byte 7: 0 y6 y5 y4 y3 y2 y1 y0 byte 8: 0 z6 z5 z4 z3 z2 z1 z0”…””}”hj·sbah}”(h]”h ]”h"]”h$]”h&]”jïjðuh1jßh³hÊh´K‹hj¦h²hubhÝ)”}”(hXDevices which use the interleaving format normally send standard PS/2 mouse packets for the DualPoint Stick + ALPS Absolute Mode packets for the touchpad, switching to the interleaved packet format when both the stick and the touchpad are used at the same time.”h]”hXDevices which use the interleaving format normally send standard PS/2 mouse packets for the DualPoint Stick + ALPS Absolute Mode packets for the touchpad, switching to the interleaved packet format when both the stick and the touchpad are used at the same time.”…””}”(hjÅh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K•hj¦h²hubeh}”(h]”Œ*dualpoint-device-interleaved-packet-format”ah ]”h"]”Œ-dualpoint device -- interleaved packet format”ah$]”h&]”uh1hµhh·h²hh³hÊh´K‡ubh¶)”}”(hhh]”(h»)”}”(hŒ'ALPS Absolute Mode - Protocol Version 3”h]”hŒ'ALPS Absolute Mode - Protocol Version 3”…””}”(hjÞh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjÛh²hh³hÊh´K›ubhÝ)”}”(hŒ¢ALPS protocol version 3 has three different packet formats. The first two are associated with touchpad events, and the third is associated with trackstick events.”h]”hŒ¢ALPS protocol version 3 has three different packet formats. The first two are associated with touchpad events, and the third is associated with trackstick events.”…””}”(hjìh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´KhjÛh²hubhÝ)”}”(hŒ0The first type is the touchpad position packet::”h]”hŒ/The first type is the touchpad position packet:”…””}”(hjúh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K¡hjÛh²hubjà)”}”(hXbyte 0: 1 ? x1 x0 1 1 1 1 byte 1: 0 x10 x9 x8 x7 x6 x5 x4 byte 2: 0 y10 y9 y8 y7 y6 y5 y4 byte 3: 0 M R L 1 m r l byte 4: 0 mt x3 x2 y3 y2 y1 y0 byte 5: 0 z6 z5 z4 z3 z2 z1 z0”h]”hXbyte 0: 1 ? x1 x0 1 1 1 1 byte 1: 0 x10 x9 x8 x7 x6 x5 x4 byte 2: 0 y10 y9 y8 y7 y6 y5 y4 byte 3: 0 M R L 1 m r l byte 4: 0 mt x3 x2 y3 y2 y1 y0 byte 5: 0 z6 z5 z4 z3 z2 z1 z0”…””}”hjsbah}”(h]”h ]”h"]”h$]”h&]”jïjðuh1jßh³hÊh´K£hjÛh²hubhÝ)”}”(hŒ†Note that for some devices the trackstick buttons are reported in this packet, and on others it is reported in the trackstick packets.”h]”hŒ†Note that for some devices the trackstick buttons are reported in this packet, and on others it is reported in the trackstick packets.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´KªhjÛh²hubhÝ)”}”(hXkThe second packet type contains bitmaps representing the x and y axes. In the bitmaps a given bit is set if there is a finger covering that position on the given axis. Thus the bitmap packet can be used for low-resolution multi-touch data, although finger tracking is not possible. This packet also encodes the number of contacts (f1 and f0 in the table below)::”h]”hXjThe second packet type contains bitmaps representing the x and y axes. In the bitmaps a given bit is set if there is a finger covering that position on the given axis. Thus the bitmap packet can be used for low-resolution multi-touch data, although finger tracking is not possible. This packet also encodes the number of contacts (f1 and f0 in the table below):”…””}”(hj$h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K­hjÛh²hubjà)”}”(hXbyte 0: 1 1 x1 x0 1 1 1 1 byte 1: 0 x8 x7 x6 x5 x4 x3 x2 byte 2: 0 y7 y6 y5 y4 y3 y2 y1 byte 3: 0 y10 y9 y8 1 1 1 1 byte 4: 0 x14 x13 x12 x11 x10 x9 y0 byte 5: 0 1 ? ? ? ? f1 f0”h]”hXbyte 0: 1 1 x1 x0 1 1 1 1 byte 1: 0 x8 x7 x6 x5 x4 x3 x2 byte 2: 0 y7 y6 y5 y4 y3 y2 y1 byte 3: 0 y10 y9 y8 1 1 1 1 byte 4: 0 x14 x13 x12 x11 x10 x9 y0 byte 5: 0 1 ? ? ? ? f1 f0”…””}”hj2sbah}”(h]”h ]”h"]”h$]”h&]”jïjðuh1jßh³hÊh´K³hjÛh²hubhÝ)”}”(hŒÀThis packet only appears after a position packet with the mt bit set, and usually only appears when there are two or more contacts (although occasionally it's seen with only a single contact).”h]”hŒÂThis packet only appears after a position packet with the mt bit set, and usually only appears when there are two or more contacts (although occasionally it’s seen with only a single contact).”…””}”(hj@h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´KºhjÛh²hubhÝ)”}”(hŒ3The final v3 packet type is the trackstick packet::”h]”hŒ2The final v3 packet type is the trackstick packet:”…””}”(hjNh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´K¾hjÛh²hubjà)”}”(hXbyte 0: 1 1 x7 y7 1 1 1 1 byte 1: 0 x6 x5 x4 x3 x2 x1 x0 byte 2: 0 y6 y5 y4 y3 y2 y1 y0 byte 3: 0 1 TP SW 1 M R L byte 4: 0 z6 z5 z4 z3 z2 z1 z0 byte 5: 0 0 1 1 1 1 1 1”h]”hXbyte 0: 1 1 x7 y7 1 1 1 1 byte 1: 0 x6 x5 x4 x3 x2 x1 x0 byte 2: 0 y6 y5 y4 y3 y2 y1 y0 byte 3: 0 1 TP SW 1 M R L byte 4: 0 z6 z5 z4 z3 z2 z1 z0 byte 5: 0 0 1 1 1 1 1 1”…””}”hj\sbah}”(h]”h ]”h"]”h$]”h&]”jïjðuh1jßh³hÊh´KÀhjÛh²hubhÝ)”}”(hŒ˜TP means Tap SW status when tap processing is enabled or Press status when press processing is enabled. SW means scroll up when 4 buttons are available.”h]”hŒ˜TP means Tap SW status when tap processing is enabled or Press status when press processing is enabled. SW means scroll up when 4 buttons are available.”…””}”(hjjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´KÇhjÛh²hubeh}”(h]”Œ%alps-absolute-mode-protocol-version-3”ah ]”h"]”Œ'alps absolute mode - protocol version 3”ah$]”h&]”uh1hµhh·h²hh³hÊh´K›ubh¶)”}”(hhh]”(h»)”}”(hŒ'ALPS Absolute Mode - Protocol Version 4”h]”hŒ'ALPS Absolute Mode - Protocol Version 4”…””}”(hjƒh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj€h²hh³hÊh´KËubhÝ)”}”(hŒ0Protocol version 4 has an 8-byte packet format::”h]”hŒ/Protocol version 4 has an 8-byte packet format:”…””}”(hj‘h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´KÍhj€h²hubjà)”}”(hXqbyte 0: 1 ? x1 x0 1 1 1 1 byte 1: 0 x10 x9 x8 x7 x6 x5 x4 byte 2: 0 y10 y9 y8 y7 y6 y5 y4 byte 3: 0 1 x3 x2 y3 y2 y1 y0 byte 4: 0 ? ? ? 1 ? r l byte 5: 0 z6 z5 z4 z3 z2 z1 z0 byte 6: bitmap data (described below) byte 7: bitmap data (described below)”h]”hXqbyte 0: 1 ? x1 x0 1 1 1 1 byte 1: 0 x10 x9 x8 x7 x6 x5 x4 byte 2: 0 y10 y9 y8 y7 y6 y5 y4 byte 3: 0 1 x3 x2 y3 y2 y1 y0 byte 4: 0 ? ? ? 1 ? r l byte 5: 0 z6 z5 z4 z3 z2 z1 z0 byte 6: bitmap data (described below) byte 7: bitmap data (described below)”…””}”hjŸsbah}”(h]”h ]”h"]”h$]”h&]”jïjðuh1jßh³hÊh´KÏhj€h²hubhÝ)”}”(hŒ¾The last two bytes represent a partial bitmap packet, with 3 full packets required to construct a complete bitmap packet. Once assembled, the 6-byte bitmap packet has the following format::”h]”hŒ½The last two bytes represent a partial bitmap packet, with 3 full packets required to construct a complete bitmap packet. Once assembled, the 6-byte bitmap packet has the following format:”…””}”(hj­h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´KØhj€h²hubjà)”}”(hXbyte 0: 0 1 x7 x6 x5 x4 x3 x2 byte 1: 0 x1 x0 y4 y3 y2 y1 y0 byte 2: 0 0 ? x14 x13 x12 x11 x10 byte 3: 0 x9 x8 y9 y8 y7 y6 y5 byte 4: 0 0 0 0 0 0 0 0 byte 5: 0 0 0 0 0 0 0 y10”h]”hXbyte 0: 0 1 x7 x6 x5 x4 x3 x2 byte 1: 0 x1 x0 y4 y3 y2 y1 y0 byte 2: 0 0 ? x14 x13 x12 x11 x10 byte 3: 0 x9 x8 y9 y8 y7 y6 y5 byte 4: 0 0 0 0 0 0 0 0 byte 5: 0 0 0 0 0 0 0 y10”…””}”hj»sbah}”(h]”h ]”h"]”h$]”h&]”jïjðuh1jßh³hÊh´KÜhj€h²hubhÝ)”}”(hŒ+There are several things worth noting here.”h]”hŒ+There are several things worth noting here.”…””}”(hjÉh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´Kãhj€h²hubhŒ block_quote”“”)”}”(hX~1) In the bitmap data, bit 6 of byte 0 serves as a sync byte to identify the first fragment of a bitmap packet. 2) The bitmaps represent the same data as in the v3 bitmap packets, although the packet layout is different. 3) There doesn't seem to be a count of the contact points anywhere in the v4 protocol packets. Deriving a count of contact points must be done by analyzing the bitmaps. 4) There is a 3 to 1 ratio of position packets to bitmap packets. Therefore MT position can only be updated for every third ST position update, and the count of contact points can only be updated every third packet as well. ”h]”hŒenumerated_list”“”)”}”(hhh]”(hŒ list_item”“”)”}”(hŒmIn the bitmap data, bit 6 of byte 0 serves as a sync byte to identify the first fragment of a bitmap packet. ”h]”hÝ)”}”(hŒlIn the bitmap data, bit 6 of byte 0 serves as a sync byte to identify the first fragment of a bitmap packet.”h]”hŒlIn the bitmap data, bit 6 of byte 0 serves as a sync byte to identify the first fragment of a bitmap packet.”…””}”(hjèh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´Kåhjäubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjßubjã)”}”(hŒjThe bitmaps represent the same data as in the v3 bitmap packets, although the packet layout is different. ”h]”hÝ)”}”(hŒiThe bitmaps represent the same data as in the v3 bitmap packets, although the packet layout is different.”h]”hŒiThe bitmaps represent the same data as in the v3 bitmap packets, although the packet layout is different.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´Kèhjüubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjßubjã)”}”(hŒ¦There doesn't seem to be a count of the contact points anywhere in the v4 protocol packets. Deriving a count of contact points must be done by analyzing the bitmaps. ”h]”hÝ)”}”(hŒ¥There doesn't seem to be a count of the contact points anywhere in the v4 protocol packets. Deriving a count of contact points must be done by analyzing the bitmaps.”h]”hŒ§There doesn’t seem to be a count of the contact points anywhere in the v4 protocol packets. Deriving a count of contact points must be done by analyzing the bitmaps.”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´Këhjubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjßubjã)”}”(hŒÝThere is a 3 to 1 ratio of position packets to bitmap packets. Therefore MT position can only be updated for every third ST position update, and the count of contact points can only be updated every third packet as well. ”h]”hÝ)”}”(hŒÜThere is a 3 to 1 ratio of position packets to bitmap packets. Therefore MT position can only be updated for every third ST position update, and the count of contact points can only be updated every third packet as well.”h]”hŒÜThere is a 3 to 1 ratio of position packets to bitmap packets. Therefore MT position can only be updated for every third ST position update, and the count of contact points can only be updated every third packet as well.”…””}”(hj0h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´Kïhj,ubah}”(h]”h ]”h"]”h$]”h&]”uh1jâhjßubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ)”uh1jÝhjÙubah}”(h]”h ]”h"]”h$]”h&]”uh1j×h³hÊh´Kåhj€h²hubhÝ)”}”(hŒ 2 fingers are down, and some fingers are in the button area, then the 2 coordinates reported are for fingers outside the button area and these report extra fingers being present in the right / left button area. Note these fingers are not added to the F field! so if a TWO packet is received and R = 1 then there are 3 fingers down, etc. TWO: 1: Two touches present, byte 0/4/5 are in TWO fmt 0: If byte 4 bit 0 is 1, then byte 0/4/5 are in MULTI fmt otherwise byte 0 bit 4 must be set and byte 0/4/5 are in NEW fmt F: Number of fingers - 3, 0 means 3 fingers, 1 means 4 ...”h]”hXR packet-fmt b7 b6 b5 b4 b3 b2 b1 b0 byte 0: TWO & MULTI L 1 R M 1 Y0-2 Y0-1 Y0-0 byte 0: NEW L 1 X1-5 1 1 Y0-2 Y0-1 Y0-0 byte 1: Y0-10 Y0-9 Y0-8 Y0-7 Y0-6 Y0-5 Y0-4 Y0-3 byte 2: X0-11 1 X0-10 X0-9 X0-8 X0-7 X0-6 X0-5 byte 3: X1-11 1 X0-4 X0-3 1 X0-2 X0-1 X0-0 byte 4: TWO X1-10 TWO X1-9 X1-8 X1-7 X1-6 X1-5 X1-4 byte 4: MULTI X1-10 TWO X1-9 X1-8 X1-7 X1-6 Y1-5 1 byte 4: NEW X1-10 TWO X1-9 X1-8 X1-7 X1-6 0 0 byte 5: TWO & NEW Y1-10 0 Y1-9 Y1-8 Y1-7 Y1-6 Y1-5 Y1-4 byte 5: MULTI Y1-10 0 Y1-9 Y1-8 Y1-7 Y1-6 F-1 F-0 L: Left button R / M: Non-clickpads: Right / Middle button Clickpads: When > 2 fingers are down, and some fingers are in the button area, then the 2 coordinates reported are for fingers outside the button area and these report extra fingers being present in the right / left button area. Note these fingers are not added to the F field! so if a TWO packet is received and R = 1 then there are 3 fingers down, etc. TWO: 1: Two touches present, byte 0/4/5 are in TWO fmt 0: If byte 4 bit 0 is 1, then byte 0/4/5 are in MULTI fmt otherwise byte 0 bit 4 must be set and byte 0/4/5 are in NEW fmt F: Number of fingers - 3, 0 means 3 fingers, 1 means 4 ...”…””}”hjdsbah}”(h]”h ]”h"]”h$]”h&]”jïjðuh1jßh³hÊh´M4hj)h²hubeh}”(h]”Œ%alps-absolute-mode-protocol-version-7”ah ]”h"]”Œ'alps absolute mode - protocol version 7”ah$]”h&]”uh1hµhh·h²hh³hÊh´M'ubh¶)”}”(hhh]”(h»)”}”(hŒ'ALPS Absolute Mode - Protocol Version 8”h]”hŒ'ALPS Absolute Mode - Protocol Version 8”…””}”(hj}h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjzh²hh³hÊh´MQubhÝ)”}”(hŒ5Spoken by SS4 (73 03 14) and SS5 (73 03 28) hardware.”h]”hŒ5Spoken by SS4 (73 03 14) and SS5 (73 03 28) hardware.”…””}”(hj‹h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´MShjzh²hubhÝ)”}”(hŒ>The packet type is given by the APD field, bits 4-5 of byte 3.”h]”hŒ>The packet type is given by the APD field, bits 4-5 of byte 3.”…””}”(hj™h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´MUhjzh²hubhÝ)”}”(hŒTouchpad packet (APD = 0x2)::”h]”hŒTouchpad packet (APD = 0x2):”…””}”(hj§h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´MWhjzh²hubjà)”}”(hXO b7 b6 b5 b4 b3 b2 b1 b0 byte 0: SWM SWR SWL 1 1 0 0 X7 byte 1: 0 X6 X5 X4 X3 X2 X1 X0 byte 2: 0 Y6 Y5 Y4 Y3 Y2 Y1 Y0 byte 3: 0 T&P 1 0 1 0 0 Y7 byte 4: 0 Z6 Z5 Z4 Z3 Z2 Z1 Z0 byte 5: 0 0 0 0 0 0 0 0”h]”hXO b7 b6 b5 b4 b3 b2 b1 b0 byte 0: SWM SWR SWL 1 1 0 0 X7 byte 1: 0 X6 X5 X4 X3 X2 X1 X0 byte 2: 0 Y6 Y5 Y4 Y3 Y2 Y1 Y0 byte 3: 0 T&P 1 0 1 0 0 Y7 byte 4: 0 Z6 Z5 Z4 Z3 Z2 Z1 Z0 byte 5: 0 0 0 0 0 0 0 0”…””}”hjµsbah}”(h]”h ]”h"]”h$]”h&]”jïjðuh1jßh³hÊh´MYhjzh²hubhÝ)”}”(hŒ4SWM, SWR, SWL: Middle, Right, and Left button states”h]”hŒ4SWM, SWR, SWL: Middle, Right, and Left button states”…””}”(hjÃh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´Mahjzh²hubhÝ)”}”(hŒ&Touchpad 1 Finger packet (APD = 0x0)::”h]”hŒ%Touchpad 1 Finger packet (APD = 0x0):”…””}”(hjÑh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´Mchjzh²hubjà)”}”(hXR b7 b6 b5 b4 b3 b2 b1 b0 byte 0: SWM SWR SWL 1 1 X2 X1 X0 byte 1: X9 X8 X7 1 X6 X5 X4 X3 byte 2: 0 X11 X10 LFB Y3 Y2 Y1 Y0 byte 3: Y5 Y4 0 0 1 TAPF2 TAPF1 TAPF0 byte 4: Zv7 Y11 Y10 1 Y9 Y8 Y7 Y6 byte 5: Zv6 Zv5 Zv4 0 Zv3 Zv2 Zv1 Zv0”h]”hXR b7 b6 b5 b4 b3 b2 b1 b0 byte 0: SWM SWR SWL 1 1 X2 X1 X0 byte 1: X9 X8 X7 1 X6 X5 X4 X3 byte 2: 0 X11 X10 LFB Y3 Y2 Y1 Y0 byte 3: Y5 Y4 0 0 1 TAPF2 TAPF1 TAPF0 byte 4: Zv7 Y11 Y10 1 Y9 Y8 Y7 Y6 byte 5: Zv6 Zv5 Zv4 0 Zv3 Zv2 Zv1 Zv0”…””}”hjßsbah}”(h]”h ]”h"]”h$]”h&]”jïjðuh1jßh³hÊh´Mehjzh²hubhÝ)”}”(hŒTAPF: ??? LFB: ???”h]”hŒTAPF: ??? LFB: ???”…””}”(hjíh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´Mmhjzh²hubhÝ)”}”(hŒ&Touchpad 2 Finger packet (APD = 0x1)::”h]”hŒ%Touchpad 2 Finger packet (APD = 0x1):”…””}”(hjûh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´Mphjzh²hubjà)”}”(hXO b7 b6 b5 b4 b3 b2 b1 b0 byte 0: SWM SWR SWL 1 1 AX6 AX5 AX4 byte 1: AX11 AX10 AX9 AX8 AX7 AZ1 AY4 AZ0 byte 2: AY11 AY10 AY9 CONT AY8 AY7 AY6 AY5 byte 3: 0 0 0 1 1 BX6 BX5 BX4 byte 4: BX11 BX10 BX9 BX8 BX7 BZ1 BY4 BZ0 byte 5: BY11 BY10 BY9 0 BY8 BY7 BY5 BY5”h]”hXO b7 b6 b5 b4 b3 b2 b1 b0 byte 0: SWM SWR SWL 1 1 AX6 AX5 AX4 byte 1: AX11 AX10 AX9 AX8 AX7 AZ1 AY4 AZ0 byte 2: AY11 AY10 AY9 CONT AY8 AY7 AY6 AY5 byte 3: 0 0 0 1 1 BX6 BX5 BX4 byte 4: BX11 BX10 BX9 BX8 BX7 BZ1 BY4 BZ0 byte 5: BY11 BY10 BY9 0 BY8 BY7 BY5 BY5”…””}”hj sbah}”(h]”h ]”h"]”h$]”h&]”jïjðuh1jßh³hÊh´Mrhjzh²hubhÝ)”}”(hŒ)CONT: A 3-or-4 Finger packet is to follow”h]”hŒ)CONT: A 3-or-4 Finger packet is to follow”…””}”(hjh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´Mzhjzh²hubhÝ)”}”(hŒ+Touchpad 3-or-4 Finger packet (APD = 0x3)::”h]”hŒ*Touchpad 3-or-4 Finger packet (APD = 0x3):”…””}”(hj%h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´M|hjzh²hubjà)”}”(hXO b7 b6 b5 b4 b3 b2 b1 b0 byte 0: SWM SWR SWL 1 1 AX6 AX5 AX4 byte 1: AX11 AX10 AX9 AX8 AX7 AZ1 AY4 AZ0 byte 2: AY11 AY10 AY9 OVF AY8 AY7 AY6 AY5 byte 3: 0 0 1 1 1 BX6 BX5 BX4 byte 4: BX11 BX10 BX9 BX8 BX7 BZ1 BY4 BZ0 byte 5: BY11 BY10 BY9 0 BY8 BY7 BY5 BY5”h]”hXO b7 b6 b5 b4 b3 b2 b1 b0 byte 0: SWM SWR SWL 1 1 AX6 AX5 AX4 byte 1: AX11 AX10 AX9 AX8 AX7 AZ1 AY4 AZ0 byte 2: AY11 AY10 AY9 OVF AY8 AY7 AY6 AY5 byte 3: 0 0 1 1 1 BX6 BX5 BX4 byte 4: BX11 BX10 BX9 BX8 BX7 BZ1 BY4 BZ0 byte 5: BY11 BY10 BY9 0 BY8 BY7 BY5 BY5”…””}”hj3sbah}”(h]”h ]”h"]”h$]”h&]”jïjðuh1jßh³hÊh´M~hjzh²hubhÝ)”}”(hŒOVF: 5th finger detected”h]”hŒOVF: 5th finger detected”…””}”(hjAh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÜh³hÊh´M†hjzh²hubeh}”(h]”Œ%alps-absolute-mode-protocol-version-8”ah ]”h"]”Œ'alps absolute mode - protocol version 8”ah$]”h&]”uh1hµhh·h²hh³hÊh´MQubeh}”(h]”Œalps-touchpad-protocol”ah ]”h"]”Œalps touchpad protocol”ah$]”h&]”uh1hµhhh²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\jYj j j^j[j½jºjjjGjDjnjkj£j jØjÕj}jzjhjejÇjÄj&j#jwjtjTjQuŒ nametypes”}”(j\‰j ‰j^‰j½‰j‰jG‰jn‰j£‰j؉j}‰jh‰jljj&‰jw‰jT‰uh}”(jYh·j hËj[jjºjajjÀjDjjkjJj jqjÕj¦jzjÛjej€jÄjkj#jÊjtj)jQjzuŒ 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.