[samples] Adds a sample that shows using HIP with cmake

Change-Id: Ief983ea0894d7b5d1ea46a755f9134dda0a1bb8f

samples/2_Cookbook/12_cmake_hip_add_executable/Readme.md

@@ -0,0 +1,53 @@
+## hip_add_executable ###
+This tutorial shows how to use the FindHIP cmake module and create an executable using ```hip_add_executable``` macro.
+
+## Including FindHIP cmake module in the project
+Since FindHIP cmake module is not yet a part of the default cmake distribution, ```CMAKE_MODULE_PATH``` needs to be updated to contain the path to FindHIP.cmake.
+
+The simplest approach is to use
+```
+set(CMAKE_MODULE_PATH "/opt/rocm/hip/cmake" ${CMAKE_MODULE_PATH})
+find_package(HIP)
+```
+
+A more generic solution that allows for a user specified location for the HIP installation would look something like
+```
+if(NOT DEFINED HIP_PATH)
+    if(NOT DEFINED ENV{HIP_PATH})
+        set(HIP_PATH "/opt/rocm/hip" CACHE PATH "Path to which HIP has been installed")
+    else()
+        set(HIP_PATH $ENV{HIP_PATH} CACHE PATH "Path to which HIP has been installed")
+    endif()
+endif()
+set(CMAKE_MODULE_PATH "${HIP_PATH}/cmake" ${CMAKE_MODULE_PATH})
+find_package(HIP)
+```
+
+If your project already modifies ```CMAKE_MODULE_PATH```, you will need to append the path to FindHIP.cmake instead of replacing it.
+
+## Using the hip_add_executable macro
+FindHIP provides the ```hip_add_executable``` macro that is similar to the ```cuda_add_executable``` macro that is provided by FindCUDA.
+The syntax is also similar. The ```hip_add_executable``` macro uses the hipcc wrapper as the compiler.
+The macro supports specifying HCC-specific, NVCC-specific compiler options using the ```HCC_OPTIONS``` and ```NVCC_OPTIONS``` keywords.
+Common options targeting both compilers can be specificed after the ```HIPCC_OPTIONS``` keyword. 
+
+## How to build and run:
+Use the following commands to build and execute the sample
+
+```
+mkdir build
+cd build
+cmake ..
+make
+./MatrixTranspose
+```
+
+## More Info:
+- [HIP FAQ](https://github.com/ROCm-Developer-Tools/HIP/docs/markdown/hip_faq.md)
+- [HIP Kernel Language](https://github.com/ROCm-Developer-Tools/HIP/docs/markdown/hip_kernel_language.md)
+- [HIP Runtime API (Doxygen)](http://rocm-developer-tools.github.io/HIP)
+- [HIP Porting Guide](https://github.com/ROCm-Developer-Tools/HIP/docs/markdown/hip_porting_guide.md)
+- [HIP Terminology](https://github.com/ROCm-Developer-Tools/HIP/docs/markdown/hip_terms.md) (including Rosetta Stone of GPU computing terms across CUDA/HIP/HC/AMP/OpenL)
+- [hipify-clang](https://github.com/ROCm-Developer-Tools/HIP/hipify-clang/README.md)
+- [Developer/CONTRIBUTING Info](https://github.com/ROCm-Developer-Tools/HIP/CONTRIBUTING.md)
+- [Release Notes](https://github.com/ROCm-Developer-Tools/HIP/RELEASE.md)