[PATCH 29/88] drm/amdgpu: add amdgpu uapi header (v4)

Alex Deucher alexdeucher at gmail.com
Mon Jun 8 19:51:32 PDT 2015


On Fri, Jun 5, 2015 at 2:57 PM, Jerome Glisse <j.glisse at gmail.com> wrote:
> On Tue, May 26, 2015 at 11:19:31PM -0400, Alex Deucher wrote:
>> This header defines the ioctl interface to the driver.
>>
>> v2: remove stale tiling defines
>> v3: add appropriate padding
>> v4: remove executable bits on header
>>
>> Acked-by: Christian K├Ânig <christian.koenig at amd.com>
>> Acked-by: Jammy Zhou <Jammy.Zhou at amd.com>
>> Signed-off-by: Alex Deucher <alexander.deucher at amd.com>
>> ---
>>  include/uapi/drm/amdgpu_drm.h | 590 ++++++++++++++++++++++++++++++++++++++++++
>>  1 file changed, 590 insertions(+)
>>  create mode 100644 include/uapi/drm/amdgpu_drm.h
>>
>> diff --git a/include/uapi/drm/amdgpu_drm.h b/include/uapi/drm/amdgpu_drm.h
>> new file mode 100644
>> index 0000000..9e771fb
>> --- /dev/null
>> +++ b/include/uapi/drm/amdgpu_drm.h
>> @@ -0,0 +1,590 @@
>> +/* amdgpu_drm.h -- Public header for the amdgpu driver -*- linux-c -*-
>> + *
>> + * Copyright 2000 Precision Insight, Inc., Cedar Park, Texas.
>> + * Copyright 2000 VA Linux Systems, Inc., Fremont, California.
>> + * Copyright 2002 Tungsten Graphics, Inc., Cedar Park, Texas.
>> + * Copyright 2014 Advanced Micro Devices, Inc.
>> + *
>> + * Permission is hereby granted, free of charge, to any person obtaining a
>> + * copy of this software and associated documentation files (the "Software"),
>> + * to deal in the Software without restriction, including without limitation
>> + * the rights to use, copy, modify, merge, publish, distribute, sublicense,
>> + * and/or sell copies of the Software, and to permit persons to whom the
>> + * Software is furnished to do so, subject to the following conditions:
>> + *
>> + * The above copyright notice and this permission notice shall be included in
>> + * all copies or substantial portions of the Software.
>> + *
>> + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
>> + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
>> + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
>> + * THE COPYRIGHT HOLDER(S) OR AUTHOR(S) BE LIABLE FOR ANY CLAIM, DAMAGES OR
>> + * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
>> + * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
>> + * OTHER DEALINGS IN THE SOFTWARE.
>> + *
>> + * Authors:
>> + *    Kevin E. Martin <martin at valinux.com>
>> + *    Gareth Hughes <gareth at valinux.com>
>> + *    Keith Whitwell <keith at tungstengraphics.com>
>> + */
>> +
>> +#ifndef __AMDGPU_DRM_H__
>> +#define __AMDGPU_DRM_H__
>> +
>> +#include <drm/drm.h>
>> +
>> +#define DRM_AMDGPU_GEM_CREATE                0x00
>> +#define DRM_AMDGPU_GEM_MMAP          0x01
>> +#define DRM_AMDGPU_CTX                       0x02
>> +#define DRM_AMDGPU_BO_LIST           0x03
>> +#define DRM_AMDGPU_CS                        0x04
>> +#define DRM_AMDGPU_INFO                      0x05
>> +#define DRM_AMDGPU_GEM_METADATA              0x06
>> +#define DRM_AMDGPU_GEM_WAIT_IDLE     0x07
>> +#define DRM_AMDGPU_GEM_VA            0x08
>> +#define DRM_AMDGPU_WAIT_CS           0x09
>> +#define DRM_AMDGPU_GEM_OP            0x10
>> +#define DRM_AMDGPU_GEM_USERPTR               0x11
>> +
>> +#define DRM_IOCTL_AMDGPU_GEM_CREATE  DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_CREATE, union drm_amdgpu_gem_create)
>> +#define DRM_IOCTL_AMDGPU_GEM_MMAP    DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_MMAP, union drm_amdgpu_gem_mmap)
>> +#define DRM_IOCTL_AMDGPU_CTX         DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_CTX, union drm_amdgpu_ctx)
>> +#define DRM_IOCTL_AMDGPU_BO_LIST     DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_BO_LIST, union drm_amdgpu_bo_list)
>> +#define DRM_IOCTL_AMDGPU_CS          DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_CS, union drm_amdgpu_cs)
>> +#define DRM_IOCTL_AMDGPU_INFO                DRM_IOW(DRM_COMMAND_BASE + DRM_AMDGPU_INFO, struct drm_amdgpu_info)
>> +#define DRM_IOCTL_AMDGPU_GEM_METADATA        DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_METADATA, struct drm_amdgpu_gem_metadata)
>> +#define DRM_IOCTL_AMDGPU_GEM_WAIT_IDLE       DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_WAIT_IDLE, union drm_amdgpu_gem_wait_idle)
>> +#define DRM_IOCTL_AMDGPU_GEM_VA              DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_VA, union drm_amdgpu_gem_va)
>> +#define DRM_IOCTL_AMDGPU_WAIT_CS     DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_WAIT_CS, union drm_amdgpu_wait_cs)
>> +#define DRM_IOCTL_AMDGPU_GEM_OP              DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_OP, struct drm_amdgpu_gem_op)
>> +#define DRM_IOCTL_AMDGPU_GEM_USERPTR DRM_IOWR(DRM_COMMAND_BASE + DRM_AMDGPU_GEM_USERPTR, struct drm_amdgpu_gem_userptr)
>> +
>> +#define AMDGPU_GEM_DOMAIN_CPU                0x1
>> +#define AMDGPU_GEM_DOMAIN_GTT                0x2
>> +#define AMDGPU_GEM_DOMAIN_VRAM               0x4
>> +#define AMDGPU_GEM_DOMAIN_GDS                0x8
>> +#define AMDGPU_GEM_DOMAIN_GWS                0x10
>> +#define AMDGPU_GEM_DOMAIN_OA         0x20
>
> Can we get a description on this new domains (GDS, GWS, OA) ?

