/* SPDX-License-Identifier: GPL-2.0-only */
/*
 * Copyright (C) 2012 Synopsys, Inc. (www.synopsys.com)
 *
 * based on METAG mach/arch.h (which in turn was based on ARM)
 */

#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_per_cpu:       for each CPU as it is coming up (SMP as well as UP)
 *                      [(M):init_IRQ(), (o):start_kernel_secondary()]
 * @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_per_cpu)(unsigned int);
        void                    (*init_machine)(void);
        void                    (*init_late)(void);

};

/*
 * Current machine - only accessible during boot.
 */
extern const struct machine_desc *machine_desc;

/*
 * Machine type table - also only accessible during boot
 */
extern const struct machine_desc __arch_info_begin[], __arch_info_end[];

/*
 * 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 __section(".arch.info.init") = {                 \
        .name           = _name,

#define MACHINE_END                             \
};

extern const struct machine_desc *setup_machine_fdt(void *dt);

#endif