The Kiibohd Controller
----------------------
-TODO, write some insightful/informative :P
+This README is a bit long, just look at the sections you are interested in.
+You only need to install avr-gcc if you want to build for the Teensy 2.0/2.0++.
+Everything else needs an arm-none-eabi-gcc compiler (e.g. Infinity keyboard, Teensy 3.0/3.1, McHCK).
+
+
+Linux is the ideal build environment (preferably recent'ish).
+In the near future I'll make available an Arch Linux VM for building/manufacturing tests.
+
+
+Building on Mac should be ok for 99% of users with Macports (haven't tried Brew).
+The dfu Bootloader will not build correctly with the old version of arm-none-eabi-gcc that Macports currently has (4.7.3).
+This is due to a bug with lto (link time optimizations) which makes the resulting binary too big to fit on the chip (must be less than 4096 Bytes).
+
+
+Building on Windows should also be fine for 99% of users, but takes a bunch of work to setup (because Windows is a crappy dev environment).
+Cygwin is currently required along with some non-Cygwin compilers and utilities (because they are not available for Cygwin).
+The dfu Bootloader will not build because of a Make 3.81+ bug/feature that removed support for non-Unix (Windows) filenames as dependencies of targets.
+If you replace the version of Make in Cygwin it should work (e.g. http://stackoverflow.com/questions/601516/cygwin-make-error-target-pattern-contains-no).
+However, make sure that the flash size is no larger than 4096 Bytes or the bootloader will not work.
+Things will likely break if there are *SPACES IN YOUR PATHS*. I install cygwin to C:\cygwin64.
+If you are brave and have programming knowledge, I will accept patches to fix any issues regarding spaces in paths.
+
Please give authors credit for modules used if you use in a distributed product :D
----------------------
-Dependencies
+General Dependencies
----------------------
Below listed are the Arch Linux pacman names, AUR packages may be required.
These depend a bit on which targets you are trying to build, but the general one:
- cmake (2.8 and higher)
+- git
+- ctags (recommended, not required)
+- python3
+- libusb1.0 (and -devel)
+- make
AVR Specific (Teensy 1.0/++,2.0/++) (try to use something recent, suggested versions below)
- avr-libc (~1.8.0)
-ARM Specific (Teensy 3.0/3.1) (Sourcery CodeBench Lite for ARM EABI
-(http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/)
-- arm-none-eabi
-OR
+ARM Specific (Teensy 3.0/3.1, Infinity Keyboard, McHCK)
+
+Arch Linux / Mac Ports
- arm-none-eabi-gcc
- arm-none-eaby-binutils
-(I've actually had some issues with Sourcery CodeBench on Linux, so I often just use these)
+
+Windows
+(https://launchpad.net/gcc-arm-embedded/+download)
+- gcc-arm-none-eabi (win32.zip)
- gcc-g++
- libusb1.0
- libusb1.0-devel
+- python3
+- ctags (recommended, not required)
+
+Please note, I use cygwin term exclusively for any command line options. Unless mentioned otherwise, use it.
+Do NOT use CMD or Powershell.
-Also install the Windows version of CMake - http://cmake.org/cmake/resources/software.html
+Also install the Windows version of CMake (3+ is ideal) - http://cmake.org/cmake/resources/software.html
+Select "Do not add CMake to system PATH".
This is in addition to the Cygwin version. This is an easier alternative to installing another C compiler.
Add the following line to your .bashrc, making sure the CMake path is correct:
- alias wincmake="PATH='/cygdrive/c/Program Files (x86)/CMake 2.8'/bin:\"${PATH}\" cmake"
+ echo "alias wincmake=\"PATH='/cygdrive/c/Program Files (x86)/CMake'/bin:'${PATH}' cmake -G 'Unix Makefiles'\"" >> ~/.bashrc
Install the PJRC Virtual Serial Port Driver:
(http://pjrc.com/teensy/serial_install.exe)
Next, install the compiler(s) you want.
+
---------
| AVR GCC |
---------
http://www.atmel.com/tools/atmelavrtoolchainforwindows.aspx
(Atmel AVR 8-bit Toolchain 3.4.3 - Windows)
-Extract the files to a directory, say C:\avr8-gnu-toolchain. Then copy all the folders in that directory to the Cygwin directory.
-Mine is C:\cygwin64.
+Extract the files to a directory, say C:\avr8-gnu-toolchain. Then copy all the folders in that directory to the Cygwin /usr/local directory.
+Mine is C:\cygwin64\usr\local.
(You can also just setup the paths, but this is faster/simpler. Might screw up your Cygwin though).
| ARM EABI |
----------
-Download the latest version of Mentor Graphics Sourcery CodeBench ARM EABI.
+Download the latest GNU Tools for Embedded Processors gcc-arm-none-eabi.
+
+https://launchpad.net/gcc-arm-embedded/+download
+
+Download "gcc-arm-none-eabi*win32.zip".
-http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/
+Then extract all the folders/files in the zip to the Cygwin /usr/local directory.
+Mine is C:\cygwin64\usr\local.
+Or, you can setup paths using the installer (you have to be more careful, avoid spaces in paths).
-Look for "Download the EABI Release".
-Enter your info to get the download link.
-Select the most recent download.
-Then download the "IA32 Windows Installer".
-Use the installer and make sure you add the binaries to your path within the installer.
+
+----------------------
+CMake Info
+----------------------
+
+One of the big benefits of using CMake is the ability to build multiple configurations (for different microcontrollers) at the same time.
+The following sections explain in detail what each CMakeLists.txt configuration option does and what you can change it to.
+However, it is possible to configure each of these options using the -D command line flag.
+
+For example, to build the Infinity Keyboard default configuration:
+
+mkdir build_infinity
+cd build_infinity
+cmake -DCHIP=mk20dx128vlf5 -DScanModule=MD1 -DMacroModule=PartialMap -DOutputModule=pjrcUSB -DDebugModule=full -DBaseMap=defaultMap -DDefaultMap="md1Overlay stdFuncMap" -DPartialMaps="hhkbpro2" ..
+make
+
+CMake defaults to the values specified in CMakeLists.txt if not overridden via the command line.
+NOTE: On Windows, you will have to use "wincmake" instead of "cmake".
# "at90usb162" # Teensy 1.0 (avr)
# "atmega32u4" # Teensy 2.0 (avr)
# "at90usb646" # Teensy++ 1.0 (avr)
- "at90usb1286" # Teensy++ 2.0 (avr)
+ # "at90usb1286" # Teensy++ 2.0 (avr)
# "mk20dx128" # Teensy 3.0 (arm)
+ "mk20dx128vlf5" # McHCK mk20dx128vlf5
# "mk20dx256" # Teensy 3.1 (arm)
- )
+ CACHE STRING "Microcontroller Chip" )
Just uncomment the chip you want, and comment out the old one.
#| All of the modules must be specified, as they generate the sources list of files to compile
#| Any modifications to this file will cause a complete rebuild of the project
- #| Please look at the {Scan,Macro,Output,Debug}/module.txt for information on the modules and how to create new ones
+ #| Please look at the {Scan,Macro,Output,Debug} for information on the modules and how to create new ones
##| Deals with acquiring the keypress information and turning it into a key index
- set( ScanModule "avr-capsense" )
+ set( ScanModule "MD1"
+ CACHE STRING "Scan Module" )
- ##| Uses the key index and potentially applies special conditions to it, mapping it to a usb key code
- set( MacroModule "buffer" )
+ ##| Provides the mapping functions for DefaultMap and handles any macro processing before sending to the OutputModule
+ set( MacroModule "PartialMap"
+ CACHE STRING "Macro Module" )
##| Sends the current list of usb key codes through USB HID
- set( OutputModule "pjrc" )
+ set( OutputModule "pjrcUSB"
+ CACHE STRING "Output Module" )
##| Debugging source to use, each module has it's own set of defines that it sets
- set( DebugModule "full" )
+ set( DebugModule "full"
+ CACHE STRING "Debug Module" )
Look at each module individually for it's requirements. There is chip/architecture dependency checking but some permutations of modules may not be tested/compile.
Example output:
- [master]: cmake .. [...sy/avr-capsense-haata/build](hyatt@901Mas:pts/4)
+ [master]: cmake .. [~/Source/controller/build](hyatt@x230mas:pts/6)
-- Compiler Family:
- avr
- -- MCU Selected:
- at90usb1286
+ arm
+ -- Chip Selected:
+ mk20dx128vlf5
+ -- Chip Family:
+ mk20dx
+ -- CPU Selected:
+ cortex-m4
+ -- Compiler Source Files:
+ Lib/mk20dx.c;Lib/delay.c
+ -- Bootloader Type:
+ dfu
-- Detected Scan Module Source Files:
- Scan/avr-capsense/scan_loop.c
+ Scan/MD1/scan_loop.c;Scan/MD1/../MatrixARM/matrix_scan.c
-- Detected Macro Module Source Files:
- Macro/buffer/macro.c
+ Macro/PartialMap/macro.c
-- Detected Output Module Source Files:
- Output/pjrc/usb_com.c;Output/pjrc/avr/usb_keyboard_debug.c
+ Output/pjrcUSB/output_com.c;Output/pjrcUSB/arm/usb_desc.c;Output/pjrcUSB/arm/usb_dev.c;
+ Output/pjrcUSB/arm/usb_keyboard.c;Output/pjrcUSB/arm/usb_mem.c;Output/pjrcUSB/arm/usb_serial.c
-- Detected Debug Module Source Files:
- Debug/full/../led/led.c;Debug/full/../print/print.c
+ Debug/full/../cli/cli.c;Debug/full/../led/led.c;Debug/full/../print/print.c
+ -- Found Git: /usr/bin/git (found version "2.2.1")
+ -- Found Ctags: /usr/bin/ctags (found version "5.8")
+ -- Checking for latest kll version:
+ Current branch master is up to date.
+ -- Detected Layout Files:
+ /home/hyatt/Source/controller/Macro/PartialMap/capabilities.kll
+ /home/hyatt/Source/controller/Output/pjrcUSB/capabilities.kll
+ /home/hyatt/Source/controller/Scan/MD1/defaultMap.kll
+ /home/hyatt/Source/controller/kll/layouts/md1Overlay.kll
+ /home/hyatt/Source/controller/kll/layouts/stdFuncMap.kll
+ /home/hyatt/Source/controller/kll/layouts/hhkbpro2.kll
-- Configuring done
-- Generating done
- -- Build files have been written to: /home/hyatt/Source/Teensy/avr-capsense-haata/build
- [master]: make [...sy/avr-capsense-haata/build](hyatt@901Mas:pts/4)
+ -- Build files have been written to: /home/hyatt/Source/controller/build
+ [master]: make [~/Source/controller/build](hyatt@x230mas:pts/6)
+ [ 5%] Generating KLL Layout
Scanning dependencies of target kiibohd.elf
- [ 12%] Building C object CMakeFiles/kiibohd.elf.dir/main.c.o
- [ 25%] Building C object CMakeFiles/kiibohd.elf.dir/Scan/avr-capsense/scan_loop.c.o
- [ 37%] Building C object CMakeFiles/kiibohd.elf.dir/Macro/buffer/macro.c.o
- [ 50%] Building C object CMakeFiles/kiibohd.elf.dir/Output/pjrc/usb_com.c.o
- [ 62%] Building C object CMakeFiles/kiibohd.elf.dir/Output/pjrc/avr/usb_keyboard_debug.c.o
- [ 75%] Building C object CMakeFiles/kiibohd.elf.dir/Debug/led/led.c.o
- [ 87%] Building C object CMakeFiles/kiibohd.elf.dir/Debug/print/print.c.o
+ [ 11%] Building C object CMakeFiles/kiibohd.elf.dir/main.c.o
+ [ 17%] Building C object CMakeFiles/kiibohd.elf.dir/Lib/mk20dx.c.o
+ [ 23%] Building C object CMakeFiles/kiibohd.elf.dir/Lib/delay.c.o
+ [ 29%] Building C object CMakeFiles/kiibohd.elf.dir/Scan/MD1/scan_loop.c.o
+ [ 35%] Building C object CMakeFiles/kiibohd.elf.dir/Scan/MatrixARM/matrix_scan.c.o
+ [ 41%] Building C object CMakeFiles/kiibohd.elf.dir/Macro/PartialMap/macro.c.o
+ [ 47%] Building C object CMakeFiles/kiibohd.elf.dir/Output/pjrcUSB/output_com.c.o
+ [ 52%] Building C object CMakeFiles/kiibohd.elf.dir/Output/pjrcUSB/arm/usb_desc.c.o
+ [ 58%] Building C object CMakeFiles/kiibohd.elf.dir/Output/pjrcUSB/arm/usb_dev.c.o
+ [ 64%] Building C object CMakeFiles/kiibohd.elf.dir/Output/pjrcUSB/arm/usb_keyboard.c.o
+ [ 70%] Building C object CMakeFiles/kiibohd.elf.dir/Output/pjrcUSB/arm/usb_mem.c.o
+ [ 76%] Building C object CMakeFiles/kiibohd.elf.dir/Output/pjrcUSB/arm/usb_serial.c.o
+ [ 82%] Building C object CMakeFiles/kiibohd.elf.dir/Debug/cli/cli.c.o
+ [ 88%] Building C object CMakeFiles/kiibohd.elf.dir/Debug/led/led.c.o
+ [ 94%] Building C object CMakeFiles/kiibohd.elf.dir/Debug/print/print.c.o
Linking C executable kiibohd.elf
- Creating load file for Flash: kiibohd.hex
- Creating Extended Listing: kiibohd.lss
- Creating Symbol Table: kiibohd.sym
- [ 87%] Built target kiibohd.elf
+ [ 94%] Built target kiibohd.elf
Scanning dependencies of target SizeAfter
- [100%] Size after generation:
- text data bss dec hex filename
- 0 6112 0 6112 17e0 kiibohd.hex
- 5792 320 852 6964 1b34 kiibohd.elf
+ [100%] Chip usage for mk20dx128vlf5
+ SRAM: 32% 5384/16384 bytes
+ Flash: 18% 23384/126976 bytes
[100%] Built target SizeAfter
+----------------------
+Linux Building Bootloader
+----------------------
+
+*NOTE* Does not apply to Teensy based builds.
+
+From this directory.
+cd Bootloader
+mkdir build
+cd build
+cmake ..
+make
+
+Example output:
+
+ [master]: cmake .. [~/Source/controller/Bootloader/build](hyatt@x230mas:pts/6)
+ -- Compiler Family:
+ arm
+ -- Chip Selected:
+ mk20dx128vlf5
+ -- Chip Family:
+ mk20dx
+ -- CPU Selected:
+ cortex-m4
+ -- Compiler Source Files:
+ Lib/mk20dx.c;Lib/delay.c
+ -- Bootloader Type:
+ dfu
+ -- Bootloader Source Files:
+ main.c;dfu.c;dfu.desc.c;flash.c;kinetis.c;usb.c
+ -- Found Git: /usr/bin/git (found version "2.2.1")
+ -- Found Ctags: /usr/bin/ctags (found version "5.8")
+ -- Configuring done
+ -- Generating done
+ -- Build files have been written to: /home/hyatt/Source/controller/Bootloader/build
+ [master]: make [~/Source/controller/Bootloader/build](hyatt@x230mas:pts/6)
+ Scanning dependencies of target kiibohd_bootloader.elf
+ [ 11%] Building C object CMakeFiles/kiibohd_bootloader.elf.dir/main.c.o
+ [ 22%] Building C object CMakeFiles/kiibohd_bootloader.elf.dir/dfu.c.o
+ [ 33%] Building C object CMakeFiles/kiibohd_bootloader.elf.dir/dfu.desc.c.o
+ [ 44%] Building C object CMakeFiles/kiibohd_bootloader.elf.dir/flash.c.o
+ [ 55%] Building C object CMakeFiles/kiibohd_bootloader.elf.dir/kinetis.c.o
+ [ 66%] Building C object CMakeFiles/kiibohd_bootloader.elf.dir/usb.c.o
+ [ 77%] Building C object CMakeFiles/kiibohd_bootloader.elf.dir/home/hyatt/Source/controller/Lib/mk20dx.c.o
+ [ 88%] Building C object CMakeFiles/kiibohd_bootloader.elf.dir/home/hyatt/Source/controller/Lib/delay.c.o
+ Linking C executable kiibohd_bootloader.elf
+ [ 88%] Built target kiibohd_bootloader.elf
+ Scanning dependencies of target SizeAfter
+ [100%] Chip usage for mk20dx128vlf5
+ SRAM: 19% 3176/16384 bytes
+ Flash: 2% 3736/126976 bytes
+ [100%] Built target SizeAfter
+
+
+
+----------------------
+Linux Loading Bootloader
+----------------------
+
+*NOTE* Does not apply to Teensy based builds.
+
+It's recommended to use an SWD-type flasher like a Bus Pirate.
+There is a convenience script for loading the firmware once the system is setup.
+
+cd Bootloader/Scripts
+./swdLoad.bash
+
+The above script requires Ruby, Ruby serial port module, git, and a /dev/buspirate udev rule.
+
+Additional Notes:
+https://github.com/mchck/mchck/wiki/Getting-Started (See Bus-Pirate section)
+https://wiki.archlinux.org/index.php/Bus_pirate
+
+
+
----------------------
Windows Building
----------------------
From this directory.
mkdir build
cd build
-wincmake -G "Unix Makefiles" ..
+wincmake ..
+make
Example output:
- $ cmake -G "Unix Makefiles" ..
+ $ wincmake ..
-- Compiler Family:
- avr
- -- MCU Selected:
- atmega32u4
+ arm
+ -- Chip Selected:
+ mk20dx128vlf5
+ -- Chip Family:
+ mk20dx
-- CPU Selected:
- megaAVR
+ cortex-m4
+ -- Compiler Source Files:
+ Lib/mk20dx.c;Lib/delay.c
+ -- Bootloader Type:
+ dfu
-- Detected Scan Module Source Files:
- Scan/SKM67001/../matrix/matrix_scan.c;Scan/SKM67001/../matrix/scan_loop.c
+ Scan/MD1/scan_loop.c;Scan/MD1/../MatrixARM/matrix_scan.c
-- Detected Macro Module Source Files:
Macro/PartialMap/macro.c
-- Detected Output Module Source Files:
- Output/pjrcUSB/output_com.c;Output/pjrcUSB/avr/usb_keyboard_serial.c
+ Output/pjrcUSB/output_com.c;Output/pjrcUSB/arm/usb_desc.c;Output/pjrcUSB/arm/usb_dev.c;Output/pjrcUSB/arm/usb_keyboard.c;Output/pjrcUSB/arm/usb_mem.c;Output/pjrcUSB/arm/usb_serial.c
-- Detected Debug Module Source Files:
Debug/full/../cli/cli.c;Debug/full/../led/led.c;Debug/full/../print/print.c
- -- Found Git: C:/cygwin64/bin/git.exe (found version "1.7.9")
+ -- Found Git: C:/cygwin64/bin/git.exe (found version "2.1.1")
+ -- Found Ctags: C:/cygwin64/bin/ctags.exe (found version "5.8")
+ -- Checking for latest kll version:
+ Current branch master is up to date.
+ -- Detected Layout Files:
+ C:/cygwin64/home/Jacob/controller/Macro/PartialMap/capabilities.kll
+ C:/cygwin64/home/Jacob/controller/Output/pjrcUSB/capabilities.kll
+ C:/cygwin64/home/Jacob/controller/Scan/MD1/defaultMap.kll
+ C:/cygwin64/home/Jacob/controller/kll/layouts/md1Overlay.kll
+ C:/cygwin64/home/Jacob/controller/kll/layouts/stdFuncMap.kll
+ C:/cygwin64/home/Jacob/controller/kll/layouts/hhkbpro2.kll
-- Configuring done
-- Generating done
- -- Build files have been written to: C:/cygwin64/home/jacob.alexander/src/capsense-beta/build
+ -- Build files have been written to: C:/cygwin64/home/Jacob/controller/build
- jacob.alexander@JALEXANDER2-LT ~/src/capsense-beta/build
+ Jacob@DenPC ~/controller/build
$ make
+ [ 5%] Generating KLL Layout
Scanning dependencies of target kiibohd.elf
- [ 10%] Building C object CMakeFiles/kiibohd.elf.dir/main.c.obj
- [ 20%] Building C object CMakeFiles/kiibohd.elf.dir/Scan/matrix/matrix_scan.c.obj
- [ 30%] Building C object CMakeFiles/kiibohd.elf.dir/Scan/matrix/scan_loop.c.obj
- [ 40%] Building C object CMakeFiles/kiibohd.elf.dir/Macro/PartialMap/macro.c.obj
- [ 50%] Building C object CMakeFiles/kiibohd.elf.dir/Output/pjrcUSB/output_com.c.obj
- [ 60%] Building C object CMakeFiles/kiibohd.elf.dir/Output/pjrcUSB/avr/usb_keyboard_serial.c.obj
- [ 70%] Building C object CMakeFiles/kiibohd.elf.dir/Debug/cli/cli.c.obj
- [ 80%] Building C object CMakeFiles/kiibohd.elf.dir/Debug/led/led.c.obj
- [ 90%] Building C object CMakeFiles/kiibohd.elf.dir/Debug/print/print.c.obj
+ [ 11%] Building C object CMakeFiles/kiibohd.elf.dir/main.c.obj
+ [ 17%] Building C object CMakeFiles/kiibohd.elf.dir/Lib/mk20dx.c.obj
+ [ 23%] Building C object CMakeFiles/kiibohd.elf.dir/Lib/delay.c.obj
+ [ 29%] Building C object CMakeFiles/kiibohd.elf.dir/Scan/MD1/scan_loop.c.obj
+ [ 35%] Building C object CMakeFiles/kiibohd.elf.dir/Scan/MatrixARM/matrix_scan.c.obj
+ [ 41%] Building C object CMakeFiles/kiibohd.elf.dir/Macro/PartialMap/macro.c.obj
+ [ 47%] Building C object CMakeFiles/kiibohd.elf.dir/Output/pjrcUSB/output_com.c.obj
+ [ 52%] Building C object CMakeFiles/kiibohd.elf.dir/Output/pjrcUSB/arm/usb_desc.c.obj
+ [ 58%] Building C object CMakeFiles/kiibohd.elf.dir/Output/pjrcUSB/arm/usb_dev.c.obj
+ [ 64%] Building C object CMakeFiles/kiibohd.elf.dir/Output/pjrcUSB/arm/usb_keyboard.c.obj
+ [ 70%] Building C object CMakeFiles/kiibohd.elf.dir/Output/pjrcUSB/arm/usb_mem.c.obj
+ [ 76%] Building C object CMakeFiles/kiibohd.elf.dir/Output/pjrcUSB/arm/usb_serial.c.obj
+ [ 82%] Building C object CMakeFiles/kiibohd.elf.dir/Debug/cli/cli.c.obj
+ [ 88%] Building C object CMakeFiles/kiibohd.elf.dir/Debug/led/led.c.obj
+ [ 94%] Building C object CMakeFiles/kiibohd.elf.dir/Debug/print/print.c.obj
Linking C executable kiibohd.elf
- Creating load file for Flash: kiibohd.hex
- Creating Extended Listing: kiibohd.lss
- Creating Symbol Table: kiibohd.sym
- [ 90%] Built target kiibohd.elf
+ [ 94%] Built target kiibohd.elf
Scanning dependencies of target SizeAfter
- [100%] Size after generation
- Flash Usage: data (hex)
- RAM Usage: data (elf)
- text data bss dec hex filename
- 0 9738 0 9738 260a kiibohd.hex
- 7982 1756 264 10002 2712 kiibohd.elf
+ [100%] Chip usage for mk20dx128vlf5
+ SRAM: 32% 5384/16384 bytes
+ Flash: 18% 23296/126976 bytes
[100%] Built target SizeAfter
+NOTES:
+
+If you get the following error, you have not setup wincmake correctly:
+
+$ make
+[ 5%] Generating KLL Layout
+Scanning dependencies of target kiibohd.elf
+[ 11%] Building C object CMakeFiles/kiibohd.elf.dir/main.c.o
+../main.c:28:19: fatal error: macro.h: No such file or directory
+ #include <macro.h>
+ ^
+compilation terminated.
+CMakeFiles/kiibohd.elf.dir/build.make:67: recipe for target 'CMakeFiles/kiibohd.elf.dir/main.c.o' failed
+make[2]: *** [CMakeFiles/kiibohd.elf.dir/main.c.o] Error 1
+CMakeFiles/Makefile2:98: recipe for target 'CMakeFiles/kiibohd.elf.dir/all' failed
+make[1]: *** [CMakeFiles/kiibohd.elf.dir/all] Error 2
+Makefile:75: recipe for target 'all' failed
+make: *** [all] Error 2
+
+If you have already added the line to your ~/.bashrc try restarting your cygwin shell.
+
+
----------------------
Windows Loading Firmware
Mac OS X Building
----------------------
+From this directory.
+mkdir build
+cd build
+cmake ..
+make
+
+
+Example output:
TODO
Mac OS X Loading Firmware
----------------------
-TODO
+First place the keyboard into re-flash mode.
+This can be done either by pressing the re-flash button on the PCB/Teensy.
+Or by entering the Kiibohd Virtual Serial Port and using the 'reload' command.
+
+The 'load' script that is created during the build can load the firmware over USB.
+
+
+To load the newly built firmware:
+./load
-------
I generally use screen.
-You will need sudo/root priviledges if you haven't installed the 98-kiibohd.rules file to /etc/udev/rules.d
+You will need sudo/root priviledges if you haven't installed the 98-kiibohd.rules file to /etc/udev/rules.d
screen /dev/ttyACM0
(Might be ACM1, ACM2, etc.)
Make sure the Teensy Virtual Serial Port driver is installed.
If possible use screen (as part of Cygwin).
+Check which COM port the virtual serial port has been assigned to:
+ Device Manager->Ports (COM & LPT)->Teensy USB Serial
+ In brackets it will say which COM port (e.g. COM3)
+
-screen /dev/ttyS3
+putty works well when using DTR/DSR or RTS/CTS flow control.
+Connection type: Serial
+Serial line: <Your COM port, e.g. COM3>
+Speed: (doesn't matter, it's auto-negotiated)
+
+Under Category->Connections->Serial
+Flow control: DTR/DSR
+
+If stuff is hard to read (you have a dumb colour scheme):
+Category->Window->Colours->Use system colur
+That seems to make text at least readable (I use a custom colour scheme that makes each colour easy to see -HaaTa).
+
+
+Unfortunately, screen for Cygwin seems to be broken for serial ports, but you can try it...
+screen /dev/ttyS2
(Might be a different file, ttyS0, ttyACM0, ttyUSB0, etc.)
+Gnu screen doesn't seem to echo all the characters (it works though).
+I believe it's a problem with stty, but I don't know how to fix it...
+
----------
| Mac OS X |
----------
-TODO (What is the usual device name). screen if possible.
+I recommend screen (can be installed via Macports).
+screen /dev/tty.<usb something>
projects / kiibohd-controller.git / blobdiff