GDS, GWS, and OA are on chip shader resources that can be allocated
similarly to vram or gart.  GDS is the global data store on the shader
block.  It's basically global memory that can be used by wavefronts of
a kernel on all compute units.  GWS is a global wave sync resource
(sort of a shader semaphore) and OA is a ordered allocation resource
(basically a special counter for handling wave ordering).  See the ISA
documents for a more extensive description.

On older asics, these resources were statically partitioned per ring
by the CP.  On newer asics, they are mapped into the clients virtual
address space.  We decided to use ttm to manage them like other GPU
resource pools since they are basically another resource type.


>
>> +
>> +#define AMDGPU_GEM_DOMAIN_MASK               0x3F
>> +
>> +/* Flag that CPU access will be required for the case of VRAM domain */
>> +#define AMDGPU_GEM_CREATE_CPU_ACCESS_REQUIRED        (1 << 0)
>> +/* Flag that CPU access will not work, this VRAM domain is invisible */
>> +#define AMDGPU_GEM_CREATE_NO_CPU_ACCESS              (1 << 1)
>> +/* Flag that un-cached attributes should be used for GTT */
>> +#define AMDGPU_GEM_CREATE_CPU_GTT_UC         (1 << 2)
>> +/* Flag that USWC attributes should be used for GTT */
>> +#define AMDGPU_GEM_CREATE_CPU_GTT_WC         (1 << 3)
>> +
>> +/* Flag mask for GTT domain_flags */
>> +#define AMDGPU_GEM_CREATE_CPU_GTT_MASK \
>> +     (AMDGPU_GEM_CREATE_CPU_GTT_WC | \
>> +      AMDGPU_GEM_CREATE_CPU_GTT_UC | \
>> +      AMDGPU_GEM_CREATE_CPU_ACCESS_REQUIRED | \
>> +      AMDGPU_GEM_CREATE_NO_CPU_ACCESS)
>> +
>> +struct drm_amdgpu_gem_create_in  {
>> +     /** the requested memory size */
>> +     uint64_t bo_size;
>> +     /** physical start_addr alignment in bytes for some HW requirements */
>> +     uint64_t alignment;
>> +     /** the requested memory domains */
>> +     uint64_t domains;
>> +     /** allocation flags */
>> +     uint64_t domain_flags;
>> +};
>> +
>> +struct drm_amdgpu_gem_create_out  {
>> +     /** returned GEM object handle */
>> +     uint32_t handle;
>> +     uint32_t _pad;
>> +};
>> +
>> +union drm_amdgpu_gem_create {
>> +     struct drm_amdgpu_gem_create_in         in;
>> +     struct drm_amdgpu_gem_create_out        out;
>> +};
>> +
>> +/** Opcode to create new residency list.  */
>> +#define AMDGPU_BO_LIST_OP_CREATE     0
>> +/** Opcode to destroy previously created residency list */
>> +#define AMDGPU_BO_LIST_OP_DESTROY    1
>> +/** Opcode to update resource information in the list */
>> +#define AMDGPU_BO_LIST_OP_UPDATE     2
>> +
>> +struct drm_amdgpu_bo_list_in {
>> +     /** Type of operation */
>> +     uint32_t operation;
>> +     /** Handle of list or 0 if we want to create one */
>> +     uint32_t list_handle;
>> +     /** Number of BOs in list  */
>> +     uint32_t bo_number;
>> +     /** Size of each element describing BO */
>> +     uint32_t bo_info_size;
>> +     /** Pointer to array describing BOs */
>> +     uint64_t bo_info_ptr;
>> +};
>> +
>> +struct drm_amdgpu_bo_list_entry {
>> +     /** Handle of BO */
>> +     uint32_t bo_handle;
>> +     /** New (if specified) BO priority to be used during migration */
>> +     uint32_t bo_priority;
>> +};
>> +
>> +struct drm_amdgpu_bo_list_out {
>> +     /** Handle of resource list  */
>> +     uint32_t list_handle;
>> +     uint32_t _pad;
>> +};
>> +
>> +union drm_amdgpu_bo_list {
>> +     struct drm_amdgpu_bo_list_in in;
>> +     struct drm_amdgpu_bo_list_out out;
>> +};
>> +
>> +/* context related */
>> +#define AMDGPU_CTX_OP_ALLOC_CTX      1
>> +#define AMDGPU_CTX_OP_FREE_CTX       2
>> +#define AMDGPU_CTX_OP_QUERY_STATE    3
>> +
>> +#define AMDGPU_CTX_OP_STATE_RUNNING  1
>
> So this does not seems to be use yet ? Am i correct ? Then better
> to remove it now and introduce it once it is use.

