ESP32-S2 playing with the mouse

Last Updated on 15. October 2026 by Suffocation●Link status: OK

Ein Bekannter hat mir neulich sein Leid geklagt. Er sei jetzt im Home-Office und befürchte, dass sein Arbeitgeber seine Computer Daten trackt. Da der Computer nach wenigen Minuten in den Standby-Modus schaltet, kam er auf die Idee, immer wieder die Mouse zu bewegen, um dies zu verhindern. Seine Funkmouse reiche sogar bis zur Toilette, sagte er mir und richtete seinen Dank an die Hersteller solcher Mäuse.

Nun ist der Bekannte nicht nur ein guter, sondern auch ein Beamter und diese brauchen bekanntlich ihren Mittagsschlaf. Die Mouse an die Katze zu binden (sieht jemand die Ironie) oder sie auf einen Plattenspieler mitlaufen zu lassen, ist nicht ganz perfekt.

Abends, die Kinder ins Bett bringend, ließ ich in dieser Richtung meine Gedanken schweifen. Mir kam der ESP32-S2●Link status: OK ins Gedächtnis, der über die Möglichkeit verfügt, ein HID (Human Interface Device), also bspw. ne Mouse oder Tastatur, zu emulieren.

Somit war ein neues Projekt geboren – eine Mouse zu emulieren, die dann eingreift, wenn man gerade inaktiv ist. Natürlich wäre eine Softwareemulation auf dem Rechner auch denkbar, aber die meisten Firmenrechner sind gegen die Installation fremder Software abgesichert.

Facts

• Einfaches Anstecken der FAKE-Mouse an die USB Schnittstelle.
• Mouse greift ein, wenn länger als 3 Minuten keine Aktion erkannt wurde. War nicht möglich, keine Rückmeldung vom Computer
• Mouse hört auf, sobald der Benutzer wieder etwas macht. Same reason as above
• The mouse movements should be random in pace and time intervals.

Selected Hardware

LILYGO EP32 S2 V1.1●Link status: Unknown

Alternatives

LILYGO T8 ESP32-S2 Display V1.1●Link status: Unknown

Areas of application

• Funny mouse movements on the screen
• Liberation from the yoke of employers.
• Ausleben des Beamtentums (Eine Entschuldigung an Beamte, die für ihr Geld richtig arbeiten müssen)

Views

Photos are available at LILYGO EP32 S2 V1.1●Link status: Unknown.

Programming

Libraries

The two required libraries, USB.h and USBHIDMouse.h, are included in the ESP32 library from version 2.0 onwards.

Test programme

Demos are available in the example projects below.

Das Beispiel zur MouseButtonControl habe ich als Basis für meine Bestrebungen genutzt und mein eigenes erstellt:

Source code AutoMouseToKeepTheComputerAlive.ino (GitHub●Link status: OK)

/**
 * Small programm that moves the mouse to keep the computer in active mode.
 * Arduino ESP lib 2.0 higher can be used, no addtional libs needed.
 * 
 * Visit http://fambach.net if you want. 
 */
#include "USB.h"
#include "USBHIDMouse.h"
USBHIDMouse Mouse;

#define DELAY_MIN  5000
#define DELAY_MAX 60 * 1000 // 180 * one second = 1.5 minute 
#define DIST_X_MIN 10 // 10 pixel
#define DIST_X_MAX 200 // 10 pixel
#define DIST_Y_MIN 10 // 10 pixel
#define DIST_Y_MAX 180 // 10 pixel


int range = 5;              // output range of X or Y movement; affects movement speed
int responseDelay = 10;     // response delay of the mouse, in ms


void setup() {
  // initialize mouse control:
  Mouse.begin();
  USB.begin();
}

void loop() {

  int distX = random(DIST_X_MIN,DIST_X_MAX);
  int distY = random(DIST_Y_MIN,DIST_Y_MAX);

  // delay between 5 seconds and 3 minutes
  long responseDelay = random(DELAY_MIN, DELAY_MAX);
 
  Mouse.move(-distX, -distY, 0);

  // delay(2000);document out to see the mouse moving
  delay(100);
  // and go back
  Mouse.move(distX, distY, 0);
 
  // a delay so the mouse doesn't move too fast:
  delay(responseDelay);
}

Install the firmware and set the DIP switches to HID mode (OTG).

Problems

The mouse is not keeping the computer alive.

Possibly the time between movements is too short, so the computer still goes into standby mode.

Einfach den Wert für das Delay verlängern. Ruhig auch mal auf 2000 stellen, dann sieht man die Mouse springen.

Miscellaneous

Bewegungen der eigenen Mouse erfassen

Stefan (siehe Kommentare) schlägt vor, die Schaltung in die Mouse zu integrieren, zum einen könnte man die Mousebewegungen dann mittracken, zum anderen bräuchte es bei geschickter Verdrahtung noch nicht einmal OTG Fähigkeit.

Evtl. wäre auch ein durchgeschleifter USB Port etwas, ein Arduino Clone mit Hostshield. Die eigene Mouse an den Hostshield angeschlossen und die Daten der Mouse einfach weiter an den Rechner übertragen. Pausiert die Mouse, übernimmt der Arduino Clone.

Conclusion

Das Programm war schnell geschrieben und funktioniert, in den nächsten Tagen werde ich es dem Usertest übergeben.

Related Posts

• Espressif IDF – GPIOs●Link status: Unknown
• Espressif IDF – Tasks●Link status: Unknown
• Espressif IDF – Menuconfig●Link status: Unknown
• Espressif IDF – Timer●Link status: Unknown
• Espressif IDF – Lognachrichten●Link status: Unknown
• Espressif IDF – Fehlerbehandlung●Link status: Unknown
• Espressif IDF – Konsolenausgabe●Link status: Unknown
• Espressif IDF – Projekt erstellen●Link status: Unknown
• LILYGO EP32 S2 V1.1●Link status: Unknown
• VS-Code Espressif IDF●Link status: OK

Sources

https://github.com/espressif/arduino-esp32●Link status: OK (Lib zum Nachschlagen der USB und Mouse Bibliothek)

https://ericdraken.com/usb-mouse-jiggler/●Link status: OK (Er hat ein ähnliches Projekt mit einem anderen Board gemacht)

https://github.com/seife/marble_fx●Link status: OK

https://github.com/seife/marble_fx_digistump●Link status: OK