Module Name: src
Committed By: mbalmer
Date: Sun Aug 9 08:20:54 UTC 2009
Modified Files:
src/distrib/sets/lists/man: mi
src/share/man/man4: Makefile
Added Files:
src/share/man/man4: gpioiic.4
Log Message:
Add the manual page for the gpioiic(4) driver.
To generate a diff of this commit:
cvs rdiff -u -r1.1151 -r1.1152 src/distrib/sets/lists/man/mi
cvs rdiff -u -r1.495 -r1.496 src/share/man/man4/Makefile
cvs rdiff -u -r0 -r1.1 src/share/man/man4/gpioiic.4
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/distrib/sets/lists/man/mi
diff -u src/distrib/sets/lists/man/mi:1.1151 src/distrib/sets/lists/man/mi:1.1152
--- src/distrib/sets/lists/man/mi:1.1151 Sun Aug 9 06:40:10 2009
+++ src/distrib/sets/lists/man/mi Sun Aug 9 08:20:53 2009
@@ -1,4 +1,4 @@
-# $NetBSD: mi,v 1.1151 2009/08/09 06:40:10 kiyohara Exp $
+# $NetBSD: mi,v 1.1152 2009/08/09 08:20:53 mbalmer Exp $
#
# Note: don't delete entries from here - mark them as "obsolete" instead.
#
@@ -938,6 +938,7 @@
./usr/share/man/cat4/gphyter.0 man-sys-catman .cat
./usr/share/man/cat4/gpib.0 man-sys-catman .cat
./usr/share/man/cat4/gpio.0 man-sys-catman .cat
+./usr/share/man/cat4/gpioiic.0 man-sys-catman .cat
./usr/share/man/cat4/gpioow.0 man-sys-catman .cat
./usr/share/man/cat4/gpiosim.0 man-sys-catman .cat
./usr/share/man/cat4/gre.0 man-sys-catman .cat
@@ -3546,6 +3547,7 @@
./usr/share/man/html4/gphyter.html man-sys-htmlman html
./usr/share/man/html4/gpib.html man-sys-htmlman html
./usr/share/man/html4/gpio.html man-sys-htmlman html
+./usr/share/man/html4/gpioiic.html man-sys-htmlman html
./usr/share/man/html4/gpioow.html man-sys-htmlman html
./usr/share/man/html4/gpiosim.html man-sys-htmlman html
./usr/share/man/html4/gre.html man-sys-htmlman html
@@ -5934,6 +5936,7 @@
./usr/share/man/man4/gphyter.4 man-sys-man .man
./usr/share/man/man4/gpib.4 man-sys-man .man
./usr/share/man/man4/gpio.4 man-sys-man .man
+./usr/share/man/man4/gpioiic.4 man-sys-man .man
./usr/share/man/man4/gpioow.4 man-sys-man .man
./usr/share/man/man4/gpiosim.4 man-sys-man .man
./usr/share/man/man4/gre.4 man-sys-man .man
Index: src/share/man/man4/Makefile
diff -u src/share/man/man4/Makefile:1.495 src/share/man/man4/Makefile:1.496
--- src/share/man/man4/Makefile:1.495 Sun Aug 9 06:40:09 2009
+++ src/share/man/man4/Makefile Sun Aug 9 08:20:53 2009
@@ -1,4 +1,4 @@
-# $NetBSD: Makefile,v 1.495 2009/08/09 06:40:09 kiyohara Exp $
+# $NetBSD: Makefile,v 1.496 2009/08/09 08:20:53 mbalmer Exp $
# @(#)Makefile 8.1 (Berkeley) 6/18/93
MAN= aac.4 ac97.4 acardide.4 aceride.4 acphy.4 acpidalb.4 \
@@ -86,7 +86,7 @@
MAN+= radio.4 az.4 mr.4 rt.4 rtii.4 sf2r.4
# machine-independent busses
-MAN+= eisa.4 isa.4 isapnp.4 ofisa.4 pci.4 pcmcia.4
+MAN+= eisa.4 gpioiic.4 isa.4 isapnp.4 ofisa.4 pci.4 pcmcia.4
MAN+= podulebus.4 ieee1394if.4 spi.4
# machine-independent PCI devices
Added files:
Index: src/share/man/man4/gpioiic.4
diff -u /dev/null src/share/man/man4/gpioiic.4:1.1
--- /dev/null Sun Aug 9 08:20:54 2009
+++ src/share/man/man4/gpioiic.4 Sun Aug 9 08:20:53 2009
@@ -0,0 +1,93 @@
+.\" $NetBSD: gpioiic.4,v 1.1 2009/08/09 08:20:53 mbalmer Exp $
+.\" $OpenBSD: gpioiic.4,v 1.6 2008/11/24 15:30:21 jmc Exp $
+.\"
+.\" Copyright (c) 2006 Alexander Yurchenko <[email protected]>
+.\"
+.\" 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 August 8, 2009
+.Dt GPIOIIC 4
+.Os
+.Sh NAME
+.Nm gpioiic
+.Nd GPIO I2C controller
+.Sh SYNOPSIS
+.Cd "gpioiic* at gpio? offset 0 mask 0x3"
+.Cd "gpioiic* at gpio?"
+.Cd "iic* at gpioiic?"
+.Sh DESCRIPTION
+The
+.Nm
+driver allows bit-banging an I2C bus as a master using two GPIO pins.
+The first pin is used as a serial data (SDA) signal and the second as
+a serial clock (SCL).
+Both GPIO pins must be able to drive an output and the SDA pin must be
+also able to read an input.
+.Pp
+The pins can be specified in the kernel configuration with the
+.Ar offset
+and the
+.Ar mask
+locators.
+The
+.Ar offset
+and
+.Ar mask
+can also be specified when
+.Nm
+is attached at runtime using the
+.Dv GPIOATTACH
+.Xr ioctl 2
+on the
+.Xr gpio 4
+device.
+Each bit in the
+.Ar mask
+locator defines one pin; the pin number is calculated as an addition of
+the bit position and the
+.Ar offset
+locator.
+For example,
+.Ar offset 17
+and
+.Ar mask 0x5
+defines pin numbers 17 and 19.
+.Sh CAVEATS
+A
+.Nm
+device can not be detached from the
+.Xr gpio 4
+bus at runtime due to the fact that
+.Xr iic 4
+busses can not detach once attached.
+.Sh SEE ALSO
+.Xr gpio 4 ,
+.Xr iic 4 ,
+.Xr intro 4
+.Sh HISTORY
+The
+.Nm
+driver first appeared in
+.Ox 3.9
+and
+.Nx 5.0 .
+.Sh AUTHORS
+.An -nosplit
+The
+.Nm
+driver was written by
+.An Alexander Yurchenko Aq [email protected]
+and was pprted to
+.Nx
+by
+.An Marc Balmer Aq [email protected] .
