[src/trunk]: src/share/man/man4 Describe the i2c ioctl interface

[nia <nia%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/a7aaff5f45af
branches:  trunk
changeset: 953128:a7aaff5f45af
user:      nia <nia%NetBSD.org@localhost>
date:      Sat Feb 27 08:56:14 2021 +0000

description:
Describe the i2c ioctl interface

diffstat:

 share/man/man4/iic.4 |  33 ++++++++++++++++++++++++++++++++-
 1 files changed, 32 insertions(+), 1 deletions(-)

diffs (47 lines):

diff -r e3fd55ebf0ce -r a7aaff5f45af share/man/man4/iic.4
--- a/share/man/man4/iic.4      Sat Feb 27 08:43:15 2021 +0000
+++ b/share/man/man4/iic.4      Sat Feb 27 08:56:14 2021 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: iic.4,v 1.23 2021/02/27 08:43:15 nia Exp $
+.\"    $NetBSD: iic.4,v 1.24 2021/02/27 08:56:14 nia Exp $
 .\"    $OpenBSD: iic.4,v 1.74 2008/09/10 16:13:43 reyk Exp $
 .\"
 .\" Copyright (c) 2004, 2006 Alexander Yurchenko <grange%openbsd.org@localhost>
@@ -100,6 +100,37 @@
 .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 SPI
+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