[PATCH 1/2] drm/amd/doc: Add XGMI sysfs documentation

[Alex Deucher]

On Fri, May 24, 2019 at 9:23 AM StDenis, Tom <Tom.StDenis at amd.com> wrote:
>
> Signed-off-by: Tom St Denis <tom.stdenis at amd.com>

Series is:
Reviewed-by: Alex Deucher <alexander.deucher at amd.com>

> ---
>  Documentation/gpu/amdgpu.rst             |  9 ++++++++
>  drivers/gpu/drm/amd/amdgpu/amdgpu_xgmi.c | 28 ++++++++++++++++++++++++
>  2 files changed, 37 insertions(+)
>
> diff --git a/Documentation/gpu/amdgpu.rst b/Documentation/gpu/amdgpu.rst
> index a740e491dfcc..cacfcfad2356 100644
> --- a/Documentation/gpu/amdgpu.rst
> +++ b/Documentation/gpu/amdgpu.rst
> @@ -70,6 +70,15 @@ Interrupt Handling
>  .. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_irq.c
>     :internal:
>
> +AMDGPU XGMI Support
> +===================
> +
> +.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_xgmi.c
> +   :doc: AMDGPU XGMI Support
> +
> +.. kernel-doc:: drivers/gpu/drm/amd/amdgpu/amdgpu_xgmi.c
> +   :internal:
> +
>  GPU Power/Thermal Controls and Monitoring
>  =========================================
>
> diff --git a/drivers/gpu/drm/amd/amdgpu/amdgpu_xgmi.c b/drivers/gpu/drm/amd/amdgpu/amdgpu_xgmi.c
> index e48e9394f1e4..d11eba09eadd 100644
> --- a/drivers/gpu/drm/amd/amdgpu/amdgpu_xgmi.c
> +++ b/drivers/gpu/drm/amd/amdgpu/amdgpu_xgmi.c
> @@ -40,6 +40,34 @@ void *amdgpu_xgmi_hive_try_lock(struct amdgpu_hive_info *hive)
>         return &hive->device_list;
>  }
>
> +/**
> + * DOC: AMDGPU XGMI Support
> + *
> + * XGMI is a high speed interconnect that joins multiple GPU cards
> + * into a homogeneous memory space that is organized by a collective
> + * hive ID and individual node IDs, both of which are 64-bit numbers.
> + *
> + * The file xgmi_device_id contains the unique per GPU device ID and
> + * is stored in the /sys/class/drm/card${cardno}/device/ directory.
> + *
> + * Inside the device directory a sub-directory 'xgmi_hive_info' is
> + * created which contains the hive ID and the list of nodes.
> + *
> + * The hive ID is stored in:
> + *   /sys/class/drm/card${cardno}/device/xgmi_hive_info/xgmi_hive_id
> + *
> + * The node information is stored in numbered directories:
> + *   /sys/class/drm/card${cardno}/device/xgmi_hive_info/node${nodeno}/xgmi_device_id
> + *
> + * Each device has their own xgmi_hive_info direction with a mirror
> + * set of node sub-directories.
> + *
> + * The XGMI memory space is built by contiguously adding the power of
> + * two padded VRAM space from each node to each other.
> + *
> + */
> +
> +
>  static ssize_t amdgpu_xgmi_show_hive_id(struct device *dev,
>                 struct device_attribute *attr, char *buf)
>  {
> --
> 2.21.0
>
> _______________________________________________
> amd-gfx mailing list
> amd-gfx at lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/amd-gfx