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