| .. _installing_zephyr_win: |
| |
| Development Environment Setup on Windows |
| ######################################## |
| |
| This section describes how to configure your development environment and |
| to build Zephyr applications in a Microsoft Windows environment. |
| |
| This guide was tested by compiling and running the Zephyr's sample |
| applications on the following Windows version: |
| |
| * Windows 8.1 |
| |
| Update Your Operating System |
| **************************** |
| |
| Before proceeding with the build, ensure that you are running your |
| Windows system with the latest updates installed. |
| |
| .. _windows_requirements: |
| |
| Installing Requirements and Dependencies |
| **************************************** |
| |
| To install the software components required to build Zephyr applications on |
| Windows, you will need to build or install a toolchain. |
| |
| Install :program:`GIT`. Go to `GIT Download`_ to obtain the latest copy of |
| the software. |
| |
| Install :program:`Python 2.7`. Go to `Python Download`_ to obtain the 2.7 |
| version of the software. |
| |
| Install :program:`MinGW`. MinGW is the minimalist GNU development environment |
| for native Windows applications. The Zephyr build system will execute on top of |
| this tool set. |
| |
| To install :program:`MinGW`, visit the site `MinGW Home`_ and install the |
| following packages with their installler `mingw-get-setup.exe`: |
| |
| * mingw-developer-toolkit |
| * mingw32-base |
| * msys-base |
| * msys-binutils |
| * msys-console |
| * msys-w32api |
| |
| Launch the `MSYS console`. The installer does not create shortcuts for you, |
| but the script to launch it is in :file:`C:\MinGW\msys\1.0\msys.bat.`. |
| We need the following line in :file:`/etc/fstab`: |
| |
| .. code-block:: console |
| |
| #Win32_Path Mount_Point |
| c:/mingw /mingw |
| |
| The easiest way to do this is just copy the file :file:`fstab.sample` as |
| :file:`fstab` and confirm that the these lines are in the new |
| :file:`fstab` file. |
| |
| .. code-block:: console |
| |
| $ cp /etc/fstab.sample /etc/fstab |
| $ cat /etc/fstab |
| |
| Configure Python's folder location in the environmental variable :envvar:`PATH`. |
| |
| .. code-block:: console |
| |
| export PATH=$PATH:${PYTHON_PATH} |
| |
| .. note:: The format of the path for this variable (PYTHON_PATH) must to be in |
| the linux format. For example, :file:`C:\python27` would be written as |
| :file:`/c/python27/`. |
| |
| GNU Regex C library |
| =================== |
| |
| The Zephyr build process has a dependency with the GNU regex library. |
| Msys provides its own GNU library implementation that can be downloaded from the |
| MinGW and Msys official repository:`MinGW Repository`_. |
| Install the library from the Msys console interface and add the library to the |
| tools build proccess with the following commands: |
| |
| .. code-block:: console |
| |
| mingw-get update |
| mingw-get install msys-libregex-dev --all-related |
| export HOST_LOADLIBES=-lregex |
| |
| Toolchain Installation |
| ====================== |
| |
| The build system should be able to work with any toolchain installed in your system. |
| |
| For instance, the Zephyr build system was tested with the toolchain provided with |
| the ISSM 2016 (Intel System Studio for Microcontrollers) installation. |
| |
| To install ISSM use the link provided to download from the Intel Developer Zone: |
| `ISSM 2016 Download`_ and install it into your system. |
| |
| Finally, configure your environment variables for the ISSM 2016 toolchain. |
| For example, using the default installation path for ISSM: |
| :file:`/c/IntelSWTools/ISSM_2016.0.27/tools/compiler` |
| |
| .. code-block:: console |
| |
| export ZEPHYR_GCC_VARIANT=iamcu |
| export IAMCU_TOOLCHAIN_PATH=/c/IntelSWTools/ISSM_2016.0.27/tools/compiler |
| |
| .. note:: The format of the location for the toolchain installation directory |
| (e.g. :envvar:`IAMCU_TOOLCHAIN_PATH`) must be in the linux format. E.g. |
| :file:`C:\toolchain` would be written as :file:`/c/toolchain/`. |
| |
| .. _GIT Download: https://git-scm.com/download/win |
| .. _Python Download: https://www.python.org/downloads/ |
| .. _MinGW Home: http://www.mingw.org/ |
| .. _MinGW Repository: http:sourceforge.net/projects/mingw/files/ |
| .. _ISSM 2016 Download: https://software.intel.com/en-us/intel-system-studio-microcontrollers |