include/hw/hexagon/hex-subsys.h

/*
 * Hexagon subsystem helpers shared between the machine models.
 *
 * Copyright (c) Qualcomm Technologies, Inc. and/or its subsidiaries.
 * SPDX-License-Identifier: GPL-2.0-or-later
 */

#ifndef HW_HEXAGON_HEX_SUBSYS_H
#define HW_HEXAGON_HEX_SUBSYS_H

#include "hw/hexagon/hexagon.h"
#include "hw/core/qdev.h"

/* Create the subsystem shared by every Hexagon machine. */
void hex_subsys_create(HexagonCommonMachineState *hms,
                       const struct hexagon_machine_config *m_cfg, Rev_t rev);

/*
 * Parent a CPU into the subsystem's cluster and wire its links.  Call for
 * every CPU before hex_subsys_realize_cluster(), then realize each CPU with
 * hex_subsys_realize_cpu().  CPU[0] receives the L2VIC outputs.
 */
void hex_subsys_add_cpu(HexagonCommonMachineState *hms, DeviceState *cpu);

/* Realize the CPU cluster, once all CPUs have been parented into it. */
void hex_subsys_realize_cluster(HexagonCommonMachineState *hms);

/* Realize a CPU previously parented via hex_subsys_add_cpu(). */
void hex_subsys_realize_cpu(HexagonCommonMachineState *hms, DeviceState *cpu,
                            bool boot_cpu);

#endif /* HW_HEXAGON_HEX_SUBSYS_H */