background image

 

 
PLEASE DO NOT

 change any settings on the ‘WIRING’ or ’PINS’ tabs unless you know what you are 

doing! This should never be necessary! 
 
To edit the layout of your keyboard simply go to the ‘KEYMAP‘ section and click which keys you 
wish to swap. Please note what the key is configured to do! If you are relocating a key that says 
‘macro’ the new key must be set to use the same macro. Modifying macros can be done with ease 
under the ‘MACROS’ section.  
 
When you are finished modifying the layout of your keyboard, modifying macros, etc, navigate to 
the ‘SETTINGS’ tab. Here you can rename your new layout and download a new .json file using the 
‘Save Configuration’ button. 

NOTE

 - always save your .json file! It will be required if you wish to edit 

your current layout in the future!  
 
After saving your layout, the new .hex file can be downloaded from the ‘COMPILE’ section. If you 
want to later add functionality not available on the Keyboard Firmware Builder site, you can 
download your layout as .zip, which will include the source code used to compile the .hex (see 
Method 2 for more information on this source code). 
 

CONGRATULATIONS!!

 - You now have a firmware with your very own Mathkeeb layout! To 

see how to load this firmware onto your keyboard, please see Chapter 3 - Programming. 

Summary of Contents for Mathkeeb

Page 1: ...Mathkeeb Advanced User s Guide 2019 2020 edition...

Page 2: ...Table of Contents Table of contents Welcome Getting Started page number 1 2 Reprogramming Custom Firmware Troubleshooting 3 5 10 1...

Page 3: ...you ve decided to take the next step and download the Advanced Users Kit With this kit you will be able to load different hex files onto the keyboard s controller allowing it to speak different langu...

Page 4: ...pressing a few buttons The first button is located on the Mathkeeb itself To access this button flip the keyboard over and set it down on its keys You should see a small pinhole near the usb port at...

Page 5: ...rd Finally you can press the third button with the green arrow pointing to the right to reboot the keyboard NOTE you will have to unplug the Mathkeeb and plug it back in to turn it back on You should...

Page 6: ...Firmware Builder Why these recommendations The Linux MacOS version of Mathkeeb s firmware types certain symbols using Unicode input This option while supported by the TMK firmware base is not availab...

Page 7: ...ate to the SETTINGS tab Here you can rename your new layout and download a new json file using the Save Configuration button NOTE always save your json file It will be required if you wish to edit you...

Page 8: ...y and you will need the Teensy Loader to flash any new hex files onto Mathkeeb this is covered in the Reprogramming section above You do not need to bother with Step 2 as all of the source files for M...

Page 9: ...c files using VSCode There are different types of keycodes Ones beginning with KC_ are letters or symbols that would appear on a normal keyboard KC_TRANS indicates that the key is transparent and will...

Page 10: ...ound here https github com tmk tmk_keyboard blob master tmk_core doc keymap md The same keymap c file showing some of the macro definitions Macros are defined in the switch statement after the layer m...

Page 11: ...types f x etc We are not really sure if there is a maximum number of macros allowed so if you would like to test that and make 100 macros please be our guest and let us know how it goes When satisfie...

Page 12: ...layer and that your layer toggle functions are on the right keys Q Key is acting like it s held down even though I only pressed it once A Double check your macros You may have accidentally used the h...

Reviews: