xref: /aosp_15_r20/external/mesa3d/src/panfrost/lib/wrap.h (revision 6104692788411f58d303aa86923a9ff6ecaded22)
1*61046927SAndroid Build Coastguard Worker 
2*61046927SAndroid Build Coastguard Worker /*
3*61046927SAndroid Build Coastguard Worker  * Copyright (C) 2017-2019 Lyude Paul
4*61046927SAndroid Build Coastguard Worker  * Copyright (C) 2017-2019 Alyssa Rosenzweig
5*61046927SAndroid Build Coastguard Worker  *
6*61046927SAndroid Build Coastguard Worker  * Permission is hereby granted, free of charge, to any person obtaining a
7*61046927SAndroid Build Coastguard Worker  * copy of this software and associated documentation files (the "Software"),
8*61046927SAndroid Build Coastguard Worker  * to deal in the Software without restriction, including without limitation
9*61046927SAndroid Build Coastguard Worker  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
10*61046927SAndroid Build Coastguard Worker  * and/or sell copies of the Software, and to permit persons to whom the
11*61046927SAndroid Build Coastguard Worker  * Software is furnished to do so, subject to the following conditions:
12*61046927SAndroid Build Coastguard Worker  *
13*61046927SAndroid Build Coastguard Worker  * The above copyright notice and this permission notice (including the next
14*61046927SAndroid Build Coastguard Worker  * paragraph) shall be included in all copies or substantial portions of the
15*61046927SAndroid Build Coastguard Worker  * Software.
16*61046927SAndroid Build Coastguard Worker  *
17*61046927SAndroid Build Coastguard Worker  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18*61046927SAndroid Build Coastguard Worker  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19*61046927SAndroid Build Coastguard Worker  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
20*61046927SAndroid Build Coastguard Worker  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21*61046927SAndroid Build Coastguard Worker  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
22*61046927SAndroid Build Coastguard Worker  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
23*61046927SAndroid Build Coastguard Worker  * SOFTWARE.
24*61046927SAndroid Build Coastguard Worker  *
25*61046927SAndroid Build Coastguard Worker  */
26*61046927SAndroid Build Coastguard Worker 
27*61046927SAndroid Build Coastguard Worker #ifndef __PAN_DECODE_PUBLIC_H__
28*61046927SAndroid Build Coastguard Worker #define __PAN_DECODE_PUBLIC_H__
29*61046927SAndroid Build Coastguard Worker 
30*61046927SAndroid Build Coastguard Worker #include <inttypes.h>
31*61046927SAndroid Build Coastguard Worker #include <stdbool.h>
32*61046927SAndroid Build Coastguard Worker #include <stddef.h>
33*61046927SAndroid Build Coastguard Worker #include <stdio.h>
34*61046927SAndroid Build Coastguard Worker #include <stdlib.h>
35*61046927SAndroid Build Coastguard Worker 
36*61046927SAndroid Build Coastguard Worker /* Public entrypoints for the tracing infrastructure. This API should be kept
37*61046927SAndroid Build Coastguard Worker  * more or less stable. Don't feel bad if you have to change it; just feel
38*61046927SAndroid Build Coastguard Worker  * slightly guilty about creating more work for me later. -Alyssa <3
39*61046927SAndroid Build Coastguard Worker  *
40*61046927SAndroid Build Coastguard Worker  * I'm joking. Mostly. panwrap (out-of-tree) includes this, so update that if
41*61046927SAndroid Build Coastguard Worker  * you need to change something here. panwrap is open-source but cannot be
42*61046927SAndroid Build Coastguard Worker  * included in-tree.
43*61046927SAndroid Build Coastguard Worker  */
44*61046927SAndroid Build Coastguard Worker 
45*61046927SAndroid Build Coastguard Worker // TODO: update panwrap
46*61046927SAndroid Build Coastguard Worker 
47*61046927SAndroid Build Coastguard Worker struct pandecode_context;
48*61046927SAndroid Build Coastguard Worker 
49*61046927SAndroid Build Coastguard Worker struct pandecode_context *pandecode_create_context(bool to_stderr);
50*61046927SAndroid Build Coastguard Worker 
51*61046927SAndroid Build Coastguard Worker void pandecode_next_frame(struct pandecode_context *ctx);
52*61046927SAndroid Build Coastguard Worker 
53*61046927SAndroid Build Coastguard Worker void pandecode_destroy_context(struct pandecode_context *ctx);
54*61046927SAndroid Build Coastguard Worker 
55*61046927SAndroid Build Coastguard Worker void pandecode_inject_mmap(struct pandecode_context *ctx, uint64_t gpu_va,
56*61046927SAndroid Build Coastguard Worker                            void *cpu, unsigned sz, const char *name);
57*61046927SAndroid Build Coastguard Worker 
58*61046927SAndroid Build Coastguard Worker void pandecode_inject_free(struct pandecode_context *ctx, uint64_t gpu_va,
59*61046927SAndroid Build Coastguard Worker                            unsigned sz);
60*61046927SAndroid Build Coastguard Worker 
61*61046927SAndroid Build Coastguard Worker void pandecode_jc(struct pandecode_context *ctx, uint64_t jc_gpu_va,
62*61046927SAndroid Build Coastguard Worker                   unsigned gpu_id);
63*61046927SAndroid Build Coastguard Worker 
64*61046927SAndroid Build Coastguard Worker void pandecode_cs(struct pandecode_context *ctx, mali_ptr queue_gpu_va,
65*61046927SAndroid Build Coastguard Worker                   uint32_t size, unsigned gpu_id, uint32_t *regs);
66*61046927SAndroid Build Coastguard Worker 
67*61046927SAndroid Build Coastguard Worker void pandecode_abort_on_fault(struct pandecode_context *ctx, uint64_t jc_gpu_va,
68*61046927SAndroid Build Coastguard Worker                               unsigned gpu_id);
69*61046927SAndroid Build Coastguard Worker 
70*61046927SAndroid Build Coastguard Worker #endif /* __MMAP_TRACE_H__ */
71