ESP32 MacroPad & HID Keyboard

// ================================================
// ESP32 BLE MacroPad — HID Keyboard
// Board : ESP32 / ESP32-S3 / ESP32-C3
// Library: ESP32-BLE-Keyboard by T-vK
// ================================================

#include <BleKeyboard.h>

// Name visible in Bluetooth settings, manufacturer, battery level
BleKeyboard bleKeyboard("MacroPad ESP32", "DIY", 100);

// ================================================
// CUSTOMIZE — Edit your credentials and snippet
// ================================================
const char* LOGIN_USERNAME = "your_username";
const char* LOGIN_PASSWORD = "your_password";
const char* CUSTOM_SNIPPET = "Hello! This is my custom snippet.";

// ---- Button GPIO pins ----
const int BTN_LOGIN = 12;
const int BTN_COPY = 14;
const int BTN_PASTE = 27;
const int BTN_SAVE = 26;
const int BTN_CUSTOM = 25;
const int BTN_LOCK = 33;
const int LED_PIN = 2;

const int NUM_BUTTONS = 6;
const int buttonPins[NUM_BUTTONS] = { 12, 14, 27, 26, 25, 33 };
unsigned long lastPressTime[NUM_BUTTONS] = { 0 };
const unsigned long DEBOUNCE_MS = 250;

// ================================================
// MACROS — Each function = one button action
// ================================================
void macroAutoLogin() {
bleKeyboard.print(LOGIN_USERNAME); // Type username
delay(150);
bleKeyboard.write(KEY_TAB); // Jump to password field
delay(150);
bleKeyboard.print(LOGIN_PASSWORD); // Type password
delay(150);
bleKeyboard.write(KEY_RETURN); // Submit / press Enter
}

void macroCopy() {
bleKeyboard.press(KEY_LEFT_CTRL);
bleKeyboard.press('c');
delay(50);
bleKeyboard.releaseAll();
}

void macroPaste() {
bleKeyboard.press(KEY_LEFT_CTRL);
bleKeyboard.press('v');
delay(50);
bleKeyboard.releaseAll();
}

void macroSave() {
bleKeyboard.press(KEY_LEFT_CTRL);
bleKeyboard.press('s');
delay(50);
bleKeyboard.releaseAll();
}

void macroCustom() {
bleKeyboard.print(CUSTOM_SNIPPET);
}

void macroLock() {
bleKeyboard.press(KEY_LEFT_GUI); // Windows key
bleKeyboard.press('l');
delay(50);
bleKeyboard.releaseAll();
}

// ================================================
// DEBOUNCE — Prevents multiple triggers per press
// ================================================
bool debounced(int index) {
unsigned long now = millis();
if (now - lastPressTime[index] > DEBOUNCE_MS) {
lastPressTime[index] = now;
return true;
}
return false;
}

void ledBlink(int times) {
for (int i = 0; i < times; i++) {
digitalWrite(LED_PIN, HIGH); delay(80);
digitalWrite(LED_PIN, LOW); delay(80);
}
}

void setup() {
Serial.begin(115200);
pinMode(LED_PIN, OUTPUT);
for (int i = 0; i < NUM_BUTTONS; i++)
pinMode(buttonPins[i], INPUT_PULLUP);
bleKeyboard.begin();
Serial.println("BLE MacroPad started — waiting for BT connection...");
}

void loop() {
// Slow blink while not connected via Bluetooth
if (!bleKeyboard.isConnected()) {
digitalWrite(LED_PIN, HIGH); delay(500);
digitalWrite(LED_PIN, LOW); delay(500);
return;
}
// Check each button — trigger macro if pressed
if (digitalRead(BTN_LOGIN) == LOW && debounced(0)) { ledBlink(1); macroAutoLogin(); }
if (digitalRead(BTN_COPY) == LOW && debounced(1)) { ledBlink(1); macroCopy(); }
if (digitalRead(BTN_PASTE) == LOW && debounced(2)) { ledBlink(1); macroPaste(); }
if (digitalRead(BTN_SAVE) == LOW && debounced(3)) { ledBlink(1); macroSave(); }
if (digitalRead(BTN_CUSTOM) == LOW && debounced(4)) { ledBlink(1); macroCustom(); }
if (digitalRead(BTN_LOCK) == LOW && debounced(5)) { ledBlink(1); macroLock(); }
delay(10);
}

