ARC: [Review] Multi-platform image #2: Board callback Infrastructure

The orig platform code orgnaization was singleton design pattern - only
one platform (and board thereof) would build at a time.

Thus any platform/board specific code (e.g. irq init, early init ...)
expected by ARC common code was exported as well defined set of APIs,
with only ONE instance building ever.

Now with multiple-platform build requirement, that design of code no
longer holds - multiple board specific calls need to build at the same
time - so ARC common code can't use the API approach, it needs a
callback based design where each board registers it's specific set of
functions, and at runtime, depending on board detection, the callbacks
are used from the registry.

This commit adds all the infrastructure, where board specific callbacks
are specified as a "maThine description".

All the hooks are placed in right spots, no board callbacks registered
yet (with MACHINE_STARt/END constructs) so the hooks will not run.

Next commit will actually convert the platform to this infrastructure.

Signed-off-by: Vineet Gupta <vgupta@synopsys.com>
Cc: Arnd Bergmann <arnd@arndb.de>
Acked-by: Arnd Bergmann <arnd@arndb.de>

2 files changed, 85 insertions, 1 deletions

diff --git a/arch/arc/include/asm/mach_desc.h b/arch/arc/include/asm/mach_desc.h
new file mode 100644
index 000000000000..eaebaf835f85
--- /dev/null
+++ b/arch/arc/include/asm/mach_desc.h
@@ -0,0 +1,85 @@
+/*
+ * Copyright (C) 2012 Synopsys, Inc. (www.synopsys.com)
+ *
+ * based on METAG mach/arch.h (which in turn was based on ARM)
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License version 2 as
+ * published by the Free Software Foundation.
+ */
+
+#ifndef _ASM_ARC_MACH_DESC_H_
+#define _ASM_ARC_MACH_DESC_H_
+
+/**
+ * struct machine_desc - Board specific callbacks, called from ARC common code
+ *      Provided by each ARC board using MACHINE_START()/MACHINE_END(), so
+ *      a multi-platform kernel builds with array of such descriptors.
+ *      We extend the early DT scan to also match the DT's "compatible" string
+ *      against the @dt_compat of all such descriptors, and one with highest
+ *      "DT score" is selected as global @machine_desc.
+ *
+ * @name:               Board/SoC name
+ * @dt_compat:          Array of device tree 'compatible' strings
+ *                      (XXX: although only 1st entry is looked at)
+ * @init_early:         Very early callback [called from setup_arch()]
+ * @init_irq:           setup external IRQ controllers [called from init_IRQ()]
+ * @init_smp:           for each CPU (e.g. setup IPI)
+ *                      [(M):init_IRQ(), (o):start_kernel_secondary()]
+ * @init_time:          platform specific clocksource/clockevent registration
+ *                      [called from time_init()]
+ * @init_machine:       arch initcall level callback (e.g. populate static
+ *                      platform devices or parse Devicetree)
+ * @init_late:          Late initcall level callback
+ *
+ */
+struct machine_desc {
+        const char              *name;
+        const char              **dt_compat;
+
+        void                    (*init_early)(void);
+        void                    (*init_irq)(void);
+#ifdef CONFIG_SMP
+        void                    (*init_smp)(unsigned int);
+#endif
+        void                    (*init_time)(void);
+        void                    (*init_machine)(void);
+        void                    (*init_late)(void);
+
+};
+
+/*
+ * Current machine - only accessible during boot.
+ */
+extern struct machine_desc *machine_desc;
+
+/*
+ * Machine type table - also only accessible during boot
+ */
+extern struct machine_desc __arch_info_begin[], __arch_info_end[];
+#define for_each_machine_desc(p)                        \
+        for (p = __arch_info_begin; p < __arch_info_end; p++)
+
+static inline struct machine_desc *default_machine_desc(void)
+{
+        /* the default machine is the last one linked in */
+        if (__arch_info_end - 1 < __arch_info_begin)
+                return NULL;
+        return __arch_info_end - 1;
+}
+
+/*
+ * Set of macros to define architecture features.
+ * This is built into a table by the linker.
+ */
+#define MACHINE_START(_type, _name)                     \
+static const struct machine_desc __mach_desc_##_type    \
+__used                                                  \
+__attribute__((__section__(".arch.info.init"))) = {     \
+        .name           = _name,
+
+#define MACHINE_END                             \
+};
+
+extern struct machine_desc *setup_machine_fdt(void *dt);
+#endif
diff --git a/arch/arc/include/asm/prom.h b/arch/arc/include/asm/prom.h
index f54489bc4eca..692d0d0789a7 100644
--- a/arch/arc/include/asm/prom.h
+++ b/arch/arc/include/asm/prom.h
@@ -10,6 +10,5 @@
 #define _ASM_ARC_PROM_H_
 
 #define HAVE_ARCH_DEVTREE_FIXUPS
-extern int __init setup_machine_fdt(void *dt);
 
 #endif