Skip to content

Latest commit

 

History

History
221 lines (111 loc) · 7.08 KB

troubleshooting.md

File metadata and controls

221 lines (111 loc) · 7.08 KB

Common Issues / Troubleshooting

Get duckyPad | Official Discord | Getting Started | Table of Contents


A couple of commonly encountered issues are explained here.

Click a question below to jump to the answer!

Join Our Discord!

If you have some issues that's not in this list, feel free to join our Official Discord to ask about it! We also have discussions, script sharing, and latest updates!


I press a key and nothing happens!

First, make sure the key has a valid script mapped to it. If in doubt, use one of the sample profiles.

If none of the keys work

  • Check that the cable is plugged all the way in.

  • Try a different cable.

  • Try a different USB port.

  • Try plugging it directly into a computer instead of through a USB hub.

  • Try a different computer.

If a certain key doesn't work

Take off the switch and inspect the pins, chances are one of them is bent:

Alt text

If so, straighten it up with a pair of pliers, then insert again. Make sure the pins are straight and aim for hot-swap socket holes.

The letters and symbols come out wrong!

You'll need select a different keyboard layout.

F13 - F24 Keys doesn't work!

Please update your duckyPad to the latest firmware to fix this issue.

My script behaves inconsistently!

duckyPad might be typing too fast for your computer.

You can slow it down by using DELAY commands.

  • DELAY n adds an arbitrary delay in milliseconds.

  • DEFAULTDELAY n sets the amount of time to wait between each line of command.

  • DEFAULTCHARDELAY n sets the amount of time to wait between each keystroke.

  • More info here

My duckyPad seems to be getting sluggish!

If your duckyPad is getting slower at starting up and switching profiles, it's usually because of the SD card fragmentation.

  • Make a backup of the files on SD card.

  • Format it in FAT32 or FAT.

  • Copy the files back, it should be much faster now.

You can also use your own faster SD card.

I want to use my own SD card!

  • (Optional) Make a backup of the contents of the original SD card.

  • Format the new SD card in FAT or FAT32:

Alt text

Alt text

  • Copy all the files back.

  • You can also download the sample profiles and copy everything to the root of your SD card:

Alt text

The RGB backlight is flickering slightly!

  • Make sure the USB port can provide enough power.

  • Try plugging it directly into the computer, instead of through a USB hub.

  • Also try a different cable if possible.

The RGB backlight is too bright!

  • You can adjust the brightness by holding down - button.

Will the OLED suffer burn-in?

Measures have been taken to prevent OLED burn-in.

  • The pixels shifts around slightly every 2 minutes.

  • The screen dims after 5 minutes.

  • duckyPad goes to sleep after 30 minutes (adjustable).

The OLED screen isn't working properly!

If your OLED screen is acting weird, you might want to try to re-seat its ribbon cable.

  • Disassemble until you can remove the circuit board. You can follow this in reverse.

  • Locate the tabs on the ribbon cable connector:

Alt text

  • Push it outwards gently to loosen the tab:

Alt text

  • Pull out the ribbon cable, and wipe the golden contacts with a dry cloth.

  • Insert it back all the way. Look at the above photos for reference.

  • Push the tab back in to lock in place.

  • Try it out, if it still doesn't work, let me know!

Numpad keys doesn't work!

Make sure your NUM LOCK is on.

In-app test-run doesn't work!

The in-app test-run has some limitations.

SD Card doesn't work on mac!

If macOS doesn't like your SD card, you can reformat it in FAT/FAT32 in macOS itself, then it should work.

Click Initialize...:

Alt text

In Disk Utility, select Erase, then MS-DOS (FAT):

Alt text

Now the card should be readable in both macOS and duckyPad.

If you want, you can copy the sample profiles back to the root of the SD card.

Table of Contents

Main page

Getting Started Guide

Kit Assembly Guide

Using duckyScript

Common issues / Troubleshooting

Firmware Updates and Version History

Make Your Own Keymap

Manual Setup

Build a duckyPad Yourself

Kickstarter Backer Acknowledgments

Questions or Comments?

Please feel free to open an issue, ask in the official duckyPad discord, DM me on discord dekuNukem#6998, or email dekuNukem@gmail.com for inquires.