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:
parent
366f6c9276
commit
4e4e95d69f
47
README
47
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)
|
- git (needed for some compilation info)
|
||||||
- cmake
|
- cmake
|
||||||
- gcc-core
|
- gcc-core
|
||||||
|
- gcc-g++
|
||||||
- libusb1.0
|
- libusb1.0
|
||||||
- libusb1.0-devel
|
- 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:
|
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"
|
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.
|
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/
|
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.
|
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
|
Linux Loading Firmware
|
||||||
----------------------
|
----------------------
|
||||||
|
|
||||||
The 'load' script that is created during the build can load the firmware over USB.
|
First place the keyboard into re-flash mode.
|
||||||
It uses sudo, so make sure you have the priviledges.
|
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
|
./load
|
||||||
|
|
||||||
|
|
||||||
@ -312,7 +328,18 @@ Example output:
|
|||||||
Windows Loading Firmware
|
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
|
Mac OS X Building
|
||||||
@ -320,6 +347,8 @@ Mac OS X Building
|
|||||||
|
|
||||||
TODO
|
TODO
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
----------------------
|
----------------------
|
||||||
Mac OS X Loading Firmware
|
Mac OS X Loading Firmware
|
||||||
----------------------
|
----------------------
|
||||||
@ -327,6 +356,7 @@ Mac OS X Loading Firmware
|
|||||||
TODO
|
TODO
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
----------------------
|
----------------------
|
||||||
Virtual Serial Port - CLI
|
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.
|
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)
|
This allows for you to use a generic serial terminal to debug/control the keyboard firmware (e.g. Tera Term, minicom, screen)
|
||||||
|
|
||||||
|
|
||||||
-------
|
-------
|
||||||
| Linux |
|
| Linux |
|
||||||
-------
|
-------
|
||||||
|
|
||||||
I generally use screen.
|
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 |
|
| 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.)
|
||||||
|
|
||||||
|
|
||||||
----------
|
----------
|
||||||
|
Reference in New Issue
Block a user