AirMouseS3
AirMouseS3 is an ESP32-S3 based gesture-controlled mouse that uses an onboard gyroscope and accelerometer to translate physical movement into cursor actions. Designed for the M5Stack StickS3, it utilizes the NimBLE library for Bluetooth HID connectivity and the M5Unified framework for hardware management.
About the AirMouseS3
The AirMouseS3 is an innovative peripheral project that transforms the M5Stack StickS3 into a motion-sensing computer mouse. By utilizing the device’s built-in gyroscope and accelerometer, it allows users to control their computer cursor through physical movement in the air, rather than on a flat surface.
This project is designed for versatility and can be connected to any device that supports Bluetooth HID, including PCs, tablets, and smartphones. It offers a compact and wireless solution for presentations or alternative input needs.
Flash and Setup
Deploying the AirMouseS3 firmware is straightforward using the M5Stack ecosystem. Users can find the project listed as «AirMouseS3» within the M5Burner tool to flash their StickS3 device. Once the firmware is installed and the device is powered on, it initializes the internal sensors and prepares for wireless communication.
To begin using the device, you simply need to connect to the Bluetooth hotspot advertised as “AirStick.” Once paired, the StickS3 acts as a standard input device, requiring no additional software on the host computer.
Controls and Navigation
The AirMouseS3 maps its physical buttons to essential mouse functions to ensure a seamless navigation experience:
- BUTTON A: Serves as the Left Mouse Button (LMB) for clicking and selecting items.
- BUTTON B: Acts as a movement freeze. This is a critical feature for recalibrating or “straightening” the stick. By holding this button, movement tracking is paused, allowing the user to reposition their hand without moving the cursor on the screen.
Technical Implementation
The project is built using the PlatformIO environment, targeting the ESP32-S3 DevKit board. It relies on the M5Unified library to interface with the StickS3’s hardware components and the NimBLE-Arduino library to manage efficient Bluetooth Low Energy (BLE) communications. The build process involves merging the bootloader, partition table, and application firmware into a single deployable binary using esptool.exe.
Related Projects
ESP32-S3 USB to BLE Keyboard Bridge
This project transforms standard USB keyboards into wireless Bluetooth Low Energy (BLE) devices using the ESP32-S3's native USB-OTG hardware. It features multi-device switching for up to three paired hosts and utilizes the NimBLE stack for low-latency HID report forwarding.
Gesture-Detecting Macro Keyboard
A Bluetooth-enabled macro keyboard featuring gesture recognition powered by TensorFlow Lite for Microcontrollers on an ESP32. It combines capacitive touch sensors, physical buttons, and an OLED display to provide customizable computer control via BLE HID and AutoHotkey integration.