/* SPDX-License-Identifier: GPL-2.0 */ /* * Copyright (c) 2016-2018, 2020, The Linux Foundation. All rights reserved. * Copyright (c) 2024, Qualcomm Innovation Center, Inc. All rights reserved. */ #include <linux/bitfield.h> #include <linux/debugfs.h> #include <linux/kernel.h> #include <linux/module.h> #include <linux/of.h> #include <linux/of_address.h> #include <linux/of_reserved_mem.h> #include <linux/platform_device.h> #include <linux/seq_file.h> #include <linux/types.h> #include <soc/qcom/cmd-db.h> #define NUM_PRIORITY … #define MAX_SLV_ID … #define SLAVE_ID_MASK … #define SLAVE_ID_SHIFT … #define SLAVE_ID(addr) … #define VRM_ADDR(addr) … /** * struct entry_header: header for each entry in cmddb * * @id: resource's identifier * @priority: unused * @addr: the address of the resource * @len: length of the data * @offset: offset from :@data_offset, start of the data */ struct entry_header { … }; /** * struct rsc_hdr: resource header information * * @slv_id: id for the resource * @header_offset: entry's header at offset from the end of the cmd_db_header * @data_offset: entry's data at offset from the end of the cmd_db_header * @cnt: number of entries for HW type * @version: MSB is major, LSB is minor * @reserved: reserved for future use. */ struct rsc_hdr { … }; /** * struct cmd_db_header: The DB header information * * @version: The cmd db version * @magic: constant expected in the database * @header: array of resources * @checksum: checksum for the header. Unused. * @reserved: reserved memory * @data: driver specific data */ struct cmd_db_header { … }; /** * DOC: Description of the Command DB database. * * At the start of the command DB memory is the cmd_db_header structure. * The cmd_db_header holds the version, checksum, magic key as well as an * array for header for each slave (depicted by the rsc_header). Each h/w * based accelerator is a 'slave' (shared resource) and has slave id indicating * the type of accelerator. The rsc_header is the header for such individual * slaves of a given type. The entries for each of these slaves begin at the * rsc_hdr.header_offset. In addition each slave could have auxiliary data * that may be needed by the driver. The data for the slave starts at the * entry_header.offset to the location pointed to by the rsc_hdr.data_offset. * * Drivers have a stringified key to a slave/resource. They can query the slave * information and get the slave id and the auxiliary data and the length of the * data. Using this information, they can format the request to be sent to the * h/w accelerator and request a resource state. */ static const u8 CMD_DB_MAGIC[] = …; static bool cmd_db_magic_matches(const struct cmd_db_header *header) { … } static struct cmd_db_header *cmd_db_header; static inline const void *rsc_to_entry_header(const struct rsc_hdr *hdr) { … } static inline void * rsc_offset(const struct rsc_hdr *hdr, const struct entry_header *ent) { … } /** * cmd_db_ready - Indicates if command DB is available * * Return: 0 on success, errno otherwise */ int cmd_db_ready(void) { … } EXPORT_SYMBOL_GPL(…); static int cmd_db_get_header(const char *id, const struct entry_header **eh, const struct rsc_hdr **rh) { … } /** * cmd_db_read_addr() - Query command db for resource id address. * * @id: resource id to query for address * * Return: resource address on success, 0 on error * * This is used to retrieve resource address based on resource * id. */ u32 cmd_db_read_addr(const char *id) { … } EXPORT_SYMBOL_GPL(…); /** * cmd_db_read_aux_data() - Query command db for aux data. * * @id: Resource to retrieve AUX Data on * @len: size of data buffer returned * * Return: pointer to data on success, error pointer otherwise */ const void *cmd_db_read_aux_data(const char *id, size_t *len) { … } EXPORT_SYMBOL_GPL(…); /** * cmd_db_match_resource_addr() - Compare if both Resource addresses are same * * @addr1: Resource address to compare * @addr2: Resource address to compare * * Return: true if two addresses refer to the same resource, false otherwise */ bool cmd_db_match_resource_addr(u32 addr1, u32 addr2) { … } EXPORT_SYMBOL_GPL(…); /** * cmd_db_read_slave_id - Get the slave ID for a given resource address * * @id: Resource id to query the DB for version * * Return: cmd_db_hw_type enum on success, CMD_DB_HW_INVALID on error */ enum cmd_db_hw_type cmd_db_read_slave_id(const char *id) { … } EXPORT_SYMBOL_GPL(…); #ifdef CONFIG_DEBUG_FS static int cmd_db_debugfs_dump(struct seq_file *seq, void *p) { … } static int open_cmd_db_debugfs(struct inode *inode, struct file *file) { … } #endif static const struct file_operations cmd_db_debugfs_ops = …; static int cmd_db_dev_probe(struct platform_device *pdev) { … } static const struct of_device_id cmd_db_match_table[] = …; MODULE_DEVICE_TABLE(of, cmd_db_match_table); static struct platform_driver cmd_db_dev_driver = …; static int __init cmd_db_device_init(void) { … } core_initcall(cmd_db_device_init); MODULE_DESCRIPTION(…) …; MODULE_LICENSE(…) …;
Codebase Browser
linux