// SPDX-License-Identifier: GPL-2.0 /* * Intel SoC Core Telemetry Driver * Copyright (C) 2015, Intel Corporation. * All Rights Reserved. * * Telemetry Framework provides platform related PM and performance statistics. * This file provides the core telemetry API implementation. */ #include <linux/device.h> #include <linux/module.h> #include <asm/intel_telemetry.h> #define DRIVER_NAME … struct telemetry_core_config { … }; static struct telemetry_core_config telm_core_conf; static int telemetry_def_update_events(struct telemetry_evtconfig pss_evtconfig, struct telemetry_evtconfig ioss_evtconfig) { … } static int telemetry_def_set_sampling_period(u8 pss_period, u8 ioss_period) { … } static int telemetry_def_get_sampling_period(u8 *pss_min_period, u8 *pss_max_period, u8 *ioss_min_period, u8 *ioss_max_period) { … } static int telemetry_def_get_eventconfig( struct telemetry_evtconfig *pss_evtconfig, struct telemetry_evtconfig *ioss_evtconfig, int pss_len, int ioss_len) { … } static int telemetry_def_get_trace_verbosity(enum telemetry_unit telem_unit, u32 *verbosity) { … } static int telemetry_def_set_trace_verbosity(enum telemetry_unit telem_unit, u32 verbosity) { … } static int telemetry_def_raw_read_eventlog(enum telemetry_unit telem_unit, struct telemetry_evtlog *evtlog, int len, int log_all_evts) { … } static int telemetry_def_read_eventlog(enum telemetry_unit telem_unit, struct telemetry_evtlog *evtlog, int len, int log_all_evts) { … } static int telemetry_def_add_events(u8 num_pss_evts, u8 num_ioss_evts, u32 *pss_evtmap, u32 *ioss_evtmap) { … } static int telemetry_def_reset_events(void) { … } static const struct telemetry_core_ops telm_defpltops = …; /** * telemetry_update_events() - Update telemetry Configuration * @pss_evtconfig: PSS related config. No change if num_evts = 0. * @ioss_evtconfig: IOSS related config. No change if num_evts = 0. * * This API updates the IOSS & PSS Telemetry configuration. Old config * is overwritten. Call telemetry_reset_events when logging is over * All sample period values should be in the form of: * bits[6:3] -> value; bits [0:2]-> Exponent; Period = (Value *16^Exponent) * * Return: 0 success, < 0 for failure */ int telemetry_update_events(struct telemetry_evtconfig pss_evtconfig, struct telemetry_evtconfig ioss_evtconfig) { … } EXPORT_SYMBOL_GPL(…); /** * telemetry_set_sampling_period() - Sets the IOSS & PSS sampling period * @pss_period: placeholder for PSS Period to be set. * Set to 0 if not required to be updated * @ioss_period: placeholder for IOSS Period to be set * Set to 0 if not required to be updated * * All values should be in the form of: * bits[6:3] -> value; bits [0:2]-> Exponent; Period = (Value *16^Exponent) * * Return: 0 success, < 0 for failure */ int telemetry_set_sampling_period(u8 pss_period, u8 ioss_period) { … } EXPORT_SYMBOL_GPL(…); /** * telemetry_get_sampling_period() - Get IOSS & PSS min & max sampling period * @pss_min_period: placeholder for PSS Min Period supported * @pss_max_period: placeholder for PSS Max Period supported * @ioss_min_period: placeholder for IOSS Min Period supported * @ioss_max_period: placeholder for IOSS Max Period supported * * All values should be in the form of: * bits[6:3] -> value; bits [0:2]-> Exponent; Period = (Value *16^Exponent) * * Return: 0 success, < 0 for failure */ int telemetry_get_sampling_period(u8 *pss_min_period, u8 *pss_max_period, u8 *ioss_min_period, u8 *ioss_max_period) { … } EXPORT_SYMBOL_GPL(…); /** * telemetry_reset_events() - Restore the IOSS & PSS configuration to default * * Return: 0 success, < 0 for failure */ int telemetry_reset_events(void) { … } EXPORT_SYMBOL_GPL(…); /** * telemetry_get_eventconfig() - Returns the pss and ioss events enabled * @pss_evtconfig: Pointer to PSS related configuration. * @ioss_evtconfig: Pointer to IOSS related configuration. * @pss_len: Number of u32 elements allocated for pss_evtconfig array * @ioss_len: Number of u32 elements allocated for ioss_evtconfig array * * Return: 0 success, < 0 for failure */ int telemetry_get_eventconfig(struct telemetry_evtconfig *pss_evtconfig, struct telemetry_evtconfig *ioss_evtconfig, int pss_len, int ioss_len) { … } EXPORT_SYMBOL_GPL(…); /** * telemetry_add_events() - Add IOSS & PSS configuration to existing settings. * @num_pss_evts: Number of PSS Events (<29) in pss_evtmap. Can be 0. * @num_ioss_evts: Number of IOSS Events (<29) in ioss_evtmap. Can be 0. * @pss_evtmap: Array of PSS Event-IDs to Enable * @ioss_evtmap: Array of PSS Event-IDs to Enable * * Events are appended to Old Configuration. In case of total events > 28, it * returns error. Call telemetry_reset_events to reset after eventlog done * * Return: 0 success, < 0 for failure */ int telemetry_add_events(u8 num_pss_evts, u8 num_ioss_evts, u32 *pss_evtmap, u32 *ioss_evtmap) { … } EXPORT_SYMBOL_GPL(…); /** * telemetry_read_events() - Fetches samples as specified by evtlog.telem_evt_id * @telem_unit: Specify whether IOSS or PSS Read * @evtlog: Array of telemetry_evtlog structs to fill data * evtlog.telem_evt_id specifies the ids to read * @len: Length of array of evtlog * * Return: number of eventlogs read for success, < 0 for failure */ int telemetry_read_events(enum telemetry_unit telem_unit, struct telemetry_evtlog *evtlog, int len) { … } EXPORT_SYMBOL_GPL(…); /** * telemetry_raw_read_events() - Fetch samples specified by evtlog.telem_evt_id * @telem_unit: Specify whether IOSS or PSS Read * @evtlog: Array of telemetry_evtlog structs to fill data * evtlog.telem_evt_id specifies the ids to read * @len: Length of array of evtlog * * The caller must take care of locking in this case. * * Return: number of eventlogs read for success, < 0 for failure */ int telemetry_raw_read_events(enum telemetry_unit telem_unit, struct telemetry_evtlog *evtlog, int len) { … } EXPORT_SYMBOL_GPL(…); /** * telemetry_read_eventlog() - Fetch the Telemetry log from PSS or IOSS * @telem_unit: Specify whether IOSS or PSS Read * @evtlog: Array of telemetry_evtlog structs to fill data * @len: Length of array of evtlog * * Return: number of eventlogs read for success, < 0 for failure */ int telemetry_read_eventlog(enum telemetry_unit telem_unit, struct telemetry_evtlog *evtlog, int len) { … } EXPORT_SYMBOL_GPL(…); /** * telemetry_raw_read_eventlog() - Fetch the Telemetry log from PSS or IOSS * @telem_unit: Specify whether IOSS or PSS Read * @evtlog: Array of telemetry_evtlog structs to fill data * @len: Length of array of evtlog * * The caller must take care of locking in this case. * * Return: number of eventlogs read for success, < 0 for failure */ int telemetry_raw_read_eventlog(enum telemetry_unit telem_unit, struct telemetry_evtlog *evtlog, int len) { … } EXPORT_SYMBOL_GPL(…); /** * telemetry_get_trace_verbosity() - Get the IOSS & PSS Trace verbosity * @telem_unit: Specify whether IOSS or PSS Read * @verbosity: Pointer to return Verbosity * * Return: 0 success, < 0 for failure */ int telemetry_get_trace_verbosity(enum telemetry_unit telem_unit, u32 *verbosity) { … } EXPORT_SYMBOL_GPL(…); /** * telemetry_set_trace_verbosity() - Update the IOSS & PSS Trace verbosity * @telem_unit: Specify whether IOSS or PSS Read * @verbosity: Verbosity to set * * Return: 0 success, < 0 for failure */ int telemetry_set_trace_verbosity(enum telemetry_unit telem_unit, u32 verbosity) { … } EXPORT_SYMBOL_GPL(…); /** * telemetry_set_pltdata() - Set the platform specific Data * @ops: Pointer to ops structure * @pltconfig: Platform config data * * Usage by other than telemetry pltdrv module is invalid * * Return: 0 success, < 0 for failure */ int telemetry_set_pltdata(const struct telemetry_core_ops *ops, struct telemetry_plt_config *pltconfig) { … } EXPORT_SYMBOL_GPL(…); /** * telemetry_clear_pltdata() - Clear the platform specific Data * * Usage by other than telemetry pltdrv module is invalid * * Return: 0 success, < 0 for failure */ int telemetry_clear_pltdata(void) { … } EXPORT_SYMBOL_GPL(…); /** * telemetry_get_pltdata() - Return telemetry platform config * * May be used by other telemetry modules to get platform specific * configuration. */ struct telemetry_plt_config *telemetry_get_pltdata(void) { … } EXPORT_SYMBOL_GPL(…); static inline int telemetry_get_pssevtname(enum telemetry_unit telem_unit, const char **name, int len) { … } static inline int telemetry_get_iossevtname(enum telemetry_unit telem_unit, const char **name, int len) { … } /** * telemetry_get_evtname() - Checkif platform config is valid * @telem_unit: Telemetry Unit to check * @name: Array of character pointers to contain name * @len: length of array name provided by user * * Usage by other than telemetry debugfs module is invalid * * Return: 0 success, < 0 for failure */ int telemetry_get_evtname(enum telemetry_unit telem_unit, const char **name, int len) { … } EXPORT_SYMBOL_GPL(…); static int __init telemetry_module_init(void) { … } static void __exit telemetry_module_exit(void) { … } module_init(…) …; module_exit(telemetry_module_exit); MODULE_AUTHOR(…) …; MODULE_DESCRIPTION(…) …; MODULE_LICENSE(…) …;
Codebase Browser
linux