Add the initial nova-drm driver skeleton. nova-drm is connected to nova-core through the auxiliary bus and implements the DRM parts of the nova driver stack. For now, it implements the fundamental DRM abstractions, i.e. creates a DRM device and registers it, exposing a three sample IOCTLs. DRM_IOCTL_NOVA_GETPARAM - provides the PCI bar size from the bar that maps the GPUs VRAM from nova-core DRM_IOCTL_NOVA_GEM_CREATE - creates a new dummy DRM GEM object and returns a handle DRM_IOCTL_NOVA_GEM_INFO - provides metadata for the DRM GEM object behind a given handle I implemented a small userspace test suite [1] that utilizes this interface.
Showing the changes to include/uapi (1 of 12 files). Show all
Unified · Split
| @@ -0,0 +1,101 @@ | ||
| 1 | +/* SPDX-License-Identifier: MIT */ | |
| 2 | + | |
| 3 | +#ifndef __NOVA_DRM_H__ | |
| 4 | +#define __NOVA_DRM_H__ | |
| 5 | + | |
| 6 | +#include "drm.h" | |
| 7 | + | |
| 8 | +/* DISCLAIMER: Do not use, this is not a stable uAPI. | |
| 9 | + * | |
| 10 | + * This uAPI serves only testing purposes as long as this driver is still in | |
| 11 | + * development. It is required to implement and test infrastructure which is | |
| 12 | + * upstreamed in the context of this driver. See also [1]. | |
| 13 | + * | |
| 14 | + * [1] https://lore.kernel.org/dri-devel/Zfsj0_tb-0-tNrJy@cassiopeiae/T/#u | |
| 15 | + */ | |
| 16 | + | |
| 17 | +#if defined(__cplusplus) | |
| 18 | +extern "C" { | |
| 19 | +#endif | |
| 20 | + | |
| 21 | +/* | |
| 22 | + * NOVA_GETPARAM_VRAM_BAR_SIZE | |
| 23 | + * | |
| 24 | + * Query the VRAM BAR size in bytes. | |
| 25 | + */ | |
| 26 | +#define NOVA_GETPARAM_VRAM_BAR_SIZE 0x1 | |
| 27 | + | |
| 28 | +/** | |
| 29 | + * struct drm_nova_getparam - query GPU and driver metadata | |
| 30 | + */ | |
| 31 | +struct drm_nova_getparam { | |
| 32 | + /** | |
| 33 | + * @param: The identifier of the parameter to query. | |
| 34 | + */ | |
| 35 | + __u64 param; | |
| 36 | + | |
| 37 | + /** | |
| 38 | + * @value: The value for the specified parameter. | |
| 39 | + */ | |
| 40 | + __u64 value; | |
| 41 | +}; | |
| 42 | + | |
| 43 | +/** | |
| 44 | + * struct drm_nova_gem_create - create a new DRM GEM object | |
| 45 | + */ | |
| 46 | +struct drm_nova_gem_create { | |
| 47 | + /** | |
| 48 | + * @handle: The handle of the new DRM GEM object. | |
| 49 | + */ | |
| 50 | + __u32 handle; | |
| 51 | + | |
| 52 | + /** | |
| 53 | + * @pad: 32 bit padding, should be 0. | |
| 54 | + */ | |
| 55 | + __u32 pad; | |
| 56 | + | |
| 57 | + /** | |
| 58 | + * @size: The size of the new DRM GEM object. | |
| 59 | + */ | |
| 60 | + __u64 size; | |
| 61 | +}; | |
| 62 | + | |
| 63 | +/** | |
| 64 | + * struct drm_nova_gem_info - query DRM GEM object metadata | |
| 65 | + */ | |
| 66 | +struct drm_nova_gem_info { | |
| 67 | + /** | |
| 68 | + * @handle: The handle of the DRM GEM object to query. | |
| 69 | + */ | |
| 70 | + __u32 handle; | |
| 71 | + | |
| 72 | + /** | |
| 73 | + * @pad: 32 bit padding, should be 0. | |
| 74 | + */ | |
| 75 | + __u32 pad; | |
| 76 | + | |
| 77 | + /** | |
| 78 | + * @size: The size of the DRM GEM obejct. | |
| 79 | + */ | |
| 80 | + __u64 size; | |
| 81 | +}; | |
| 82 | + | |
| 83 | +#define DRM_NOVA_GETPARAM 0x00 | |
| 84 | +#define DRM_NOVA_GEM_CREATE 0x01 | |
| 85 | +#define DRM_NOVA_GEM_INFO 0x02 | |
| 86 | + | |
| 87 | +/* Note: this is an enum so that it can be resolved by Rust bindgen. */ | |
| 88 | +enum { | |
| 89 | + DRM_IOCTL_NOVA_GETPARAM = DRM_IOWR(DRM_COMMAND_BASE + DRM_NOVA_GETPARAM, | |
| 90 | + struct drm_nova_getparam), | |
| 91 | + DRM_IOCTL_NOVA_GEM_CREATE = DRM_IOWR(DRM_COMMAND_BASE + DRM_NOVA_GEM_CREATE, | |
| 92 | + struct drm_nova_gem_create), | |
| 93 | + DRM_IOCTL_NOVA_GEM_INFO = DRM_IOWR(DRM_COMMAND_BASE + DRM_NOVA_GEM_INFO, | |
| 94 | + struct drm_nova_gem_info), | |
| 95 | +}; | |
| 96 | + | |
| 97 | +#if defined(__cplusplus) | |
| 98 | +} | |
| 99 | +#endif | |
| 100 | + | |
| 101 | +#endif /* __NOVA_DRM_H__ */ | |