Archived
1
0

Updating README for Windows.

- Updated Windows build instructions
- Added some notes on all the types of builds.
- Updated dependency lists
This commit is contained in:
Jacob Alexander 2014-09-15 18:45:01 -07:00
parent 66a5031c4c
commit 549b67e518

35
README
View File

@ -1,7 +1,20 @@
The Kiibohd Controller
----------------------
TODO, write some insightful/informative :P
This README is a bit long, just look at the sections you are interested in.
Linux is the ideal build environment (preferably recent'ish).
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.
Please give authors credit for modules used if you use in a distributed product :D
@ -15,6 +28,11 @@ 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)
@ -47,14 +65,16 @@ First make sure Cygwin is installed - http://www.cygwin.com/ - 32bit or 64bit is
- 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
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:
echo "alias wincmake=\"PATH='/cygdrive/c/Program Files (x86)/CMake 2.8'/bin:\"${PATH}\" cmake" >> ~/.bashrc
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)
@ -62,6 +82,7 @@ Install the PJRC Virtual Serial Port Driver:
Next, install the compiler(s) you want.
---------
| AVR GCC |
---------
@ -71,8 +92,8 @@ You just need the Atmel AVR 8-bit Toolchain. The latest should be fine, as of wr
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).
@ -89,7 +110,9 @@ 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.
Then copy all the folders/files installed (e.g. C:\Users\Haata\MentorGraphics\Sourcery_CodeBench_Lite_for_ARM_EABI\) to Cygwin /usr/local directory.
Mine is C:\cygwin64\usr\local.
Or, you can setup paths using the installer (you have to be more careful though).