From 4e4e95d69f8c54e9665491a38201cbb20560e914 Mon Sep 17 00:00:00 2001 From: Jacob Alexander Date: Mon, 26 May 2014 22:46:03 -0700 Subject: [PATCH] Adding updated information on Windows Builds. - Windows builds and loading has been working just fine - screen does work with Cygwin, but there are output problems (echoing isn't working for basic input, commands still work) - TeraTerm works good, but kills the serial port if you don't quit after reloading the firmware --- README | 47 ++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 42 insertions(+), 5 deletions(-) diff --git a/README b/README index 57193e1..ed197a8 100644 --- a/README +++ b/README @@ -44,6 +44,7 @@ First make sure Cygwin is installed - http://www.cygwin.com/ - 32bit or 64bit is - git (needed for some compilation info) - cmake - gcc-core +- gcc-g++ - libusb1.0 - libusb1.0-devel @@ -52,6 +53,9 @@ This is in addition to the Cygwin version. This is an easier alternative to inst 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" +Install the PJRC Virtual Serial Port Driver: +(http://pjrc.com/teensy/serial_install.exe) + Next, install the compiler(s) you want. @@ -77,6 +81,11 @@ Download the latest version of Mentor Graphics Sourcery CodeBench ARM EABI. http://www.mentor.com/embedded-software/sourcery-tools/sourcery-codebench/editions/lite-edition/ +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. @@ -241,9 +250,16 @@ Example output: Linux Loading Firmware ---------------------- -The 'load' script that is created during the build can load the firmware over USB. -It uses sudo, so make sure you have the priviledges. +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. +Either run it with sudo, or install the 98-kiibohd.rules to /etc/udev/rules.d + and run: udevadm control --reload-rules + + +To load the newly built firmware: ./load @@ -312,7 +328,18 @@ Example output: Windows 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 Interface 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 + +Be patient the couple of times, Windows is slow at installing drivers... + + ---------------------- Mac OS X Building @@ -320,6 +347,8 @@ Mac OS X Building TODO + + ---------------------- Mac OS X Loading Firmware ---------------------- @@ -327,6 +356,7 @@ Mac OS X Loading Firmware TODO + ---------------------- Virtual Serial Port - CLI ---------------------- @@ -334,20 +364,27 @@ Virtual Serial Port - CLI Rather than use a special program that can interpret Raw HID, this controller exposes a USB Serial CDC endpoint. This allows for you to use a generic serial terminal to debug/control the keyboard firmware (e.g. Tera Term, minicom, screen) + ------- | Linux | ------- 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 -sudo screen /dev/ttyACM0 +screen /dev/ttyACM0 +(Might be ACM1, ACM2, etc.) --------- | Windows | --------- -TODO Probably COM1, but not exactly sure. Tera Term. +Make sure the Teensy Virtual Serial Port driver is installed. +If possible use screen (as part of Cygwin). + +screen /dev/ttyS3 +(Might be a different file, ttyS0, ttyACM0, ttyUSB0, etc.) ----------