I think Marek's robustness stuff for EGL 1.5 may use it, but I'm not
sure.  If not, we can drop it for now.

>
>> +
>> +struct drm_amdgpu_ctx_in {
>> +     uint32_t        op;
>> +     uint32_t        flags;
>> +     uint32_t        ctx_id;
>> +     uint32_t        _pad;
>> +};
>> +
>> +union drm_amdgpu_ctx_out {
>> +             struct {
>> +                     uint32_t        ctx_id;
>> +                     uint32_t        _pad;
>> +             } alloc;
>> +
>> +             struct {
>> +                     uint64_t        flags;
>> +                     uint64_t        hangs;
>> +             } state;
>> +};
>
> There is no define for the state.flags i would rather like see
> each value that can be returned with a define.
>

We'll add those.

>> +
>> +union drm_amdgpu_ctx {
>> +     struct drm_amdgpu_ctx_in in;
>> +     union drm_amdgpu_ctx_out out;
>> +};
>> +
>> +/*
>> + * This is not a reliable API and you should expect it to fail for any
>> + * number of reasons and have fallback path that do not use userptr to
>> + * perform any operation.
>> + */
>> +#define AMDGPU_GEM_USERPTR_READONLY  (1 << 0)
>> +#define AMDGPU_GEM_USERPTR_ANONONLY  (1 << 1)
>> +#define AMDGPU_GEM_USERPTR_VALIDATE  (1 << 2)
>> +#define AMDGPU_GEM_USERPTR_REGISTER  (1 << 3)
>> +
>> +struct drm_amdgpu_gem_userptr {
>> +     uint64_t                addr;
>> +     uint64_t                size;
>> +     uint32_t                flags;
>> +     uint32_t                handle;
>> +};
>> +
>> +#define AMDGPU_TILING_MACRO                          0x1
>> +#define AMDGPU_TILING_MICRO                          0x2
>> +#define AMDGPU_TILING_SWAP_16BIT                     0x4
>> +#define AMDGPU_TILING_R600_NO_SCANOUT                        AMDGPU_TILING_SWAP_16BIT
>> +#define AMDGPU_TILING_SWAP_32BIT                     0x8
>> +/* this object requires a surface when mapped - i.e. front buffer */
>> +#define AMDGPU_TILING_SURFACE                                0x10
>> +#define AMDGPU_TILING_MICRO_SQUARE                   0x20
>> +#define AMDGPU_TILING_EG_BANKW_SHIFT                 8
>> +#define AMDGPU_TILING_EG_BANKW_MASK                  0xf
>> +#define AMDGPU_TILING_EG_BANKH_SHIFT                 12
>> +#define AMDGPU_TILING_EG_BANKH_MASK                  0xf
>> +#define AMDGPU_TILING_EG_MACRO_TILE_ASPECT_SHIFT     16
>> +#define AMDGPU_TILING_EG_MACRO_TILE_ASPECT_MASK      0xf
>> +#define AMDGPU_TILING_EG_TILE_SPLIT_SHIFT            24
>> +#define AMDGPU_TILING_EG_TILE_SPLIT_MASK             0xf
>> +#define AMDGPU_TILING_EG_STENCIL_TILE_SPLIT_SHIFT    28
>> +#define AMDGPU_TILING_EG_STENCIL_TILE_SPLIT_MASK     0xf
>> +
>> +#define AMDGPU_GEM_METADATA_OP_SET_METADATA                  1
>> +#define AMDGPU_GEM_METADATA_OP_GET_METADATA                  2
>> +
>> +/** The same structure is shared for input/output */
>> +struct drm_amdgpu_gem_metadata {
>> +     uint32_t        handle;         /* GEM Object handle */
>> +     uint32_t        op;             /** Do we want get or set metadata */
>> +     struct {
>> +             uint64_t        flags;
>
> Same here nothing describe expected value for flags

We'll add those.

>
>> +             uint64_t        tiling_info; /* family specific tiling info */
>> +             uint32_t        data_size_bytes;
>> +             uint32_t        data[64];
>> +     } data;
>> +};
>> +
>> +struct drm_amdgpu_gem_mmap_in {
>> +     uint32_t handle;                /** the GEM object handle */
>> +     uint32_t _pad;
>> +};
>> +
>> +struct drm_amdgpu_gem_mmap_out {
>> +     uint64_t addr_ptr;      /** mmap offset from the vma offset manager */
>> +};
>> +
>> +union drm_amdgpu_gem_mmap {
>> +     struct drm_amdgpu_gem_mmap_in   in;
>> +     struct drm_amdgpu_gem_mmap_out out;
>> +};
>> +
>> +struct drm_amdgpu_gem_wait_idle_in {
>> +     uint32_t handle;        /* GEM object handle */
>> +     uint32_t flags;
>> +     uint64_t timeout;       /* Timeout to wait. If 0 then returned immediately with the status */
>> +};
>> +
>> +struct drm_amdgpu_gem_wait_idle_out {
>> +     uint32_t status;        /*   BO status:  0 - BO is idle, 1 - BO is busy */
>> +     uint32_t domain; /*  Returned current memory domain */
>> +};
>> +
>> +union drm_amdgpu_gem_wait_idle {
>> +     struct drm_amdgpu_gem_wait_idle_in  in;
>> +     struct drm_amdgpu_gem_wait_idle_out out;
>> +};
>> +
>> +struct drm_amdgpu_wait_cs_in {
>> +     uint64_t handle;
>> +     uint64_t timeout;
>> +     uint32_t ip_type;
>> +     uint32_t ip_instance;
>> +     uint32_t ring;
>> +     uint32_t _pad;
>> +};
>> +
>> +struct drm_amdgpu_wait_cs_out {
>> +     uint64_t status;
>> +};
>
> Same here nothing to define status (0 or 1 by reading the code)
>

