User Tools

Site Tools


getting_started:compile_eeros

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
getting_started:compile_eeros [2017/06/22 08:49] grafgetting_started:compile_eeros [2019/04/25 11:39] – [Compile Using a Script] graf
Line 12: Line 12:
 This will put all the executables into the build directory you have chosen and the compiled libraries together with the header files into the install directory.  This will put all the executables into the build directory you have chosen and the compiled libraries together with the header files into the install directory. 
  
-===== Compile with KDevelop ===== 
  
-After the source has been fetched click **Next**: 
- 
-{{:getting_started:compile_eeros_02_open_project.png|}} 
- 
-Select the **CMakeLists.txt** file and click **Next**: 
- 
-{{:getting_started:compile_eeros_03_project_name.png|}} 
- 
-Enter the name of the project in KDevelop and click **Finish**: 
- 
-{{:getting_started:compile_eeros_04_config.png|}} 
- 
-Enter the location where EEROS should be build into the field **Build Directory**. It is recommended that you name this folder //build-PROJECTNAME-ARCHITECTURE// (e.g. build-eeros-x86-64, build-eeros-armhf, build-eeros-ppc, ...). 
- 
-Enter the location where EEROS should be installed to into the filed **Installation Prefix**. If you want to install EEROS globally on the current system then leave this field empty. It is recommended that you specify a location and that you name it //install-ARCHITECTURE// (e.g. install-x86-64, install-armhf, install-ppc, ...). 
- 
-Do not forget to choose the build type. Per default it will be ''Debug''. Make sure to change to ''Release'' for maximum efficiency. 
- 
-Enter any additional CMake arguments into the field **Extra Arguments**. If you want to cross-compile EEROS enter the path to the toolchain file (e.g. -DCMAKE_TOOLCHAIN_FILE=path/to/toolchain-file.cmake). 
- 
-Click **OK** to configure CMake. Before we build EEROS, a stable version should be checked out: 
- 
-{{:getting_started:compile_eeros_04b_branches.png|}} 
- 
-Right-click the EEROS Project and select **Git** > **Branches**: 
- 
-{{:getting_started:compile_eeros_04c_checkout.png|}} 
- 
-Select the stable branch you like and click **Checkout**. Stable branches have the format STABLEVERSION.x (e.g. 0.4.x, 0.5.x, 1.0.x, ...). 
- 
-{{:getting_started:compile_eeros_05_build.png?200|}} 
- 
-Build EEROS by clicking on the **Build** button. 
- 
-{{:getting_started:compile_eeros_06_install.png?200|}} 
- 
-Install EEROS by right-clicking on the project and selecting **Install**. This last step will install the header files into the directory **include** and the compiled library into the directory **lib**. The directory **lib** will also contain some necessary cmake files to compile EEROS applications.   
  
 ===== Compile in terminal ===== ===== Compile in terminal =====
- 
-Clone the EEROS source repository: 
-<code> 
-$ cd path/to/working/directory 
-$ git clone https://github.com/eeros-project/eeros-framework.git 
-</code> 
- 
-Checkout a stable version of EEROS: 
-<code> 
-$ cd eeros-framework 
-$ git checkout v0.5 
-</code> 
- 
-Tags in the format vX.Y are stable releases. To show all tags execute the following command: 
-<code> 
-$ git tag 
-</code> 
- 
 Compile and install EEROS to a custom folder: Compile and install EEROS to a custom folder:
 <code> <code>
Line 86: Line 30:
 </code> </code>
  
 +
 +We recommend to not install EEROS globally on your system. However, if you want to install EEROS globally you have to execute the following commands:
 +<code>
 +$ mkdir build
 +$ cd build
 +$ cmake ..
 +$ make
 +# make install
 +</code>
 +The reason for not installing EEROS globally is that you might need two or even more versions of EEROS as soon as you compile for various target architectures. For this purpose we will install various versions of EEROS into custom folders named after the target architecture by setting the CMake variable CMAKE_INSTALL_PREFIX. 
 +
 +As soon as you access dedicated hardware on your system you have to install one of the [[getting_started:install_wrapper|]].