https://github.com/unic8s/hd2_macropad

A very flexible and easy-to-use macropad for HELLDIVERS™ 2
https://github.com/unic8s/hd2_macropad

ble-hid capacitive-touch esp-idf-framework esp32-idf esp32-s3 helldivers2 i2s-audio lvgl-esp32 macropad platformio squareline vscode

Last synced: 2 months ago
JSON representation

A very flexible and easy-to-use macropad for HELLDIVERS™ 2

• Host: GitHub
• URL: https://github.com/unic8s/hd2_macropad
• Owner: unic8s
• License: other
• Created: 2024-11-07T19:12:14.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2025-04-07T17:12:25.000Z (2 months ago)
• Last Synced: 2025-04-10T01:04:20.027Z (2 months ago)
• Topics: ble-hid, capacitive-touch, esp-idf-framework, esp32-idf, esp32-s3, helldivers2, i2s-audio, lvgl-esp32, macropad, platformio, squareline, vscode
• Language: C
• Homepage:
• Size: 34.4 MB
• Stars: 10
• Watchers: 1
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE.md
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md

Awesome Lists containing this project

README

        
# HD2 Macropad

![The device including the 3D printed frame](screens/device.jpg)

[Video preview](https://www.youtube.com/watch?v=zbW8vrxIuko) on YouTube.

A very flexible and easy-to-use macropad for HELLDIVERS™ 2 for live configuration on each drop into combat with individual loadouts.

> [!NOTE]

> **The software requires this specific device [JC3248W535](https://s.click.aliexpress.com/e/_DneMCLR)**

Get the game on [PC](https://store.steampowered.com/app/553850/HELLDIVERS_2/) or [PS5™](https://www.playstation.com/games/helldivers-2/)

Based on an affordable IoT platform device with a capacitive touchscreen it's very handy for a PC or PS5™ since it's connected via Bluetooth or USB as a keyboard input device.

> HELLDIVERS and PS5 are registered trademarks of SONY INTERACTIVE ENTERTAINMENT LLC.

## Instructions

> [!TIP]  

> For instructions to get your own device and installation - please visit the [Wiki](https://github.com/unic8s/hd2_macropad/wiki)

> There you will also find lots of details and how to configure and use the device.

> [!IMPORTANT]  

> The device is only able to connect to the PS5™ via USB.

> It's not able to connect to the PS5™ via Bluetooth directly.

> We're currently working on the [BT2USB bridge](https://github.com/unic8s/bt2usb_bridge) which plugs into the USB port of a PS5™ directly and connects to the HD2 Macropad via Bluetooth.

## Support

We're pleased with your feedback so far and we try to keep up with your good ideas for new features. Thanks to all of you participating on our journey.

If you enjoy the project and want to support our private work feel free to make a small donation.

[](https://www.buymeacoffee.com/unic8)

## Screenshots

### Intro

![](squareline/assets/intro.png)

### Setup

![](screens/setup_weapons.png)

![](screens/setup_equipment.png)

![](screens/setup_stationary.png)

![](screens/setup_strike.png)

![](screens/setup_eagle.png)

### Config

![](screens/config_display.png)

![](screens/config_audio.png)

![](screens/config_input.png)

### Game (example configuration)

![](screens/game.png)

## Credits and special thanks

- [Icon Set](https://github.com/nvigneux/Helldivers-2-Stratagems-icons-svg) from [@nvigneux](https://github.com/nvigneux)

- [Demo project](https://github.com/NorthernMan54/JC3248W535EN) from [@NorthernMan54](https://github.com/NorthernMan54)

## Disclaimer and copyright

> This is a private opensource project and is not associated in any kind with SONY INTERACTIVE ENTERTAINMENT LLC.

> SONY INTERACTIVE ENTERTAINMENT LLC is not responsible for any function and content that is related to this project.

> Related assets in this project are either produced by us and free to use for non-commercial usage or respectively published by the owners mentioned here.