Programming Guide

MiniVan Flashing and Programming 101

Hello and welcome to MiniVan Flashing and Programming 101. Much of the following information is available elsewhere, but I wanted to compile it all into one authoritative resource to make everyone's life easier. If you are still having trouble after reading through this page, please send me an email at thevankeyboards+support@gmail.com and I'll be glad to help you through it.

Contents
  • Stage 1 - Build Firmware
    • Shortcut - Generate Firmware Online
    • Step 1 - Setup Build Environment
      • Windows
      • Mac
      • Linux
    • Step 2 - Download Firmware
    • Step 3 - Configure Firmware
    • Step 4 - Compile Firmware
      • Windows
      • Mac
      • Linux
  • Stage 2 - Flash Keyboard
    • Step 1 - Install Bootloader
      • Windows
      • Mac
      • Linux
    • Step 2 - Flash Compiled Firmware Onto Keyboard
      • Windows
      • Mac
      • Linux

Stage 1 - Build Firmware

Shortcut - Generate Firmware Online

Firmware for the MiniVan can be customized and built online via http://minivan.config.thevankeyboards.com/

Right clicking on the keys will open a context menu making configuration a breeze.

Step 1 - Setup Build Environment

Windows

Mac & Linux

Step 2 - Download Firmware

The firmware is available in my github at the following link.
https://github.com/evangs/tmk_keyboard
Click the "Clone or download" button and then "Download ZIP".


Extract the zip somewhere you can find it.

 

Stage 2 - Flash Keyboard

Step 1 - Install Bootloader

Windows

  • Download Flip Bootloader and install.
  • Install the ATmega32u4 driver found in C:\Program Files (x86)\Atmel\Flip 3.4.7\usb
    • Press the reset button on the bottom of the keyboard.
    • In Device Manager find the ATmega32u4 device and right click on it.
    • Select "Update Driver Software".
    • Click "Browse my computer for driver software".
    • Navigate to the folder above. Leave "Include subfolders" checked.
    • Click "Next".

Mac & Linux

You should now be ready to Flash the hex file onto the keyboard.

Step 2 - Flash Compiled Firmware Onto Keyboard

Windows

  • Open Atmel Flip Bootloader.
  • Under the "Device" menu, click "Select".
  • Select "ATmega32u4" and click "OK".
  • Press the Reset button on the bottom of the keyboard.
  • Open the USB device. 
    • Click the USB cable icon.
    • Click "USB".
    • Click "Open".
  • Load the Hex file. 
    • Click the Load Hex FIle button.  
    • Navigate to your hex file.
    • Select the hex file and click "OK".
  • Ensure "Erase", "Blank Check", "Program", and "Verify" are all checked.
  • Click "Run".   
  • Once complete, click "Start Application".

Mac & Linux

  • Open the terminal.
  • Navigate to your hex file.
  • Press the reset button on the bottom of the keyboard
  • Type the following commands:
    • sudo dfu-programmer atmega32u4 erase
    • sudo dfu-programmer atmega32u4 flash yourfirmware.hex (replace yourfirmware.hex with the name of the hex file containing your firmware)
    • sudo dfu-programmer atmega32u4 start
Your keyboard should now be flashed and ready to go! Tap a key, give it a quick test.