.\" $NetBSD: iic.4,v 1.22.6.1 2021/03/05 13:55:27 martin Exp $ .\" $OpenBSD: iic.4,v 1.74 2008/09/10 16:13:43 reyk Exp $ .\" .\" Copyright (c) 2004, 2006 Alexander Yurchenko .\" Copyright (c) 2009 Hubert Feyrer .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies. .\" .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" .Dd February 27, 2021 .Dt IIC 4 .Os .Sh NAME .Nm iic .Nd Inter IC (I2C) bus .Sh SYNOPSIS .\" .\" Use the following commands in (t)csh to output the list below (note .\" the first sed command includes a and character in each .\" of the bracket expressions): .\" cd .../src/sys/arch .\" grep -h '^iic.*at' */conf/* | sort -u -k +3 | sed -e 's,[ ][ ]*, ,g' -e 's, *#.*,,' | sh -c 'while read iic at ic ; do printf ".Cd \"$iic $at %-20s # %s\"\n" "$ic" "`grep \"iic.*at.*$ic\" */conf/* | sed \"s,/.*,,\" | sort -u | tr \"\012\" \ `" ; done' | uniq | tee /tmp/x .\" cat /tmp/x .\" .Cd "iic* at alipm? # alpha amd64 i386 sparc64 " .Cd "iic* at amdpm? # amd64 i386 " .Cd "iic* at armadillo9iic? # evbarm " .Cd "iic0 at at91twi? # evbarm " .Cd "iic0 at ausmbus0 # evbmips " .Cd "iic* at awiniic? # evbarm " .Cd "iic* at bcmi2c? # evbarm " .Cd "iic* at coram? # amd64 i386 " .Cd "iic* at cuda? # macppc " .Cd "iic* at cxdtv? # amd64 i386 " .Cd "iic* at diic? # acorn32 evbppc " .Cd "iic* at dwiic? # amd64 i386 " .Cd "iic* at exyoi2c? # evbarm " .Cd "iic* at g2i2c? # evbarm " .Cd "iic0 at gpiic? # evbppc " .Cd "iic* at gpioiic? # amd64 i386 " .Cd "iic* at gttwsi? # evbarm evbppc " .Cd "iic* at gxiic? # evbarm " .Cd "iic* at i2cbus? # evbarm " .Cd "iic* at ichsmb? # amd64 i386 " .Cd "iic* at imcsmb? # amd64 i386 " .Cd "iic* at imxi2c? # evbarm " .Cd "iic0 at iomdiic? # acorn32 " .Cd "iic0 at iopiic? # evbarm iyonix " .Cd "iic* at ismt? # amd64 i386 " .Cd "iic* at jziic? # evbmips " .Cd "iic* at ki2c? # macppc " .Cd "iic* at nbpiic? # hpcarm " .Cd "iic* at nfsmb? # amd64 i386 " .Cd "iic* at ociic? # sandpoint " .Cd "iic* at omapiic? # evbarm " .Cd "iic* at pcfiic? # sparc64 " .Cd "iic* at piixpm? # amd64 i386 " .Cd "iic* at pmu? # macppc " .Cd "iic* at ri2c? # evbmips " .Cd "iic* at rtciic? # mmeye " .Cd "iic0 at slugiic0 # evbarm " .Cd "iic* at tegrai2c? # evbarm " .Cd "iic* at tiiic? # evbarm " .Cd "iic* at tsciic? # alpha " .Cd "iic* at viapcib? # i386 " .Cd "iic* at voyager0 # evbmips " .Cd "iic0 at ziic? # evbmips zaurus " .Sh DESCRIPTION I2C is a two-wire bus developed by Philips used for connecting integrated circuits. It is commonly used for connecting devices such as EEPROMs, temperature sensors, fan controllers, real-time clocks, tuners, and other types of integrated circuits. .Pp The .Nm driver provides a uniform programming interface layer between I2C master controllers and various I2C slave devices. Each I2C master controller attaches an .Nm framework; several slave devices can then be attached to the .Nm bus. .Pp All I2C slave devices are uniquely identified by the address on the bus. The master accesses a particular slave device using its address. .\" Devices are found on the bus using a sophisticated scanning routine .\" which attempts to identify commonly available devices. .\" On other machines (such as sparc64 and macppc) where the machine ROM .\" supplies a list of I2C devices, that list is used instead. .Pp System Management Bus (SMBus) protocol is also supported by emulating it with the I2C commands. .Sh IOCTLS The following .Xr ioctl 2 calls apply to .Em IIC devices. They are defined in the header file .In dev/i2c/i2c_io.h : .Bl -tag -width indent .It Dv I2C_IOCTL_EXEC (i2c_ioctl_exec_t) User ioctl to execute an i2c operation. .Bd -literal typedef enum { I2C_OP_READ, I2C_OP_READ_WITH_STOP, I2C_OP_WRITE, I2C_OP_WRITE_WITH_STOP, I2C_OP_READ_BLOCK, I2C_OP_WRITE_BLOCK } i2c_op_t; typedef struct i2c_ioctl_exec { i2c_op_t iie_op; /* operation to perform */ i2c_addr_t iie_addr; /* address of device */ const void *iie_cmd; /* pointer to command */ size_t iie_cmdlen; /* length of command */ void *iie_buf; /* pointer to data buffer */ size_t iie_buflen; /* length of data buffer */ } i2c_ioctl_exec_t; .Ed .El .Sh SUPPORTED MASTERS A wide list of I2C masters are supported, among them are: .Pp .\" .\" Generate the following list with these (t)csh commands: .\" cd .../src/sys/arch .\" grep -h '^iic.*at' */conf/* | awk '{print $3}' | sed 's,.$,,' | sort -u | sh -c 'while read i ; do echo .It Xr $i 4; n=`grep -h ^.Nd ../../share/man/man4/$i* | sed "s,^.Nd ,,"`; if [ -n "$n" ]; then echo $n ; else echo "" ; fi ; done' | tee /tmp/x .\" cat /tmp/x .\" .Bl -tag -width 18n -compact -offset indent .It Xr acpismbus 4 ACPI SMBus Control Method Interface .It Xr alipm 4 Acer Labs M7101 SMBus controller .It Xr amdpm 4 AMD768 Power Management Controller and AMD8111 System Management Controller .It Xr armadillo9iic 4 .It Xr at91twi 4 .It Xr ausmbus 4 .It Xr awiniic 4 .It Xr awinp2wi 4 .It Xr bcmi2c 4 .It Xr coram 4 digital video driver for Conexant CX23885 based cards .It Xr cuda 4 support for CUDA microcontrollers found in many Power Macintosh and compatible computers .It Xr cxdtv 4 digital video driver for Conexant CX2388x based cards .It Xr diic 4 .It Xr exyoiic 4 .It Xr g2i2c 4 .It Xr gpiic 4 .It Xr gpioiic 4 GPIO I2C controller .It Xr gttwsi 4 .It Xr i2cbus 4 .It Xr gxiic 4 .It Xr ichsmb 4 Intel Chipset internal SMBus controller .It Xr imxi2c 4 .It Xr iociic 4 .It Xr iomdiic 4 .It Xr iopiic 4 .It Xr ismt 4 Intel Chipset internal SMBus 2.0 controller with DMA .It Xr jziic 4 .It Xr ki2c 4 .It Xr nbpiic 4 .It Xr nfsmb 4 NVIDIA nForce 2/3/4 SMBus controller and SMBus driver .It Xr ociic 4 .It Xr omapiic 4 .It Xr pcfiic 4 .It Xr piixpm 4 Intel PIIX and compatible Power Management controller .It Xr ri2c 4 .It Xr rkiic 4 .It Xr rtciic 4 .It Xr slugiic 4 .It Xr tegrai2c 4 .It Xr tiiic 4 .It Xr tsciic 4 .It Xr viapcib 4 .El .Sh SUPPORTED SLAVES A wide list of slaves are supported, among them: .Pp .\" .\" Create the following list with these commands: .\" cd .../src/sys/arch .\" grep -h '.* at iic.*' */conf/* | sed -e 's,^#,,' -e 's, .*,,' -e 's,.$,,' | sort -u | sh -c 'while read i ; do echo .It Xr $i 4 ; n=`grep ^.Nd ../../share/man/man4/$i* | sed "s,^.Nd ,,"` ; if [ -n "$n" ]; then echo $n ; else echo "" ; fi ; done' | tee /tmp/x .\" cat /tmp/x .\" .Bl -tag -width 13n -compact -offset indent .It Xr dbcool 4 dbCool(tm) family of environmental monitors and fan controllers .It Xr dsrtc 4 .It Xr ioexp 4 .It Xr m41trtc 4 .It Xr nbppcon 4 .It Xr pcf8563rtc 4 NXP PCF8563 real-time clock .It Xr r2025rtc 4 .It Xr rs5c372rtc 4 RICOH RS5C372A and RS5C372B real-time clock .It Xr s390rtc 4 Seiko Instruments S-35390 real-time clock .It Xr sdtemp 4 JEDEC JC-42.4 compatible memory module temperature sensors .It Xr seeprom 4 24-series I2C EEPROM driver .It Xr sgsmix 4 driver for SGS 7433 Basic Audio Processor found in some Apple machines .It Xr spdmem 4 Generic Memory Module Serial Presence Detect .It Xr ssdfb 4 OLED/PLED framebuffer modules .El .Sh FILES .Bl -tag -width "/dev/iicu" -compact .It /dev/iic Ns Ar u I2C device unit .Ar u file. .El .Sh SEE ALSO .Xr dtviic 4 , .Xr intro 4 , .Xr i2cscan 8 , .Xr iic 9 .Sh HISTORY The I2C framework first appeared in .Nx 2.0 . .Ox support was added in .Ox 3.6 . This manpage first appeared in .Nx 6.0 , it was ported from .Ox . .Sh AUTHORS .An -nosplit The I2C framework was written by .An Steve C. Woodford and .An Jason R. Thorpe for .Nx and then ported to .Ox by .An Alexander Yurchenko Aq Mt grange@openbsd.org .