cirque-pinnacle 1.0.1

Supported Features

• Use SPI or I2C bus protocols to interface with the Pinnacle ASIC (Application Specific Integrated Circuit) touch controller.

• Relative mode data reporting (AKA Mouse mode) with optional tap detection.

• Absolute mode data reporting (x, y, & z axis positions).

• AnyMeas mode data reporting. This mode exposes the ADC (Analog to Digital Converter) values and is not well documented in the numerous datasheets provided by the Cirque corporation about the Pinnacle (1CA027), thus this is a rather experimental mode.

• Hardware input buttons’ states included in data reports. There are 3 button input lines on the Cirque circle trackpads – see Pinout section.

• Configure measurements for finger or stylus (or automatically determine either) touch events. The Cirque circle trackpads are natively capable of measuring only 1 touch point per event.

• Download/upload the underlying compensation matrix for ADC measurements.

• Adjust the ADC matrix gain (sensitivity).

Unsupported Features

• The legacy PS\2 interface is pretty limited. Therefore, it has been neglected in this library.

• Cirque’s circle trackpads ship with the newer non-AG (Advanced Gestures) variant of the Pinnacle touch controller ASIC. Thus, this library focuses on the the non-AG variant’s functionality via testing, and it does not provide access to the older AG variant’s features (register addresses slightly differ which breaks compatibility).

Model Labeling Scheme

TMyyyxxx-202i-cco

• yyyxxx stands for the respective vertical & horizontal width of the trackpad in millimeters.

• i stands for the hardwired interface protocol (3 = I2C, 4 = SPI). Notice, if there is a resistor populated at the R1 (470K ohm) junction (located just above the Pinnacle ASIC), it is configured for SPI, otherwise it is configured for I2C.

• cc stands for Custom Configuration which describes if a 470K ohm resistor is populated at junction R4. “30” (resistor at R4 exists) means that the hardware is configured to disable certain features despite what this library does. “00” (no resistor at R4) means that the hardware is configured to allow certain features to be manipulated by this library. These features include “secondary tap” (thought of as “right mouse button” in relative data mode), Intellimouse scrolling (Microsoft patented scroll wheel behavior – a throw back to when scroll wheels were first introduced), and 180 degree orientation (your application can invert the axis data anyway).

• o stands for the overlay type (0 = none, 1 = adhesive, 2 = flat, 3 = curved)

Sphinx documentation

Sphinx is used to build the documentation. First, install dependencies (Python 3 & Python’s pip is required):

pip3 install -r docs/requirements.txt

Now, run sphinx. The following command is executed from the repository’s root folder.

sphinx-build -E -W docs docs/_build/html

This will output the documentation to docs/_build/html. Open the index.html in your browser to view them. It will also (due to -W) error out on any warning. This is a good way to locally verify it will pass the CI workflow (and ReadTheDocs builds).