ROCm/HIP 项目使用教程

1. 项目目录结构及介绍

HIP/
├── bin/
│   └── hipcc  # HIP 编译器
├── cmake/
│   └── FindHIP.cmake  # CMake 配置文件
├── docs/
│   └── README.md  # 项目文档
├── include/
│   ├── hip/  # HIP 头文件
│   └── hcc/  # HCC 头文件
├── lib/
│   └── libhip_hcc.so  # HIP 库文件
├── samples/
│   ├── 0_Intro/  # 示例代码
│   └── 1_Utils/  # 工具代码
├── tests/
│   └── hipTest.cpp  # 测试代码
└── README.md  # 项目介绍

目录结构介绍

• bin/: 包含 HIP 编译器 hipcc，用于编译 HIP 代码。
• cmake/: 包含 CMake 配置文件 FindHIP.cmake，用于在 CMake 项目中集成 HIP。
• docs/: 包含项目的文档，主要是 README.md。
• include/: 包含 HIP 和 HCC 的头文件，分别位于 hip/ 和 hcc/ 目录下。
• lib/: 包含 HIP 的库文件 libhip_hcc.so。
• samples/: 包含示例代码，分为 0_Intro/ 和 1_Utils/ 两个子目录。
• tests/: 包含测试代码 hipTest.cpp。
• README.md: 项目的主介绍文件。

2. 项目启动文件介绍

hipcc

hipcc 是 HIP 项目的编译器，位于 bin/ 目录下。它用于将 HIP 代码编译为可执行文件或库文件。使用方法如下：

hipcc -o my_program my_program.cpp

README.md

README.md 是项目的启动文件，位于项目根目录下。它包含了项目的介绍、安装方法、使用说明等重要信息。建议在开始使用项目前仔细阅读该文件。

3. 项目的配置文件介绍

FindHIP.cmake

FindHIP.cmake 是 CMake 的配置文件，位于 cmake/ 目录下。它用于在 CMake 项目中查找并配置 HIP 库。使用方法如下：

find_package(HIP REQUIRED)
include_directories(${HIP_INCLUDE_DIRS})
target_link_libraries(my_target ${HIP_LIBRARIES})

libhip_hcc.so

libhip_hcc.so 是 HIP 的库文件，位于 lib/ 目录下。它包含了 HIP 的核心功能实现，是 HIP 项目的关键组成部分。

示例代码

samples/ 目录下包含了多个示例代码，可以帮助用户快速上手 HIP 项目。建议从 0_Intro/ 目录开始学习。

cd samples/0_Intro
hipcc -o intro_example intro_example.cpp
./intro_example

通过以上步骤，您可以快速了解并开始使用 ROCm/HIP 项目。