arch/arc/include/asm/mach_desc.h

   1 /*
   2  * Copyright (C) 2012 Synopsys, Inc. (www.synopsys.com)
   3  *
   4  * based on METAG mach/arch.h (which in turn was based on ARM)
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License version 2 as
   8  * published by the Free Software Foundation.
   9  */
  10
  11 #ifndef _ASM_ARC_MACH_DESC_H_
  12 #define _ASM_ARC_MACH_DESC_H_
  13
  14 /**
  15  * struct machine_desc - Board specific callbacks, called from ARC common code
  16  *      Provided by each ARC board using MACHINE_START()/MACHINE_END(), so
  17  *      a multi-platform kernel builds with array of such descriptors.
  18  *      We extend the early DT scan to also match the DT's "compatible" string
  19  *      against the @dt_compat of all such descriptors, and one with highest
  20  *      "DT score" is selected as global @machine_desc.
  21  *
  22  * @name:               Board/SoC name
  23  * @dt_compat:          Array of device tree 'compatible' strings
  24  *                      (XXX: although only 1st entry is looked at)
  25  * @init_early:         Very early callback [called from setup_arch()]
  26  * @init_irq:           setup external IRQ controllers [called from init_IRQ()]
  27  * @init_smp:           for each CPU (e.g. setup IPI)
  28  *                      [(M):init_IRQ(), (o):start_kernel_secondary()]
  29  * @init_time:          platform specific clocksource/clockevent registration
  30  *                      [called from time_init()]
  31  * @init_machine:       arch initcall level callback (e.g. populate static
  32  *                      platform devices or parse Devicetree)
  33  * @init_late:          Late initcall level callback
  34  *
  35  */
  36 struct machine_desc {
  37         const char              *name;
  38         const char              **dt_compat;
  39
  40         void                    (*init_early)(void);
  41         void                    (*init_irq)(void);
  42 #ifdef CONFIG_SMP
  43         void                    (*init_smp)(unsigned int);
  44 #endif
  45         void                    (*init_time)(void);
  46         void                    (*init_machine)(void);
  47         void                    (*init_late)(void);
  48
  49 };
  50
  51 /*
  52  * Current machine - only accessible during boot.
  53  */
  54 extern struct machine_desc *machine_desc;
  55
  56 /*
  57  * Machine type table - also only accessible during boot
  58  */
  59 extern struct machine_desc __arch_info_begin[], __arch_info_end[];
  60 #define for_each_machine_desc(p)                        \
  61         for (p = __arch_info_begin; p < __arch_info_end; p++)
  62
  63 static inline struct machine_desc *default_machine_desc(void)
  64 {
  65         /* the default machine is the last one linked in */
  66         if (__arch_info_end - 1 < __arch_info_begin)
  67                 return NULL;
  68         return __arch_info_end - 1;
  69 }
  70
  71 /*
  72  * Set of macros to define architecture features.
  73  * This is built into a table by the linker.
  74  */
  75 #define MACHINE_START(_type, _name)                     \
  76 static const struct machine_desc __mach_desc_##_type    \
  77 __used                                                  \
  78 __attribute__((__section__(".arch.info.init"))) = {     \
  79         .name           = _name,
  80
  81 #define MACHINE_END                             \
  82 };
  83
  84 extern struct machine_desc *setup_machine_fdt(void *dt);
  85 extern void __init copy_devtree(void);
  86
  87 #endif