i2cvar.h revision 1.24.2.5
1 /* $NetBSD: i2cvar.h,v 1.24.2.5 2021/05/17 00:05:56 thorpej Exp $ */ 2 3 /* 4 * Copyright (c) 2003 Wasabi Systems, Inc. 5 * All rights reserved. 6 * 7 * Written by Steve C. Woodford and Jason R. Thorpe for Wasabi Systems, Inc. 8 * 9 * Redistribution and use in source and binary forms, with or without 10 * modification, are permitted provided that the following conditions 11 * are met: 12 * 1. Redistributions of source code must retain the above copyright 13 * notice, this list of conditions and the following disclaimer. 14 * 2. Redistributions in binary form must reproduce the above copyright 15 * notice, this list of conditions and the following disclaimer in the 16 * documentation and/or other materials provided with the distribution. 17 * 3. All advertising materials mentioning features or use of this software 18 * must display the following acknowledgement: 19 * This product includes software developed for the NetBSD Project by 20 * Wasabi Systems, Inc. 21 * 4. The name of Wasabi Systems, Inc. may not be used to endorse 22 * or promote products derived from this software without specific prior 23 * written permission. 24 * 25 * THIS SOFTWARE IS PROVIDED BY WASABI SYSTEMS, INC. ``AS IS'' AND 26 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 27 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 28 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL WASABI SYSTEMS, INC 29 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 30 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 31 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 32 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 33 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 34 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 35 * POSSIBILITY OF SUCH DAMAGE. 36 */ 37 38 #ifndef _DEV_I2C_I2CVAR_H_ 39 #define _DEV_I2C_I2CVAR_H_ 40 41 #include <sys/device.h> 42 #include <sys/mutex.h> 43 #include <dev/i2c/i2c_io.h> 44 #include <prop/proplib.h> 45 46 /* Flags passed to i2c routines. */ 47 #define I2C_F_WRITE 0 /* new transfer is a write */ 48 #define I2C_F_READ __BIT(0) /* new transfer is a read */ 49 #define I2C_F_LAST __BIT(1) /* last byte of read */ 50 #define I2C_F_STOP __BIT(2) /* send stop after byte */ 51 #define I2C_F_POLL __BIT(3) /* poll, don't sleep */ 52 #define I2C_F_PEC __BIT(4) /* smbus packet error checking */ 53 #define I2C_F_SPEED __BITS(28,31) /* I2C transfer speed selector */ 54 55 #define I2C_SPEED_SM 0 /* standard mode (100Kb/s) */ 56 #define I2C_SPEED_FM 1 /* fast mode (400Kb/s) */ 57 #define I2C_SPEED_FMPLUS 2 /* fast mode+ (1Mb/s) */ 58 #define I2C_SPEED_HS 3 /* high speed (3.4Mb/s) */ 59 60 /* i2c bus instance properties */ 61 #define I2C_PROP_INDIRECT_PROBE_STRATEGY \ 62 "i2c-indirect-probe-strategy" 63 #define I2C_PROBE_STRATEGY_QUICK_WRITE \ 64 "smbus-quick-write" 65 #define I2C_PROBE_STRATEGY_RECEIVE_BYTE \ 66 "smbus-receive-byte" 67 #define I2C_PROBE_STRATEGY_NONE \ 68 "none" 69 70 #define I2C_PROP_INDIRECT_DEVICE_PERMITLIST \ 71 "i2c-indirect-device-permitlist" 72 /* value is a prop_array of prop_strings */ 73 74 struct ic_intr_list { 75 LIST_ENTRY(ic_intr_list) il_next; 76 int (*il_intr)(void *); 77 void *il_intrarg; 78 }; 79 80 /* 81 * This structure provides the interface between the i2c framework 82 * and the underlying i2c controller. 83 * 84 * Note that this structure is designed specifically to allow us 85 * to either use the autoconfiguration framework or not. This 86 * allows a driver for a board with a private i2c bus use generic 87 * i2c client drivers for chips that might be on that board. 88 */ 89 typedef struct i2c_controller { 90 void *ic_cookie; /* controller private */ 91 92 /* 93 * Multi-channel i2c controllers and i2c muxes allow 94 * for multiple busses to be driven by a single block 95 * of controller logic. Different platform device 96 * tree representations may find it useful to know 97 * which physical channel a given logical controller 98 * (represented by the i2c_tag_t) is associated with. 99 * We allow this to be stashed away here as a convenience. 100 * This is not used for anything else by the i2c layer. 101 */ 102 int ic_channel; 103 104 /* 105 * These provide synchronization in the presence of 106 * multiple users of the i2c bus. When a device 107 * driver wishes to perform transfers on the i2c 108 * bus, the driver should acquire the bus. When 109 * the driver is finished, it should release the 110 * bus. 111 * 112 * The main synchronization logic is handled by the 113 * generic i2c layer, but optional hooks to back-end 114 * drivers are provided in case additional processing 115 * is needed (e.g. enabling the i2c controller). 116 */ 117 kmutex_t ic_bus_lock; 118 int (*ic_acquire_bus)(void *, int); 119 void (*ic_release_bus)(void *, int); 120 121 /* 122 * The preferred API for clients of the i2c interface 123 * is the scripted API. This handles i2c controllers 124 * that do not provide raw access to the i2c signals. 125 */ 126 int (*ic_exec)(void *, i2c_op_t, i2c_addr_t, const void *, size_t, 127 void *, size_t, int); 128 129 int (*ic_send_start)(void *, int); 130 int (*ic_send_stop)(void *, int); 131 int (*ic_initiate_xfer)(void *, i2c_addr_t, int); 132 int (*ic_read_byte)(void *, uint8_t *, int); 133 int (*ic_write_byte)(void *, uint8_t, int); 134 135 LIST_HEAD(, ic_intr_list) ic_list; 136 LIST_HEAD(, ic_intr_list) ic_proc_list; 137 volatile int ic_running; 138 volatile int ic_pending; 139 struct lwp *ic_intr_thread; 140 const char *ic_devname; 141 } *i2c_tag_t; 142 143 /* Used to attach the i2c framework to the controller. */ 144 struct i2cbus_attach_args { 145 i2c_tag_t iba_tag; /* the controller */ 146 }; 147 148 /* Used to attach devices on the i2c bus. */ 149 struct i2c_attach_args { 150 i2c_tag_t ia_tag; /* our controller */ 151 i2c_addr_t ia_addr; /* address of device */ 152 int ia_type; /* bus type */ 153 154 /* only set if using direct config */ 155 const char * ia_name; /* name of the device */ 156 const char * ia_clist; /* compatible strlist */ 157 size_t ia_clist_size; /* size of compatible strlist */ 158 prop_dictionary_t ia_prop; /* property dictionary for the device */ 159 devhandle_t ia_devhandle; /* device handle for the device */ 160 }; 161 162 /* 163 * i2c-enumerate-devices device call 164 * 165 * Enumerate the devices connected to this I2C bus, filling out 166 * the i2c_attach_args and invoking the callback for each one. 167 * If the callback returns true, then enumeration continues. If 168 * the callback returns false, enumeration is stopped. 169 */ 170 struct i2c_enumerate_devices_args { 171 struct i2c_attach_args *ia; 172 bool (*callback)(device_t, struct i2c_enumerate_devices_args *); 173 }; 174 175 /* 176 * API presented to i2c controllers. 177 */ 178 int iicbus_print(void *, const char *); 179 int iicbus_print_multi(void *, const char *); 180 void iic_tag_init(i2c_tag_t); 181 void iic_tag_fini(i2c_tag_t); 182 183 /* 184 * API presented to i2c devices. 185 */ 186 int iic_compatible_match(const struct i2c_attach_args *, 187 const struct device_compatible_entry *); 188 bool iic_use_direct_match(const struct i2c_attach_args *, const cfdata_t, 189 const struct device_compatible_entry *, int *); 190 const struct device_compatible_entry * 191 iic_compatible_lookup(const struct i2c_attach_args *, 192 const struct device_compatible_entry *); 193 194 /* 195 * Constants to indicate the quality of a match made by a driver's 196 * match routine, from lowest to higest: 197 * 198 * -- Address only; no other checks were made. 199 * 200 * -- Address + device probed and recognized. 201 * 202 * -- Direct-config match by "compatible" string. 203 * 204 * -- Direct-config match by specific driver name. 205 */ 206 #define I2C_MATCH_ADDRESS_ONLY 1 207 #define I2C_MATCH_ADDRESS_AND_PROBE 2 208 #define I2C_MATCH_DIRECT_COMPATIBLE 10 209 #define I2C_MATCH_DIRECT_COMPATIBLE_MAX 99 210 #define I2C_MATCH_DIRECT_SPECIFIC 100 211 212 #ifdef _I2C_PRIVATE 213 /* 214 * Macros used internally by the i2c framework. 215 */ 216 #define iic_send_start(ic, flags) \ 217 (*(ic)->ic_send_start)((ic)->ic_cookie, (flags)) 218 #define iic_send_stop(ic, flags) \ 219 (*(ic)->ic_send_stop)((ic)->ic_cookie, (flags)) 220 #define iic_initiate_xfer(ic, addr, flags) \ 221 (*(ic)->ic_initiate_xfer)((ic)->ic_cookie, (addr), (flags)) 222 223 #define iic_read_byte(ic, bytep, flags) \ 224 (*(ic)->ic_read_byte)((ic)->ic_cookie, (bytep), (flags)) 225 #define iic_write_byte(ic, byte, flags) \ 226 (*(ic)->ic_write_byte)((ic)->ic_cookie, (byte), (flags)) 227 #endif /* _I2C_PRIVATE */ 228 229 /* 230 * Simplified API for clients of the i2c framework. Definitions 231 * in <dev/i2c/i2c_io.h>. 232 */ 233 int iic_acquire_bus(i2c_tag_t, int); 234 void iic_release_bus(i2c_tag_t, int); 235 int iic_exec(i2c_tag_t, i2c_op_t, i2c_addr_t, const void *, 236 size_t, void *, size_t, int); 237 238 int iic_smbus_write_byte(i2c_tag_t, i2c_addr_t, uint8_t, uint8_t, int); 239 int iic_smbus_write_word(i2c_tag_t, i2c_addr_t, uint8_t, uint16_t, int); 240 int iic_smbus_read_byte(i2c_tag_t, i2c_addr_t, uint8_t, uint8_t *, int); 241 int iic_smbus_read_word(i2c_tag_t, i2c_addr_t, uint8_t, uint16_t *, int); 242 int iic_smbus_receive_byte(i2c_tag_t, i2c_addr_t, uint8_t *, int); 243 int iic_smbus_send_byte(i2c_tag_t, i2c_addr_t, uint8_t, int); 244 int iic_smbus_quick_read(i2c_tag_t, i2c_addr_t, int); 245 int iic_smbus_quick_write(i2c_tag_t, i2c_addr_t, int); 246 int iic_smbus_block_read(i2c_tag_t, i2c_addr_t, uint8_t, uint8_t *, 247 size_t, int); 248 int iic_smbus_block_write(i2c_tag_t, i2c_addr_t, uint8_t, uint8_t *, 249 size_t, int); 250 251 void * iic_smbus_intr_establish(i2c_tag_t, int (*)(void *), void *); 252 void * iic_smbus_intr_establish_proc(i2c_tag_t, int (*)(void *), void *); 253 void iic_smbus_intr_disestablish(i2c_tag_t, void *); 254 void iic_smbus_intr_disestablish_proc(i2c_tag_t, void *); 255 int iic_smbus_intr(i2c_tag_t); 256 257 #endif /* _DEV_I2C_I2CVAR_H_ */ 258
Indexes created Fri Oct 03 02:09:57 GMT 2025