@facchinm and/or @agdl , please add these improvements to Mouse library :

1. Fix the broken link to Mouse library reference in README.adoc file :
   http://www.arduino.cc/en/Reference/Mouse.
   I suggest to replace the previous broken link with this one :
   https://www.arduino.cc/en/Reference/MouseKeyboard
2. Fix the name of the library in keywords.txt file :
   # Syntax Coloring Map For Keyboard -> # Syntax Coloring Map For Mouse

Best regards.

This library has no examples included, but-
https://www.arduino.cc/reference/en/language/functions/usb/mouse/
already has three basic example:

• KeyboardAndMouseControl
• ButtonMouseControl
• JoystickMouseControl

Should I just migrate them here and create a pull request or what should be done?

Hi there,

long time ago I've wrote a small program to emulate a mouse button click for clicker games. This was done for a Teensy 2.0 using the Arduino IDE - see here for more details.

Now I've got a new computer and tried to get this program compiling again. I'm using Platform IO in VS Code as extension. An empty default program without any logic compiles well. When I add the mouse library, the compile fails because the header file HID.h used in Mouse.h is not found.

So I tried this also in the Arduino IDE - same happens there, the header file HID.h is missing.

Seems that there is something missing, but I cannot remember on what this lib depends. Same also for Keyboard, there is also HID.h used. Also can't find any hint on the pages of Arduino for keyboard or mouse.

What have i missed?

Currently the library does not include any bundled example sketches.

Due to the library's origin as part of the core, the examples were instead included in the "built-in" examples bundled with Arduino IDE:

https://github.com/arduino/arduino-examples/tree/main/examples/09.USB

This poses two problems:

• Users are accustomed to finding library examples via the File > Examples > <library name> menu path in the IDE
• The "built-in" examples are not be available for users of other development tools which provide the Mouse library (e.g., Arduino CLI, PlatformIO)

Hi.
I'm doing a mouse on arduino and I ran into a problem:
How to use 16-bit data for XY axes? The fact is that the 8-bit data type is not enough for the optical sensor and when I put large DPI values then the mouse cursor makes a jerk. This happens when the value on the axis exceeds 127 and the cursor goes to 0.

How much I understood it is necessary to modify file Mouse.cpp.

Add a way to read the OS's set mouse sensitivity so the sensitivity of mice using this library can be set from the OS.

See here for example code for windows using SystemParametersInfo(SPI_GETMOUSESPEED, 0, &mouseSpeed, 0);

Hello!

Have you considered adding a support for emulating horizontal scroll, or this is not needed for vast majority of this library's users?

It seems that this is possible to add such functionality in a painless way: https://arduino.stackexchange.com/questions/46055/can-the-mouse-library-scroll-horizontally

I had made a fork of this lib with the aforementioned adjustments (https://github.com/nikita-tomilov/HMouse), and it actually works as expected, but I had to rename the class because of conflict with another library. I will be more than happy to create a proper pull request to this repository (without such renaming), if there is any need in this.

Originally opened by @125401qwerty here.

@125401qwerty
Hi.
I'm doing a mouse on arduino and I ran into a problem:
How to use 16-bit data for XY axes? The fact is that the 8-bit data type is not enough for the optical sensor and when I put large DPI values then the mouse cursor makes a jerk. This happens when the value on the axis exceeds 127 (-127) and the cursor goes to 0.
Apparently it's in the file Mouse.cpp. It is necessary to change the descriptor.
In general, how to increase the limit on the XY axes in the -127 to +127, At least up to 255 -255 or -1024 +1024?
Maybe someone already solved this problem.

I found a simpler solution:

if (x > 126) {x = 127;}
if (x < -126) {x = -127;}
if (y > 126) {y = 127;}
if (y < -126) {y = -127;}
Mouse.move(x, y, 0);

@PaulStoffregen
I believe this issue should be moved to the Mouse library repository.

https://github.com/arduino-libraries/Mouse

As I understand this, the issue seems to be a misunderstanding about integer truncation. It's pretty easy to see how this sort of misunderstanding could happen by looking at the Mouse.move() documentation.

https://www.arduino.cc/reference/en/language/functions/usb/mouse/mousemove/

While it does say "Allowed data types: signed char", nowhere on that page is the actual numerical range explained to be -128 to +127. Neither does this page link to any other reference that explains the significance of what "Allowed data types: signed char" really means.

Even if the page did explain that, the HID report descriptor says the numerical range is -127 to +127. Using -128 should not be allowed.

The Mouse.move() reference does have an example program, but the example is overly complicated and pretty far from the simple novice-friendly style Arduino normally uses for examples. It also limits the range to only 12, without any explanation I can see.

At the very least, the reference page should be updated to explicitly state the allowed numerical range is -127 to +127.

A better, much more Arduino-style approach might change Mouse.move() to take int inputs instead of signed char, and explicitly clamp the range to -127 to +127. Then if a user unwittingly tries to call Mouse.move() with values outside the legal -127 to +127 range, they would be nicely limited to the maximum rather than giving the confusing result of the compiler passing only the low 8 bits.