SWDEV-288929 - update hipamd document

Change-Id: I638afb4c7f0b96df3f0c1cc0b3bf04ab57692d27


[ROCm/clr commit: 70e18827a6]

projects/clr/hipamd/README.md

@@ -1,21 +1,23 @@
 ## What is this repository for? ###
 
-**This repository provides implementation of [HIP](https://github.com/ROCm-Developer-Tools/HIP) for AMD GPUs.**
+This repository provides [HIP](https://github.com/ROCm-Developer-Tools/HIP) implementation specifically for AMD platform.
 
-© 201 Advanced Micro Devices, Inc. All Rights Reserved.
+## DISCLAIMER
+
+The information contained herein is for informational purposes only, and is subject to change without notice. In addition, any stated support is planned and is also subject to change. While every precaution has been taken in the preparation of this document, it may contain technical inaccuracies, omissions and typographical errors, and AMD is under no obligation to update or otherwise correct this information. Advanced Micro Devices, Inc. makes no representations or warranties with respect to the accuracy or completeness of the contents of this document, and assumes no liability of any kind, including the implied warranties of noninfringement, merchantability or fitness for particular purposes, with respect to the operation or use of AMD hardware, software or other products described herein. No license, including implied or arising by estoppel, to any intellectual property rights is granted by this document. Terms and limitations applicable to the purchase or use of AMD’s products are as set forth in a signed agreement between the parties or in AMD's Standard Terms and Conditions of Sale.
+
+© 2020 Advanced Micro Devices, Inc. All Rights Reserved.
 
 ## Repository branches:
 
 The hipamd repository maintains several branches. The branches that are of importance are:
 
-* Main branch: This is the stable branch. It is up to date with the latest release branch, for example, if the latest HIP release is rocm-4.3, main branch will be the repository based on this release.
+* Main branch: This is the stable branch. It is up to date with the latest release branch, for example, if the latest HIP release is rocm-4.4, main branch will be the repository based on this release.
 * Release branches. These are branches corresponding to each ROCM release, listed with release tags, such as rocm-4.4, etc.
 
 ## Release tagging:
 
 hipamd releases are typically naming convention for each ROCM release to help differentiate them.
 
-* rocm x.yy: These are the stable releases based on the ROCM release. 
-  This type of release is typically made once a month.*
-
-
+* rocm x.yy: These are the stable releases based on the ROCM release.
+  This type of release is typically made once a month.*

projects/clr/hipamd/install.md

@@ -0,0 +1,38 @@
+## Prerequisites
+
+-   Install mesa-common-dev
+-   Either build or install [COMGR](https://github.com/RadeonOpenCompute/ROCm-CompilerSupport), [CLANG](https://github.com/RadeonOpenCompute/llvm-project) and [Device Library](https://github.com/RadeonOpenCompute/ROCm-Device-Libs)
+
+## Getting the source code
+
+```bash
+git clone -b rocm-4.4.x https://github.com/ROCm-Developer-Tools/hipamd.git
+git clone -b rocm-4.4.x https://github.com/ROCm-Developer-Tools/hip.git
+git clone -b rocm-4.4.x https://github.com/ROCm-Developer-Tools/ROCclr.git
+git clone -b rocm-4.4.x https://github.com/RadeonOpenCompute/ROCm-OpenCL-Runtime.git
+```
+
+## Set the environment variables
+
+```bash
+export HIPAMD_DIR="$(readlink -f hipamd)"
+export HIP_DIR="$(readlink -f hip)"
+export ROCclr_DIR="$(readlink -f ROCclr)"
+export OPENCL_DIR="$(readlink -f ROCm-OpenCL-Runtime)"
+```
+
+## Build AMDHIP
+Commands to build amdhip are as following,
+
+```bash
+cd "$HIPAMD_DIR"
+mkdir -p build; cd build
+cmake -DHIP_COMMON_DIR=$HIP_DIR -DAMD_OPENCL_PATH=$OPENCL_DIR -DROCCLR_PATH=$ROCCLR_DIR -DCMAKE_PREFIX_PATH="/opt/rocm/" -DCMAKE_INSTALL_PREFIX=$PWD/install ..
+make -j$(nproc)
+sudo make install
+```
+
+Note,
+HIP_COMMON_DIR looks for hip common source codes.
+By default, release version of AMDHIP is built.
+