128 lines · c
1/* SPDX-License-Identifier: GPL-2.0-only */2/*3 * Coresight system configuration driver.4 */5 6#ifndef CORESIGHT_SYSCFG_H7#define CORESIGHT_SYSCFG_H8 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 */20enum cscfg_load_ops {21 CSCFG_NONE,22 CSCFG_LOAD,23 CSCFG_UNLOAD24};25 26/**27 * System configuration manager device.28 *29 * Contains lists of the loaded configurations and features, plus a list of CoreSight devices30 * registered with the system as supporting configuration management.31 *32 * Need a device to 'own' some coresight system wide sysfs entries in33 * 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 */46struct 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 */60struct device *cscfg_device(void);61 62/**63 * List entry for Coresight devices that are registered as supporting complex64 * 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 */71struct 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 */79enum 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 and86 * unload of configurations and features. Caller loading a config87 * set provides a context handle for unload. API ensures that88 * items unloaded strictly in reverse order from load to ensure89 * 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 */95struct cscfg_load_owner_info {96 struct list_head item;97 int type;98 void *owner_handle;99};100 101/* internal core operations for cscfg */102int __init cscfg_init(void);103void cscfg_exit(void);104int cscfg_preload(void *owner_handle);105const struct cscfg_feature_desc *cscfg_get_named_feat_desc(const char *name);106int cscfg_update_feat_param_val(struct cscfg_feature_desc *feat_desc,107 int param_idx, u64 value);108int cscfg_config_sysfs_activate(struct cscfg_config_desc *cfg_desc, bool activate);109void cscfg_config_sysfs_set_preset(int preset);110 111/* syscfg manager external API */112int 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);115int cscfg_unload_config_sets(struct cscfg_load_owner_info *owner_info);116int cscfg_register_csdev(struct coresight_device *csdev, u32 match_flags,117 struct cscfg_csdev_feat_ops *ops);118void cscfg_unregister_csdev(struct coresight_device *csdev);119int cscfg_activate_config(unsigned long cfg_hash);120void cscfg_deactivate_config(unsigned long cfg_hash);121void cscfg_csdev_reset_feats(struct coresight_device *csdev);122int cscfg_csdev_enable_active_config(struct coresight_device *csdev,123 unsigned long cfg_hash, int preset);124void cscfg_csdev_disable_active_config(struct coresight_device *csdev);125void cscfg_config_sysfs_get_active_cfg(unsigned long *cfg_hash, int *preset);126 127#endif /* CORESIGHT_SYSCFG_H */128