1 | /* SPDX-License-Identifier: GPL-2.0-only */ |
2 | /* |
3 | * Coresight system configuration driver. |
4 | */ |
5 | |
6 | #ifndef CORESIGHT_SYSCFG_H |
7 | #define CORESIGHT_SYSCFG_H |
8 | |
9 | #include <linux/configfs.h> |
10 | #include <linux/coresight.h> |
11 | #include <linux/device.h> |
12 | |
13 | #include "coresight-config.h" |
14 | |
15 | /* |
16 | * Load operation types. |
17 | * When loading or unloading, another load operation cannot be run. |
18 | * When unloading configurations cannot be activated. |
19 | */ |
20 | enum cscfg_load_ops { |
21 | CSCFG_NONE, |
22 | CSCFG_LOAD, |
23 | CSCFG_UNLOAD |
24 | }; |
25 | |
26 | /** |
27 | * System configuration manager device. |
28 | * |
29 | * Contains lists of the loaded configurations and features, plus a list of CoreSight devices |
30 | * registered with the system as supporting configuration management. |
31 | * |
32 | * Need a device to 'own' some coresight system wide sysfs entries in |
33 | * perf events, configfs etc. |
34 | * |
35 | * @dev: The device. |
36 | * @csdev_desc_list: List of coresight devices registered with the configuration manager. |
37 | * @feat_desc_list: List of feature descriptors to load into registered devices. |
38 | * @config_desc_list: List of system configuration descriptors to load into registered devices. |
39 | * @load_order_list: Ordered list of owners for dynamically loaded configurations. |
40 | * @sys_active_cnt: Total number of active config descriptor references. |
41 | * @cfgfs_subsys: configfs subsystem used to manage configurations. |
42 | * @sysfs_active_config:Active config hash used if CoreSight controlled from sysfs. |
43 | * @sysfs_active_preset:Active preset index used if CoreSight controlled from sysfs. |
44 | * @load_state: A multi-stage load/unload operation is in progress. |
45 | */ |
46 | struct cscfg_manager { |
47 | struct device dev; |
48 | struct list_head csdev_desc_list; |
49 | struct list_head feat_desc_list; |
50 | struct list_head config_desc_list; |
51 | struct list_head load_order_list; |
52 | atomic_t sys_active_cnt; |
53 | struct configfs_subsystem cfgfs_subsys; |
54 | u32 sysfs_active_config; |
55 | int sysfs_active_preset; |
56 | enum cscfg_load_ops load_state; |
57 | }; |
58 | |
59 | /* get reference to dev in cscfg_manager */ |
60 | struct device *cscfg_device(void); |
61 | |
62 | /** |
63 | * List entry for Coresight devices that are registered as supporting complex |
64 | * config operations. |
65 | * |
66 | * @csdev: The registered device. |
67 | * @match_flags: The matching type information for adding features. |
68 | * @ops: Operations supported by the registered device. |
69 | * @item: list entry. |
70 | */ |
71 | struct cscfg_registered_csdev { |
72 | struct coresight_device *csdev; |
73 | u32 match_flags; |
74 | struct cscfg_csdev_feat_ops ops; |
75 | struct list_head item; |
76 | }; |
77 | |
78 | /* owner types for loading and unloading of config and feature sets */ |
79 | enum cscfg_load_owner_type { |
80 | CSCFG_OWNER_PRELOAD, |
81 | CSCFG_OWNER_MODULE, |
82 | }; |
83 | |
84 | /** |
85 | * Load item - item to add to the load order list allowing dynamic load and |
86 | * unload of configurations and features. Caller loading a config |
87 | * set provides a context handle for unload. API ensures that |
88 | * items unloaded strictly in reverse order from load to ensure |
89 | * dependencies are respected. |
90 | * |
91 | * @item: list entry for load order list. |
92 | * @type: type of owner - allows interpretation of owner_handle. |
93 | * @owner_handle: load context - handle for owner of loaded configs. |
94 | */ |
95 | struct cscfg_load_owner_info { |
96 | struct list_head item; |
97 | int type; |
98 | void *owner_handle; |
99 | }; |
100 | |
101 | /* internal core operations for cscfg */ |
102 | int __init cscfg_init(void); |
103 | void cscfg_exit(void); |
104 | int cscfg_preload(void *owner_handle); |
105 | const struct cscfg_feature_desc *cscfg_get_named_feat_desc(const char *name); |
106 | int cscfg_update_feat_param_val(struct cscfg_feature_desc *feat_desc, |
107 | int param_idx, u64 value); |
108 | int cscfg_config_sysfs_activate(struct cscfg_config_desc *cfg_desc, bool activate); |
109 | void cscfg_config_sysfs_set_preset(int preset); |
110 | |
111 | /* syscfg manager external API */ |
112 | int cscfg_load_config_sets(struct cscfg_config_desc **cfg_descs, |
113 | struct cscfg_feature_desc **feat_descs, |
114 | struct cscfg_load_owner_info *owner_info); |
115 | int cscfg_unload_config_sets(struct cscfg_load_owner_info *owner_info); |
116 | int cscfg_register_csdev(struct coresight_device *csdev, u32 match_flags, |
117 | struct cscfg_csdev_feat_ops *ops); |
118 | void cscfg_unregister_csdev(struct coresight_device *csdev); |
119 | int cscfg_activate_config(unsigned long cfg_hash); |
120 | void cscfg_deactivate_config(unsigned long cfg_hash); |
121 | void cscfg_csdev_reset_feats(struct coresight_device *csdev); |
122 | int cscfg_csdev_enable_active_config(struct coresight_device *csdev, |
123 | unsigned long cfg_hash, int preset); |
124 | void cscfg_csdev_disable_active_config(struct coresight_device *csdev); |
125 | void cscfg_config_sysfs_get_active_cfg(unsigned long *cfg_hash, int *preset); |
126 | |
127 | #endif /* CORESIGHT_SYSCFG_H */ |
128 | |