summaryrefslogtreecommitdiff
path: root/Help/manual/cmake-toolchains.7.rst
diff options
context:
space:
mode:
authorPascal Bach <pascal.bach@siemens.com>2014-09-19 12:58:02 +0200
committerBrad King <brad.king@kitware.com>2014-09-19 13:18:31 -0400
commitdb54d872874407c81690794e274cb4b88c64872b (patch)
tree04d7c862cee15527fd9fa6a74518b2ae045fd61b /Help/manual/cmake-toolchains.7.rst
parent0d72451a054ea1e6d2b479b8a59d864317236fdf (diff)
downloadcmake-db54d872874407c81690794e274cb4b88c64872b.tar.gz
Help: Add Windows CE cross-compiling to cmake-toolchains.7 manual
Diffstat (limited to 'Help/manual/cmake-toolchains.7.rst')
-rw-r--r--Help/manual/cmake-toolchains.7.rst26
1 files changed, 26 insertions, 0 deletions
diff --git a/Help/manual/cmake-toolchains.7.rst b/Help/manual/cmake-toolchains.7.rst
index bb96da3ec5..858499a1f8 100644
--- a/Help/manual/cmake-toolchains.7.rst
+++ b/Help/manual/cmake-toolchains.7.rst
@@ -192,3 +192,29 @@ value to those supported compilers when compiling:
set(CMAKE_C_COMPILER_TARGET ${arch})
set(CMAKE_CXX_COMPILER QCC)
set(CMAKE_CXX_COMPILER_TARGET ${arch})
+
+Cross Compiling for Windows CE
+------------------------------
+
+Cross compiling for Windows CE requires the corresponding SDK being
+installed on your system. These SDKs are usually installed under
+``C:/Program Files (x86)/Windows CE Tools/SDKs``.
+
+A toolchain file to configure a Visual Studio generator for
+Windows CE may look like this:
+
+.. code-block:: cmake
+
+ set(CMAKE_SYSTEM_NAME WindowsCE)
+
+ set(CMAKE_SYSTEM_VERSION 8.0)
+ set(CMAKE_SYSTEM_PROCESSOR arm)
+
+ set(CMAKE_GENERATOR_TOOLSET CE800) # Can be omitted for 8.0
+ set(CMAKE_GENERATOR_PLATFORM SDK_AM335X_SK_WEC2013_V310)
+
+The :variable:`CMAKE_GENERATOR_PLATFORM` tells the generator which SDK to use.
+Further :variable:`CMAKE_SYSTEM_VERSION` tells the generator what version of
+Windows CE to use. Currently version 8.0 (Windows Embedded Compact 2013) is
+supported out of the box. Other versions may require one to set
+:variable:`CMAKE_GENERATOR_TOOLSET` to the correct value.