Common driver for ARM Cache Coherent Interconnects
authorVikram Kanigiri <vikram.kanigiri@arm.com>
Tue, 23 Dec 2014 01:00:22 +0000 (01:00 +0000)
committerVikram Kanigiri <vikram.kanigiri@arm.com>
Mon, 16 Mar 2015 18:37:47 +0000 (18:37 +0000)
Even though both CCI-400 and CCI-500 IPs have different configurations
with respect to the number and types of supported interfaces, their
register offsets and programming sequences are similar. This patch
creates a common driver for enabling and disabling snoop transactions
and DVMs with both the IPs.

New platform ports which implement one of these IPs should use this
common driver. Existing platform ports which implement CCI-400 should
migrate to the common driver as the standalone CCI-400 will be
deprecated in the future.

Change-Id: I3ccd0eb7b062922d2e4a374ff8c21e79fa357556

Makefile
docs/user-guide.md
drivers/arm/cci/cci.c [new file with mode: 0644]
drivers/arm/cci400/cci400.c
include/drivers/arm/cci.h [new file with mode: 0644]

index 1e2f324c05f2dcb05a6ac8cae00b0edae232b995..9dff969d6b407d0603f4b2239d12559e003695fc 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -60,6 +60,9 @@ CTX_INCLUDE_FPREGS            := 0
 # Determine the version of ARM GIC architecture to use for interrupt management
 # in EL3. The platform port can change this value if needed.
 ARM_GIC_ARCH           :=      2
+# Determine the version of ARM CCI product used in the platform. The platform
+# port can change this value if needed.
+ARM_CCI_PRODUCT_ID     :=      400
 # Flag used to indicate if ASM_ASSERTION should be enabled for the build.
 # This defaults to being present in DEBUG builds only.
 ASM_ASSERTION          :=      ${DEBUG}
@@ -235,6 +238,9 @@ $(eval $(call add_define,CTX_INCLUDE_FPREGS))
 # Process ARM_GIC_ARCH flag
 $(eval $(call add_define,ARM_GIC_ARCH))
 
+# Process ARM_CCI_PRODUCT_ID flag
+$(eval $(call add_define,ARM_CCI_PRODUCT_ID))
+
 # Process ASM_ASSERTION flag
 $(eval $(call assert_boolean,ASM_ASSERTION))
 $(eval $(call add_define,ASM_ASSERTION))
index 1badc0c8e5168497f376f8430764e90bb74ac28a..c115bccf3add1dc5ce45670ae6eeacf271530def 100644 (file)
@@ -218,6 +218,10 @@ performed.
     driver for implementing the platform GIC API. This API is used
     by the interrupt management framework. Default is 2 (that is, version 2.0).
 
+*   `ARM_CCI_PRODUCT_ID`: Choice of ARM CCI product used by the platform. This
+    is used to determine the number of valid slave interfaces available in the
+    ARM CCI driver. Default is 400 (that is, CCI-400).
+
 *   `IMF_READ_INTERRUPT_ID`: Boolean flag used by the interrupt management
     framework to enable passing of the interrupt id to its handler. The id is
     read using a platform GIC API. `INTR_ID_UNAVAILABLE` is passed instead if
