FAQ & Troubleshooting

Here we will post common questions with their answers and troubleshooting solutions.


Where can I find the GRAM Slim SMASH Quick Start Guide?

Please click this image below of the GRAM Slim SMASH Quick Start Guide to view a larger version and save it.

How do I use my GRAM Slim with the Brook Wingman Adapter?

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.

GRAM Size Comparison Chart
How do I download and install the HayBox firmware on my GRAM Controller?

To set up your GRAM Controller with the HayBox firmware, follow these steps:

  1. Download Firmware:

  2. 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.

  3. Connect Your Controller:

    • Use a USB cable to connect your GRAM Controller to your PC.

  4. Configure in Dolphin:

    • Open Dolphin, navigate to controller settings, and assign a port to “Standard Controller”. Then, enter the controller configuration menu.

  5. Refresh Device List:

    • Refresh the Device Dropdown list to ensure your GRAM Controller is recognized.

  6. 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.

  7. Complete Setup:

    • Click "Close" to finalize the setup. Your GRAM Controller is now equipped with HayBox firmware and ready for use.

Required Downloads to use your GRAM with your PC
  1. Navigate to GRAMCtrl.com/dolphin to download the latest .ini file for the HayBox firmware.

  2. 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.

  3. Connect your GRAM Controller to your PC using a USB cable.

  4. Open Dolphin and go to the controller settings. Assign a port to “Standard Controller” and enter the controller configuration menu.

  5. Refresh the Device Dropdown list to ensure your controller is recognized.

  6. Look for “HayBox” in the dropdown menu under Profiles.

  7. Click the "Load" button to activate the profile. Remember, always choose "Load" instead of "Save" to avoid configuration issues.

  8. Finalize the setup by clicking "Close". Your GRAM Controller is now ready for action.

For more information, please visit

How do I use my GRAM Controller with my Nintendo Switch?

How can I connect my GRAM controller to the Nintendo Switch? To connect your GRAM controller to the Nintendo Switch, follow these simple steps:

  1. Before plugging your controller into the Nintendo Switch, hold down the X button.

  2. 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”.

  3. Release the X button.

  4. 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.

What should I do if my GRAM Controller is not recognized in Dolphin?

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.

Is the GRAM Slim hot-swappable?

Yes, the GRAM Slim controller supports hotswapping switches. For detailed information about this feature and other specifications specific to the model you're interested in or currently own, please visit the product page on gramctrl.com.


How do I change game modes on my controller?

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.

What's the Neutral SOCD Version of Bubblebox WASD?

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

Can I visually display controller inputs on my stream?

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:

  1. Visit the GitHub repository: TinyControllerWebDisplay to download the HTML file.

  2. In OBS, look for the "Browser" source option where you can input a URL.

  3. 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.

  4. Customize the layout by adding suffix parameters to the file name in the URL. ?type=gram

  5. 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.

How can I flash new firmware onto my GRAM controller?

Step-by-Step Guide: Step 1: Prepare Your GRAM for Flashing

  • 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.

Can I reconfigure custom controls on my GRAM device?

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.

How can I remap my GRAM controller?

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.

Can the GRAM controller connect to PC or PS natively?

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.

How can I remap button placements on the GRAM controller?

Button remapping can be done either through coding adjustments or firmware swaps. Additionally, we are developing a web-based remapper to facilitate easier customization.


USB Connection Issues

Encountered USB connection problems with your GRAM controller? Here's a condensed guide to troubleshoot:

  1. Experiment with Connections: Try different USB modes (e.g., USB-C to GCC, USB-C to Switch).

  2. Boot Select Mode: Use the start button or the Raspberry Pi button to attempt boot select mode for firmware access.

  3. Power Check: Ensure the Raspberry Pi lights up, indicating power reception.

  4. Final Resort: Connect via USB-C to GCC with an adapter, then switch back to the initial connection.

If issues persist:

  • Document and Report: Capture the problem with videos/photos and open a support ticket for further assistance.

This odd USB issue usually resolves after switching connection modes. For continuous issues, documentation helps us improve the knowledge base and future troubleshooting.

Resolving Input Issues on GameCube and Dolphin with Your GRAM Controller

If you're experiencing input issues with your GRAM Controller on GameCube or Dolphin, try these fixes:

  • For GameCube: Disconnect the GCC end from the Wii/GameCube but keep the USB-C connected to the controller. Reconnect and see if it solves the problem.

  • For Dolphin: Ensure you have the right .ini file for the Haybox firmware. Load this .ini into your Dolphin profiles. You can find the .ini file in the general channel or check out the HayBox GitHub for detailed setup instructions.

In Dolphin, you can set up your controller as a standard controller or use a GCC adapter. A USB connection is recommended for stability, but using a GCC adapter should work fine too.

If these steps resolved your issue, excellent! If you have more questions or need further help, feel free to ask.

Resolving D-Pad and Up Button Configuration Errors on GRAM Controllers

If you're experiencing an issue where both the up button and the D-pad button are registering as "up," you might have accidentally activated "tournament illegal mode" while trying to enable WASD mode. Here's how to fix it:

  1. Ensure you're using the correct combination to activate WASD mode. The correct combination should not cause both buttons to register as "up."

  2. If you've entered an incorrect combination (like Mod X + B + Start instead of just X), simply unplug and then replug the controller from the console to reset it.

  3. After replugging, use the correct combination for WASD mode without including additional buttons that might trigger other modes.