We'll add those.

>> +
>> +union drm_amdgpu_wait_cs {
>> +     struct drm_amdgpu_wait_cs_in in;
>> +     struct drm_amdgpu_wait_cs_out out;
>> +};
>> +
>> +/* Sets or returns a value associated with a buffer. */
>> +struct drm_amdgpu_gem_op {
>> +     uint32_t        handle; /* buffer */
>> +     uint32_t        op;     /* AMDGPU_GEM_OP_* */
>> +     uint64_t        value;  /* input or return value */
>> +};
>> +
>> +#define AMDGPU_GEM_OP_GET_GEM_CREATE_INFO            0
>> +#define AMDGPU_GEM_OP_SET_INITIAL_DOMAIN     1
>> +
>> +#define AMDGPU_VA_OP_MAP                     1
>> +#define AMDGPU_VA_OP_UNMAP                   2
>> +
>> +#define AMDGPU_VA_RESULT_OK                  0
>> +#define AMDGPU_VA_RESULT_ERROR                       1
>> +#define AMDGPU_VA_RESULT_VA_INVALID_ALIGNMENT        2
>> +
>> +/* Mapping flags */
>> +/* readable mapping */
>> +#define AMDGPU_VM_PAGE_READABLE              (1 << 1)
>> +/* writable mapping */
>> +#define AMDGPU_VM_PAGE_WRITEABLE     (1 << 2)
>> +/* executable mapping, new for VI */
>> +#define AMDGPU_VM_PAGE_EXECUTABLE    (1 << 3)
>> +
>> +struct drm_amdgpu_gem_va_in {
>> +     /* GEM object handle */
>> +     uint32_t handle;
>> +     uint32_t _pad;
>> +     /* map or unmap*/
>> +     uint32_t operation;
>> +     /* specify mapping flags */
>> +     uint32_t flags;
>> +     /* va address to assign . Must be correctly aligned.*/
>> +     uint64_t va_address;
>> +     /* Specify offset inside of BO to assign. Must be correctly aligned.*/
>> +     uint64_t offset_in_bo;
>> +     /* Specify mapping size. If 0 and offset is 0 then map the whole BO.*/
>> +     /* Must be correctly aligned. */
>> +     uint64_t map_size;
>> +};
>> +
>> +struct drm_amdgpu_gem_va_out {
>> +     uint32_t result;
>> +     uint32_t _pad;
>> +};
>> +
>> +union drm_amdgpu_gem_va {
>> +     struct drm_amdgpu_gem_va_in  in;
>> +     struct drm_amdgpu_gem_va_out out;
>> +};
>> +
>> +#define AMDGPU_HW_IP_GFX          0
>> +#define AMDGPU_HW_IP_COMPUTE      1
>> +#define AMDGPU_HW_IP_DMA          2
>> +#define AMDGPU_HW_IP_UVD          3
>> +#define AMDGPU_HW_IP_VCE          4
>> +#define AMDGPU_HW_IP_NUM          5
>> +
>> +#define AMDGPU_HW_IP_INSTANCE_MAX_COUNT 1
>> +
>> +#define AMDGPU_CHUNK_ID_IB           0x01
>> +#define AMDGPU_CHUNK_ID_FENCE                0x02
>> +struct drm_amdgpu_cs_chunk {
>> +     uint32_t                chunk_id;
>> +     uint32_t                length_dw;
>> +     uint64_t                chunk_data;
>> +};
>> +
>> +struct drm_amdgpu_cs_in {
>> +     /** Rendering context id */
>> +     uint32_t                ctx_id;
>> +     /**  Handle of resource list associated with CS */
>> +     uint32_t                bo_list_handle;
>> +     uint32_t                num_chunks;
>> +     uint32_t                _pad;
>> +     /* this points to uint64_t * which point to cs chunks */
>> +     uint64_t                chunks;
>> +};
>> +
>> +struct drm_amdgpu_cs_out {
>> +     uint64_t handle;
>> +};
>> +
>> +union drm_amdgpu_cs {
>> +       struct drm_amdgpu_cs_in in;
>> +       struct drm_amdgpu_cs_out out;
>> +};
>> +
>> +/* Specify flags to be used for IB */
>> +
>> +/* This IB should be submitted to CE */
>> +#define AMDGPU_IB_FLAG_CE    (1<<0)
>> +
>> +/* GDS is used by this IB */
>> +#define AMDGPU_IB_FLAG_GDS   (1<<1)
>> +
>> +struct drm_amdgpu_cs_chunk_ib {
>> +     /**
>> +      * Handle of GEM object to be used as IB or 0 if it is already in
>> +      * residency list.
>> +      */
>> +     uint32_t handle;
>> +     uint32_t flags;         /* IB Flags */
>> +     uint64_t va_start;      /* Virtual address to begin IB execution */
>> +     uint32_t ib_bytes;      /* Size of submission */
>> +     uint32_t ip_type;       /* HW IP to submit to */
>> +     uint32_t ip_instance;   /* HW IP index of the same type to submit to  */
>> +     uint32_t ring;          /* Ring index to submit to */
>> +};
>> +
>> +struct drm_amdgpu_cs_chunk_fence {
>> +     uint32_t handle;
>> +     uint32_t offset;
>> +};
>> +
>> +struct drm_amdgpu_cs_chunk_data {
>> +     union {
>> +             struct drm_amdgpu_cs_chunk_ib           ib_data;
>> +             struct drm_amdgpu_cs_chunk_fence        fence_data;
>> +     };
>> +};
>> +
>> +/**
>> + *  Query h/w info: Flag that this is integrated (a.h.a. fusion) GPU
>> + *
>> + */
>> +#define AMDGPU_IDS_FLAGS_FUSION         0x1
>> +
>> +/* indicate if acceleration can be working */
>> +#define AMDGPU_INFO_ACCEL_WORKING            0x00
>> +/* get the crtc_id from the mode object id? */
>> +#define AMDGPU_INFO_CRTC_FROM_ID             0x01
>> +/* query hw IP info */
>> +#define AMDGPU_INFO_HW_IP_INFO                       0x02
>> +/* query hw IP instance count for the specified type */
>> +#define AMDGPU_INFO_HW_IP_COUNT                      0x03
>> +/* timestamp for GL_ARB_timer_query */
>> +#define AMDGPU_INFO_TIMESTAMP                        0x05
>> +/* Query the firmware version */
>> +#define AMDGPU_INFO_FW_VERSION                       0x0e
>> +     /* Subquery id: Query VCE firmware version */
>> +     #define AMDGPU_INFO_FW_VCE              0x1
>> +     /* Subquery id: Query UVD firmware version */
>> +     #define AMDGPU_INFO_FW_UVD              0x2
>> +     /* Subquery id: Query GMC firmware version */
>> +     #define AMDGPU_INFO_FW_GMC              0x03
>> +     /* Subquery id: Query GFX ME firmware version */
>> +     #define AMDGPU_INFO_FW_GFX_ME           0x04
>> +     /* Subquery id: Query GFX PFP firmware version */
>> +     #define AMDGPU_INFO_FW_GFX_PFP          0x05
>> +     /* Subquery id: Query GFX CE firmware version */
>> +     #define AMDGPU_INFO_FW_GFX_CE           0x06
>> +     /* Subquery id: Query GFX RLC firmware version */
>> +     #define AMDGPU_INFO_FW_GFX_RLC          0x07
>> +     /* Subquery id: Query GFX MEC firmware version */
>> +     #define AMDGPU_INFO_FW_GFX_MEC          0x08
>> +     /* Subquery id: Query SMC firmware version */
>> +     #define AMDGPU_INFO_FW_SMC              0x0a
>> +     /* Subquery id: Query SDMA firmware version */
>> +     #define AMDGPU_INFO_FW_SDMA             0x0b
>> +/* number of bytes moved for TTM migration */
>> +#define AMDGPU_INFO_NUM_BYTES_MOVED          0x0f
>> +/* the used VRAM size */
>> +#define AMDGPU_INFO_VRAM_USAGE                       0x10
>> +/* the used GTT size */
>> +#define AMDGPU_INFO_GTT_USAGE                        0x11
>> +/* Information about GDS, etc. resource configuration */
>> +#define AMDGPU_INFO_GDS_CONFIG                       0x13
>> +/* Query information about VRAM and GTT domains */
>> +#define AMDGPU_INFO_VRAM_GTT                 0x14
>> +/* Query information about register in MMR address space*/
>> +#define AMDGPU_INFO_READ_MMR_REG             0x15
>> +/* Query information about device: rev id, family, etc. */
>> +#define AMDGPU_INFO_DEV_INFO                 0x16
>> +/* visible vram usage */
>> +#define AMDGPU_INFO_VIS_VRAM_USAGE           0x17
>> +
>> +#define AMDGPU_INFO_MMR_SE_INDEX_SHIFT       0
>> +#define AMDGPU_INFO_MMR_SE_INDEX_MASK        0xff
>> +#define AMDGPU_INFO_MMR_SH_INDEX_SHIFT       8
>> +#define AMDGPU_INFO_MMR_SH_INDEX_MASK        0xff
>> +
>> +/* Input structure for the INFO ioctl */
>> +struct drm_amdgpu_info {
>> +     /* Where the return value will be stored */
>> +     uint64_t return_pointer;
>> +     /* The size of the return value. Just like "size" in "snprintf",
>> +      * it limits how many bytes the kernel can write. */
>> +     uint32_t return_size;
>> +     /* The query request id. */
>> +     uint32_t query;
>> +
>> +     union {
>> +             struct {
>> +                     uint32_t id;
>> +                     uint32_t _pad;
>> +             } mode_crtc;
>> +
>> +             struct {
>> +                     /** AMDGPU_HW_IP_* */
>> +                     uint32_t type;
>> +                     /**
>> +                      * Index of the IP if there are more IPs of the same type.
>> +                      * Ignored by AMDGPU_INFO_HW_IP_COUNT.
>> +                      */
>> +                     uint32_t ip_instance;
>> +             } query_hw_ip;
>> +
>> +             struct {
>> +                     uint32_t dword_offset;
>> +                     uint32_t count; /* number of registers to read */
>> +                     uint32_t instance;
>> +                     uint32_t flags;
>> +             } read_mmr_reg;
>> +
>> +             struct {
>> +                     /** AMDGPU_INFO_FW_* */
>> +                     uint32_t fw_type;
>> +                     /** Index of the IP if there are more IPs of the same type. */
>> +                     uint32_t ip_instance;
>> +                     /**
>> +                      * Index of the engine. Whether this is used depends
>> +                      * on the firmware type. (e.g. MEC, SDMA)
>> +                      */
>> +                     uint32_t index;
>> +                     uint32_t _pad;
>> +             } query_fw;
>> +     };
>> +};
>> +
>> +struct drm_amdgpu_info_gds {
>> +     /** GDS GFX partition size */
>> +     uint32_t gds_gfx_partition_size;
>> +     /** GDS compute partition size */
>> +     uint32_t compute_partition_size;
>> +     /** total GDS memory size */
>> +     uint32_t gds_total_size;
>> +     /** GWS size per GFX partition */
>> +     uint32_t gws_per_gfx_partition;
>> +     /** GSW size per compute partition */
>> +     uint32_t gws_per_compute_partition;
>> +     /** OA size per GFX partition */
>> +     uint32_t oa_per_gfx_partition;
>> +     /** OA size per compute partition */
>> +     uint32_t oa_per_compute_partition;
>> +     uint32_t _pad;
>> +};
>> +
>> +struct drm_amdgpu_info_vram_gtt {
>> +     uint64_t vram_size;
>> +     uint64_t vram_cpu_accessible_size;
>> +     uint64_t gtt_size;
>> +};
>> +
>> +struct drm_amdgpu_info_firmware {
>> +     uint32_t ver;
>> +     uint32_t feature;
>> +};
>> +
>> +struct drm_amdgpu_info_device {
>> +     /** PCI Device ID */
>> +     uint32_t device_id;
>> +     /** Internal chip revision: A0, A1, etc.) */
>> +     uint32_t chip_rev;
>> +     uint32_t external_rev;
>> +     /** Revision id in PCI Config space */
>> +     uint32_t pci_rev;
>> +     uint32_t family;
>> +     uint32_t num_shader_engines;
>> +     uint32_t num_shader_arrays_per_engine;
>> +     uint32_t gpu_counter_freq; /* in KHz */
>> +     uint64_t max_engine_clock; /* in KHz */
>> +     /* cu information */
>> +     uint32_t cu_active_number;
>> +     uint32_t cu_ao_mask;
>> +     uint32_t cu_bitmap[4][4];
>> +     /** Render backend pipe mask. One render backend is CB+DB. */
>> +     uint32_t enabled_rb_pipes_mask;
>> +     uint32_t num_rb_pipes;
>> +     uint32_t num_hw_gfx_contexts;
>> +     uint32_t _pad;
>> +     uint64_t ids_flags;
>> +     /** Starting virtual address for UMDs. */
>> +     uint64_t virtual_address_offset;
>> +     /** Required alignment of virtual addresses. */
>> +     uint32_t virtual_address_alignment;
>> +     /** Page table entry - fragment size */
>> +     uint32_t pte_fragment_size;
>> +     uint32_t gart_page_size;
>> +};
>> +
>> +struct drm_amdgpu_info_hw_ip {
>> +     /** Version of h/w IP */
>> +     uint32_t  hw_ip_version_major;
>> +     uint32_t  hw_ip_version_minor;
>> +     /** Capabilities */
>> +     uint64_t  capabilities_flags;
>> +     /** Bitmask of available rings. Bit 0 means ring 0, etc. */
>> +     uint32_t  available_rings;
>> +     uint32_t  _pad;
>> +};
>> +
>> +/*
>> + * Supported GPU families
>> + */
>> +#define AMDGPU_FAMILY_UNKNOWN                        0
>> +#define AMDGPU_FAMILY_CI                     120 /* Bonaire, Hawaii */
>> +#define AMDGPU_FAMILY_KV                     125 /* Kaveri, Kabini, Mullins */
>> +#define AMDGPU_FAMILY_VI                     130 /* Iceland, Tonga */
>> +#define AMDGPU_FAMILY_CZ                     135 /* Carrizo */
>> +
>
> That's weird why using those numbers and not 1, 2, 3, 4 ... :)

:)

We'll get this stuff cleaned up this week.  Thanks for reviewing!

Alex

>
>> +#endif
>> --
>> 1.8.3.1
>>
>> _______________________________________________
>> dri-devel mailing list
>> dri-devel at lists.freedesktop.org
>> http://lists.freedesktop.org/mailman/listinfo/dri-devel


More information about the dri-devel mailing list