1 /*
2  * Copyright (c) 2017 Mellanox Technologies. All rights reserved.
3  * Copyright (c) 2017 Vadim Pasternak <vadimp@mellanox.com>
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions are met:
7  *
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  * 3. Neither the names of the copyright holders nor the names of its
14  *    contributors may be used to endorse or promote products derived from
15  *    this software without specific prior written permission.
16  *
17  * Alternatively, this software may be distributed under the terms of the
18  * GNU General Public License ("GPL") version 2 as published by the Free
19  * Software Foundation.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
22  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
25  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
26  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
27  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
31  * POSSIBILITY OF SUCH DAMAGE.
32  */
33 
34 #ifndef __LINUX_PLATFORM_DATA_MLXREG_H
35 #define __LINUX_PLATFORM_DATA_MLXREG_H
36 
37 #define MLXREG_CORE_LABEL_MAX_SIZE	32
38 #define MLXREG_CORE_WD_FEATURE_NOWAYOUT		BIT(0)
39 #define MLXREG_CORE_WD_FEATURE_START_AT_BOOT	BIT(1)
40 
41 /**
42  * enum mlxreg_wdt_type - type of HW watchdog
43  *
44  * TYPE1 HW watchdog implementation exist in old systems.
45  * All new systems have TYPE2 HW watchdog.
46  */
47 enum mlxreg_wdt_type {
48 	MLX_WDT_TYPE1,
49 	MLX_WDT_TYPE2,
50 };
51 
52 /**
53  * struct mlxreg_hotplug_device - I2C device data:
54  *
55  * @adapter: I2C device adapter;
56  * @client: I2C device client;
57  * @brdinfo: device board information;
58  * @nr: I2C device adapter number, to which device is to be attached;
59  *
60  * Structure represents I2C hotplug device static data (board topology) and
61  * dynamic data (related kernel objects handles).
62  */
63 struct mlxreg_hotplug_device {
64 	struct i2c_adapter *adapter;
65 	struct i2c_client *client;
66 	struct i2c_board_info *brdinfo;
67 	int nr;
68 };
69 
70 /**
71  * struct mlxreg_core_data - attributes control data:
72  *
73  * @label: attribute label;
74  * @reg: attribute register;
75  * @mask: attribute access mask;
76  * @bit: attribute effective bit;
77  * @capability: attribute capability register;
78  * @mode: access mode;
79  * @np - pointer to node platform associated with attribute;
80  * @hpdev - hotplug device data;
81  * @health_cntr: dynamic device health indication counter;
82  * @attached: true if device has been attached after good health indication;
83  */
84 struct mlxreg_core_data {
85 	char label[MLXREG_CORE_LABEL_MAX_SIZE];
86 	u32 reg;
87 	u32 mask;
88 	u32 bit;
89 	u32 capability;
90 	umode_t	mode;
91 	struct device_node *np;
92 	struct mlxreg_hotplug_device hpdev;
93 	u8 health_cntr;
94 	bool attached;
95 };
96 
97 /**
98  * struct mlxreg_core_item - same type components controlled by the driver:
99  *
100  * @data: component data;
101  * @aggr_mask: group aggregation mask;
102  * @reg: group interrupt status register;
103  * @mask: group interrupt mask;
104  * @cache: last status value for elements fro the same group;
105  * @count: number of available elements in the group;
106  * @ind: element's index inside the group;
107  * @inversed: if 0: 0 for signal status is OK, if 1 - 1 is OK;
108  * @health: true if device has health indication, false in other case;
109  */
110 struct mlxreg_core_item {
111 	struct mlxreg_core_data *data;
112 	u32 aggr_mask;
113 	u32 reg;
114 	u32 mask;
115 	u32 cache;
116 	u8 count;
117 	u8 ind;
118 	u8 inversed;
119 	u8 health;
120 };
121 
122 /**
123  * struct mlxreg_core_platform_data - platform data:
124  *
125  * @data: instance private data;
126  * @regmap: register map of parent device;
127  * @counter: number of instances;
128  * @features: supported features of device;
129  * @version: implementation version;
130  * @identity: device identity name;
131  */
132 struct mlxreg_core_platform_data {
133 	struct mlxreg_core_data *data;
134 	void *regmap;
135 	int counter;
136 	u32 features;
137 	u32 version;
138 	char identity[MLXREG_CORE_LABEL_MAX_SIZE];
139 };
140 
141 /**
142  * struct mlxreg_core_hotplug_platform_data - hotplug platform data:
143  *
144  * @items: same type components with the hotplug capability;
145  * @irq: platform interrupt number;
146  * @regmap: register map of parent device;
147  * @counter: number of the components with the hotplug capability;
148  * @cell: location of top aggregation interrupt register;
149  * @mask: top aggregation interrupt common mask;
150  * @cell_low: location of low aggregation interrupt register;
151  * @mask_low: low aggregation interrupt common mask;
152  * @deferred_nr: I2C adapter number must be exist prior probing execution;
153  * @shift_nr: I2C adapter numbers must be incremented by this value;
154  */
155 struct mlxreg_core_hotplug_platform_data {
156 	struct mlxreg_core_item *items;
157 	int irq;
158 	void *regmap;
159 	int counter;
160 	u32 cell;
161 	u32 mask;
162 	u32 cell_low;
163 	u32 mask_low;
164 	int deferred_nr;
165 	int shift_nr;
166 };
167 
168 #endif /* __LINUX_PLATFORM_DATA_MLXREG_H */
169