15. Sentelic 触摸板

版权所有:

© 2002-2011 Sentelic Corporation.

最后更新:

2011年12月7日

15.1. 手指感应板 Intellimouse 模式（滚动轮、第 4 个和第 5 个按钮）

1. MSID 4：滚动轮模式加上前进页（第 4 个按钮）和后退页（第 5 个按钮）

1. 将采样率设置为 200；

2. 将采样率设置为 200；

3. 将采样率设置为 80；

4. 发出“获取设备 ID”命令 (0xF2) 并等待响应；

5. FSP 将响应 0x04。

Packet 1
Bit 7 6 5 4 3 2 1 0       7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0
BYTE  |---------------|BYTE |---------------|BYTE|---------------|BYTE|---------------|
  1   |Y|X|y|x|1|M|R|L|  2  |X|X|X|X|X|X|X|X|  3 |Y|Y|Y|Y|Y|Y|Y|Y|  4 | | |B|F|W|W|W|W|
      |---------------|     |---------------|    |---------------|    |---------------|

Byte 1: Bit7 => Y overflow
        Bit6 => X overflow
        Bit5 => Y sign bit
        Bit4 => X sign bit
        Bit3 => 1
        Bit2 => Middle Button, 1 is pressed, 0 is not pressed.
        Bit1 => Right Button, 1 is pressed, 0 is not pressed.
        Bit0 => Left Button, 1 is pressed, 0 is not pressed.
