mirror of
				https://github.com/torvalds/linux.git
				synced 2025-11-04 10:40:15 +02:00 
			
		
		
		
	The infrastructure includes parsing of the firmware image, initialising
FW-side structures, handling the kernel and firmware command
ringbuffers and starting & stopping the firmware processor.
This patch also adds the necessary support code for the META firmware
processor.
Changes since v8:
- Fix documentation for pvr_fwccb_process()
- Corrected license identifiers
Changes since v6:
- Add a minimum retry count to pvr_kccb_reserve_slot_sync()
Changes since v5:
- Add workaround for BRN 71242
- Attempt to recover GPU on MMU flush command failure
Changes since v4:
- Remove use of drm_gem_shmem_get_pages()
- Remove interrupt resource name
Changes since v3:
- Hard reset FW processor on watchdog timeout
- Switch to threaded IRQ
- Rework FW object creation/initialisation to aid hard reset
- Added MODULE_FIRMWARE()
- Use drm_dev_{enter,exit}
Signed-off-by: Sarah Walker <sarah.walker@imgtec.com>
Signed-off-by: Donald Robson <donald.robson@imgtec.com>
Link: https://lore.kernel.org/r/bb52a8dc84f296b37dc6668dfe8fbaf2ba551139.1700668843.git.donald.robson@imgtec.com
Signed-off-by: Maxime Ripard <mripard@kernel.org>
		
	
			
		
			
				
	
	
		
			71 lines
		
	
	
	
		
			2.2 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			71 lines
		
	
	
	
		
			2.2 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/* SPDX-License-Identifier: GPL-2.0-only OR MIT */
 | 
						|
/* Copyright (c) 2023 Imagination Technologies Ltd. */
 | 
						|
 | 
						|
#ifndef PVR_CCB_H
 | 
						|
#define PVR_CCB_H
 | 
						|
 | 
						|
#include "pvr_rogue_fwif.h"
 | 
						|
 | 
						|
#include <linux/mutex.h>
 | 
						|
#include <linux/types.h>
 | 
						|
 | 
						|
/* Forward declaration from pvr_device.h. */
 | 
						|
struct pvr_device;
 | 
						|
 | 
						|
/* Forward declaration from pvr_gem.h. */
 | 
						|
struct pvr_fw_object;
 | 
						|
 | 
						|
struct pvr_ccb {
 | 
						|
	/** @ctrl_obj: FW object representing CCB control structure. */
 | 
						|
	struct pvr_fw_object *ctrl_obj;
 | 
						|
	/** @ccb_obj: FW object representing CCB. */
 | 
						|
	struct pvr_fw_object *ccb_obj;
 | 
						|
 | 
						|
	/** @ctrl_fw_addr: FW virtual address of CCB control structure. */
 | 
						|
	u32 ctrl_fw_addr;
 | 
						|
	/** @ccb_fw_addr: FW virtual address of CCB. */
 | 
						|
	u32 ccb_fw_addr;
 | 
						|
 | 
						|
	/** @num_cmds: Number of commands in this CCB. */
 | 
						|
	u32 num_cmds;
 | 
						|
 | 
						|
	/** @cmd_size: Size of each command in this CCB, in bytes. */
 | 
						|
	u32 cmd_size;
 | 
						|
 | 
						|
	/** @lock: Mutex protecting @ctrl and @ccb. */
 | 
						|
	struct mutex lock;
 | 
						|
	/**
 | 
						|
	 * @ctrl: Kernel mapping of CCB control structure. @lock must be held
 | 
						|
	 *        when accessing.
 | 
						|
	 */
 | 
						|
	struct rogue_fwif_ccb_ctl *ctrl;
 | 
						|
	/** @ccb: Kernel mapping of CCB. @lock must be held when accessing. */
 | 
						|
	void *ccb;
 | 
						|
};
 | 
						|
 | 
						|
int pvr_kccb_init(struct pvr_device *pvr_dev);
 | 
						|
void pvr_kccb_fini(struct pvr_device *pvr_dev);
 | 
						|
int pvr_fwccb_init(struct pvr_device *pvr_dev);
 | 
						|
void pvr_ccb_fini(struct pvr_ccb *ccb);
 | 
						|
 | 
						|
void pvr_fwccb_process(struct pvr_device *pvr_dev);
 | 
						|
 | 
						|
struct dma_fence *pvr_kccb_fence_alloc(void);
 | 
						|
void pvr_kccb_fence_put(struct dma_fence *fence);
 | 
						|
struct dma_fence *
 | 
						|
pvr_kccb_reserve_slot(struct pvr_device *pvr_dev, struct dma_fence *f);
 | 
						|
void pvr_kccb_release_slot(struct pvr_device *pvr_dev);
 | 
						|
int pvr_kccb_send_cmd(struct pvr_device *pvr_dev,
 | 
						|
		      struct rogue_fwif_kccb_cmd *cmd, u32 *kccb_slot);
 | 
						|
int pvr_kccb_send_cmd_powered(struct pvr_device *pvr_dev,
 | 
						|
			      struct rogue_fwif_kccb_cmd *cmd,
 | 
						|
			      u32 *kccb_slot);
 | 
						|
void pvr_kccb_send_cmd_reserved_powered(struct pvr_device *pvr_dev,
 | 
						|
					struct rogue_fwif_kccb_cmd *cmd,
 | 
						|
					u32 *kccb_slot);
 | 
						|
int pvr_kccb_wait_for_completion(struct pvr_device *pvr_dev, u32 slot_nr, u32 timeout,
 | 
						|
				 u32 *rtn_out);
 | 
						|
bool pvr_kccb_is_idle(struct pvr_device *pvr_dev);
 | 
						|
void pvr_kccb_wake_up_waiters(struct pvr_device *pvr_dev);
 | 
						|
 | 
						|
#endif /* PVR_CCB_H */
 |