keyboards/tada68/readme.md

   1 TADA68
   2 ======
   3
   4 A compact 65% keyboard.
   5
   6 Keyboard Maintainer: QMK Community
   7 Hardware Supported: TADA68 PCB
   8 Hardware Availability: [kbdfans](https://kbdfans.myshopify.com/products/tada68-mechanical-keyboard-gateron-swtich-65-layout-dye-sub-keycaps-cherry-profils?variant=34710238797), [kbdist](http://www.kbdist.com/)
   9
  10 Make example for this keyboard (after setting up your build environment):
  11
  12     make tada68:default:bin
  13
  14 See [build environment setup](https://docs.qmk.fm/#/getting_started_build_tools) then the [make instructions](https://docs.qmk.fm/#/getting_started_make_guide) for more information.
  15
  16 ## Flashing Instructions (Win)
  17
  18 *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!__*
  19
  20 1) from the `qmk_firmware\` directory run:
  21 ```
  22 $ make tada68:default:flashbin
  23 ```
  24
  25 2) Connect your keyboard to Windows computer, hit the reset button on the TADA, the lights will start flashing.
  26
  27 3) You'll see a new drive on your computer called TADA68. Backup the original factory `FLASH.BIN` file thats inside it.
  28
  29 4) 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.
  30
  31 5) *Do not eject the USB device.* Hit ESC on the keyboard. The lights will stop flashing and your firmware is loaded!
  32
  33 ## Flashing Instructions (Mac)
  34
  35 *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/*
  36
  37 1) from the `qmk_firmware\` directory run:
  38 ```
  39 $ make tada68:default:flashbin
  40 ```
  41
  42 2) Connect your keyboard to your Mac, hit the reset button on the bottom of the TADA, the lights will start flashing.
  43
  44 3) You'll see a new drive on your computer called TADA68. Backup the original factory `FLASH.BIN` file that's inside it.
  45
  46 4) Open the terminal and cd to the folder where the keyboard has been mounted
  47
  48 `cd /Volumes/TADA68\ /`
  49
  50 5) Copy over your new firmware to the keyboard
  51
  52 `cp -r <path to your qmk_firmware folder>/FLASH.bin .`
  53
  54 6) Remove files that MacOS automatically created which interfere with the keyboard
  55
  56 `rm -fr .Trashes/ .fseventsd/ ._.Trashes ._FLASH.bin`
  57
  58 7) Eject the USB device or hit ESC on the keyboard. The lights will stop flashing and your firmware is loaded!
  59
  60 ## Flashing Instructions (Linux)
  61
  62 *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/*
  63
  64 1) from the `qmk_firmware\` directory run:
  65 ```
  66 $ make tada68:default:flashbin
  67 ```
  68
  69 2) Connect your keyboard to Windows computer, hit the reset button on the TADA, the lights will start flashing.
  70
  71 3) A new entry should appear at `/dev/sd*`. Mount the board using this command:
  72
  73 ```
  74 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
  75 ```
  76
  77 4) Back up the original firmware
  78
  79 `mv /mnt/tada68/FLASH.BIN ~`
  80
  81 5) Copy over your new firmware to the keybaord
  82
  83 `cp <path to your qmk_firmware folder>/FLASH.bin /mnt/tada68`
  84
  85 5) *Do not eject the USB device.* Hit ESC on the keyboard. The lights will stop flashing and your firmware is loaded!