OP-1516 fixed boundf mistake

[librepilot.git] / make / winx86 / README.txt

This set of scripts is to provide a unix-like build environment on Windows.\r
---------------------------------------------------------------------------\r
\r
1. Why do I need it?\r
2. How to install?\r
3. How to use it?\r
3.1. Interactive mode\r
3.2. Batch mode\r
4. Advanced usage\r
5. Limitations of use\r
6. Credits and license\r
\r
\r
1. Why do I need it?\r
--------------------\r
It allows to use the "Big Hammer", that is, to build whole OpenPilot system\r
with a single command "make all" using the top level Makefile originally\r
written for Linux and Mac only.\r
\r
Also any routine task automation could use the same set of scripts and commands\r
on all platforms (Linux, Mac and Windows) if scripts are written in the shell\r
language. It is particularly important for cross-paltform projects like the\r
OpenPilot.\r
\r
\r
2. How to install?\r
------------------\r
Fortunately, it requires only few small text files since all others components\r
should already be installed on your system as parts of msysGit, QtSDK and\r
Arm compiler packages required to build the OpenPilot.\r
\r
It is expected that you have the following tools installed into the listed\r
locations (but any other locations are fine as well):\r
\r
 - Python            in C:\Python27\r
 - QtSDK             in C:\QtSDK (depending on SDK version)\r
 - CodeSourcery G++  in %ProgramFiles%\CodeSourcery\Sourcery G++ Lite\r
 - msysGit           in %ProgramFiles%\Git\r
 - Unicode NSIS      in %ProgramFiles%\NSIS\Unicode\r
 - OpenOCD           in C:\OpenOCD\0.4.0\bin (optional)\r
\r
The SDL and SSL libraries and headers should be installed into Qt directories to \r
build the GCS. Check the wiki or ground/openpilotgcs/copydata.pro for details.\r
\r
Also it is assumed that you have the C:\Program Files\Git\cmd\ directory in\r
the PATH. Usually this is the case for msysGit installation if you have chosen\r
the 2nd option: put only git and gitk in the PATH (it is recommended option).\r
\r
Now you need to copy few files to your msysGit installation folders.\r
Assuming that you installed the msysGit into C:\Program Files\Git\,\r
you have to copy:\r
\r
   make\winx86\bin\*  ->  C:\Program Files\Git\bin\\r
   make\winx86\cmd\*  ->  C:\Program Files\Git\cmd\\r
\r
If you have msysGit installed into another directory, you need to update paths\r
accordingly. Also if you have tools installed into different directories and\r
they are not in the PATH, then you may want to update paths in the sh.cmd\r
script too (it is self-documented).\r
\r
Note for Windows 64-bit users: 64-bit systems use %ProgramFiles(x86)% folder\r
as default for program files instead of %ProgramFiles%. You have to check where\r
your tools are installed and update paths above accordingly.\r
\r
\r
3. How to use it?\r
-----------------\r
\r
3.1. Interactive mode\r
---------------------\r
\r
1) Type:\r
\r
   C:\> sh\r
\r
and the bash prompt should appear:\r
\r
   user@pc /\r
   $\r
\r
2) Enter your OpenPilot directory:\r
\r
   user@pc /\r
   $ cd D:/Work/OpenPilot/git\r
\r
   user@pc /d/Work/OpenPilot/git (master)\r
   $\r
\r
Note the current git branch in parentheses (master), if it exists. The path\r
format is also printed according to MSYS notation. And you have to use forward\r
slashes in paths, not backslashes.\r
\r
3) Enter make command with required options and target list:\r
\r
   user@pc /d/Work/OpenPilot/git (master)\r
   $ make all\r
\r
The building should be started, and you will have full system including ground\r
software and flight firmware built in the end.\r
\r
4) To build parts of the system you can use, for example, such commands:\r
\r
   user@pc /d/Work/OpenPilot/git (master)\r
   $ make -j2 GCS_BUILD_CONF=release gcs coptercontrol\r
\r
or to completely remove the build directory:\r
\r
   user@pc /d/Work/OpenPilot/git (master)\r
   $ make all_clean\r
\r
\r
3.2. Batch mode\r
---------------\r
\r
1) Create a shell script file containing all required commands, for instance:\r
\r
   #!/bin/sh\r
   # This is the cc_make_release.sh file used to build CC release software\r
   cd D:/Work/OpenPilot/git\r
   make -j2 GCS_BUILD_CONF=release gcs coptercontrol\r
   echo RC=$?\r
\r
2) Run it typing:\r
\r
   C:\> sh cc_make_release.sh\r
\r
3) Of course, a lot of other shell commands can be used in scripts.\r
\r
\r
4. Advanced usage\r
-----------------\r
\r
It is possible to go further and integrate shell scripting into Windows system\r
like any other executables. This allows:\r
\r
 - double click on any .sh file in the Explorer window to execute it;\r
 - type name of .sh file with any arguments on the command line to run script;\r
 - omit .sh extension typing names since it is now recognized automatically;\r
 - call .sh scripts even from .bat and .cmd files as Windows command;\r
 - execute scripts which are in any directory in the PATH;\r
 - return and check exit code from .sh scripts to .bat or .cmd batch files.\r
\r
In short, you may have quite powerful and cross-platform bash scripting on\r
Windows.\r
\r
In order to integrate bash scripting into Windows system you need to:\r
\r
 - double click on the included shell_script.reg file to register .sh\r
   extension in the system. Thus, any click on .sh script will execute it\r
   automatically assuming that the sh.cmd is in the PATH;\r
 - register .sh extension as an executable file type, so you can omit the\r
   .sh typing commands. To do so open "My Computer" properties dialog, choose\r
   the "Advanced" tab, "Environment variables", in the "System variables"\r
   find the variable called "PATHEXT". It contains the list of "executable"\r
   file extensions separated by semicolon. You want to add a ";.SH" to the\r
   end of its value. Then click OK to apply.\r
\r
Now any .sh script can be run just by typing its name, optionally with\r
parameters.\r
\r
As an example, you can create a shell script named make.sh in the cmd/\r
subdirectory of Git installation with the following content:\r
\r
   exec /bin/make $*\r
\r
and then build the OpenPilot software typing\r
\r
   make all\r
\r
directly from Windows command line or from a batch file.\r
\r
You also may want to rename or remove "C:\Program Files\Git\etc\motd" file\r
to get rid of git bash welcome message on every script invocation.\r
\r
\r
5. Limitations of use\r
---------------------\r
\r
Currently there may be some problems running scripts which contain spaces in\r
file names or located in directories which contain spaces in full paths.\r
It results in strange "file not found" or other errors.\r
\r
It is recommended to avoid using such names with spaces.\r
\r
\r
6. Credits and license\r
----------------------\r
\r
This set of scripts uses the MSYS package included into the msysGit\r
distribution and MinGW make included into the QtSDK package.\r
\r
The sh.cmd, shell_script.reg and this README.txt files were written\r
by Oleg Semyonov (os@openpilot.org) for the OpenPilot project and\r
are licensed under CC-BY-SA terms:\r
\r
    http://creativecommons.org/licenses/by-sa/3.0/\r
\r
Feel free to contact me for additions and improvements.\r
\r
Happy bashing!\r