// ================================================
// ESP32-S2 / S3 USB HID MacroPad
// Board : ESP32-S2 or ESP32-S3 DevKit
// Prereq : Tools → USB Mode → USB-OTG (TinyUSB)
// Library: None — uses built-in TinyUSB
// ================================================

#include "USB.h"
#include "USBHIDKeyboard.h"

USBHIDKeyboard Keyboard;

// ================================================
// CUSTOMIZE — Edit your credentials and snippet
// ================================================
const char* LOGIN_USERNAME = "your_username";
const char* LOGIN_PASSWORD = "your_password";
const char* CUSTOM_SNIPPET = "Hello! This is my custom snippet.";

// ---- Button GPIO pins ----
const int BTN_LOGIN = 12;
const int BTN_COPY = 14;
const int BTN_PASTE = 27;
const int BTN_SAVE = 26;
const int BTN_CUSTOM = 25;
const int BTN_LOCK = 33;
const int LED_PIN = 2;

const int NUM_BUTTONS = 6;
const int buttonPins[NUM_BUTTONS] = { 12, 14, 27, 26, 25, 33 };
unsigned long lastPressTime[NUM_BUTTONS] = { 0 };
const unsigned long DEBOUNCE_MS = 250;

// ================================================
// MACROS
// ================================================
void macroAutoLogin() {
Keyboard.print(LOGIN_USERNAME); // Type username
delay(150);
Keyboard.write(KEY_TAB); // Jump to password field
delay(150);
Keyboard.print(LOGIN_PASSWORD); // Type password
delay(150);
Keyboard.write(KEY_RETURN); // Submit / press Enter
}

void macroCopy() {
Keyboard.press(KEY_LEFT_CTRL);
Keyboard.press('c');
delay(50);
Keyboard.releaseAll();
}

void macroPaste() {
Keyboard.press(KEY_LEFT_CTRL);
Keyboard.press('v');
delay(50);
Keyboard.releaseAll();
}

void macroSave() {
Keyboard.press(KEY_LEFT_CTRL);
Keyboard.press('s');
delay(50);
Keyboard.releaseAll();
}

void macroCustom() {
Keyboard.print(CUSTOM_SNIPPET);
}

void macroLock() {
Keyboard.press(KEY_LEFT_GUI); // Windows key
Keyboard.press('l');
delay(50);
Keyboard.releaseAll();
}

// ---- Debounce ----
bool debounced(int index) {
unsigned long now = millis();
if (now - lastPressTime[index] > DEBOUNCE_MS) {
lastPressTime[index] = now;
return true;
}
return false;
}

void ledBlink(int times) {
for (int i = 0; i < times; i++) {
digitalWrite(LED_PIN, HIGH); delay(80);
digitalWrite(LED_PIN, LOW); delay(80);
}
}

void setup() {
Serial.begin(115200);
pinMode(LED_PIN, OUTPUT);
for (int i = 0; i < NUM_BUTTONS; i++)
pinMode(buttonPins[i], INPUT_PULLUP);
Keyboard.begin();
USB.begin();
delay(3000); // Give OS time to enumerate the USB HID device
ledBlink(3); // 3 blinks = device ready
Serial.println("USB HID MacroPad ready!");
}

void loop() {
if (digitalRead(BTN_LOGIN) == LOW && debounced(0)) { ledBlink(1); macroAutoLogin(); }
if (digitalRead(BTN_COPY) == LOW && debounced(1)) { ledBlink(1); macroCopy(); }
if (digitalRead(BTN_PASTE) == LOW && debounced(2)) { ledBlink(1); macroPaste(); }
if (digitalRead(BTN_SAVE) == LOW && debounced(3)) { ledBlink(1); macroSave(); }
if (digitalRead(BTN_CUSTOM) == LOW && debounced(4)) { ledBlink(1); macroCustom(); }
if (digitalRead(BTN_LOCK) == LOW && debounced(5)) { ledBlink(1); macroLock(); }
delay(10);
}