diff --git a/drivers/arm/cci/cci.c b/drivers/arm/cci/cci.c
new file mode 100644 (file)
index 0000000..44916d4
--- /dev/null
@@ -0,0 +1,141 @@
+/*
+ * Copyright (c) 2015, ARM Limited and Contributors. All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * Redistributions of source code must retain the above copyright notice, this
+ * list of conditions and the following disclaimer.
+ *
+ * Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ *
+ * Neither the name of ARM nor the names of its contributors may be used
+ * to endorse or promote products derived from this software without specific
+ * prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#include <arch.h>
+#include <assert.h>
+#include <cci.h>
+#include <debug.h>
+#include <mmio.h>
+
+static unsigned long g_cci_base;
+static unsigned int g_max_master_id;
+static const int *g_cci_slave_if_map;
+
+#if DEBUG
+static int validate_cci_map(const int *map)
+{
+       unsigned int valid_cci_map = 0;
+       int slave_if_id;
+       int i;
+
+       /* Validate the map */
+       for (i = 0; i <= g_max_master_id; i++) {
+               slave_if_id = map[i];
+
+               if (slave_if_id < 0)
+                       continue;
+
+               if (slave_if_id >= CCI_SLAVE_INTERFACE_COUNT) {
+                       tf_printf("Slave interface ID is invalid\n");
+                       return 0;
+               }
+
+               if (valid_cci_map & (1 << slave_if_id)) {
+                       tf_printf("Multiple masters are assigned same"
+                                               " slave interface ID\n");
+                       return 0;
+               }
+               valid_cci_map |= 1 << slave_if_id;
+       }
+
+       if (!valid_cci_map) {
+               tf_printf("No master is assigned a valid slave interface\n");
+               return 0;
+       }
+
+       return 1;
+}
+#endif /* DEBUG */
+
+void cci_init(unsigned long cci_base,
+               const int *map,
+               unsigned int num_cci_masters)
+{
+       assert(map);
+       assert(cci_base);
+
+       g_cci_base = cci_base;
+
+       /*
+        * Master Id's are assigned from zero, So in an array of size n
+        * the max master id is (n - 1).
+        */
+       g_max_master_id = num_cci_masters - 1;
+
+       assert(validate_cci_map(map));
+       g_cci_slave_if_map = map;
+}
+
+void cci_enable_snoop_dvm_reqs(unsigned int master_id)
+{
+       int slave_if_id;
+
+       assert(g_cci_base);
+       assert(master_id <= g_max_master_id);
+
+       slave_if_id = g_cci_slave_if_map[master_id];
+       assert((slave_if_id < CCI_SLAVE_INTERFACE_COUNT) && (slave_if_id >= 0));
+
+       /*
+        * Enable Snoops and DVM messages, no need for Read/Modify/Write as
+        * rest of bits are write ignore
+        */
+       mmio_write_32(g_cci_base +
+                     SLAVE_IFACE_OFFSET(slave_if_id) +
+                     SNOOP_CTRL_REG, DVM_EN_BIT | SNOOP_EN_BIT);
+
+       /* Wait for the dust to settle down */
+       while (mmio_read_32(g_cci_base + STATUS_REG) & CHANGE_PENDING_BIT)
+               ;
+}
+
+void cci_disable_snoop_dvm_reqs(unsigned int master_id)
+{
+       int slave_if_id;
+
+       assert(g_cci_base);
+       assert(master_id <= g_max_master_id);
+
+       slave_if_id = g_cci_slave_if_map[master_id];
+       assert((slave_if_id < CCI_SLAVE_INTERFACE_COUNT) && (slave_if_id >= 0));
+
+       /*
+        * Disable Snoops and DVM messages, no need for Read/Modify/Write as
+        * rest of bits are write ignore.
+        */
+       mmio_write_32(g_cci_base +
+                     SLAVE_IFACE_OFFSET(slave_if_id) +
+                     SNOOP_CTRL_REG, ~(DVM_EN_BIT | SNOOP_EN_BIT));
+
+       /* Wait for the dust to settle down */
+       while (mmio_read_32(g_cci_base + STATUS_REG) & CHANGE_PENDING_BIT)
+               ;
+}
+
index 6a8737a574bc2f1d7f8da7479de2aeeb3e980577..f832af826005e880710e50bb23c28d55734556bd 100644 (file)
@@ -31,6 +31,7 @@
 #include <arch.h>
 #include <assert.h>
 #include <cci400.h>
+#include <debug.h>
 #include <mmio.h>
 
 #define MAX_CLUSTERS           2