Byte 2: X Movement(9-bit 2's complement integers)
Byte 3: Y Movement(9-bit 2's complement integers)
Byte 4: Bit3~Bit0 => the scrolling wheel's movement since the last data report.
                    valid values, -8 ~ +7
        Bit4 => 1 = 4th mouse button is pressed, Forward one page.
                0 = 4th mouse button is not pressed.
        Bit5 => 1 = 5th mouse button is pressed, Backward one page.
                0 = 5th mouse button is not pressed.

2. MSID 6：水平和垂直滚动

• 将寄存器 0x40 中的位 1 设置为 1

FSP 将滚动轮的移动替换为 4 位，以显示水平和垂直滚动。

Packet 1
Bit 7 6 5 4 3 2 1 0       7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0
BYTE  |---------------|BYTE |---------------|BYTE|---------------|BYTE|---------------|
  1   |Y|X|y|x|1|M|R|L|  2  |X|X|X|X|X|X|X|X|  3 |Y|Y|Y|Y|Y|Y|Y|Y|  4 | | |B|F|r|l|u|d|
      |---------------|     |---------------|    |---------------|    |---------------|

Byte 1: Bit7 => Y overflow
        Bit6 => X overflow
        Bit5 => Y sign bit
        Bit4 => X sign bit
        Bit3 => 1
        Bit2 => Middle Button, 1 is pressed, 0 is not pressed.
        Bit1 => Right Button, 1 is pressed, 0 is not pressed.
        Bit0 => Left Button, 1 is pressed, 0 is not pressed.
Byte 2: X Movement(9-bit 2's complement integers)
Byte 3: Y Movement(9-bit 2's complement integers)
Byte 4: Bit0 => the Vertical scrolling movement downward.
        Bit1 => the Vertical scrolling movement upward.
        Bit2 => the Horizontal scrolling movement leftward.
        Bit3 => the Horizontal scrolling movement rightward.
        Bit4 => 1 = 4th mouse button is pressed, Forward one page.
                0 = 4th mouse button is not pressed.
        Bit5 => 1 = 5th mouse button is pressed, Backward one page.
                0 = 5th mouse button is not pressed.

3. MSID 7

FSP 使用 2 个数据包（8 字节）来表示绝对位置。因此我们有数据包编号来识别数据包。

如果数据包编号为 0，则该数据包为数据包 1。如果数据包编号为 1，则该数据包为数据包 2。请在程序中计算此编号。

启用 MSID 7 时，MSID6 特殊数据包将同时启用。

15.2. STL3886-G0 的绝对位置

1. 将寄存器 0x40 中的位 2 或 3 设置为 1

2. 将寄存器 0x40 中的位 6 设置为 1

Packet 1 (ABSOLUTE POSITION)
Bit 7 6 5 4 3 2 1 0       7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0
BYTE  |---------------|BYTE |---------------|BYTE|---------------|BYTE|---------------|
  1   |0|1|V|1|1|M|R|L|  2  |X|X|X|X|X|X|X|X|  3 |Y|Y|Y|Y|Y|Y|Y|Y|  4 |r|l|d|u|X|X|Y|Y|
      |---------------|     |---------------|    |---------------|    |---------------|

Byte 1: Bit7~Bit6 => 00, Normal data packet
                => 01, Absolute coordination packet
                => 10, Notify packet
        Bit5 => valid bit
        Bit4 => 1
        Bit3 => 1
        Bit2 => Middle Button, 1 is pressed, 0 is not pressed.
        Bit1 => Right Button, 1 is pressed, 0 is not pressed.
        Bit0 => Left Button, 1 is pressed, 0 is not pressed.
Byte 2: X coordinate (xpos[9:2])
Byte 3: Y coordinate (ypos[9:2])
Byte 4: Bit1~Bit0 => Y coordinate (xpos[1:0])
        Bit3~Bit2 => X coordinate (ypos[1:0])
        Bit4 => scroll up
        Bit5 => scroll down
        Bit6 => scroll left
        Bit7 => scroll right

Notify Packet for G0
Bit 7 6 5 4 3 2 1 0       7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0
BYTE  |---------------|BYTE |---------------|BYTE|---------------|BYTE|---------------|
  1   |1|0|0|1|1|M|R|L|  2  |C|C|C|C|C|C|C|C|  3 |M|M|M|M|M|M|M|M|  4 |0|0|0|0|0|0|0|0|
      |---------------|     |---------------|    |---------------|    |---------------|

Byte 1: Bit7~Bit6 => 00, Normal data packet
                => 01, Absolute coordination packet
                => 10, Notify packet
        Bit5 => 0
        Bit4 => 1
        Bit3 => 1
        Bit2 => Middle Button, 1 is pressed, 0 is not pressed.
        Bit1 => Right Button, 1 is pressed, 0 is not pressed.
        Bit0 => Left Button, 1 is pressed, 0 is not pressed.
Byte 2: Message Type => 0x5A (Enable/Disable status packet)
        Mode Type => 0xA5 (Normal/Icon mode status)
Byte 3: Message Type => 0x00 (Disabled)
                    => 0x01 (Enabled)
        Mode Type    => 0x00 (Normal)
                    => 0x01 (Icon)
Byte 4: Bit7~Bit0 => Don't Care

15.3. STL3888-Ax 的绝对位置

Packet 1 (ABSOLUTE POSITION)
Bit 7 6 5 4 3 2 1 0       7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0
BYTE  |---------------|BYTE |---------------|BYTE|---------------|BYTE|---------------|
  1   |0|1|V|A|1|L|0|1|  2  |X|X|X|X|X|X|X|X|  3 |Y|Y|Y|Y|Y|Y|Y|Y|  4 |x|x|y|y|X|X|Y|Y|
      |---------------|     |---------------|    |---------------|    |---------------|

Byte 1: Bit7~Bit6 => 00, Normal data packet
                => 01, Absolute coordination packet
                => 10, Notify packet
                => 11, Normal data packet with on-pad click
        Bit5 => Valid bit, 0 means that the coordinate is invalid or finger up.
                When both fingers are up, the last two reports have zero valid
                bit.
        Bit4 => arc
        Bit3 => 1
        Bit2 => Left Button, 1 is pressed, 0 is released.
        Bit1 => 0
        Bit0 => 1
Byte 2: X coordinate (xpos[9:2])
Byte 3: Y coordinate (ypos[9:2])
Byte 4: Bit1~Bit0 => Y coordinate (xpos[1:0])
        Bit3~Bit2 => X coordinate (ypos[1:0])
        Bit5~Bit4 => y1_g
        Bit7~Bit6 => x1_g

Packet 2 (ABSOLUTE POSITION)
Bit 7 6 5 4 3 2 1 0       7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0
BYTE  |---------------|BYTE |---------------|BYTE|---------------|BYTE|---------------|
  1   |0|1|V|A|1|R|1|0|  2  |X|X|X|X|X|X|X|X|  3 |Y|Y|Y|Y|Y|Y|Y|Y|  4 |x|x|y|y|X|X|Y|Y|
      |---------------|     |---------------|    |---------------|    |---------------|

Byte 1: Bit7~Bit6 => 00, Normal data packet
                => 01, Absolute coordinates packet
                => 10, Notify packet
                => 11, Normal data packet with on-pad click
        Bit5 => Valid bit, 0 means that the coordinate is invalid or finger up.
                When both fingers are up, the last two reports have zero valid
                bit.
        Bit4 => arc
        Bit3 => 1
        Bit2 => Right Button, 1 is pressed, 0 is released.
        Bit1 => 1
        Bit0 => 0
Byte 2: X coordinate (xpos[9:2])
Byte 3: Y coordinate (ypos[9:2])
Byte 4: Bit1~Bit0 => Y coordinate (xpos[1:0])
        Bit3~Bit2 => X coordinate (ypos[1:0])
        Bit5~Bit4 => y2_g
        Bit7~Bit6 => x2_g

Notify Packet for STL3888-Ax
Bit 7 6 5 4 3 2 1 0       7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0
BYTE  |---------------|BYTE |---------------|BYTE|---------------|BYTE|---------------|
  1   |1|0|1|P|1|M|R|L|  2  |C|C|C|C|C|C|C|C|  3 |0|0|F|F|0|0|0|i|  4 |r|l|d|u|0|0|0|0|
      |---------------|     |---------------|    |---------------|    |---------------|

Byte 1: Bit7~Bit6 => 00, Normal data packet
                => 01, Absolute coordinates packet
                => 10, Notify packet
                => 11, Normal data packet with on-pad click
        Bit5 => 1
        Bit4 => when in absolute coordinates mode (valid when EN_PKT_GO is 1):
                0: left button is generated by the on-pad command
                1: left button is generated by the external button
        Bit3 => 1
        Bit2 => Middle Button, 1 is pressed, 0 is not pressed.
        Bit1 => Right Button, 1 is pressed, 0 is not pressed.
        Bit0 => Left Button, 1 is pressed, 0 is not pressed.
Byte 2: Message Type => 0xB7 (Multi Finger, Multi Coordinate mode)
Byte 3: Bit7~Bit6 => Don't care
        Bit5~Bit4 => Number of fingers
        Bit3~Bit1 => Reserved
        Bit0 => 1: enter gesture mode; 0: leaving gesture mode
Byte 4: Bit7 => scroll right button
        Bit6 => scroll left button
        Bit5 => scroll down button
        Bit4 => scroll up button
            * Note that if gesture and additional button (Bit4~Bit7)
            happen at the same time, the button information will not
            be sent.
        Bit3~Bit0 => Reserved

多指、多坐标模式的采样序列

通知数据包（有效位 == 1），abs pkt 1，abs pkt 2，abs pkt 1，abs pkt 2，...，通知数据包（有效位 == 0）

15.4. STL3888-B0 的绝对位置

Packet 1(ABSOLUTE POSITION)
Bit 7 6 5 4 3 2 1 0       7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0
BYTE  |---------------|BYTE |---------------|BYTE|---------------|BYTE|---------------|
  1   |0|1|V|F|1|0|R|L|  2  |X|X|X|X|X|X|X|X|  3 |Y|Y|Y|Y|Y|Y|Y|Y|  4 |r|l|u|d|X|X|Y|Y|
      |---------------|     |---------------|    |---------------|    |---------------|

Byte 1: Bit7~Bit6 => 00, Normal data packet
                => 01, Absolute coordinates packet
                => 10, Notify packet
                => 11, Normal data packet with on-pad click
        Bit5 => Valid bit, 0 means that the coordinate is invalid or finger up.
                When both fingers are up, the last two reports have zero valid
                bit.
        Bit4 => finger up/down information. 1: finger down, 0: finger up.
        Bit3 => 1
        Bit2 => finger index, 0 is the first finger, 1 is the second finger.
        Bit1 => Right Button, 1 is pressed, 0 is not pressed.
        Bit0 => Left Button, 1 is pressed, 0 is not pressed.
Byte 2: X coordinate (xpos[9:2])
Byte 3: Y coordinate (ypos[9:2])
Byte 4: Bit1~Bit0 => Y coordinate (xpos[1:0])
        Bit3~Bit2 => X coordinate (ypos[1:0])
        Bit4 => scroll down button
        Bit5 => scroll up button
        Bit6 => scroll left button
        Bit7 => scroll right button

Packet 2 (ABSOLUTE POSITION)
Bit 7 6 5 4 3 2 1 0       7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0
BYTE  |---------------|BYTE |---------------|BYTE|---------------|BYTE|---------------|
  1   |0|1|V|F|1|1|R|L|  2  |X|X|X|X|X|X|X|X|  3 |Y|Y|Y|Y|Y|Y|Y|Y|  4 |r|l|u|d|X|X|Y|Y|
      |---------------|     |---------------|    |---------------|    |---------------|

Byte 1: Bit7~Bit6 => 00, Normal data packet
                => 01, Absolute coordination packet
                => 10, Notify packet
                => 11, Normal data packet with on-pad click
        Bit5 => Valid bit, 0 means that the coordinate is invalid or finger up.
                When both fingers are up, the last two reports have zero valid
                bit.
        Bit4 => finger up/down information. 1: finger down, 0: finger up.
        Bit3 => 1
        Bit2 => finger index, 0 is the first finger, 1 is the second finger.
        Bit1 => Right Button, 1 is pressed, 0 is not pressed.
        Bit0 => Left Button, 1 is pressed, 0 is not pressed.
Byte 2: X coordinate (xpos[9:2])
Byte 3: Y coordinate (ypos[9:2])
Byte 4: Bit1~Bit0 => Y coordinate (xpos[1:0])
        Bit3~Bit2 => X coordinate (ypos[1:0])
        Bit4 => scroll down button
        Bit5 => scroll up button
        Bit6 => scroll left button
        Bit7 => scroll right button

STL3888-B0 的通知数据包

Bit 7 6 5 4 3 2 1 0       7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0
BYTE  |---------------|BYTE |---------------|BYTE|---------------|BYTE|---------------|
  1   |1|0|1|P|1|M|R|L|  2  |C|C|C|C|C|C|C|C|  3 |0|0|F|F|0|0|0|i|  4 |r|l|u|d|0|0|0|0|
      |---------------|     |---------------|    |---------------|    |---------------|

Byte 1: Bit7~Bit6 => 00, Normal data packet
                => 01, Absolute coordination packet
                => 10, Notify packet
                => 11, Normal data packet with on-pad click
        Bit5 => 1
        Bit4 => when in absolute coordinates mode (valid when EN_PKT_GO is 1):
                0: left button is generated by the on-pad command
                1: left button is generated by the external button
        Bit3 => 1
        Bit2 => Middle Button, 1 is pressed, 0 is not pressed.
        Bit1 => Right Button, 1 is pressed, 0 is not pressed.
        Bit0 => Left Button, 1 is pressed, 0 is not pressed.
Byte 2: Message Type => 0xB7 (Multi Finger, Multi Coordinate mode)
Byte 3: Bit7~Bit6 => Don't care
        Bit5~Bit4 => Number of fingers
        Bit3~Bit1 => Reserved
        Bit0 => 1: enter gesture mode; 0: leaving gesture mode
Byte 4: Bit7 => scroll right button
        Bit6 => scroll left button
        Bit5 => scroll up button
        Bit4 => scroll down button
            * Note that if gesture and additional button(Bit4~Bit7)
            happen at the same time, the button information will not
            be sent.
        Bit3~Bit0 => Reserved

多指、多坐标模式的采样序列

通知数据包（有效位 == 1），abs pkt 1，abs pkt 2，abs pkt 1，abs pkt 2，...，通知数据包（有效位 == 0）

15.5. STL3888-Cx 和 STL3888-Dx 的绝对位置

Single Finger, Absolute Coordinate Mode (SFAC)
Bit 7 6 5 4 3 2 1 0       7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0
BYTE  |---------------|BYTE |---------------|BYTE|---------------|BYTE|---------------|
  1   |0|1|0|P|1|M|R|L|  2  |X|X|X|X|X|X|X|X|  3 |Y|Y|Y|Y|Y|Y|Y|Y|  4 |r|l|B|F|X|X|Y|Y|
      |---------------|     |---------------|    |---------------|    |---------------|

Byte 1: Bit7~Bit6 => 00, Normal data packet
                => 01, Absolute coordinates packet
                => 10, Notify packet
        Bit5 => Coordinate mode(always 0 in SFAC mode):
                0: single-finger absolute coordinates (SFAC) mode
                1: multi-finger, multiple coordinates (MFMC) mode
        Bit4 => 0: The LEFT button is generated by on-pad command (OPC)
                1: The LEFT button is generated by external button
                Default is 1 even if the LEFT button is not pressed.
        Bit3 => Always 1, as specified by PS/2 protocol.
        Bit2 => Middle Button, 1 is pressed, 0 is not pressed.
        Bit1 => Right Button, 1 is pressed, 0 is not pressed.
        Bit0 => Left Button, 1 is pressed, 0 is not pressed.
Byte 2: X coordinate (xpos[9:2])
Byte 3: Y coordinate (ypos[9:2])
Byte 4: Bit1~Bit0 => Y coordinate (xpos[1:0])
        Bit3~Bit2 => X coordinate (ypos[1:0])
        Bit4 => 4th mouse button(forward one page)
        Bit5 => 5th mouse button(backward one page)
        Bit6 => scroll left button
        Bit7 => scroll right button

Multi Finger, Multiple Coordinates Mode (MFMC):
Bit 7 6 5 4 3 2 1 0       7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0
BYTE  |---------------|BYTE |---------------|BYTE|---------------|BYTE|---------------|
  1   |0|1|1|P|1|F|R|L|  2  |X|X|X|X|X|X|X|X|  3 |Y|Y|Y|Y|Y|Y|Y|Y|  4 |r|l|B|F|X|X|Y|Y|
      |---------------|     |---------------|    |---------------|    |---------------|

Byte 1: Bit7~Bit6 => 00, Normal data packet
                => 01, Absolute coordination packet
                => 10, Notify packet
        Bit5 => Coordinate mode (always 1 in MFMC mode):
                0: single-finger absolute coordinates (SFAC) mode
                1: multi-finger, multiple coordinates (MFMC) mode
        Bit4 => 0: The LEFT button is generated by on-pad command (OPC)
                1: The LEFT button is generated by external button
                Default is 1 even if the LEFT button is not pressed.
        Bit3 => Always 1, as specified by PS/2 protocol.
        Bit2 => Finger index, 0 is the first finger, 1 is the second finger.
                If bit 1 and 0 are all 1 and bit 4 is 0, the middle external
                button is pressed.
        Bit1 => Right Button, 1 is pressed, 0 is not pressed.
        Bit0 => Left Button, 1 is pressed, 0 is not pressed.
Byte 2: X coordinate (xpos[9:2])
Byte 3: Y coordinate (ypos[9:2])
Byte 4: Bit1~Bit0 => Y coordinate (xpos[1:0])
        Bit3~Bit2 => X coordinate (ypos[1:0])
        Bit4 => 4th mouse button(forward one page)
        Bit5 => 5th mouse button(backward one page)
        Bit6 => scroll left button
        Bit7 => scroll right button

当两个手指中的一个抬起时，设备将输出四个连续的 MFMC#0 报告数据包，其 X 和 Y 为零，表示第一个手指抬起，或输出四个连续的 MFMC#1 报告数据包，其 X 和 Y 为零，表示第二个手指抬起。另一方面，如果两个手指都抬起，设备将输出四个连续的单指绝对坐标 (SFAC) 数据包，其 X 和 Y 为零。

STL3888-Cx/Dx 的通知数据包

Bit 7 6 5 4 3 2 1 0       7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0
BYTE  |---------------|BYTE |---------------|BYTE|---------------|BYTE|---------------|
  1   |1|0|0|P|1|M|R|L|  2  |C|C|C|C|C|C|C|C|  3 |0|0|F|F|0|0|0|i|  4 |r|l|u|d|0|0|0|0|
      |---------------|     |---------------|    |---------------|    |---------------|

Byte 1: Bit7~Bit6 => 00, Normal data packet
                => 01, Absolute coordinates packet
                => 10, Notify packet
        Bit5 => Always 0
        Bit4 => 0: The LEFT button is generated by on-pad command(OPC)
                1: The LEFT button is generated by external button
                Default is 1 even if the LEFT button is not pressed.
        Bit3 => 1
        Bit2 => Middle Button, 1 is pressed, 0 is not pressed.
        Bit1 => Right Button, 1 is pressed, 0 is not pressed.
        Bit0 => Left Button, 1 is pressed, 0 is not pressed.
Byte 2: Message type:
        0xba => gesture information
        0xc0 => one finger hold-rotating gesture
Byte 3: The first parameter for the received message:
        0xba => gesture ID (refer to the 'Gesture ID' section)
        0xc0 => region ID
Byte 4: The second parameter for the received message:
        0xba => N/A
        0xc0 => finger up/down information

多指、多坐标模式的采样序列

通知数据包（有效位 == 1），MFMC 数据包 1（字节 1，位 2 == 0），MFMC 数据包 2（字节 1，位 2 == 1），MFMC 数据包 1，MFMC 数据包 2，...，通知数据包（有效位 == 0）

也就是说，当设备处于 MFMC 模式时，主机将接收每个手指的交错的绝对坐标数据包。

15.6. FSP 启用/禁用数据包

Bit 7 6 5 4 3 2 1 0       7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0      7 6 5 4 3 2 1 0
BYTE  |---------------|BYTE |---------------|BYTE|---------------|BYTE|---------------|
  1   |Y|X|0|0|1|M|R|L|  2  |0|1|0|1|1|0|1|E|  3 | | | | | | | | |  4 | | | | | | | | |
      |---------------|     |---------------|    |---------------|    |---------------|

FSP will send out enable/disable packet when FSP receive PS/2 enable/disable
command. Host will receive the packet which Middle, Right, Left button will
be set. The packet only use byte 0 and byte 1 as a pattern of original packet.
Ignore the other bytes of the packet.

Byte 1: Bit7 => 0, Y overflow
        Bit6 => 0, X overflow
        Bit5 => 0, Y sign bit
        Bit4 => 0, X sign bit
        Bit3 => 1
        Bit2 => 1, Middle Button
        Bit1 => 1, Right Button
        Bit0 => 1, Left Button
Byte 2: Bit7~1 => (0101101b)
        Bit0 => 1 = Enable
                0 = Disable
Byte 3: Don't care
Byte 4: Don't care (MOUSE ID 3, 4)
Byte 5~8: Don't care (Absolute packet)

15.7. PS/2 命令集

FSP 支持基本的 PS/2 命令集和模式，有关 PS/2 命令的详细信息，请参考以下 URL

http://www.computer-engineering.org/ps2mouse/

15.8. 确定数据包解析流程的编程顺序

1. 通过读取设备 ID (0x00) 和版本 (0x01) 寄存器来识别 FSP

2. 对于 FSP 版本 < STL3888 Cx，通过读取“测试模式状态” (0x20) 寄存器来确定按钮数量

   buttons = reg[0x20] & 0x30
   
   if buttons == 0x30 or buttons == 0x20:
           # two/four buttons
           Refer to 'Finger Sensing Pad PS/2 Mouse Intellimouse'
           section A for packet parsing detail(ignore byte 4, bit ~ 7)
   elif buttons == 0x10:
           # 6 buttons
           Refer to 'Finger Sensing Pad PS/2 Mouse Intellimouse'
           section B for packet parsing detail
   elif buttons == 0x00:
           # 6 buttons
           Refer to 'Finger Sensing Pad PS/2 Mouse Intellimouse'
           section A for packet parsing detail
   

3. 对于 FSP 版本 >= STL3888 Cx

   有关数据包解析的详细信息，请参阅“手指感应板 PS/2 鼠标 Intellimouse”部分 A（忽略字节 4，位 ~ 7）

15.9. 寄存器读取/写入的编程顺序

寄存器反转要求

以下值在发送到 FSP 之前需要反转（C 中的“~”运算符）

0xe8, 0xe9, 0xee, 0xf2, 0xf3 and 0xff.

寄存器交换要求

以下值在发送到 FSP 之前需要将其高 4 位和低 4 位交换

10, 20, 40, 60, 80, 100 and 200.

寄存器读取顺序

1. 向 FSP 发送 0xf3 PS/2 命令；

2. 向 FSP 发送 0x66 PS/2 命令；

3. 向 FSP 发送 0x88 PS/2 命令；

4. 向 FSP 发送 0xf3 PS/2 命令；

5. 如果要读取的寄存器地址不需要反转（请参阅“寄存器反转要求”部分），请转到步骤 6

1. 向 FSP 发送 0x68 PS/2 命令；

2. 向 FSP 发送反转的寄存器地址，然后转到步骤 8；

6. 如果要读取的寄存器地址不需要交换（请参阅“寄存器交换要求”部分），请转到步骤 7

1. 向 FSP 发送 0xcc PS/2 命令；

2. 向 FSP 发送交换后的寄存器地址，然后转到步骤 8；

7. 向 FSP 发送 0x66 PS/2 命令；

1. 向 FSP 发送原始寄存器地址，然后转到步骤 8；

8. 向 FSP 发送 0xe9（状态请求）PS/2 命令；

9. 从 FSP 读取的响应的第 4 个字节应该是请求的寄存器值（?? 表示不关心的字节）

host: 0xe9
3888: 0xfa (??) (??) (val)

• 请注意，自 Cx 版本发布以来，硬件将在状态请求结果的第 3 个字节处返回寄存器值的 1 的补码

  host: 0xe9
  3888: 0xfa (??) (~val) (val)
  

寄存器写入顺序

1. 向 FSP 发送 0xf3 PS/2 命令；

2. 如果要写入的寄存器地址不需要反转（请参阅“寄存器反转要求”部分），请转到步骤 3

1. 向 FSP 发送 0x74 PS/2 命令；

2. 向 FSP 发送反转的寄存器地址，然后转到步骤 5；

3. 如果要写入的寄存器地址不需要交换（请参阅“寄存器交换要求”部分），请转到步骤 4

1. 向 FSP 发送 0x77 PS/2 命令；

2. 向 FSP 发送交换后的寄存器地址，然后转到步骤 5；

4. 向 FSP 发送 0x55 PS/2 命令；

1. 向 FSP 发送寄存器地址，然后转到步骤 5；

5. 向 FSP 发送 0xf3 PS/2 命令；

6. 如果要写入的寄存器值不需要反转（请参阅“寄存器反转要求”部分），请转到步骤 7

1. 向 FSP 发送 0x47 PS/2 命令；

2. 向 FSP 发送反转的寄存器值，然后转到步骤 9；

7. 如果要写入的寄存器值不需要交换（请参阅“寄存器交换要求”部分），请转到步骤 8

1. 向 FSP 发送 0x44 PS/2 命令；

2. 向 FSP 发送交换后的寄存器值，然后转到步骤 9；

8. 向 FSP 发送 0x33 PS/2 命令；

1. 向 FSP 发送寄存器值；

9. 寄存器写入顺序完成。

• 自 Cx 版本发布以来，硬件将在状态请求结果的第 3 个字节处返回寄存器值的 1 的补码。主机可以选择在寄存器写入结束时向 FSP 发送另一个 0xe9（状态请求）PS/2 命令，以验证寄存器写入操作是否成功（?? 表示不关心的字节）

  host: 0xe9
  3888: 0xfa (??) (~val) (val)
  

15.10. 页寄存器读取/写入的编程顺序

为了克服支持的最大寄存器数量的限制，硬件将寄存器分为不同的组，称为“页”。每个页能够包含多达 255 个寄存器。

上电后的默认页为 0x82；因此，如果要访问寄存器 0x8301，则必须使用以下顺序切换到页 0x83，然后使用上一节中描述的寄存器读取/写入顺序开始从偏移量 0x01 读取/写入。

页寄存器读取顺序

1. 向 FSP 发送 0xf3 PS/2 命令；

2. 向 FSP 发送 0x66 PS/2 命令；

3. 向 FSP 发送 0x88 PS/2 命令；

4. 向 FSP 发送 0xf3 PS/2 命令；

5. 向 FSP 发送 0x83 PS/2 命令；

6. 向 FSP 发送 0x88 PS/2 命令；

7. 向 FSP 发送 0xe9（状态请求）PS/2 命令；

8. 从 FSP 读取的响应应该是请求的页值。

页寄存器写入顺序

1. 向 FSP 发送 0xf3 PS/2 命令；

2. 向 FSP 发送 0x38 PS/2 命令；

3. 向 FSP 发送 0x88 PS/2 命令；

4. 向 FSP 发送 0xf3 PS/2 命令；

5. 如果要写入的页地址不需要反转（请参阅“寄存器反转要求”部分），请转到步骤 6

1. 向 FSP 发送 0x47 PS/2 命令；

2. 向 FSP 发送反转的页地址，然后转到步骤 9；

6. 如果要写入的页地址不需要交换（请参阅“寄存器交换要求”部分），请转到步骤 7

1. 向 FSP 发送 0x44 PS/2 命令；

2. 向 FSP 发送交换后的页地址，然后转到步骤 9；

7. 向 FSP 发送 0x33 PS/2 命令；

8. 向 FSP 发送页地址；

9. 页寄存器写入顺序完成。

15.11. 手势 ID

与其他将多个手指的坐标发送到主机的设备不同，FSP 在内部处理多个手指的坐标，并将它们转换为 8 位整数，即“手势 ID”。以下是支持的手势 ID 列表

ID	描述
0x86	2 个手指向上伸直
0x82	2 个手指向下伸直
0x80	2 个手指伸直向右
0x84	2 个手指伸直向左
0x8f	2 个手指放大
0x8b	2 个手指缩小
0xc0	2 个手指曲线，逆时针
0xc4	2 个手指曲线，顺时针
0x2e	3 个手指向上伸直
0x2a	3 个手指向下伸直
0x28	3 个手指伸直向右
0x2c	3 个手指伸直向左
0x38	手掌

15.12. 寄存器列表

寄存器以 16 位值表示。高 8 位表示页地址，低 8 位表示该特定页内的相对偏移量。有关如何更改当前页地址的说明，请参阅“页寄存器读取/写入的编程顺序”部分

offset width           default r/w     name
0x8200 bit7~bit0       0x01    RO      device ID

0x8201 bit7~bit0               RW      version ID
                                       0xc1: STL3888 Ax
                                       0xd0 ~ 0xd2: STL3888 Bx
                                       0xe0 ~ 0xe1: STL3888 Cx
                                       0xe2 ~ 0xe3: STL3888 Dx

0x8202 bit7~bit0       0x01    RO      vendor ID

0x8203 bit7~bit0       0x01    RO      product ID

0x8204 bit3~bit0       0x01    RW      revision ID

0x820b                                 test mode status 1
       bit3            1       RO      0: rotate 180 degree
                                       1: no rotation
                                       *only supported by H/W prior to Cx

0x820f                                 register file page control
       bit2            0       RW      1: rotate 180 degree
                                       0: no rotation
                                       *supported since Cx

       bit0            0       RW      1 to enable page 1 register files
                                       *only supported by H/W prior to Cx

0x8210                         RW      system control 1
       bit0            1       RW      Reserved, must be 1
       bit1            0       RW      Reserved, must be 0
       bit4            0       RW      Reserved, must be 0
       bit5            1       RW      register clock gating enable
                                       0: read only, 1: read/write enable
       (Note that following registers does not require clock gating being
       enabled prior to write: 05 06 07 08 09 0c 0f 10 11 12 16 17 18 23 2e
       40 41 42 43.  In addition to that, this bit must be 1 when gesture
       mode is enabled)

0x8220                                 test mode status
       bit5~bit4               RO      number of buttons
                                       11 => 2, lbtn/rbtn
                                       10 => 4, lbtn/rbtn/scru/scrd
                                       01 => 6, lbtn/rbtn/scru/scrd/scrl/scrr
                                       00 => 6, lbtn/rbtn/scru/scrd/fbtn/bbtn
                                       *only supported by H/W prior to Cx

0x8231                         RW      on-pad command detection
       bit7            0       RW      on-pad command left button down tag
                                       enable
                                       0: disable, 1: enable
                                       *only supported by H/W prior to Cx

0x8234                         RW      on-pad command control 5
       bit4~bit0       0x05    RW      XLO in 0s/4/1, so 03h = 0010.1b = 2.5
       (Note that position unit is in 0.5 scanline)
                                       *only supported by H/W prior to Cx

       bit7            0       RW      on-pad tap zone enable
                                       0: disable, 1: enable
                                       *only supported by H/W prior to Cx

0x8235                         RW      on-pad command control 6
       bit4~bit0       0x1d    RW      XHI in 0s/4/1, so 19h = 1100.1b = 12.5
       (Note that position unit is in 0.5 scanline)
                                       *only supported by H/W prior to Cx

0x8236                         RW      on-pad command control 7
       bit4~bit0       0x04    RW      YLO in 0s/4/1, so 03h = 0010.1b = 2.5
       (Note that position unit is in 0.5 scanline)
                                       *only supported by H/W prior to Cx

0x8237                         RW      on-pad command control 8
       bit4~bit0       0x13    RW      YHI in 0s/4/1, so 11h = 1000.1b = 8.5
       (Note that position unit is in 0.5 scanline)
                                       *only supported by H/W prior to Cx

0x8240                         RW      system control 5
       bit1            0       RW      FSP Intellimouse mode enable
                                       0: disable, 1: enable
                                       *only supported by H/W prior to Cx

       bit2            0       RW      movement + abs. coordinate mode enable
                                       0: disable, 1: enable
       (Note that this function has the functionality of bit 1 even when
       bit 1 is not set. However, the format is different from that of bit 1.
       In addition, when bit 1 and bit 2 are set at the same time, bit 2 will
       override bit 1.)
                                       *only supported by H/W prior to Cx

       bit3            0       RW      abs. coordinate only mode enable
                                       0: disable, 1: enable
       (Note that this function has the functionality of bit 1 even when
       bit 1 is not set. However, the format is different from that of bit 1.
       In addition, when bit 1, bit 2 and bit 3 are set at the same time,
       bit 3 will override bit 1 and 2.)
                                       *only supported by H/W prior to Cx

       bit5            0       RW      auto switch enable
                                       0: disable, 1: enable
                                       *only supported by H/W prior to Cx

       bit6            0       RW      G0 abs. + notify packet format enable
                                       0: disable, 1: enable
       (Note that the absolute/relative coordinate output still depends on
       bit 2 and 3.  That is, if any of those bit is 1, host will receive
       absolute coordinates; otherwise, host only receives packets with
       relative coordinate.)
                                       *only supported by H/W prior to Cx

       bit7            0       RW      EN_PS2_F2: PS/2 gesture mode 2nd
                                       finger packet enable
                                       0: disable, 1: enable
                                       *only supported by H/W prior to Cx

0x8243                         RW      on-pad control
       bit0            0       RW      on-pad control enable
                                       0: disable, 1: enable
       (Note that if this bit is cleared, bit 3/5 will be ineffective)
                                       *only supported by H/W prior to Cx

       bit3            0       RW      on-pad fix vertical scrolling enable
                                       0: disable, 1: enable
                                       *only supported by H/W prior to Cx

       bit5            0       RW      on-pad fix horizontal scrolling enable
                                       0: disable, 1: enable
                                       *only supported by H/W prior to Cx

0x8290                         RW      software control register 1
       bit0            0       RW      absolute coordination mode
                                       0: disable, 1: enable
                                       *supported since Cx

       bit1            0       RW      gesture ID output
                                       0: disable, 1: enable
                                       *supported since Cx

       bit2            0       RW      two fingers' coordinates output
                                       0: disable, 1: enable
                                       *supported since Cx

       bit3            0       RW      finger up one packet output
                                       0: disable, 1: enable
                                       *supported since Cx

       bit4            0       RW      absolute coordination continuous mode
                                       0: disable, 1: enable
                                       *supported since Cx

       bit6~bit5       00      RW      gesture group selection
                                       00: basic
                                       01: suite
                                       10: suite pro
                                       11: advanced
                                       *supported since Cx

       bit7            0       RW      Bx packet output compatible mode
                                       0: disable, 1: enable
                                       *supported since Cx
                                       *supported since Cx


0x833d                         RW      on-pad command control 1
       bit7            1       RW      on-pad command detection enable
                                       0: disable, 1: enable
                                       *supported since Cx

0x833e                         RW      on-pad command detection
       bit7            0       RW      on-pad command left button down tag
                                       enable. Works only in H/W based PS/2
                                       data packet mode.
                                       0: disable, 1: enable
                                       *supported since Cx