include: media: Add camera device driver header

This header defines the I2C, SPI bus, multiplexer
configurations and the overall sensor configuration
for the camera device.
This header exposes the structures which can be
used in userspace for the interface communication
with camera device driver.

Bug 2433156

Change-Id: I05ae2ec4144c01bef664d329082d640b7d6ac1a1
Signed-off-by: Bhanu Murthy V <bmurthyv@nvidia.com>
Reviewed-on: https://git-master.nvidia.com/r/1822198
(cherry picked from commit 3f0c4dce47ede75c20f54a8fab4c0be4143a1786)
Reviewed-on: https://git-master.nvidia.com/r/2006760
Tested-by: Ian Kaszubski <ikaszubski@nvidia.com>
Reviewed-by: Vincent Chung <vincentc@nvidia.com>
GVS: Gerrit_Virtual_Submit
Reviewed-by: Frank Chen <frankc@nvidia.com>
Reviewed-by: mobile promotions <svcmobile_promotions@nvidia.com>
Tested-by: mobile promotions <svcmobile_promotions@nvidia.com>

2 files changed, 135 insertions, 1 deletions

diff --git a/include/media/camera_device.h b/include/media/camera_device.h
new file mode 100644
index 000000000..575ae16ef
--- /dev/null
+++ b/include/media/camera_device.h
@@ -0,0 +1,132 @@
+/*
+ * include/linux/media/camera_device.h
+ *
+ * camera device driver header
+ *
+ * Copyright (c) 2019 NVIDIA Corporation.  All rights reserved.
+ *
+ * This program is free software; you can redistribute it and/or modify it
+ * under the terms and conditions of the GNU General Public License,
+ * version 2, as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+ * more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+#ifndef __CAMERA_DEVICE_H_
+#define __CAMERA_DEVICE_H_
+
+#include <linux/compiler.h>
+#include <linux/types.h>
+#include <linux/ioctl.h>
+
+#define __CAMERA_DEVICE_ALIGN __aligned(8)
+
+/* Sensor, focuser, iris etc., */
+#define MAX_DEVICES_PER_CHANNEL 4
+
+/*
+ * Increasing below values must validate
+ * copy_from or copy_to works properly
+ */
+#define MAX_COMMANDS 256
+#define MAX_BLOB_SIZE 2048
+
+struct i2c_bus {
+        u32 reg_base;
+        u32 clk_rate;
+        u32 flags;
+        u8 reserved[4];
+};
+
+struct i2c_mux {
+        bool is_mux_valid;
+        u8 mux_channel;
+        u16 mux_addr;
+        u8 reserved[4];
+};
+
+struct i2c_dev {
+        u16 addr;
+        u8 pad[2];
+        u32 flags;
+};
+
+struct spi_bus {
+        u32 reg_base;
+        u32 clk_rate;
+        u32 flags;
+        u8 reserved[4];
+};
+
+struct spi_dev {
+        u8 port;
+        u16 addr;
+        u8 pad;
+        u32 flags;
+        u8 pad1[4];
+};
+
+struct i2c_sensor_cfg {
+        u32 num_devs;
+        struct i2c_bus bus;
+        struct i2c_mux mux;
+        struct i2c_dev sd[MAX_DEVICES_PER_CHANNEL];
+};
+
+struct spi_sensor_cfg {
+        u32 num_devs;
+        struct spi_bus bus;
+        struct spi_dev sd[MAX_DEVICES_PER_CHANNEL];
+};
+
+struct sensor_cfg {
+        u8 type; /* SPI or I2C */
+        u8 pad[3]; /* for alignment */
+        union {
+                struct i2c_sensor_cfg i2c_sensor;
+                struct spi_sensor_cfg spi_sensor;
+        } u;
+} __CAMERA_DEVICE_ALIGN;
+
+struct sensor_cmd {
+        u32 opcode;
+        u32 addr;
+};
+
+struct sensor_blob {
+        u32 num_cmds;
+        u32 buf_size;
+        struct sensor_cmd cmds[MAX_COMMANDS];
+        u8 buf[MAX_BLOB_SIZE];
+} __CAMERA_DEVICE_ALIGN;
+
+struct sensor_blob_cfg {
+        u32 nlines;
+        struct sensor_blob *blob;
+} __CAMERA_DEVICE_ALIGN;
+
+#define CAMERA_DEVICE_NONE              0
+#define CAMERA_DEVICE_I2C_SENSOR        (0x1 << 1)
+#define CAMERA_DEVICE_SPI_SENSOR        (0x1 << 2)
+/* Future extensions - if necessary */
+#define CAMERA_DEVICE_VI                (0x1 << 8)
+#define CAMERA_DEVICE_CSI               (0x1 << 9)
+#define CAMERA_DEVICE_ISP               (0x1 << 16)
+
+struct camdev_chan_cfg {
+        u32 type;
+        struct sensor_cfg scfg;
+} __CAMERA_DEVICE_ALIGN;
+
+/* common functionality */
+#define CAMERA_DEVICE_REGISTER _IOW('C', 1, struct camdev_chan_cfg)
+#define CAMERA_DEVICE_UNREGISTER _IOW('C', 2, u32)
+/* sensor functionality */
+#define SENSOR_BLOB_EXECUTE _IOW('C', 10, struct sensor_blob_cfg)
+
+#endif
diff --git a/include/media/sensor_common.h b/include/media/sensor_common.h
index 736599f7c..67d1d9965 100644
--- a/include/media/sensor_common.h
+++ b/include/media/sensor_common.h
@@ -1,7 +1,7 @@
 /**
  * sensor_common.h - utilities for tegra camera driver
  *
- * Copyright (c) 2017-2018, NVIDIA Corporation.  All rights reserved.
+ * Copyright (c) 2017-2019, NVIDIA Corporation.  All rights reserved.
  *
  * This program is free software; you can redistribute it and/or modify it
  * under the terms and conditions of the GNU General Public License,
@@ -36,8 +36,10 @@
 #include <media/v4l2-ctrls.h>
 #include <linux/v4l2-mediabus.h>
 #include <media/tegra-v4l2-camera.h>
+#include <media/camera_device.h>
 
 struct sensor_properties {
+        struct sensor_cfg cfg;
         /* sensor_modes points to an array of mode properties */
         struct sensor_mode_properties *sensor_modes;
         u32 num_modes;