1Green Hills MULTI
2-----------------
3
4.. versionadded:: 3.3
5
6.. versionadded:: 3.15
7  Linux support.
8
9Generates Green Hills MULTI project files (experimental, work-in-progress).
10
11Customizations are available through the following cache variables:
12
13* ``GHS_CUSTOMIZATION``
14* ``GHS_GPJ_MACROS``
15
16.. versionadded:: 3.14
17  The buildsystem has predetermined build-configuration settings that can be controlled
18  via the :variable:`CMAKE_BUILD_TYPE` variable.
19
20Toolset and Platform Selection
21^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
22
23.. versionadded:: 3.13
24
25Customizations that are used to pick toolset and target system:
26
27* The ``-A <arch>`` can be supplied for setting the target architecture.
28  ``<arch>`` usually is one of ``arm``, ``ppc``, ``86``, etcetera.
29  If the target architecture is not specified then
30  the default architecture of ``arm`` will be used.
31
32* The ``-T <toolset>`` option can be used to set the directory location of the toolset.
33  Both absolute and relative paths are valid. Relative paths use ``GHS_TOOLSET_ROOT``
34  as the root. If the toolset is not specified then the latest toolset found in
35  ``GHS_TOOLSET_ROOT`` will be used.
36
37Cache variables that are used for toolset and target system customization:
38
39* ``GHS_TARGET_PLATFORM``
40
41  | Defaults to ``integrity``.
42  | Usual values are ``integrity``, ``threadx``, ``uvelosity``, ``velosity``,
43    ``vxworks``, ``standalone``.
44
45* ``GHS_PRIMARY_TARGET``
46
47  | Sets ``primaryTarget`` entry in project file.
48  | Defaults to ``<arch>_<GHS_TARGET_PLATFORM>.tgt``.
49
50* ``GHS_TOOLSET_ROOT``
51
52  | Root path for ``toolset`` searches.
53  | Defaults to ``C:/ghs`` in Windows or ``/usr/ghs`` in Linux.
54
55* ``GHS_OS_ROOT``
56
57  | Root path for RTOS searches.
58  | Defaults to ``C:/ghs`` in Windows or ``/usr/ghs`` in Linux.
59
60* ``GHS_OS_DIR`` and ``GHS_OS_DIR_OPTION``
61
62  | Sets ``-os_dir`` entry in project file.
63  | Defaults to latest platform OS installation at ``GHS_OS_ROOT``.  Set this value if
64    a specific RTOS is to be used.
65  | ``GHS_OS_DIR_OPTION`` default value is ``-os_dir``.
66
67  .. versionadded:: 3.15
68    The ``GHS_OS_DIR_OPTION`` variable.
69
70* ``GHS_BSP_NAME``
71
72  | Sets ``-bsp`` entry in project file.
73  | Defaults to ``sim<arch>`` for ``integrity`` platforms.
74
75Target Properties
76^^^^^^^^^^^^^^^^^
77
78.. versionadded:: 3.14
79
80The following properties are available:
81
82* :prop_tgt:`GHS_INTEGRITY_APP`
83* :prop_tgt:`GHS_NO_SOURCE_GROUP_FILE`
84
85.. note::
86  This generator is deemed experimental as of CMake |release|
87  and is still a work in progress.  Future versions of CMake
88  may make breaking changes as the generator matures.
89