i2c: interfaces for busses, bus_manager, peripherals.

Change-Id: I9c3e92cb1c1833eaadc73fa30fc8757c14c79292
Reviewed-on: https://review.haiku-os.org/c/haiku/+/2455
Reviewed-by: Adrien Destugues <pulkomandy@gmail.com>

headers/private/i2c/i2c.h

@@ -0,0 +1,151 @@
+/*
+ * Copyright 2020, Haiku, Inc. All Rights Reserved.
+ * Distributed under the terms of the MIT License.
+ */
+#ifndef _I2C_H_
+#define _I2C_H_
+
+
+#include <ACPI.h>
+#include <device_manager.h>
+#include <KernelExport.h>
+
+
+typedef uint16 i2c_addr;
+typedef enum {
+	I2C_OP_READ = 0,
+	I2C_OP_READ_STOP = 1,
+	I2C_OP_WRITE = 2,
+	I2C_OP_WRITE_STOP = 3,
+	I2C_OP_READ_BLOCK = 5,
+	I2C_OP_WRITE_BLOCK = 7,
+} i2c_op;
+
+
+#define IS_READ_OP(op)	(((op) & I2C_OP_WRITE) == 0)
+#define IS_WRITE_OP(op)	(((op) & I2C_OP_WRITE) != 0)
+#define IS_STOP_OP(op)	(((op) & 1) != 0)
+#define IS_BLOCK_OP(op)	(((op) & 4) != 0)
+
+
+// bus/device handle
+typedef void* i2c_bus;
+typedef void* i2c_device;
+
+
+// Device node
+
+// slave address (uint16)
+#define I2C_DEVICE_SLAVE_ADDR_ITEM "i2c/slave_addr"
+
+// node type
+#define I2C_DEVICE_TYPE_NAME "i2c/device/v1"
+
+// bus cookie, issued by i2c bus manager
+typedef void* i2c_bus;
+// device cookie, issued by i2c bus manager
+typedef void* i2c_device;
+
+// bus manager device interface for peripheral driver
+typedef struct {
+	driver_module_info info;
+
+	status_t (*exec_command)(i2c_device cookie, i2c_op op,
+		const void *cmdBuffer, size_t cmdLength, void* dataBuffer,
+		size_t dataLength);
+
+} i2c_device_interface;
+
+
+#define I2C_DEVICE_MODULE_NAME "bus_managers/i2c/device/driver_v1"
+
+
+// Bus node
+
+#define I2C_BUS_PATH_ID_ITEM "i2c/path_id"
+
+// node type
+#define I2C_BUS_TYPE_NAME "i2c/bus"
+
+// I2C bus node driver.
+// This interface can be used by peripheral drivers to access the
+// bus directly.
+typedef struct {
+	driver_module_info info;
+
+	status_t (*exec_command)(i2c_bus cookie, i2c_op op, i2c_addr slaveAddress,
+		const void *cmdBuffer, size_t cmdLength, void* dataBuffer,
+		size_t dataLength);
+} i2c_bus_interface;
+
+
+// name of I2C bus node driver
+#define I2C_BUS_MODULE_NAME "bus_managers/i2c/bus/driver_v1"
+
+
+
+// Interface for Controllers
+
+typedef struct {
+	driver_module_info info;
+
+	status_t (*register_device)(i2c_bus bus, i2c_addr slaveAddress,
+		char* hid, char** cid, acpi_handle acpiHandle);
+} i2c_for_controller_interface;
+
+#define I2C_FOR_CONTROLLER_MODULE_NAME "bus_managers/i2c/controller/driver_v1"
+
+
+// Controller Node
+
+// node type
+#define I2C_CONTROLLER_TYPE_NAME "bus/i2c/v1"
+// controller name (required, string)
+#define I2C_DESCRIPTION_CONTROLLER_NAME "controller_name"
+
+typedef void *i2c_bus_cookie;
+typedef void *i2c_intr_cookie;
+
+
+// Bus manager interface used by I2C controller drivers.
+typedef struct {
+	driver_module_info info;
+
+	void (*set_i2c_bus)(i2c_bus_cookie cookie, i2c_bus bus);
+
+	status_t (*exec_command)(i2c_bus_cookie cookie, i2c_op op,
+		i2c_addr slaveAddress, const void *cmdBuffer, size_t cmdLength,
+		void* dataBuffer, size_t dataLength);
+
+	status_t (*scan_bus)(i2c_bus_cookie cookie);
+
+	status_t (*install_interrupt_handler)(i2c_bus_cookie cookie,
+		i2c_intr_cookie intrCookie, interrupt_handler handler, void* data);
+
+	status_t (*uninstall_interrupt_handler)(i2c_bus_cookie cookie,
+		i2c_intr_cookie intrCookie);
+
+} i2c_sim_interface;
+
+
+// Devfs entry for raw bus access.
+// used by i2c diag tool
+
+enum {
+	I2CEXEC = B_DEVICE_OP_CODES_END + 1,
+};
+
+
+typedef struct i2c_ioctl_exec
+{
+	i2c_op		op;
+	i2c_addr	addr;
+	const void*	cmdBuffer;
+	size_t		cmdLength;
+	void*		buffer;
+	size_t		bufferLength;
+} i2c_ioctl_exec;
+
+#define I2C_EXEC_MAX_BUFFER_LENGTH  32
+
+#endif	/* _I2C_H_ */