keychron_qmk_firmware/keyboards/tada68/readme.md

3.7 KiB
Executable File

TADA68

A compact 65% keyboard.

Keyboard Maintainer: QMK Community
Hardware Supported: TADA68 PCB
Hardware Availability: kbdfans, kbdist

Make example for this keyboard (after setting up your build environment):

make tada68:default

See build environment setup then the make instructions for more information.

Firmware Format

Out of the box the tada68 uses a .bin firmware file instead of a .hex like other custom keyboards. By default QMK will build and copy the correct .bin file for you. If for some reason you need a hex file instead, you can add :hex to your make command, or look inside qmk_firmware/.build to find the hex file.

Flashing Instructions (Win)

Read all the instructions, there are a few warnings of things to avoid doing to avoid bricking your Tada68. It is much too easy to do!

  1. from the qmk_firmware\ directory run:
$ make tada68:default:flashbin
  1. Connect your keyboard to Windows computer, hit the reset button on the TADA, the lights will start flashing.

  2. You'll see a new drive on your computer called TADA68. Backup the original factory FLASH.BIN file thats inside it.

  3. Delete FLASH.BIN from the TADA drive and copy tada68_default.bin that was generated at the root of the qmk directory into the TADA drive.

  4. Do not eject the USB device. Hit ESC on the keyboard. The lights will stop flashing and your firmware is loaded!

Flashing Instructions (Mac)

When flashing the keyboard from a Mac, you must delete some files that are automatically created by the operating system in order to prevent bricking your keyboard. Original information from /u/pawlwall from https://www.reddit.com/r/MechanicalKeyboards/comments/520cov/using_an_originative_tada86_on_a_mac/

  1. from the qmk_firmware\ directory run:
$ make tada68:default:flashbin
  1. Connect your keyboard to your Mac, hit the reset button on the bottom of the TADA, the lights will start flashing.

  2. You'll see a new drive on your computer called TADA68. Backup the original factory FLASH.BIN file that's inside it.

  3. Open the terminal and cd to the folder where the keyboard has been mounted

cd /Volumes/TADA68\ /

  1. Copy over your new firmware to the keyboard

cp -r <path to your qmk_firmware folder>/FLASH.bin .

  1. Remove files that MacOS automatically created which interfere with the keyboard

rm -fr .Trashes/ .fseventsd/ ._.Trashes ._FLASH.bin

  1. Eject the USB device or hit ESC on the keyboard. The lights will stop flashing and your firmware is loaded!

Flashing Instructions (Linux)

Use these instructions at your own risk. Mount settings originally found at https://www.reddit.com/r/MechanicalKeyboards/comments/8e2nnp/help_problems_flashing_firmware_on_tada68_from/

  1. from the qmk_firmware\ directory run:
$ make tada68:default:flashbin
  1. Connect your keyboard to Windows computer, hit the reset button on the TADA, the lights will start flashing.

  2. A new entry should appear at /dev/sd*. Mount the board using this command:

mount -t vfat -o rw,nosuid,nodev,relatime,uid=1000,gid=1000,fmask=0022,dmask=0022,codepage=437,iocharset=iso8859-1,shortname=mixed,showexec,utf8,flush,errors=remount-ro,uhelper=udisks2 <path to device> /mnt/tada68
  1. Back up the original firmware

mv /mnt/tada68/FLASH.BIN ~

  1. Copy over your new firmware to the keybaord

cp <path to your qmk_firmware folder>/FLASH.bin /mnt/tada68

  1. Do not eject the USB device. Hit ESC on the keyboard. The lights will stop flashing and your firmware is loaded!