qmk_firmware/keyboards/tada68/readme.md
James Young 0027a0a948 Tada68 Fixes and Minor Refactoring ()
* fix ANSI layout macro reference

* update ISO layout macro and enable 65_iso community layout support

- rename to LAYOUT_65_iso (with LAYOUT_iso alias for backwards compatibility)
- rename position k2c to k1d (electrical position)

* rules.mk templating

* tada68.h: use #pragma once include guard

* config.h: use #pragma once include guard

* make product id unique

* update info.json

* update readme

* cleanup default keymap

- keycode alignment
- layout macro reference
- four-space indent

* remove matrix_*_user functions from tada68.h
2020-01-08 00:17:01 +00:00

3.8 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 the build environment setup and the make instructions for more information. Brand new to QMK? Start with our Complete Newbs Guide.

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 the 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!