FAQ & Troubleshooting
Here we will post common questions with their answers and troubleshooting solutions.
Last updated
Here we will post common questions with their answers and troubleshooting solutions.
Last updated
Please click this image below of the GRAM Slim SMASH Quick Start Guide to view a larger version and save it.
Follow these steps for a successful setup:
Step 1: Plug in the Wingman Adapter by itself into your console. Wait 5 seconds for it to activate.
Step 2: While holding the 'X' button on your GRAM Slim, connect the controller to the Wingman Adapter.
Reminder: Keep your GRAM Slim's firmware up to date for the best compatibility with the Brook Wingman Adapter.
To set up your GRAM Controller with the HayBox firmware, follow these steps:
Download Firmware:
Visit GRAMCtrl.com/dolphin to download the latest .ini file for the HayBox firmware.
Place the .ini File:
Copy the downloaded .ini file into %appdata%\Slippi Launcher\netplay\user\Config\Profiles\GCPad. Create the necessary directories if they do not exist.
Connect Your Controller:
Use a USB cable to connect your GRAM Controller to your PC.
Configure in Dolphin:
Open Dolphin, navigate to controller settings, and assign a port to “Standard Controller”. Then, enter the controller configuration menu.
Refresh Device List:
Refresh the Device Dropdown list to ensure your GRAM Controller is recognized.
Select HayBox Profile:
Find “HayBox” in the dropdown menu under Profiles and click the "Load" button to activate it. Always opt for "Load" over "Save" to prevent issues.
Complete Setup:
Click "Close" to finalize the setup. Your GRAM Controller is now equipped with HayBox firmware and ready for use.
Navigate to GRAMCtrl.com/dolphin to download the latest .ini file for the HayBox firmware.
Copy the .ini file and place it in %appdata%\Slippi Launcher\netplay\user\Config\Profiles\GCPad. If this path doesn't exist on your system, create the necessary directories.
Connect your GRAM Controller to your PC using a USB cable.
Open Dolphin and go to the controller settings. Assign a port to “Standard Controller” and enter the controller configuration menu.
Refresh the Device Dropdown list to ensure your controller is recognized.
Look for “HayBox” in the dropdown menu under Profiles.
Click the "Load" button to activate the profile. Remember, always choose "Load" instead of "Save" to avoid configuration issues.
Finalize the setup by clicking "Close". Your GRAM Controller is now ready for action.
For more information, please visit
How can I connect my GRAM controller to the Nintendo Switch? To connect your GRAM controller to the Nintendo Switch, follow these simple steps:
Before plugging your controller into the Nintendo Switch, hold down the X button.
While still holding the X button, plug the controller into the Nintendo Switch. This action will set your controller to “Nintendo Switch USB mode” and also set the initial game mode to “Ultimate mode”.
Release the X button.
Once you’ve entered the Ultimate mode, you’re all set! Enjoy gaming on your Nintendo Switch with the GRAM controller.
Ensure you’ve familiarized yourself with the open-source instructions on our GitHub repository. https://github.com/JonnyHaystack/HayBox#communication-backends-console-selection Note: The controller’s backend modes (like the Nintendo Switch USB mode) are selected automatically based on the button you’re holding during plugin. Thank you, @Luella for finding this guide.
If your GRAM Controller isn't recognized, ensure it's properly connected to your PC and that you've selected the correct port in Dolphin. Refreshing the device list and restarting Dolphin can also help. If issues persist, consult the support channels or community forums for further assistance.
Switch modes by holding the Key Combinations below.
Melee Mode: Mod X + Start + L
Project M/Project+ Mode: Mod X + Start + Left
Ultimate Mode: Mod X + Start + Down
FGC Mode: Mod X + Start + Right
Rivals of Aether Mode: Mod X + Start + B
Keyboard Mode (Dinput): Mod Y + Start + L
With these modes, your GRAM can swap games as fast as you do. Switching modes is instant — no need to unplug. Just hold the right combination, and you're set to start gaming.
The Neutral SOCD version of Bubblebox WASD, modified by Percival, is an experimental firmware variant for rectangle devices. It aims to test new functionalities before broader adoption. Download it here -- https://gramctrl.com/NSOCD
Q: What is the TinyControllerWebDisplay Input Viewer? A: The TinyControllerWebDisplay Input Viewer, created by @Freyaday , is a tool designed for OBS streamers who use rectangle devices. It enables viewers to see the inputs being made on the device in real-time during a stream.
Q: How does it work? A: The tool functions by interpreting the device inputs. Although it lacks access to the exact button inputs—making it somewhat imprecise—it intelligently guesses which mod buttons are pressed in ambiguous situations. It is designed to be adaptable to alternative firmware and doesn't require webserial for its operation.
Q: How can I set it up in OBS? A: To integrate the TinyControllerWebDisplay Input Viewer into your OBS setup, follow these steps:
Visit the GitHub repository: TinyControllerWebDisplay to download the HTML file.
In OBS, look for the "Browser" source option where you can input a URL.
Start the URL with file:/// followed by the path to the HTML file in the folder you've downloaded. You will be to uncheck local file.
Customize the layout by adding suffix parameters to the file name in the URL. ?type=gram
The initial display might be small, so adjust its size in OBS to fit your stream's layout preferences.
Q: Are there any limitations? A: Yes, the tool doesn't capture every exact button press due to its method of operation. It may not accurately display all mod button presses in every situation due to the guesswork involved. However, it's still a valuable tool for showing general input activity without needing webserial access. Enjoy streaming with the TinyControllerWebDisplay Input Viewer! If you have any further questions or need assistance with the setup, feel free to ask here.
Connect your GRAM controller to your computer.
As you're plugging it in, simultaneously hold down the start button.
This action places the GRAM controller into flashing mode.
Step 2: Flash the Firmware
Once in flashing mode, your GRAM will be recognized by your computer as a removable drive. This is typically labeled "RPI-RP2".
Locate the firmware file (it should have a .UF2 extension) on your computer.
Simply drag and drop (or copy and paste) this .UF2 file into the "RPI-RP2" drive.
Your computer will begin the flashing process automatically.
Once the process is completed, safely eject the "RPI-RP2" drive from your computer.
Step 3: Completion
Your GRAM controller will automatically reset.
It's now updated with the new firmware and ready for use!
Should you encounter any issues or need further guidance, don't hesitate to reach out via #support-ticket.
Yes, you have the ability to recompile the firmware to alter and customize the control mappings or modifier values according to your preferences. However, please be aware that GRAM officially supports only the legality and functionality of the default firmware settings.
Remapping your GRAM controller can be done in two main ways:
For Coders: Access the firmware's source code to write a remap using the controller mode. A helpful starting point can be found at GitHub - JonnyHaystack/HayBox.
For Experimenters: Use the Pico-rectangle tool for runtime remapping, which does not require coding knowledge. Note that this method does not support remapping the "W" button.
If you need assistance or wish to explore more about firmware modification, engaging with the community in the 📂︱open-source channel is highly encouraged. Many members have experience with firmware modification and are willing to help.
Yes, the GRAM Slim SMASH has native support for PC and can connect to PS5 via the Brook Wingman FGC adapter, ensuring compatibility across different gaming platforms.
Button remapping can be done either through coding adjustments or firmware swaps. Additionally, we are developing a web-based remapper to facilitate easier customization.
Regular cleaning is crucial. Use a dry microfiber cloth for the surface to avoid scratches and for tight spaces, compressed air or a soft-bristled brush is ideal. Avoid any liquids to prevent damage to the electronics.
Keep your controller in a cool, dry place away from direct sunlight to protect the plastic components and internal mechanisms.
Handle your controller with care to avoid drops or impacts. When transporting, use a protective case or pouch to prevent potential damage. Consider using the Official GRAM Soft Case
Firmware updates can enhance your controller's functionality and fix software issues. Check for updates periodically and follow our Discord for the latest firmware news.
The design of GRAM Digital Controllers supports natural hand positioning, akin to typing on a keyboard. To ensure ergonomic use and minimize hand strain, consider the following tips:
Hand Positioning: Hold your hands on the controller as naturally as you would on a keyboard, aiming for a relaxed grip without excessive tension.
Wrist Alignment: Maintain neutral wrist positions to avoid strain, keeping wrists straight without bending up or down excessively.
Proper Posture: Sit upright with a straight back and relaxed shoulders, similar to an optimal typing stance. Ensure your arms are positioned comfortably to hover above the controller.
Regular Breaks and Stretching: Incorporate breaks into your gaming sessions to rest and perform gentle stretches for your fingers, wrists, and arms.
Customization Options: Explore customization for your controller, including 3D printing buttons that meet your ergonomic needs. The open-source community may offer additional customization ideas to enhance comfort and gameplay.
Palms Positioning: Hovering your palms rather than resting them on the controller is often recommended for better ergonomics, especially with controllers like the Gram Slim where button elevation could lead to unnatural wrist angles.
The HTangl and Hadoe layouts are designed with ergonomics in mind, positioning the B/X/Z/Up row on top, which might require hovering the palms. This layout aligns with ergonomic principles by reducing the need to rest the wrists, though preferences vary among players.
The GRAM controller is designed for broad compatibility across various platforms, including:
Nintendo Consoles: Gamecube, Wii, Switch, and Nintendo 64
Computing Platforms: PC (Windows, macOS, and Linux)
Additional Platforms: Brook Wingman adapters enhance its compatibility further.
The GRAM Slim excels in game compatibility, supporting a wide range of titles:
Super Smash Series: Melee, Brawl, and Ultimate
Modded Titles: Project M/Project+ for enhanced gameplay
Other Noteworthy Titles: Rivals of Aether, Guilty Gear Strive, and various fighting games for the FGC community
...and many more across different genres and preferences.
Yes, this DIY process requires care. Static electricity can damage the device, so consider using an anti-static mat. Also, handle the device and plates carefully to avoid scratches or damage. Be cautious not to over-tighten the screws during reassembly.
For support or advice, visit our Support Channel. Here, you can find guidance from our team or share experiences with fellow GRAM Slim users.
While it's rare for us to fulfill custom one-off orders, we are open to discussing your needs. You can open a support ticket in our Discord to inquire about the possibility of a special layout order, such as relocating the start button.
