1 /* SPDX-License-Identifier: GPL-2.0 */
2 /* Copyright (C) 2025 Arm Ltd. */
3
4 #ifndef __LINUX_ARM_MPAM_H
5 #define __LINUX_ARM_MPAM_H
6
7 #include <linux/acpi.h>
8 #include <linux/types.h>
9
10 struct mpam_msc;
11
12 enum mpam_msc_iface {
13 MPAM_IFACE_MMIO, /* a real MPAM MSC */
14 MPAM_IFACE_PCC, /* a fake MPAM MSC */
15 };
16
17 enum mpam_class_types {
18 MPAM_CLASS_CACHE, /* Caches, e.g. L2, L3 */
19 MPAM_CLASS_MEMORY, /* Main memory */
20 MPAM_CLASS_UNKNOWN, /* Everything else, e.g. SMMU */
21 };
22
23 #define MPAM_CLASS_ID_DEFAULT 255
24
25 #ifdef CONFIG_ACPI_MPAM
26 int acpi_mpam_parse_resources(struct mpam_msc *msc,
27 struct acpi_mpam_msc_node *tbl_msc);
28
29 int acpi_mpam_count_msc(void);
30 #else
acpi_mpam_parse_resources(struct mpam_msc * msc,struct acpi_mpam_msc_node * tbl_msc)31 static inline int acpi_mpam_parse_resources(struct mpam_msc *msc,
32 struct acpi_mpam_msc_node *tbl_msc)
33 {
34 return -EINVAL;
35 }
36
acpi_mpam_count_msc(void)37 static inline int acpi_mpam_count_msc(void) { return -EINVAL; }
38 #endif
39
40 #ifdef CONFIG_ARM64_MPAM_DRIVER
41 int mpam_ris_create(struct mpam_msc *msc, u8 ris_idx,
42 enum mpam_class_types type, u8 class_id, int component_id);
43 #else
mpam_ris_create(struct mpam_msc * msc,u8 ris_idx,enum mpam_class_types type,u8 class_id,int component_id)44 static inline int mpam_ris_create(struct mpam_msc *msc, u8 ris_idx,
45 enum mpam_class_types type, u8 class_id,
46 int component_id)
47 {
48 return -EINVAL;
49 }
50 #endif
51
52 /**
53 * mpam_register_requestor() - Register a requestor with the MPAM driver
54 * @partid_max: The maximum PARTID value the requestor can generate.
55 * @pmg_max: The maximum PMG value the requestor can generate.
56 *
57 * Registers a requestor with the MPAM driver to ensure the chosen system-wide
58 * minimum PARTID and PMG values will allow the requestors features to be used.
59 *
60 * Returns an error if the registration is too late, and a larger PARTID/PMG
61 * value has been advertised to user-space. In this case the requestor should
62 * not use its MPAM features. Returns 0 on success.
63 */
64 int mpam_register_requestor(u16 partid_max, u8 pmg_max);
65
66 #endif /* __LINUX_ARM_MPAM_H */
67