forked from Qortal/Brooklyn
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
171 lines
4.1 KiB
171 lines
4.1 KiB
/* SPDX-License-Identifier: GPL-2.0 */ |
|
/* |
|
* (C) COPYRIGHT 2016 ARM Limited. All rights reserved. |
|
* Author: Brian Starkey <[email protected]> |
|
* |
|
* This program is free software and is provided to you under the terms of the |
|
* GNU General Public License version 2 as published by the Free Software |
|
* Foundation, and any use by you of this program is subject to the terms |
|
* of such GNU licence. |
|
*/ |
|
|
|
#ifndef __DRM_WRITEBACK_H__ |
|
#define __DRM_WRITEBACK_H__ |
|
#include <drm/drm_connector.h> |
|
#include <drm/drm_encoder.h> |
|
#include <linux/workqueue.h> |
|
|
|
/** |
|
* struct drm_writeback_connector - DRM writeback connector |
|
*/ |
|
struct drm_writeback_connector { |
|
/** |
|
* @base: base drm_connector object |
|
*/ |
|
struct drm_connector base; |
|
|
|
/** |
|
* @encoder: Internal encoder used by the connector to fulfill |
|
* the DRM framework requirements. The users of the |
|
* @drm_writeback_connector control the behaviour of the @encoder |
|
* by passing the @enc_funcs parameter to drm_writeback_connector_init() |
|
* function. |
|
*/ |
|
struct drm_encoder encoder; |
|
|
|
/** |
|
* @pixel_formats_blob_ptr: |
|
* |
|
* DRM blob property data for the pixel formats list on writeback |
|
* connectors |
|
* See also drm_writeback_connector_init() |
|
*/ |
|
struct drm_property_blob *pixel_formats_blob_ptr; |
|
|
|
/** @job_lock: Protects job_queue */ |
|
spinlock_t job_lock; |
|
|
|
/** |
|
* @job_queue: |
|
* |
|
* Holds a list of a connector's writeback jobs; the last item is the |
|
* most recent. The first item may be either waiting for the hardware |
|
* to begin writing, or currently being written. |
|
* |
|
* See also: drm_writeback_queue_job() and |
|
* drm_writeback_signal_completion() |
|
*/ |
|
struct list_head job_queue; |
|
|
|
/** |
|
* @fence_context: |
|
* |
|
* timeline context used for fence operations. |
|
*/ |
|
unsigned int fence_context; |
|
/** |
|
* @fence_lock: |
|
* |
|
* spinlock to protect the fences in the fence_context. |
|
*/ |
|
spinlock_t fence_lock; |
|
/** |
|
* @fence_seqno: |
|
* |
|
* Seqno variable used as monotonic counter for the fences |
|
* created on the connector's timeline. |
|
*/ |
|
unsigned long fence_seqno; |
|
/** |
|
* @timeline_name: |
|
* |
|
* The name of the connector's fence timeline. |
|
*/ |
|
char timeline_name[32]; |
|
}; |
|
|
|
/** |
|
* struct drm_writeback_job - DRM writeback job |
|
*/ |
|
struct drm_writeback_job { |
|
/** |
|
* @connector: |
|
* |
|
* Back-pointer to the writeback connector associated with the job |
|
*/ |
|
struct drm_writeback_connector *connector; |
|
|
|
/** |
|
* @prepared: |
|
* |
|
* Set when the job has been prepared with drm_writeback_prepare_job() |
|
*/ |
|
bool prepared; |
|
|
|
/** |
|
* @cleanup_work: |
|
* |
|
* Used to allow drm_writeback_signal_completion to defer dropping the |
|
* framebuffer reference to a workqueue |
|
*/ |
|
struct work_struct cleanup_work; |
|
|
|
/** |
|
* @list_entry: |
|
* |
|
* List item for the writeback connector's @job_queue |
|
*/ |
|
struct list_head list_entry; |
|
|
|
/** |
|
* @fb: |
|
* |
|
* Framebuffer to be written to by the writeback connector. Do not set |
|
* directly, use drm_writeback_set_fb() |
|
*/ |
|
struct drm_framebuffer *fb; |
|
|
|
/** |
|
* @out_fence: |
|
* |
|
* Fence which will signal once the writeback has completed |
|
*/ |
|
struct dma_fence *out_fence; |
|
|
|
/** |
|
* @priv: |
|
* |
|
* Driver-private data |
|
*/ |
|
void *priv; |
|
}; |
|
|
|
static inline struct drm_writeback_connector * |
|
drm_connector_to_writeback(struct drm_connector *connector) |
|
{ |
|
return container_of(connector, struct drm_writeback_connector, base); |
|
} |
|
|
|
int drm_writeback_connector_init(struct drm_device *dev, |
|
struct drm_writeback_connector *wb_connector, |
|
const struct drm_connector_funcs *con_funcs, |
|
const struct drm_encoder_helper_funcs *enc_helper_funcs, |
|
const u32 *formats, int n_formats); |
|
|
|
int drm_writeback_set_fb(struct drm_connector_state *conn_state, |
|
struct drm_framebuffer *fb); |
|
|
|
int drm_writeback_prepare_job(struct drm_writeback_job *job); |
|
|
|
void drm_writeback_queue_job(struct drm_writeback_connector *wb_connector, |
|
struct drm_connector_state *conn_state); |
|
|
|
void drm_writeback_cleanup_job(struct drm_writeback_job *job); |
|
|
|
void |
|
drm_writeback_signal_completion(struct drm_writeback_connector *wb_connector, |
|
int status); |
|
|
|
struct dma_fence * |
|
drm_writeback_get_out_fence(struct drm_writeback_connector *wb_connector); |
|
#endif
|
|
|