| @@ -1,14 +1,14 @@ | | | @@ -1,14 +1,14 @@ |
1 | .\" $NetBSD: iic.4,v 1.14 2018/01/24 09:04:42 skrll Exp $ | | 1 | .\" $NetBSD: iic.4,v 1.15 2018/01/24 10:00:42 wiz Exp $ |
2 | .\" $OpenBSD: iic.4,v 1.74 2008/09/10 16:13:43 reyk Exp $ | | 2 | .\" $OpenBSD: iic.4,v 1.74 2008/09/10 16:13:43 reyk Exp $ |
3 | .\" | | 3 | .\" |
4 | .\" Copyright (c) 2004, 2006 Alexander Yurchenko <grange@openbsd.org> | | 4 | .\" Copyright (c) 2004, 2006 Alexander Yurchenko <grange@openbsd.org> |
5 | .\" Copyright (c) 2009 Hubert Feyrer <hubertf@NetBSD.org> | | 5 | .\" Copyright (c) 2009 Hubert Feyrer <hubertf@NetBSD.org> |
6 | .\" | | 6 | .\" |
7 | .\" Permission to use, copy, modify, and distribute this software for any | | 7 | .\" Permission to use, copy, modify, and distribute this software for any |
8 | .\" purpose with or without fee is hereby granted, provided that the above | | 8 | .\" purpose with or without fee is hereby granted, provided that the above |
9 | .\" copyright notice and this permission notice appear in all copies. | | 9 | .\" copyright notice and this permission notice appear in all copies. |
10 | .\" | | 10 | .\" |
11 | .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES | | 11 | .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES |
12 | .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF | | 12 | .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF |
13 | .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR | | 13 | .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR |
14 | .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES | | 14 | .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES |
| @@ -67,61 +67,51 @@ | | | @@ -67,61 +67,51 @@ |
67 | .Cd "iic1 at rkiic1 # evbarm " | | 67 | .Cd "iic1 at rkiic1 # evbarm " |
68 | .Cd "iic2 at rkiic2 # evbarm " | | 68 | .Cd "iic2 at rkiic2 # evbarm " |
69 | .Cd "iic3 at rkiic3 # evbarm " | | 69 | .Cd "iic3 at rkiic3 # evbarm " |
70 | .Cd "iic4 at rkiic4 # evbarm " | | 70 | .Cd "iic4 at rkiic4 # evbarm " |
71 | .Cd "iic* at rtciic? # mmeye " | | 71 | .Cd "iic* at rtciic? # mmeye " |
72 | .Cd "iic0 at slugiic0 # evbarm " | | 72 | .Cd "iic0 at slugiic0 # evbarm " |
73 | .Cd "iic* at tegrai2c? # evbarm " | | 73 | .Cd "iic* at tegrai2c? # evbarm " |
74 | .Cd "iic* at tiiic? # evbarm " | | 74 | .Cd "iic* at tiiic? # evbarm " |
75 | .Cd "iic* at tsciic? # alpha " | | 75 | .Cd "iic* at tsciic? # alpha " |
76 | .Cd "iic* at viapcib? # i386 " | | 76 | .Cd "iic* at viapcib? # i386 " |
77 | .Cd "iic* at voyager0 # evbmips " | | 77 | .Cd "iic* at voyager0 # evbmips " |
78 | .Cd "iic0 at ziic? # evbmips zaurus " | | 78 | .Cd "iic0 at ziic? # evbmips zaurus " |
79 | .Sh DESCRIPTION | | 79 | .Sh DESCRIPTION |
80 | .Tn I2C | | 80 | I2C is a two-wire bus developed by Philips used for connecting |
81 | is a two-wire bus developed by Philips used for connecting | | | |
82 | integrated circuits. | | 81 | integrated circuits. |
83 | It is commonly used for connecting devices such as EEPROMs, | | 82 | It is commonly used for connecting devices such as EEPROMs, |
84 | temperature sensors, fan controllers, real-time clocks, tuners, | | 83 | temperature sensors, fan controllers, real-time clocks, tuners, |
85 | and other types of integrated circuits. | | 84 | and other types of integrated circuits. |
86 | .Pp | | 85 | .Pp |
87 | The | | 86 | The |
88 | .Nm | | 87 | .Nm |
89 | driver provides a uniform programming interface layer between | | 88 | driver provides a uniform programming interface layer between I2C |
90 | .Tn I2C | | 89 | master controllers and various I2C slave devices. |
91 | master controllers and various | | 90 | Each I2C master controller attaches an |
92 | .Tn I2C | | | |
93 | slave devices. | | | |
94 | Each | | | |
95 | .Tn I2C | | | |
96 | master controller attaches an | | | |
97 | .Nm | | 91 | .Nm |
98 | framework; several slave devices can then be attached to the | | 92 | framework; several slave devices can then be attached to the |
99 | .Nm | | 93 | .Nm |
100 | bus. | | 94 | bus. |
101 | .Pp | | 95 | .Pp |
102 | All | | 96 | All I2C slave devices are uniquely identified by the address on the bus. |
103 | .Tn I2C | | | |
104 | slave devices are uniquely identified by the address on the bus. | | | |
105 | The master accesses a particular slave device using its address. | | 97 | The master accesses a particular slave device using its address. |
106 | .\" Devices are found on the bus using a sophisticated scanning routine | | 98 | .\" Devices are found on the bus using a sophisticated scanning routine |
107 | .\" which attempts to identify commonly available devices. | | 99 | .\" which attempts to identify commonly available devices. |
108 | .\" On other machines (such as sparc64 and macppc) where the machine ROM | | 100 | .\" On other machines (such as sparc64 and macppc) where the machine ROM |
109 | .\" supplies a list of I2C devices, that list is used instead. | | 101 | .\" supplies a list of I2C devices, that list is used instead. |
110 | .Pp | | 102 | .Pp |
111 | System Management Bus (SMBus) protocol is also supported by emulating | | 103 | System Management Bus (SMBus) protocol is also supported by emulating |
112 | it with the | | 104 | it with the I2C commands. |
113 | .Tn I2C | | | |
114 | commands. | | | |
115 | .Sh SUPPORTED MASTERS | | 105 | .Sh SUPPORTED MASTERS |
116 | A wide list of I2C masters are supported, among them are: | | 106 | A wide list of I2C masters are supported, among them are: |
117 | .Pp | | 107 | .Pp |
118 | .\" | | 108 | .\" |
119 | .\" Generate the following list with these (t)csh commands: | | 109 | .\" Generate the following list with these (t)csh commands: |
120 | .\" cd .../src/sys/arch | | 110 | .\" cd .../src/sys/arch |
121 | .\" 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 | | 111 | .\" 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 |
122 | .\" cat /tmp/x | | 112 | .\" cat /tmp/x |
123 | .\" | | 113 | .\" |
124 | .Bl -tag -width 18n -compact -offset indent | | 114 | .Bl -tag -width 18n -compact -offset indent |
125 | .It Xr acpismbus 4 | | 115 | .It Xr acpismbus 4 |
126 | ACPI SMBus Control Method Interface | | 116 | ACPI SMBus Control Method Interface |
127 | .It Xr alipm 4 | | 117 | .It Xr alipm 4 |
| @@ -205,38 +195,34 @@ JEDEC JC-42.4 compatible memory module t | | | @@ -205,38 +195,34 @@ JEDEC JC-42.4 compatible memory module t |
205 | .It Xr seeprom 4 | | 195 | .It Xr seeprom 4 |
206 | 24-series I2C EEPROM driver | | 196 | 24-series I2C EEPROM driver |
207 | .It Xr sgsmix 4 | | 197 | .It Xr sgsmix 4 |
208 | driver for SGS 7433 Basic Audio Processor found in some Apple machines | | 198 | driver for SGS 7433 Basic Audio Processor found in some Apple machines |
209 | .It Xr spdmem 4 | | 199 | .It Xr spdmem 4 |
210 | Generic Memory Module Serial Presence Detect | | 200 | Generic Memory Module Serial Presence Detect |
211 | .El | | 201 | .El |
212 | .Sh SEE ALSO | | 202 | .Sh SEE ALSO |
213 | .Xr dtviic 4 , | | 203 | .Xr dtviic 4 , |
214 | .Xr intro 4 , | | 204 | .Xr intro 4 , |
215 | .Xr i2cscan 8 , | | 205 | .Xr i2cscan 8 , |
216 | .Xr iic 9 | | 206 | .Xr iic 9 |
217 | .Sh HISTORY | | 207 | .Sh HISTORY |
218 | The | | 208 | The I2C framework first appeared in |
219 | .Tn I2C | | | |
220 | framework first appeared in | | | |
221 | .Nx 2.0 . | | 209 | .Nx 2.0 . |
222 | .Ox | | 210 | .Ox |
223 | support was added in | | 211 | support was added in |
224 | .Ox 3.6 . | | 212 | .Ox 3.6 . |
225 | This manpage first appeared in | | 213 | This manpage first appeared in |
226 | .Nx 6.0 , | | 214 | .Nx 6.0 , |
227 | it was ported from | | 215 | it was ported from |
228 | .Ox . | | 216 | .Ox . |
229 | .Sh AUTHORS | | 217 | .Sh AUTHORS |
230 | .An -nosplit | | 218 | .An -nosplit |
231 | The | | 219 | The I2C framework was written by |
232 | .Tn I2C | | | |
233 | framework was written by | | | |
234 | .An Steve C. Woodford | | 220 | .An Steve C. Woodford |
235 | and | | 221 | and |
236 | .An Jason R. Thorpe | | 222 | .An Jason R. Thorpe |
237 | for | | 223 | for |
238 | .Nx | | 224 | .Nx |
239 | and then ported to | | 225 | and then ported to |
240 | .Ox | | 226 | .Ox |
241 | by | | 227 | by |
242 | .An Alexander Yurchenko Aq Mt grange@openbsd.org . | | 228 | .An Alexander Yurchenko Aq Mt grange@openbsd.org . |