@@ -55,6 +56,9 @@ void cci_init(unsigned long cci_base,
        assert((slave_iface3_cluster_ix >= 0) ||
                (slave_iface3_cluster_ix >= 0));
 
+       WARN("Please migrate to common cci driver, This driver will be" \
+               " deprecated in future\n");
+
        cci_base_addr = cci_base;
        if (slave_iface3_cluster_ix >= 0)
                cci_cluster_ix_to_iface[slave_iface3_cluster_ix] =
diff --git a/include/drivers/arm/cci.h b/include/drivers/arm/cci.h
new file mode 100644 (file)
index 0000000..2401e85
--- /dev/null
@@ -0,0 +1,157 @@
+/*
+ * Copyright (c) 2015, ARM Limited and Contributors. All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * Redistributions of source code must retain the above copyright notice, this
+ * list of conditions and the following disclaimer.
+ *
+ * Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ *
+ * Neither the name of ARM nor the names of its contributors may be used
+ * to endorse or promote products derived from this software without specific
+ * prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef __CCI_H__
+#define __CCI_H__
+
+/* Slave interface offsets from PERIPHBASE */
+#define SLAVE_IFACE6_OFFSET            0x7000
+#define SLAVE_IFACE5_OFFSET            0x6000
+#define SLAVE_IFACE4_OFFSET            0x5000
+#define SLAVE_IFACE3_OFFSET            0x4000
+#define SLAVE_IFACE2_OFFSET            0x3000
+#define SLAVE_IFACE1_OFFSET            0x2000
+#define SLAVE_IFACE0_OFFSET            0x1000
+#define SLAVE_IFACE_OFFSET(index)      (SLAVE_IFACE0_OFFSET +  \
+                                       (0x1000 * (index)))
+
+/* Slave interface event and count register offsets from PERIPHBASE */
+#define EVENT_SELECT7_OFFSET           0x80000
+#define EVENT_SELECT6_OFFSET           0x70000
+#define EVENT_SELECT5_OFFSET           0x60000
+#define EVENT_SELECT4_OFFSET           0x50000
+#define EVENT_SELECT3_OFFSET           0x40000
+#define EVENT_SELECT2_OFFSET           0x30000
+#define EVENT_SELECT1_OFFSET           0x20000
+#define EVENT_SELECT0_OFFSET           0x10000
+#define EVENT_OFFSET(index)            (EVENT_SELECT0_OFFSET + \
+                                       (0x10000 * (index)))
+
+/* Control and ID register offsets */
+#define CTRL_OVERRIDE_REG              0x0
+#define SECURE_ACCESS_REG              0x8
+#define STATUS_REG                     0xc
+#define IMPRECISE_ERR_REG              0x10
+#define PERFMON_CTRL_REG               0x100
+#define IFACE_MON_CTRL_REG             0x104
+
+/* Component and peripheral ID registers */
+#define PERIPHERAL_ID0                 0xFE0
+#define PERIPHERAL_ID1                 0xFE4
+#define PERIPHERAL_ID2                 0xFE8
+#define PERIPHERAL_ID3                 0xFEC
+#define PERIPHERAL_ID4                 0xFD0
+#define PERIPHERAL_ID5                 0xFD4
+#define PERIPHERAL_ID6                 0xFD8
+#define PERIPHERAL_ID7                 0xFDC
+
+#define COMPONENT_ID0                  0xFF0
+#define COMPONENT_ID1                  0xFF4
+#define COMPONENT_ID2                  0xFF8
+#define COMPONENT_ID3                  0xFFC
+#define COMPONENT_ID4                  0x1000
+#define COMPONENT_ID5                  0x1004
+#define COMPONENT_ID6                  0x1008
+#define COMPONENT_ID7                  0x100C
+
+/* Slave interface register offsets */
+#define SNOOP_CTRL_REG                 0x0
+#define SH_OVERRIDE_REG                        0x4
+#define READ_CHNL_QOS_VAL_OVERRIDE_REG 0x100
+#define WRITE_CHNL_QOS_VAL_OVERRIDE_REG        0x104
+#define MAX_OT_REG                     0x110
+
+/* Snoop Control register bit definitions */
+#define DVM_EN_BIT                     (1 << 1)
+#define SNOOP_EN_BIT                   (1 << 0)
+#define SUPPORT_SNOOPS                 (1 << 30)
+#define SUPPORT_DVM                    (1 << 31)
+
+/* Status register bit definitions */
+#define CHANGE_PENDING_BIT             (1 << 0)
+
+/* Event and count register offsets */
+#define EVENT_SELECT_REG               0x0
+#define EVENT_COUNT_REG                        0x4
+#define COUNT_CNTRL_REG                        0x8
+#define COUNT_OVERFLOW_REG             0xC
+
+/* Slave interface monitor registers */
+#define INT_MON_REG_SI0                        0x90000
+#define INT_MON_REG_SI1                        0x90004
+#define INT_MON_REG_SI2                        0x90008
+#define INT_MON_REG_SI3                        0x9000C
+#define INT_MON_REG_SI4                        0x90010
+#define INT_MON_REG_SI5                        0x90014
+#define INT_MON_REG_SI6                        0x90018
+
+/* Master interface monitor registers */
+#define INT_MON_REG_MI0                        0x90100
+#define INT_MON_REG_MI1                        0x90104
+#define INT_MON_REG_MI2                        0x90108
+#define INT_MON_REG_MI3                        0x9010c
+#define INT_MON_REG_MI4                        0x90110
+#define INT_MON_REG_MI5                        0x90114
+
+#define SLAVE_IF_UNUSED                        -1
+
+#if ARM_CCI_PRODUCT_ID == 400
+       #define CCI_SLAVE_INTERFACE_COUNT       5
+#elif ARM_CCI_PRODUCT_ID == 500
+       #define CCI_SLAVE_INTERFACE_COUNT       7
+#else
+       #error "Invalid CCI product or CCI not supported"
+#endif
+
+#ifndef __ASSEMBLY__
+
+#include <stdint.h>
+
+/* Function declarations */
+
+/*
+ * The ARM CCI driver needs the following:
+ * 1. Base address of the CCI-500/CCI-400
+ * 2. An array  of map between AMBA 4 master ids and ACE/ACE lite slave
+ *    interfaces.
+ * 3. Size of the array.
+ *
+ * SLAVE_IF_UNUSED should be used in the map to represent no AMBA 4 master exists
+ * for that interface.
+ */
+void cci_init(unsigned long cci_base,
+       const int *map,
+       unsigned int num_cci_masters);
+
+void cci_enable_snoop_dvm_reqs(unsigned int master_id);
+void cci_disable_snoop_dvm_reqs(unsigned int master_id);
+
+#endif /* __ASSEMBLY__ */
+#endif /* __CCI_H__ */