Loading 3D model… large boards can take a moment.
PUMBA-Keyboard is a PS2 to USB macro board adapter created using the Arduino framework.
PUMBA stands for PS2 to USB Macro Board Adapter.
PUMBA-Keyboard is an Arduino project that converts a PS2 keyboard into a USB keyboard with additional features. It includes a built-in calculator and the ability to create and playback macros. The board also has a small display for showing different information.
Here is a list of features offered by PUMBA-Keyboard:
PUMBA has been tested with SAMD21 and SAMD51 microcontroller boards. The project may work with most microcontrollers capable of emulating a HID device. However, it is not compatible with Arduino Leonardo or Uno boards due to limited available RAM. Most PS2 keyboards have been tested successfully, but it may not work with USB keyboards using a USB to PS2 adapter. The code was written using PlatformIO with the Arduino framework.
Tested Boards:
PCB and case designs are available for this project. However, they are not mandatory, as you can integrate everything inside a keyboard or use a breadboard. The repository includes KiCad project files, PDFs of the schematic, PCBs, and a bill of materials (BOM).
The PUMBA keyboard offers six different keyboard modes, each with its own layouts and macros. One mode is dedicated to functioning solely as a calculator, but all keyboard modes can activate the numpad as a calculator. Another mode is a hex and decimal converter, while one keyboard mode does not support macros.
When the PUMBA keyboard is plugged into a computer, it automatically enters "Keyboard 1" mode. You can switch between modes by pressing the "function key," which is set as the default to the menu button. After pressing the function key, the display shows available actions. To switch modes, press the corresponding key for the desired mode. Pressing the function key again takes you to the second-to-last mode.
Here is a list of key assignments for mode switching:
1: Keyboard 1
2: Keyboard 2
3: Keyboard 3
4: Keyboard 4
5: Keyboard 5
6: Keyboard 6
7: Not assigned
8: Hex and decimal converter
9: Calculator
0: Keyboard mode with no macros
Shift + 1-6: Keyboard mode with calculator functionality on the numpad
Ctrl + 1-6: Program macros/rebind keys for a key in the mode. The display provides instructions.
The calculator mode on the PUMBA keyboard includes the following controls:
When creating macros, they are stored on the micro SD card inserted into the device. If no SD card is present, all keyboard modes will act as normal keyboards. If there are no settings on the SD card or it is not inserted, the device will revert to default settings.
The following Arduino libraries are used by this program:
To learn how to use the PS2KeyAdvanced library, refer to the documentation at https://github.com/techpaul/PS2KeyAdvanced.
This project utilizes Project-hid for USB keyboard functionality. Refer to the documentation at https://github.com/NicoHood/HID.
The PS2KeyAdvanced library in the "lib" folder has been modified to disable keypad switching keybindings and modify lock keys to prevent issues.
On the PUMBA Keyboard, you can change settings such as the screen timeout duration, screen rotation, and the function key. Currently, there is no way to change these settings using the keyboard directly, but you can modify them in the code or by creating a settings file on the SD card. On startup, PUMBA looks for a config file named "CONFIG.TXT" located in the "/SETTING" folder on the SD card to apply the settings.
To change settings using the SD card, follow these steps:
PUMBA now supports the ability to rebind keys for each keyboard mode. To rebind keys, create a file named "LAYOUT.TXT" and place it in the mode for which you want to rebind the keys. Each line in the file corresponds to a PS2lib key name and the corresponding HID scancode in
decimal. In the code files, you can find a file called "default layout.txt" which contains the default key bindings. You can make a copy of this file, rename it, and modify it according to your needs. Additionally, there is a file named "layout cheatsheet.txt" that provides a helpful reference.
In any of the 6 modes, you can set macros or rebind almost any key on the keyboard. However, please note that some keys such as Scroll Lock, Num Lock, and Pause Break may not be compatible with macros or key rebindings.
No comments yet. Be the first to ask about this board.