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