diff options
Diffstat (limited to 'include/boardobj/boardobj.h')
-rw-r--r-- | include/boardobj/boardobj.h | 104 |
1 files changed, 104 insertions, 0 deletions
diff --git a/include/boardobj/boardobj.h b/include/boardobj/boardobj.h new file mode 100644 index 0000000..b1be9bd --- /dev/null +++ b/include/boardobj/boardobj.h | |||
@@ -0,0 +1,104 @@ | |||
1 | /* | ||
2 | * Copyright (c) 2016-2018, NVIDIA CORPORATION. All rights reserved. | ||
3 | * | ||
4 | * Permission is hereby granted, free of charge, to any person obtaining a | ||
5 | * copy of this software and associated documentation files (the "Software"), | ||
6 | * to deal in the Software without restriction, including without limitation | ||
7 | * the rights to use, copy, modify, merge, publish, distribute, sublicense, | ||
8 | * and/or sell copies of the Software, and to permit persons to whom the | ||
9 | * Software is furnished to do so, subject to the following conditions: | ||
10 | * | ||
11 | * The above copyright notice and this permission notice shall be included in | ||
12 | * all copies or substantial portions of the Software. | ||
13 | * | ||
14 | * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | ||
15 | * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | ||
16 | * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL | ||
17 | * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | ||
18 | * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING | ||
19 | * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER | ||
20 | * DEALINGS IN THE SOFTWARE. | ||
21 | */ | ||
22 | |||
23 | #ifndef NVGPU_BOARDOBJ_H | ||
24 | #define NVGPU_BOARDOBJ_H | ||
25 | |||
26 | #include <nvgpu/list.h> | ||
27 | #include <nvgpu/pmuif/nvgpu_gpmu_cmdif.h> | ||
28 | |||
29 | #include "ctrl/ctrlboardobj.h" | ||
30 | |||
31 | struct boardobj; | ||
32 | struct nvgpu_list_node; | ||
33 | |||
34 | /* | ||
35 | * check whether the specified BOARDOBJ object implements the queried | ||
36 | * type/class enumeration. | ||
37 | */ | ||
38 | typedef bool boardobj_implements(struct gk20a *g, struct boardobj *pboardobj, | ||
39 | u8 type); | ||
40 | |||
41 | /* | ||
42 | * Fills out the appropriate the nv_pmu_xxxx_device_desc_<xyz> driver->PMU | ||
43 | * description structure, describing this BOARDOBJ board device to the PMU. | ||
44 | * | ||
45 | */ | ||
46 | typedef int boardobj_pmudatainit(struct gk20a *g, struct boardobj *pboardobj, | ||
47 | struct nv_pmu_boardobj *pmudata); | ||
48 | |||
49 | /* | ||
50 | * Constructor for the base Board Object. Called by each device-specific | ||
51 | * implementation of the BOARDOBJ interface to initialize the board object. | ||
52 | */ | ||
53 | typedef int boardobj_construct(struct gk20a *g, struct boardobj **pboardobj, | ||
54 | u16 size, void *args); | ||
55 | |||
56 | /* | ||
57 | * Destructor for the base board object. Called by each device-Specific | ||
58 | * implementation of the BOARDOBJ interface to destroy the board object. | ||
59 | * This has to be explicitly set by each device that extends from the | ||
60 | * board object. | ||
61 | */ | ||
62 | typedef int boardobj_destruct(struct boardobj *pboardobj); | ||
63 | |||
64 | /* | ||
65 | * Base Class for all physical or logical device on the PCB. | ||
66 | * Contains fields common to all devices on the board. Specific types of | ||
67 | * devices may extend this object adding any details specific to that | ||
68 | * device or device-type. | ||
69 | */ | ||
70 | |||
71 | struct boardobj { | ||
72 | struct gk20a *g; | ||
73 | |||
74 | u8 type; /*type of the device*/ | ||
75 | u8 idx; /*index of boardobj within in its group*/ | ||
76 | /* true if allocated in constructor. destructor should free */ | ||
77 | u8 allocated; | ||
78 | u32 type_mask; /*mask of types this boardobjimplements*/ | ||
79 | boardobj_implements *implements; | ||
80 | boardobj_destruct *destruct; | ||
81 | /* | ||
82 | * Access interface apis which will be overridden by the devices | ||
83 | * that inherit from BOARDOBJ | ||
84 | */ | ||
85 | boardobj_pmudatainit *pmudatainit; | ||
86 | struct nvgpu_list_node node; | ||
87 | }; | ||
88 | |||
89 | boardobj_construct boardobj_construct_super; | ||
90 | boardobj_destruct boardobj_destruct_super; | ||
91 | boardobj_implements boardobj_implements_super; | ||
92 | boardobj_pmudatainit boardobj_pmudatainit_super; | ||
93 | |||
94 | #define BOARDOBJ_GET_TYPE(pobj) (((struct boardobj *)(pobj))->type) | ||
95 | #define BOARDOBJ_GET_IDX(pobj) (((struct boardobj *)(pobj))->idx) | ||
96 | |||
97 | static inline struct boardobj * | ||
98 | boardobj_from_node(struct nvgpu_list_node *node) | ||
99 | { | ||
100 | return (struct boardobj *) | ||
101 | ((uintptr_t)node - offsetof(struct boardobj, node)); | ||
102 | }; | ||
103 | |||
104 | #endif /* NVGPU_BOARDOBJ_H */ | ||