Archived
1
0

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
This commit is contained in:
Jacob Alexander 2014-05-26 22:46:03 -07:00
parent 366f6c9276
commit 4e4e95d69f

47
README
View File

@ -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.)
----------