Skip to content

unic8s/hd2_macropad

Repository files navigation

HD2 Macropad

The device including the 3D printed frame

Video preview on YouTube.

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

Get the game on PC or PS5™

Important

The device is not able to connect to the PS5™ directly. We're currently working on the BT2USB bridge which plugs into the USB port of a PS5™ directly and connects to the HD2 Macropad via Bluetooth.

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 as a keyboard input device.

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

Prerequesites

  • The specific device JC3248W535
  • USB-C data cable to communicate with a PC for flashing the firmware once. After successful operation the device will connect only via Bluetooth.
  • Normal users
  • Pro users
  • Sound output (optional)
  • BT2USB bridge (for PS5™ support)

Installation

The firmware is already pre-built available in our release section. Just go ahead and download your prefered version (we surely recommend to use the lastest one). Please follow the described steps and make your decision if you'd like to add audio support with a SD card, the mandatory assets and a speaker attached to the device.

Firmware

  1. Download the lastest BIN file or your prefered release
  2. Connect device to PC via USB-C data cable
  3. Firmware upload...
  • Normal users
    • Visit the ESP Tool
    • Click the "Connect" button and select the correct device from the shown list
    • Change the "Flash Address" to 0x0
    • Select the BIN file and upload it to your device
  • Pro users
    • Use esptool to flash the BIN to your device

Sounds (optional)

  1. Unpack and copy all assets to a SD card into the root directory
  2. Connect a speaker to the rear JST port of the device. We use a slim speaker with the right connector.

Setup

In general there is no specific further configuration needed. You only have to pair the device with your PC and it's ready to use already. Please follow the specific steps for your prefered system.

PC

  1. Connect HD2 Macropad to a power source (either USB-C or battery)
  2. Pair a Bluetooth device in Windows

PS5

  1. Connect HD2 Macropad to a power source (either USB-C or battery)
  2. Connect BT2USB bridge into the PS5 USB port

3D printing

The case on the photo is 3D printed and fits perfectly to the JC3248W535. Instructions for printing and assembling go along with STL files on...

Stratagem selection

First startup

  1. After the intro screen all stratagems are displayed in groups (weapons, backpacks, stationary, strike and eagle)
  2. Select a stratagems by clicking on it. The yellow border will turn into a white one which indicates the selection.
  3. You have to pick your 4 specific stratagems from the groups.
  4. The label and the bar at the bottom of the screen shows the progress of your selection.
  • After 4 stratagems have been selected the screen switches from the setup to game mode.
  • If you want to switch to gaming mode with less than 4 stratagems select just click the "Play" button

In-game usage

  • The 4 upper stratagems are the basic items for all operation types (reinforce, resupply, SOS and rearm eagle).
  • The 4 lower stratagems are the ones you selected in the setup procedure.
  • Just click a strategem to activate the execution of the macro.
  • The Bluetooth icon in the lower right corner indicates the connection stats.
    • disconnected
    • connected

Change selection

  1. If you want to change your selection just click the "back" button at the bottom left corner.
  2. You screen will switch back from game to setup mode.
  3. Now you can either unselect the unwanted stratagems inside the groups or just click "reset" at the bottom right corner to unselect all selected stratagems from the list.
  4. As soon as you're finished just click the "Play" button or have selected 4 stratagems again and the screen will automatically switch from setup to game mode.

Device configuration

If you click on "Config" on the setup screen you will enter the device configuration with specific hard-/software features.

Menu

  • [Back] Switch back to setup mode
  • [Default] Resets ALL settings to the default values
  • [Reboot] Restarts the device

Display

  • [Brightness] Set the brighness level of your screen (10 - 100%)
  • [Flip 180°] Set the orientation of the screen from 0 to 180° flipped (Device need to be rebooted after changing this setting)

Audio

  • [Mute] En-/disable the sound output (Requires an external speaker to work)

Input

  • [Delay] Set the input delay of the Bluetooth keyboard (50 - 200ms). This has to be adjusted if there are issues with your Bluetooth receiver of the PC or PS5™.
  • [Test] Click this button to send a test input sequence "hello" to your receiving device PC or PS5™.

Hardware - for enthusiasts

The device features a fully-fledged ESP32 called JC3248W535 from the manufacturer Shenzhen Jingcai Inteligent Co., Ltd

  • CPU: Espressif ESP32-S3
  • ROM: 16MB
  • Display: 3.5" 480 x 320 IPS LCD with 65K Colors
  • Touch: Capacitive multitouch
  • Connectivity: WiFi + Bluetooth
  • Audio: Pre-amplified speaker output (mono) on 2-pin JST connector
  • Memory: TF Card slot
  • Power supply: USB-C (also data transfer)
  • Battery: 2-pin JST connector

There is no speaker included in the casing of the device. As a speaker you should ideally use a broandband driver with a small and slim casing.

Software - for developers

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.

Credits and special thanks

Screenshots

Intro

Setup

Config

Game (example configuration)