1 /* SPDX-License-Identifier: GPL-2.0 */
2 /* Copyright 2018 Marty E. Plummer <hanetzer@startmail.com> */
3 /* Copyright 2019 Linaro, Ltd, Rob Herring <robh@kernel.org> */
4 
5 #ifndef __PANFROST_DEVICE_H__
6 #define __PANFROST_DEVICE_H__
7 
8 #include <linux/atomic.h>
9 #include <linux/io-pgtable.h>
10 #include <linux/regulator/consumer.h>
11 #include <linux/spinlock.h>
12 #include <drm/drm_device.h>
13 #include <drm/drm_mm.h>
14 #include <drm/gpu_scheduler.h>
15 
16 #include "panfrost_devfreq.h"
17 
18 struct panfrost_device;
19 struct panfrost_mmu;
20 struct panfrost_job_slot;
21 struct panfrost_job;
22 struct panfrost_perfcnt;
23 
24 #define NUM_JOB_SLOTS 3
25 #define MAX_PM_DOMAINS 3
26 
27 struct panfrost_features {
28 	u16 id;
29 	u16 revision;
30 
31 	u64 shader_present;
32 	u64 tiler_present;
33 	u64 l2_present;
34 	u64 stack_present;
35 	u32 as_present;
36 	u32 js_present;
37 
38 	u32 l2_features;
39 	u32 core_features;
40 	u32 tiler_features;
41 	u32 mem_features;
42 	u32 mmu_features;
43 	u32 thread_features;
44 	u32 max_threads;
45 	u32 thread_max_workgroup_sz;
46 	u32 thread_max_barrier_sz;
47 	u32 coherency_features;
48 	u32 afbc_features;
49 	u32 texture_features[4];
50 	u32 js_features[16];
51 
52 	u32 nr_core_groups;
53 	u32 thread_tls_alloc;
54 
55 	unsigned long hw_features[64 / BITS_PER_LONG];
56 	unsigned long hw_issues[64 / BITS_PER_LONG];
57 };
58 
59 /*
60  * Features that cannot be automatically detected and need matching using the
61  * compatible string, typically SoC-specific.
62  */
63 struct panfrost_compatible {
64 	/* Supplies count and names. */
65 	int num_supplies;
66 	const char * const *supply_names;
67 	/*
68 	 * Number of power domains required, note that values 0 and 1 are
69 	 * handled identically, as only values > 1 need special handling.
70 	 */
71 	int num_pm_domains;
72 	/* Only required if num_pm_domains > 1. */
73 	const char * const *pm_domain_names;
74 
75 	/* Vendor implementation quirks callback */
76 	void (*vendor_quirk)(struct panfrost_device *pfdev);
77 };
78 
79 struct panfrost_device {
80 	struct device *dev;
81 	struct drm_device *ddev;
82 	struct platform_device *pdev;
83 
84 	void __iomem *iomem;
85 	struct clk *clock;
86 	struct clk *bus_clock;
87 	struct regulator_bulk_data *regulators;
88 	struct reset_control *rstc;
89 	/* pm_domains for devices with more than one. */
90 	struct device *pm_domain_devs[MAX_PM_DOMAINS];
91 	struct device_link *pm_domain_links[MAX_PM_DOMAINS];
92 	bool coherent;
93 
94 	struct panfrost_features features;
95 	const struct panfrost_compatible *comp;
96 
97 	spinlock_t as_lock;
98 	unsigned long as_in_use_mask;
99 	unsigned long as_alloc_mask;
100 	struct list_head as_lru_list;
101 
102 	struct panfrost_job_slot *js;
103 
104 	struct panfrost_job *jobs[NUM_JOB_SLOTS];
105 	struct list_head scheduled_jobs;
106 
107 	struct panfrost_perfcnt *perfcnt;
108 
109 	struct mutex sched_lock;
110 
111 	struct {
112 		struct work_struct work;
113 		atomic_t pending;
114 	} reset;
115 
116 	struct mutex shrinker_lock;
117 	struct list_head shrinker_list;
118 	struct shrinker shrinker;
119 
120 	struct panfrost_devfreq pfdevfreq;
121 };
122 
123 struct panfrost_mmu {
124 	struct io_pgtable_cfg pgtbl_cfg;
125 	struct io_pgtable_ops *pgtbl_ops;
126 	int as;
127 	atomic_t as_count;
128 	struct list_head list;
129 };
130 
131 struct panfrost_file_priv {
132 	struct panfrost_device *pfdev;
133 
134 	struct drm_sched_entity sched_entity[NUM_JOB_SLOTS];
135 
136 	struct panfrost_mmu mmu;
137 	struct drm_mm mm;
138 	spinlock_t mm_lock;
139 };
140 
141 static inline struct panfrost_device *to_panfrost_device(struct drm_device *ddev)
142 {
143 	return ddev->dev_private;
144 }
145 
146 static inline int panfrost_model_cmp(struct panfrost_device *pfdev, s32 id)
147 {
148 	s32 match_id = pfdev->features.id;
149 
150 	if (match_id & 0xf000)
151 		match_id &= 0xf00f;
152 	return match_id - id;
153 }
154 
155 static inline bool panfrost_model_is_bifrost(struct panfrost_device *pfdev)
156 {
157 	return panfrost_model_cmp(pfdev, 0x1000) >= 0;
158 }
159 
160 static inline bool panfrost_model_eq(struct panfrost_device *pfdev, s32 id)
161 {
162 	return !panfrost_model_cmp(pfdev, id);
163 }
164 
165 int panfrost_unstable_ioctl_check(void);
166 
167 int panfrost_device_init(struct panfrost_device *pfdev);
168 void panfrost_device_fini(struct panfrost_device *pfdev);
169 void panfrost_device_reset(struct panfrost_device *pfdev);
170 
171 int panfrost_device_resume(struct device *dev);
172 int panfrost_device_suspend(struct device *dev);
173 
174 const char *panfrost_exception_name(struct panfrost_device *pfdev, u32 exception_code);
175 
176 #endif
177