## Joystick Mouse Control Using the Mouse library, you can controls a computer's onscreen cursor with an Arduino Leonardo, Micro, or Due. This particular example uses a pushbutton to turn on and off mouse control with a joystick. Cursor movement from the Arduino is always relative. So every time the analog input is read, the cursor's position is updated relative to it's current position. Two analog inputs ranging from 0 to 1023 are translated to ranges of -12 to 12\. The sketch assumes that the joystick resting values are around the middle of the range, but that they vary within a threshold. The pushbutton allows you to toggle mouse control on and off. As an option you may connect a status LED to pin 5 that lights upwhen the Arduino is controlling the mouse. A second pushbutton may be connected with another 10k ohm pulldown (to GND) resistor to D3 to act as the left click of the mouse. NB: When you use the Mouse.move() command, the Arduino takes over your computer's cursor! To insure you don't lose control of your computer while running a sketch with this function, make sure to set up a controller before you call Mouse.move(). This sketch includes a pushbutton to toggle the mouse control state, so you can turn on and off mouse control. ### Hardware Required * Arduino Leonardo, Micro, or Due board * 2 axis joystick * momentary pushbutton (possibly integrated in the joystick) * LED * 220 ohm resistor * 10k ohm resistor (if needed as pulldown) ### Circuit Connect your Leonardo board to your computer with a micro-USB cable. The pushbutton is connected to pin 6\. If you're using a part like the Joystick shield pictured below, you may not need a pulldown resistor. The x-axis on the joystick is connected to analog in 0, the y-axis is on analog in 1. [](https://www.arduino.cc/en/uploads/Tutorial/JoystickMouse_2_bb.png) image developed using [Fritzing](http://www.fritzing.org/). For more circuit examples, see the [Fritzing project page](http://fritzing.org/projects/) click the images to enlarge ### Schematic [](https://www.arduino.cc/en/uploads/Tutorial/joystickMouse_schem.png) click the images to enlarge ### Code /*   JoystickMouseControl   Controls the mouse from a joystick on an Arduino Leonardo, Micro or Due.   Uses a pushbutton to turn on and off mouse control, and a second pushbutton   to click the left mouse button.   Hardware:   - 2-axis joystick connected to pins A0 and A1   - pushbuttons connected to pin D2 and D3   The mouse movement is always relative. This sketch reads two analog inputs   that range from 0 to 1023 (or less on either end) and translates them into   ranges of -6 to 6.   The sketch assumes that the joystick resting values are around the middle of   the range, but that they vary within a threshold.   WARNING: When you use the Mouse.move() command, the Arduino takes over your   mouse! Make sure you have control before you use the command. This sketch   includes a pushbutton to toggle the mouse control state, so you can turn on   and off mouse control.   created 15 Sep 2011   updated 28 Mar 2012   by Tom Igoe   This example code is in the public domain.   http://www.arduino.cc/en/Tutorial/JoystickMouseControl */ #include "Mouse.h" // set pin numbers for switch, joystick axes, and LED: const int switchPin = 2;      // switch to turn on and off mouse control const int mouseButton = 3;    // input pin for the mouse pushButton const int xAxis = A0;         // joystick X axis const int yAxis = A1;         // joystick Y axis const int ledPin = 5;         // Mouse control LED // parameters for reading the joystick: int range = 12;               // output range of X or Y movement int responseDelay = 5;        // response delay of the mouse, in ms int threshold = range / 4;    // resting threshold int center = range / 2;       // resting position value boolean mouseIsActive = false;    // whether or not to control the mouse int lastSwitchState = LOW;        // previous switch state void setup() {   pinMode(switchPin, INPUT);       // the switch pin   pinMode(ledPin, OUTPUT);         // the LED pin   // take control of the mouse:   Mouse.begin(); } void loop() {   // read the switch:   int switchState = digitalRead(switchPin);   // if it's changed and it's high, toggle the mouse state:   if (switchState != lastSwitchState) {     if (switchState == HIGH) {       mouseIsActive = !mouseIsActive;       // turn on LED to indicate mouse state:       digitalWrite(ledPin, mouseIsActive);     }   }   // save switch state for next comparison:   lastSwitchState = switchState;   // read and scale the two axes:   int xReading = readAxis(A0);   int yReading = readAxis(A1);   // if the mouse control state is active, move the mouse:   if (mouseIsActive) {     Mouse.move(xReading, yReading, 0);   }   // read the mouse button and click or not click:   // if the mouse button is pressed:   if (digitalRead(mouseButton) == HIGH) {     // if the mouse is not pressed, press it:     if (!Mouse.isPressed(MOUSE_LEFT)) {       Mouse.press(MOUSE_LEFT);     }   }   // else the mouse button is not pressed:   else {     // if the mouse is pressed, release it:     if (Mouse.isPressed(MOUSE_LEFT)) {       Mouse.release(MOUSE_LEFT);     }   }   delay(responseDelay); } /*   reads an axis (0 or 1 for x or y) and scales the analog input range to a range   from 0 to */ int readAxis(int thisAxis) {   // read the analog input:   int reading = analogRead(thisAxis);   // map the reading from the analog input range to the output range:   reading = map(reading, 0, 1023, 0, range);   // if the output reading is outside from the rest position threshold, use it:   int distance = reading - center;   if (abs(distance)  threshold) {     distance = 0;   }   // return the distance for this axis:   return distance; } [[Get Code]](https://www.arduino.cc/en/Tutorial/JoystickMouseControl?action=sourceblock&num=1) ### See Also * [Mouse.click](https://www.arduino.cc/en/Reference/MouseClick)() * [Mouse.move](https://www.arduino.cc/en/Reference/MouseMove)() * [Mouse.press](https://www.arduino.cc/en/Reference/MousePress)() * [Mouse.release](https://www.arduino.cc/en/Reference/MouseRelease)() * [Mouse.isPressed](https://www.arduino.cc/en/Reference/MouseIsPressed)() * [KeyboardLogout](https://www.arduino.cc/en/Tutorial/KeyboardLogout) - Logs out the current user with key commands. * [KeyboardMessage](https://www.arduino.cc/en/Tutorial/KeyboardMessage) - Sends a text string when a button is pressed. * [KeyboardReprogram](https://www.arduino.cc/en/Tutorial/KeyboardReprogram) - Opens a new window in the Arduino IDE and reprograms the Leonardo with a simple blink program. * [KeyboardSerial](https://www.arduino.cc/en/Tutorial/KeyboardSerial) - Reads a byte from the serial port, and sends back a keystroke. * [KeyboardAndMouseControl](https://www.arduino.cc/en/Tutorial/KeyboardAndMouseControl) - Demonstrates the Mouse and Keyboard commands in one program. * [ButtonMouseControl](https://www.arduino.cc/en/Tutorial/ButtonMouseControl) - Control cursor movement with 5 pushbuttons.