README.rst

Introduction

A library for a custom HID mouse device that sends absolute coordinates.

Dependencies

This driver depends on:

• Adafruit CircuitPython

Please ensure all dependencies are available on the CircuitPython filesystem. This is easily achieved by downloading the Adafruit library and driver bundle or individual libraries can be installed using circup.

Usage Example

Copy the content of examples/absolute_mouse_boot.py to your boot.py (create it if needed).

The simple test file contains an example that moves the mouse to different points.

Original version seen on Show and Tell on 20/04/2022 Check the video.

Installing to a Connected CircuitPython Device with Circup

Make sure that you have circup installed in your Python environment. Install it with the following command if necessary:

pip3 install circup

With circup installed and your CircuitPython device connected use the following command to install:

circup install absolute_mouse

Or the following command to update an existing version:

circup update

Contributing

Contributions are welcome! Please read our Code of Conduct before contributing to help this project stay welcoming.

Credit

• @dglaude for originally creating the abs_mouse module.
• @danh for all learn guide and the USB-HID code in the core of CircuitPython and in library.
• @bitboy85 for providing working code for mouse_abs: https://gist.github.com/bitboy85/cdcd0e7e04082db414b5f1d23ab09005
• @jfurcean John Furcean for the WiiChuck library: https://github.com/jfurcean/CircuitPython_WiiChuck