AI/rocm-systems
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update install instructions (#759)

Browse Source 
- `amdgpu-install` is no longer recommended. Link to separate driver
installation docs.
- add verify step
- update readme
- add package info

Signed-off-by: Park, Peter <Peter.Park@amd.com>

[ROCm/amdsmi commit: 12fb58c30b]
This commit is contained in:
Park, Peter
2025-10-28 10:59:11 -04:00
committed by GitHub
parent fee59b2c58
commit e8d06cc0d6
2 changed files with 38 additions and 74 deletions
Download Patch File Download Diff File Expand all files Collapse all files
projects/amdsmi/README.md
+1 -46
View File
@@ -30,7 +30,7 @@ for more information.
The following are required to install and use the AMD SMI library through its language interfaces and CLI.
* `amdgpu` driver must be loaded for [`amdsmi_init()`](./docs/how-to/amdsmi-cpp-lib#hello-amd-smi) to work.
* `amdgpu` driver must be loaded for [`amdsmi_init()`](./docs/how-to/amdsmi-cpp-lib#hello-amd-smi) to work. Refer to the [Instinct documentation](https://instinct.docs.amd.com/projects/amdgpu-docs/en/latest/install/detailed-install/prerequisites.html) for installation instructions.
* Export `LD_LIBRARY_PATH` to the `amdsmi` installation directory.
```bash
@@ -51,51 +51,6 @@ sudo python3 -m pip install more_itertools
* Go version 1.20 or greater
## Install amdgpu driver and AMD SMI with ROCm
1. Get the `amdgpu-install` installer following the instructions for your Linux distribution at
[Installation via AMDGPU installer](https://rocm.docs.amd.com/projects/install-on-linux/en/latest/install/amdgpu-install.html#installation).
2. Use `amdgpu-install` to install the `amdgpu` driver and ROCm packages with
AMD SMI included.
``` shell
sudo amdgpu-install --usecase=rocm
```
The `amdgpu-install --usecase=rocm` option triggers both an `amdgpu` driver
update and AMD SMI packages to be installed on your device.
3. Verify your installation.
```shell
amd-smi --help
```
## Install AMD SMI without ROCm
The following are example steps to install the AMD SMI libraries and CLI tool on
Ubuntu 22.04.
1. Install the library.
```shell
sudo apt install amd-smi-lib
```
2. Add the installation directory to your PATH. If installed with ROCm, ignore
this step.
```shell
export PATH="${PATH:+${PATH}:}~/opt/rocm/bin"
```
3. Verify your installation.
```shell
amd-smi --help
```
## AMD SMI basic usage
### C++ library