background image

Troubleshooting 

 
Q. Mathkeeb doesn’t type anything! 

A. Make sure you aren’t in programming mode, and have properly rebooted Mathkeeb with 

the correct firmware. Unplug and re-plug the keyboard as well. If it still doesn’t work, revert 
to the default firmware. If that doesn’t work, please refer to the troubleshooting section of 
the Assembly Guide. 

 
Q. [Key] doesn’t type what I want it to! 

A. Double check your matrices, and make sure you still have the 8x7 grid, with everything in 

the right place.  Also check that you are on the correct 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 hold-down function insead 

of the type-once function (it happened to us in testing!). Also make sure all of your D( ) 
functions are paired with a U( ) function. 

 
Q.  I see a bunch of red squiggles in my IDE when I open Mathkeeb’s keymap.c files! 

A. Surprisingly, this was normal for us as well. We are not really sure what causes it, but to 

check if you actually have errors, try compiling a hex using the Makefile method outlined 
above. If your keymap fails to compile, please refer to documentation or troubleshooting on 
the TMK website. 

 
 

11 

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: