1 /* 2 * Copyright (c) 2017 Mellanox Technologies. All rights reserved. 3 * Copyright (c) 2017 Vadim Pasternak <[email protected]> 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 * @regnum: number of registers occupied by multi-register attribute; 84 */ 85 struct mlxreg_core_data { 86 char label[MLXREG_CORE_LABEL_MAX_SIZE]; 87 u32 reg; 88 u32 mask; 89 u32 bit; 90 u32 capability; 91 umode_t mode; 92 struct device_node *np; 93 struct mlxreg_hotplug_device hpdev; 94 u8 health_cntr; 95 bool attached; 96 u8 regnum; 97 }; 98 99 /** 100 * struct mlxreg_core_item - same type components controlled by the driver: 101 * 102 * @data: component data; 103 * @aggr_mask: group aggregation mask; 104 * @reg: group interrupt status register; 105 * @mask: group interrupt mask; 106 * @capability: group capability register; 107 * @cache: last status value for elements fro the same group; 108 * @count: number of available elements in the group; 109 * @ind: element's index inside the group; 110 * @inversed: if 0: 0 for signal status is OK, if 1 - 1 is OK; 111 * @health: true if device has health indication, false in other case; 112 */ 113 struct mlxreg_core_item { 114 struct mlxreg_core_data *data; 115 u32 aggr_mask; 116 u32 reg; 117 u32 mask; 118 u32 capability; 119 u32 cache; 120 u8 count; 121 u8 ind; 122 u8 inversed; 123 u8 health; 124 }; 125 126 /** 127 * struct mlxreg_core_platform_data - platform data: 128 * 129 * @data: instance private data; 130 * @regmap: register map of parent device; 131 * @counter: number of instances; 132 * @features: supported features of device; 133 * @version: implementation version; 134 * @identity: device identity name; 135 */ 136 struct mlxreg_core_platform_data { 137 struct mlxreg_core_data *data; 138 void *regmap; 139 int counter; 140 u32 features; 141 u32 version; 142 char identity[MLXREG_CORE_LABEL_MAX_SIZE]; 143 }; 144 145 /** 146 * struct mlxreg_core_hotplug_platform_data - hotplug platform data: 147 * 148 * @items: same type components with the hotplug capability; 149 * @irq: platform interrupt number; 150 * @regmap: register map of parent device; 151 * @counter: number of the components with the hotplug capability; 152 * @cell: location of top aggregation interrupt register; 153 * @mask: top aggregation interrupt common mask; 154 * @cell_low: location of low aggregation interrupt register; 155 * @mask_low: low aggregation interrupt common mask; 156 * @deferred_nr: I2C adapter number must be exist prior probing execution; 157 * @shift_nr: I2C adapter numbers must be incremented by this value; 158 */ 159 struct mlxreg_core_hotplug_platform_data { 160 struct mlxreg_core_item *items; 161 int irq; 162 void *regmap; 163 int counter; 164 u32 cell; 165 u32 mask; 166 u32 cell_low; 167 u32 mask_low; 168 int deferred_nr; 169 int shift_nr; 170 }; 171 172 #endif /* __LINUX_PLATFORM_DATA_MLXREG_H */ 173