| .. | .. |
|---|
| 21 | 21 | */ |
|---|
| 22 | 22 | |
|---|
| 23 | 23 | #include <drm/drm_atomic_helper.h> |
|---|
| 24 | | -#include <drm/drm_crtc_helper.h> |
|---|
| 25 | 24 | #include <drm/drm_fb_helper.h> |
|---|
| 25 | +#include <drm/drm_fourcc.h> |
|---|
| 26 | 26 | #include <drm/drm_modeset_helper.h> |
|---|
| 27 | 27 | #include <drm/drm_plane_helper.h> |
|---|
| 28 | +#include <drm/drm_print.h> |
|---|
| 29 | +#include <drm/drm_probe_helper.h> |
|---|
| 28 | 30 | |
|---|
| 29 | 31 | /** |
|---|
| 30 | 32 | * DOC: aux kms helpers |
|---|
| .. | .. |
|---|
| 146 | 148 | * Initialize a CRTC object with a default helper-provided primary plane and no |
|---|
| 147 | 149 | * cursor plane. |
|---|
| 148 | 150 | * |
|---|
| 151 | + * Note that we make some assumptions about hardware limitations that may not be |
|---|
| 152 | + * true for all hardware: |
|---|
| 153 | + * |
|---|
| 154 | + * 1. Primary plane cannot be repositioned. |
|---|
| 155 | + * 2. Primary plane cannot be scaled. |
|---|
| 156 | + * 3. Primary plane must cover the entire CRTC. |
|---|
| 157 | + * 4. Subpixel positioning is not supported. |
|---|
| 158 | + * 5. The primary plane must always be on if the CRTC is enabled. |
|---|
| 159 | + * |
|---|
| 160 | + * This is purely a backwards compatibility helper for old drivers. Drivers |
|---|
| 161 | + * should instead implement their own primary plane. Atomic drivers must do so. |
|---|
| 162 | + * Drivers with the above hardware restriction can look into using &struct |
|---|
| 163 | + * drm_simple_display_pipe, which encapsulates the above limitations into a nice |
|---|
| 164 | + * interface. |
|---|
| 165 | + * |
|---|
| 149 | 166 | * Returns: |
|---|
| 150 | 167 | * Zero on success, error code on failure. |
|---|
| 151 | 168 | */ |
|---|