colibri_imx7_emmc: enable DM_VIDEO

[oweals/u-boot.git] / include / axi.h

diff --git a/include/axi.h b/include/axi.h
index 2ff81c16af6c1a9159182a74cb1bb081bf0ded14..3e40692cdfda4595caf74bf72195ad03b7a04f9c 100644 (file)
--- a/include/axi.h
+++ b/include/axi.h
@@ -1,48 +1,47 @@
 /* SPDX-License-Identifier: GPL-2.0+ */
 /*
- * (C) Copyright 2017
- * Mario Six,  Guntermann & Drunck GmbH, mario.six@gdsys.cc
+ * (C) Copyright 2017, 2018
+ * Mario Six, Guntermann & Drunck GmbH, mario.six@gdsys.cc
  */
 
 #ifndef _AXI_H_
 #define _AXI_H_
 
+/**
+ * enum axi_size_t - Determine size of AXI transfer
+ * @AXI_SIZE_8:  AXI sransfer is 8-bit wide
+ * @AXI_SIZE_16: AXI sransfer is 16-bit wide
+ * @AXI_SIZE_32: AXI sransfer is 32-bit wide
+ */
 enum axi_size_t {
        AXI_SIZE_8,
        AXI_SIZE_16,
        AXI_SIZE_32,
 };
 
-/**
- * struct axi_ops - driver operations for AXI uclass
- *
- * Drivers should support these operations unless otherwise noted. These
- * operations are intended to be used by uclass code, not directly from
- * other code.
- */
 struct axi_ops {
        /**
         * read() - Read a single value from a specified address on a AXI bus
-        *
         * @dev:        AXI bus to read from.
         * @address:    The address to read from.
         * @data:       Pointer to a variable that takes the data value read
         *              from the address on the AXI bus.
         * @size:       The size of the data to be read.
-        * @return 0 if OK, -ve on error.
+        *
+        * Return: 0 if OK, -ve on error.
         */
        int (*read)(struct udevice *dev, ulong address, void *data,
                    enum axi_size_t size);
 
        /**
         * write() - Write a single value to a specified address on a AXI bus
-        *
         * @dev:        AXI bus to write to.
         * @address:    The address to write to.
         * @data:       Pointer to the data value to be written to the address
         *              on the AXI bus.
         * @size:       The size of the data to write.
-        * @return 0 if OK, -ve on error.
+        *
+        * Return 0 if OK, -ve on error.
         */
        int (*write)(struct udevice *dev, ulong address, void *data,
                     enum axi_size_t size);
@@ -52,27 +51,68 @@ struct axi_ops {
 
 /**
  * axi_read() - Read a single value from a specified address on a AXI bus
- *
  * @dev:       AXI bus to read from.
  * @address:   The address to read from.
  * @data:      Pointer to a variable that takes the data value read from the
  *              address on the AXI bus.
  * @size:      The size of the data to write.
- * @return 0 if OK, -ve on error.
+ *
+ * Return: 0 if OK, -ve on error.
  */
 int axi_read(struct udevice *dev, ulong address, void *data,
             enum axi_size_t size);
 
 /**
  * axi_write() - Write a single value to a specified address on a AXI bus
- *
  * @dev:       AXI bus to write to.
  * @address:   The address to write to.
  * @data:      Pointer to the data value to be written to the address on the
  *             AXI bus.
  * @size:      The size of the data to write.
- * @return 0 if OK, -ve on error.
+ *
+ * Return: 0 if OK, -ve on error.
  */
 int axi_write(struct udevice *dev, ulong address, void *data,
              enum axi_size_t size);
+
+struct axi_emul_ops {
+       /**
+        * read() - Read a single value from a specified address on a AXI bus
+        * @dev:        AXI bus to read from.
+        * @address:    The address to read from.
+        * @data:       Pointer to a variable that takes the data value read
+        *              from the address on the AXI bus.
+        * @size:       The size of the data to be read.
+        *
+        * Return: 0 if OK, -ve on error.
+        */
+       int (*read)(struct udevice *dev, ulong address, void *data,
+                   enum axi_size_t size);
+
+       /**
+        * write() - Write a single value to a specified address on a AXI bus
+        * @dev:        AXI bus to write to.
+        * @address:    The address to write to.
+        * @data:       Pointer to the data value to be written to the address
+        *              on the AXI bus.
+        * @size:       The size of the data to write.
+        *
+        * Return: 0 if OK, -ve on error.
+        */
+       int (*write)(struct udevice *dev, ulong address, void *data,
+                    enum axi_size_t size);
+
+       /**
+        * get_store() - Get address of internal storage of a emulated AXI
+        *               device
+        * @dev:        Emulated AXI device to get the pointer of the internal
+        *              storage for.
+        * @storep:     Pointer to the internal storage of the emulated AXI
+        *              device.
+        *
+        * Return: 0 if OK, -ve on error.
+        */
+       int (*get_store)(struct udevice *dev, u8 **storep);
+};
+
 #endif