If you successfully fix the issue by using the correct combination, great! If not, or if you have further questions, don't hesitate to ask for more help.

How to Reset GRAM Controller to Default Settings with Firmware Reflash

Resetting your GRAM controller to its default settings can be done by reflashing the firmware. Connect your controller to a PC, enter flashing mode, and drag the latest .uf2 firmware file to the device. Instructions and firmware files are available on our firmware update page.

What steps can I take if buttons on my GRAM controller are non-responsive?

Non-responsive buttons may indicate a need to check the button's seating or to replace defective switches. GRAM controllers feature hotswap sockets for easy switch replacement. For troubleshooting tips and switch replacement guides, visit our hardware support section.

How can I test and troubleshoot my GRAM controller's functionality on my PC?

To test your GRAM controller on a PC, connect it and use the Windows Joy.cpl tool to view and test all button functionalities. This process can identify held-down buttons or defective switches. For detailed instructions on accessing and using the Joy.cpl tool, consult our PC troubleshooting guide.

What should I do if a button on my GRAM controller stops working?

If the a button on your GRAM controller has stopped registering inputs in-game, despite the button itself being physically operational, here are steps to troubleshoot:

  1. Check Switch Orientation: Ensure the switch is oriented correctly when reinserting it. The pins on the switch should make direct contact with the contacts inside the hotswap socket, not the metallic parts of the socket frame.

  2. Reinsert the Switch: Carefully remove and then reinsert the switch, paying close attention to the orientation and ensuring a secure fit.

  3. Troubleshooting Assistance: If you're still encountering issues after these steps, consider reaching out for further troubleshooting assistance. Our team is available to walk you through additional steps.

Success: If these steps resolve the issue, fantastic! If not, or if you encounter other problems, our support channels are open for guidance, and our community-driven FAQ section may have the answers you need.

Care & Ergonomics

How should I clean my GRAM Digital Controller?

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.

What's the best way to store my controller?

Keep your controller in a cool, dry place away from direct sunlight to protect the plastic components and internal mechanisms.

How can I protect my controller from damage?

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

Why is it important to update my controller's firmware?

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.

How do I use my GRAM Digital Controller ergonomically to prevent hand pain?

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.

What layouts are considered more ergonomic?

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.

Are there special considerations for the Gram Slim?

Yes, the Gram Slim's elevated buttons might lead to a more pronounced upward tilt of the wrists if rested. The HTangl layout, which elevates the top row of buttons, is an ergonomic design choice that encourages palm hovering to maintain neutral wrist positions.

Remember, ergonomic needs vary by individual, and it's crucial to find a setup that feels comfortable and natural for you. If discomfort persists, consulting a healthcare professional for personalized advice is advisable.


What gaming platforms is the GRAM Slim compatible with?

The GRAM Slim 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.

Which games can I play with the GRAM Slim controller?

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.

How does the GRAM Slim enhance my gaming experience?

The GRAM Slim is your essential gaming tool, offering seamless integration with a multitude of gaming platforms and a diverse array of games. Its design ensures that you can enjoy your favorite titles with unparalleled flexibility and reliability, making it a perfect companion for both nostalgia-driven and modern gameplay experiences.

Where can I get support or more information about the GRAM Slim's compatibility?

For further support or inquiries about the GRAM Slim's compatibility, you're welcome to join our vibrant community on Discord or check our FAQ Channel for more information.

What are the differences between all of the GRAM models?


How do I prepare to customize my GRAM Slim controller?

Start with a clean, static-free workspace and ensure your hands are free from oils or lotions. You'll need an Allen wrench for the process, and if you're planning to swap plates, make sure you have the new plates ready. Custom plates are available at www.gramctrl.com.

What is the process for swapping out the top and bottom plates on a GRAM Slim?
  1. Power Off and Disconnect: Ensure your controller is off and disconnected.

  2. Locate Screws: Identify the 7 screws holding the plates in place.

  3. Unscrew: Using an Allen wrench, carefully remove each screw and keep them in a container or magnetic tray.

  4. Remove Plates: Gently lift off the top and then the bottom plate, taking care to avoid damage.

  5. Install New Plates: Align the new plates correctly and screw them back in place, ensuring not to over-tighten.

Are there any precautions I should take when customizing my GRAM Slim?

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.

What should I keep in mind regarding the GRAM Slim's features during customization?

Remember the GRAM Slim's key features like its premium low-profile design, 10mm sleek chassis, and high-quality screen-printed aluminum body. These are important to consider when handling the device for customization to maintain its integrity and aesthetics.

Where can I get support if I have questions or encounter issues during customization?

For support or advice, visit our Support Channel. Here, you can find guidance from our team or share experiences with fellow GRAM Slim users.

Is it possible to customize the GRAM controller with my own art?

Absolutely! You can personalize your GRAM controller with custom art. The art templates are available on our GitHub in More Links. Look for the DXF file for the top panel, which serves as the art template.

What are the chances of placing a special order for a different layout?

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.

I can't find the art template on GitHub. Where is it?

The art template for customizing your GRAM controller is the DXF file for the top panel, located in the same GitHub repository as the other templates for dxf/stl files. This file can be used to design your custom art. More Links

For any further questions or detailed support, don't hesitate to reach out to us through a support ticket in our Discord community.

Last updated