Moves the cursor on a connected computer. The motion onscreen is always relative to the cursor’s current location. Before using Mouse.move(), you must call Mouse.begin().

WARNING: When you use the Mouse.move() command, the 86Duino takes over your mouse! Make sure you have control before you use the command. A pushbutton to toggle the mouse control state is effective.


Mouse.move(xVal, yPos, wheel);


  • xVal: amount to move along the x-axis – signed char
  • yVal: amount to move along the y-axis – signed char
  • wheel: amount to move scroll wheel – signed char




const int xAxis = A1;         //analog sensor for X axis  
const int yAxis = A2;         // analog sensor for Y axis
int range = 12;               // output range of X or Y movement
int responseDelay = 2;        // response delay of the mouse, in ms
int threshold = range/4;      // resting threshold
int center = range/2;         // resting position value
int minima[] = {1023, 1023};  // actual analogRead minima for {x, y}
int maxima[] = {0,0};         // actual analogRead maxima for {x, y}
int axis[] = {xAxis, yAxis};  // pin numbers for {x, y}
int mouseReading[2];          // final mouse readings for {x, y}
void setup() {
void loop() {
// read and scale the two axes:
  int xReading = readAxis(0);
  int yReading = readAxis(1);
// move the mouse:
  Mouse.move(xReading, yReading, 0);
  reads an axis (0 or 1 for x or y) and scales the 
  analog input range to a range from 0 to <range>
int readAxis(int axisNumber) {
  int distance = 0;    // distance from center of the output range
  // read the analog input:
  int reading = analogRead(axis[axisNumber]);
  // of the current reading exceeds the max or min for this axis,
  // reset the max or min:
  if (reading < minima[axisNumber]) {
    minima[axisNumber] = reading;
  if (reading > maxima[axisNumber]) {
    maxima[axisNumber] = reading;
  // map the reading from the analog input range to the output range:
  reading = map(reading, minima[axisNumber], maxima[axisNumber], 0, range);
  // if the output reading is outside from the
  // rest position threshold,  use it:
  if (abs(reading - center) > threshold) {
    distance = (reading - center);
  // the Y axis needs to be inverted in order to 
  // map the movemment correctly:
  if (axisNumber == 1) {
    distance = -distance;
  // return the distance for this axis:
  return distance;

See also

Language Reference Home

The text of the 86Duino reference is a modification of the Arduino reference and is licensed under a Creative Commons Attribution-ShareAlike 3.0 License. Code samples in the reference are released into the public domain.

Leave a Comment

Scroll to Top