From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 5AF8EC433FE for ; Tue, 14 Dec 2021 17:25:42 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S236450AbhLNRZl (ORCPT ); Tue, 14 Dec 2021 12:25:41 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:46396 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S236443AbhLNRZl (ORCPT ); Tue, 14 Dec 2021 12:25:41 -0500 Received: from mail-pg1-x529.google.com (mail-pg1-x529.google.com [IPv6:2607:f8b0:4864:20::529]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id D4205C06173F for ; Tue, 14 Dec 2021 09:25:40 -0800 (PST) Received: by mail-pg1-x529.google.com with SMTP id y9so4701018pgj.5 for ; Tue, 14 Dec 2021 09:25:40 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to; bh=Sv7+eJ0fQXX7H1NGy9lIJRKrFs/U+Rvm6Ews0gOD/L0=; b=NnL2Eij2GhEJvofiH5c6wKMCWSdbHoHNPw0TR1uqsHp2fjnyE3Qv4vOcRcHVPo4it4 UEQYDmbeOrY5xwMFfScwLSEya3UsaennMdhg4Z8VmVL1HypJfsnk0sOylH+56vnTCxQf qrvom8ZIf6qEhJNrl6+tEgvtEKongcgigABkC9yAECJRYNqfZDOJzlC/qegsjbZRxYNj 0BKHLrzaoFid8UhDh5diXG1IazXN1OL894Mt81Hz09mSx+xdesBVFb72h/TUUH19JhVV ndvCgD8gryvMPpRoHl+qCE+GFY9UOMebPTe5TvZiYLZwQb9AJrx+EU52+yuz156SVlN3 RXfg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to; bh=Sv7+eJ0fQXX7H1NGy9lIJRKrFs/U+Rvm6Ews0gOD/L0=; b=dRREGF3twE3vOBdA2upR7vTIzn6eUN6k/BCSTqAqc9gsbuq4U+he+EP9ZENzqinPmE OP4F4XS3uLR6OSlwlPezBHXyuMQOSnspPpRNgS+tig24FoXP0c+nSVZnV0sHen6ZPEHM jKU+XtfTijjr+6Q4P6YnIzhZMOn4LXXfCrV4OeXmkt2nTlp3KE/nLEDg6l01lbCMuE9O ZK0WWWcSS72QgpMKfIUmlp3A1v3HTDZmcb7dJxW/JeG+5ku2nSvcojIG5i/V9N6Iu8zu PFRcyM7liquVgQ3/QCumq2Ekd33HuUxDjoniYG6Ik9N0bw0HIXeCTtg4M32V6qi0VZWu v2Qw== X-Gm-Message-State: AOAM5311iKbu0yvym1pnTII9+ToyJi/KUeCfSw74YnXGNsQkpl6BQvX4 eK+AV6GIji+gKF3/66UsfBYH X-Google-Smtp-Source: ABdhPJxZJqskPB9smz/DSpwaMvtE2yXMvnUCJ+5DnPGVi75t8A2C1SIkXZAp3nJmJm+uwAUpPKmNcw== X-Received: by 2002:a63:5c64:: with SMTP id n36mr4581599pgm.61.1639502739890; Tue, 14 Dec 2021 09:25:39 -0800 (PST) Received: from thinkpad ([2409:4072:38a:453:3a52:154c:43e0:ef62]) by smtp.gmail.com with ESMTPSA id t8sm329636pgk.66.2021.12.14.09.25.33 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 14 Dec 2021 09:25:39 -0800 (PST) Date: Tue, 14 Dec 2021 22:55:29 +0530 From: Manivannan Sadhasivam To: Souradeep Chowdhury Cc: Andy Gross , Bjorn Andersson , Rob Herring , linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, linux-arm-msm@vger.kernel.org, devicetree@vger.kernel.org, Sai Prakash Ranjan , Sibi Sankar , Rajendra Nayak , vkoul@kernel.org Subject: Re: [PATCH V6 2/7] soc: qcom: dcc:Add driver support for Data Capture and Compare unit(DCC) Message-ID: <20211214172529.GA27563@thinkpad> References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org On Tue, Aug 10, 2021 at 11:24:38PM +0530, Souradeep Chowdhury wrote: > The DCC is a DMA Engine designed to capture and store data > during system crash or software triggers.The DCC operates > based on user inputs via the sysfs interface.The user gives > addresses as inputs and these addresses are stored in the > form of linkedlists. The linked lists are present in the hardware, right? You should state it explicitly. > In case of a system crash or a manual So what does a crash here means? How does DCC detect it? > software trigger by the user through the sysfs interface, > the dcc captures and stores the values at these addresses. This could be reworded a bit: "DCC captures and stores the current values of the provided addresses in SRAM" > This patch contains the driver which has all the methods > pertaining to the sysfs interface, auxiliary functions to > support all the four fundamental operations of dcc namely > read, write, first read then write and loop.The probe method > here instantiates all the resources necessary for dcc to > operate mainly the dedicated dcc sram where it stores the Please use "DCC" everywhere. > values.The DCC driver can be used for debugging purposes > without going for a reboot since it can perform manual > triggers. > It allows users to perform software triggers for capturing values manually. > Also added the documentation for sysfs entries > and explained the functionalities of each sysfs file that > has been created for dcc. > > The following is the justification of using sysfs interface > over the other alternatives like ioctls > > i) As can be seen from the sysfs attribute descriptions, > most of it does basic hardware manipulations like dcc_enable, > dcc_disable, config reset etc. As a result sysfs is preferred > over ioctl as we just need to enter a 0 or 1. > This is not an apt reason to use sysfs. The one-value-per-file is a rule of sysfs not a criteria to use it. > ii) Existing similar debug hardwares are there for which drivers > have been written using sysfs interface.One such example is the > coresight-etm-trace driver.A closer analog can also be the watchdog > subsystems though it is ioctls based. > Initially I thought that this driver could use debugfs interface, but going through it I feel that sysfs is more suited. Reason is, debugfs interface is used by drivers to expose debugging information additional to the function they do. But the sole usage of this driver depends on the configuration exported through the attributes and they looks to be an ABI to me. > Signed-off-by: Souradeep Chowdhury > --- > Documentation/ABI/testing/sysfs-driver-dcc | 114 ++ > drivers/soc/qcom/Kconfig | 8 + > drivers/soc/qcom/Makefile | 1 + > drivers/soc/qcom/dcc.c | 1549 ++++++++++++++++++++++++++++ > 4 files changed, 1672 insertions(+) > create mode 100644 Documentation/ABI/testing/sysfs-driver-dcc > create mode 100644 drivers/soc/qcom/dcc.c > > diff --git a/Documentation/ABI/testing/sysfs-driver-dcc b/Documentation/ABI/testing/sysfs-driver-dcc > new file mode 100644 > index 0000000..05d24f0 > --- /dev/null > +++ b/Documentation/ABI/testing/sysfs-driver-dcc > @@ -0,0 +1,114 @@ > +What: /sys/bus/platform/devices/.../trigger > +Date: March 2021 Please fix the dates of all attributes. > +Contact: Souradeep Chowdhury > +Description: > + This is the sysfs interface for manual software All entries should be aligned properly. > + triggers.The user can simply enter a 1 against > + the sysfs file and enable a manual trigger. > + Example: > + echo 1 > /sys/bus/platform/devices/.../trigger Why 2 spaces after echo? > + > +What: /sys/bus/platform/devices/.../enable > +Date: March 2021 > +Contact: Souradeep Chowdhury > +Description: > + This sysfs interface is used for enabling the > + the dcc hardware.Without this being set to 1, DCC here also. And a space after "." everywhere. > + the dcc hardware ceases to function. > + Example: > + echo 0 > /sys/bus/platform/devices/.../enable > + (disable interface) > + echo 1 > /sys/bus/platform/devices/.../enable > + (enable interface) > + > +What: /sys/bus/platform/devices/.../config > +Date: March 2021 > +Contact: Souradeep Chowdhury > +Description: > + This is the most commonly used sysfs interface > + file and this basically stores the addresses of > + the registers which needs to be read in case of > + a hardware crash or manual software triggers. > + Example: > + echo 0x80000010 10 > /sys/bus/platform/devices/../config > + This specifies that 10 words starting from address words are of width? > + 0x80000010 is to be read.In case there are no words to be > + specified we can simply enter the address. No word to be read? So what's the purpose then? > + > +What: /sys/bus/platform/devices/.../config_write > +Date: March 2021 > +Contact: Souradeep Chowdhury > +Description: > + This file allows user to write a value to the register > + address given as argument.The values are entered in the > + form of .The reason for this > + feature of dcc is that for accessing certain registers > + it is necessary to set some bits of soe other register. soe? > + That is achievable by giving DCC this privelege. privilege > + Example: > + echo 0x80000000 0xFF > /sys/bus/platform/devices/.../config_write > + > +What: /sys/bus/platform/devices/.../config_reset > +Date: March 2021 > +Contact: Souradeep Chowdhury > +Description: > + This file is used to reset the configuration of > + a dcc driver to the default configuration. s/"a dcc driver"/"the DCC driver"/g > + Example: > + echo 1 > /sys/bus/platform/devices/.../config_reset > + > +What: /sys/bus/platform/devices/.../loop > +Date: March 2021 > +Contact: Souradeep Chowdhury > +Description: > + This file is used to enter the loop count as dcc > + driver gives the option to loop multiple times on > + the same register and store the values for each > + loop.This is done to capture the changing values > + of a register with time which comes handy for > + debugging purposes. > + Example: > + echo 10 > /sys/bus/platform/devices/10a2000.dcc/loop > + (Setting the loop count to 10) > + echo 0x80000010 10 > /sys/bus/platform/devices/.../config > + (Read 10 words starting from address 0x80000010O) > + echo 1 > /sys/bus/platform/devices/.../loop > + (Terminate the loop by writing a count of 1 to the loop sysfs node) > + > +What: /sys/bus/platform/devices/.../rd_mod_wr Can you come up with a better name? Like config_read_write? > +Date: March 2021 > +Contact: Souradeep Chowdhury > +Description: > + This file is used to read the value of the register > + and then write the value given as an argument to the > + register address in config.The address argument should > + be given of the form .For debugging > + purposes sometimes we need to first read from a register > + and then set some values to the register. Reading this description gives an impression that this file is used to read the value of a register. But it is write only and the value will be read only during the trigger or crash. So this should be stated explicitly. > + Example: > + echo 0x80000000 > /sys/bus/platform/devices/.../config > + (Set the address in config file) > + echo 0xF 0xA > /sys/bus/platform/devices/.../rd_mod_wr > + (Provide the mask and the value to write) > + > +What: /sys/bus/platform/devices/.../ready > +Date: March 2021 > +Contact: Souradeep Chowdhury > +Description: > + This file is used to check the status of the dcc > + hardware if it's ready to take the inputs. > + Example: > + cat /sys/bus/platform/devices/.../ready Document the value read also. > + > +What: /sys/bus/platform/devices/.../curr_list > +Date: February 2021 > +Contact: Souradeep Chowdhury > +Description: > + This attribute is used to enter the linklist to be > + used while appending addresses.The range of values > + for this can be from 0 to 3.This feature is given in > + order to use certain linkedlist for certain debugging > + purposes. > + Example: > + echo 0 > /sys/bus/platform/devices/10a2000.dcc/curr_list > + How does a user will know the contents of the linked list? Basis on what criteria, user will know what value to write? > diff --git a/drivers/soc/qcom/Kconfig b/drivers/soc/qcom/Kconfig > index 79b568f..5101912 100644 > --- a/drivers/soc/qcom/Kconfig > +++ b/drivers/soc/qcom/Kconfig > @@ -69,6 +69,14 @@ config QCOM_LLCC > SDM845. This provides interfaces to clients that use the LLCC. > Say yes here to enable LLCC slice driver. > > +config QCOM_DCC > + tristate "Qualcomm Technologies, Inc. Data Capture and Compare(DCC) engine driver" > + depends on ARCH_QCOM || COMPILE_TEST > + help > + This option enables driver for Data Capture and Compare engine. DCC > + driver provides interface to configure DCC block and read back > + captured data from DCC's internal SRAM. > + > config QCOM_KRYO_L2_ACCESSORS > bool > depends on ARCH_QCOM && ARM64 || COMPILE_TEST > diff --git a/drivers/soc/qcom/Makefile b/drivers/soc/qcom/Makefile > index ad675a6..0aaf82b 100644 > --- a/drivers/soc/qcom/Makefile > +++ b/drivers/soc/qcom/Makefile > @@ -4,6 +4,7 @@ obj-$(CONFIG_QCOM_AOSS_QMP) += qcom_aoss.o > obj-$(CONFIG_QCOM_GENI_SE) += qcom-geni-se.o > obj-$(CONFIG_QCOM_COMMAND_DB) += cmd-db.o > obj-$(CONFIG_QCOM_CPR) += cpr.o > +obj-$(CONFIG_QCOM_DCC) += dcc.o > obj-$(CONFIG_QCOM_GSBI) += qcom_gsbi.o > obj-$(CONFIG_QCOM_MDT_LOADER) += mdt_loader.o > obj-$(CONFIG_QCOM_OCMEM) += ocmem.o > diff --git a/drivers/soc/qcom/dcc.c b/drivers/soc/qcom/dcc.c > new file mode 100644 > index 0000000..daf4388 > --- /dev/null > +++ b/drivers/soc/qcom/dcc.c > @@ -0,0 +1,1549 @@ > +// SPDX-License-Identifier: GPL-2.0-only > +/* > + * Copyright (c) 2015-2021, The Linux Foundation. All rights reserved. > + */ > + > +#include > +#include > +#include > +#include > +#include > +#include > +#include > +#include > +#include > +#include > +#include > +#include > +#include > + > +#define TIMEOUT_US 5000 > + > +#define dcc_writel(drvdata, val, off) \ > + writel((val), drvdata->base + dcc_offset_conv(drvdata, off)) > +#define dcc_readl(drvdata, off) \ > + readl(drvdata->base + dcc_offset_conv(drvdata, off)) > + > +#define DCC_SRAM_NODE "dcc_sram" > + > +/* DCC registers */ > +#define DCC_HW_INFO 0x04 > +#define DCC_LL_NUM_INFO 0x10 > +#define DCC_STATUS 0x1C Please use lower case for register offsets. Also, align the defines properly. > +#define DCC_LL_LOCK(m) (0x34 + 0x80 * m) > +#define DCC_LL_CFG(m) (0x38 + 0x80 * m) > +#define DCC_LL_BASE(m) (0x3c + 0x80 * m) > +#define DCC_FD_BASE(m) (0x40 + 0x80 * m) > +#define DCC_LL_TIMEOUT(m) (0x44 + 0x80 * m) > +#define DCC_LL_INT_ENABLE(m) (0x4C + 0x80 * m) > +#define DCC_LL_INT_STATUS(m) (0x50 + 0x80 * m) > +#define DCC_LL_SW_TRIGGER(m) (0x60 + 0x80 * m) > +#define DCC_LL_BUS_ACCESS_STATUS(m) (0x64 + 0x80 * m) > + > +#define DCC_MAP_LEVEL1 0x18 > +#define DCC_MAP_LEVEL2 0x34 > +#define DCC_MAP_LEVEL3 0x4C > + > +#define DCC_MAP_OFFSET1 0x10 > +#define DCC_MAP_OFFSET2 0x18 > +#define DCC_MAP_OFFSET3 0x1C > +#define DCC_MAP_OFFSET4 0x8 > + > +#define DCC_FIX_LOOP_OFFSET 16 > +#define DCC_VER_INFO_BIT 9 > + > +#define DCC_READ 0 > +#define DCC_WRITE 1 > +#define DCC_LOOP 2 > +#define DCC_READ_WRITE 3 > + > +#define MAX_DCC_OFFSET GENMASK(9, 2) > +#define MAX_DCC_LEN GENMASK(6, 0) > +#define MAX_LOOP_CNT GENMASK(7, 0) > + > +#define DCC_ADDR_DESCRIPTOR 0x00 > +#define DCC_ADDR_LIMIT 27 > +#define DCC_ADDR_OFF_RANGE 8 > +#define DCC_ADDR_RANGE GENMASK(31, 4) > +#define DCC_LOOP_DESCRIPTOR BIT(30) > +#define DCC_RD_MOD_WR_DESCRIPTOR BIT(31) > +#define DCC_LINK_DESCRIPTOR GENMASK(31, 30) > + > +#define DCC_READ_IND 0x00 > +#define DCC_WRITE_IND (BIT(28)) > + > +#define DCC_AHB_IND 0x00 > +#define DCC_APB_IND BIT(29) > + > +#define DCC_MAX_LINK_LIST 8 > +#define DCC_INVALID_LINK_LIST GENMASK(7, 0) > + > +#define DCC_VER_MASK1 GENMASK(6, 0) > +#define DCC_VER_MASK2 GENMASK(5, 0) > + > +#define DCC_RD_MOD_WR_ADDR 0xC105E > + > +struct qcom_dcc_config { > + int dcc_ram_offset; Are you planning to expand this structure? If not, please use "dcc_ram_offset" directly. > +}; > + > +enum dcc_descriptor_type { > + DCC_ADDR_TYPE, > + DCC_LOOP_TYPE, > + DCC_READ_WRITE_TYPE, > + DCC_WRITE_TYPE > +}; > + > +enum dcc_mem_map_ver { > + DCC_MEM_MAP_VER1 = 1, > + DCC_MEM_MAP_VER2 = 2, > + DCC_MEM_MAP_VER3 = 3 > +}; > + > +struct dcc_config_entry { > + u32 base; > + u32 offset; > + u32 len; > + u32 index; > + u32 loop_cnt; > + u32 write_val; > + u32 mask; > + bool apb_bus; > + enum dcc_descriptor_type desc_type; > + struct list_head list; > +}; > + > +/** > + * struct dcc_drvdata - configuration information related to a dcc device > + * @base: Base Address of the dcc device > + * @dev: The device attached to the driver data > + * @mutex: Lock to protect access and manipulation of dcc_drvdata What? Are you trying to protect the whole structure or some fields? > + * @ram_base: Base address for the SRAM dedicated for the dcc device > + * @ram_offset: Offset to the SRAM dedicated for dcc device > + * @mem_map_ver: Memory map version of DCC hardware > + * @ram_cfg: Used for address limit calculation for dcc > + * @ram_start: Starting address of DCC SRAM > + * @enable: Flag to check if DCC linked list is enabled This contains an array of linked list enable flags. > + * @interrupt_disable:Flag to enable/disable interrupts For simplicity, just use a space after colon. > + * @sram_dev: Character device equivalent of dcc SRAM > + * @sram_class: Class equivalent of the DCC SRAM device > + * @cfg_head: Points to the head of the linked list of addresses > + * @nr_config: Stores the number of addresses currently configured for a linkedlist > + * @nr_link_list: Total number of linkedlists supported by the DCC configuration > + * @curr_list: The index of the current linklist with which the driver is working > + * @loopoff: Loop offset bits range for the addresses > + */ > +struct dcc_drvdata { > + void __iomem *base; > + struct device *dev; > + struct mutex mutex; > + void __iomem *ram_base; > + phys_addr_t ram_size; > + phys_addr_t ram_offset; > + enum dcc_mem_map_ver mem_map_ver; > + phys_addr_t ram_cfg; > + phys_addr_t ram_start; > + bool *enable; > + bool interrupt_disable; Move this to end to avoid holes. > + struct cdev sram_dev; > + struct class *sram_class; > + struct list_head *cfg_head; > + size_t *nr_config; > + size_t nr_link_list; > + u8 curr_list; > + u8 loopoff; > +}; Is it possible to move the linked list specific members to a different struct? > + > +struct dcc_cfg_attr { > + u32 addr; > + u32 prev_addr; > + u32 prev_off; > + u32 link; > + u32 sram_offset; > +}; > + > +struct dcc_cfg_loop_attr { > + u32 loop; > + bool loop_start; Move this to the end > + u32 loop_cnt; > + u32 loop_len; > + u32 loop_off; > +}; > + > +static size_t dcc_offset_conv(struct dcc_drvdata *drvdata, size_t off) Add comment on what this function does. > +{ > + if (drvdata->mem_map_ver == DCC_MEM_MAP_VER1) { > + if ((off & DCC_VER_MASK1) >= DCC_MAP_LEVEL3) Use FIELD_* macros where applicable. > + return off - DCC_MAP_OFFSET3; Use brackets (): return (off - DCC_MAP_OFFSET3); > + if ((off & DCC_VER_MASK1) >= DCC_MAP_LEVEL2) > + return off - DCC_MAP_OFFSET2; > + else if ((off & DCC_VER_MASK1) >= DCC_MAP_LEVEL1) > + return off - DCC_MAP_OFFSET1; > + } else if (drvdata->mem_map_ver == DCC_MEM_MAP_VER2) { > + if ((off & DCC_VER_MASK1) >= DCC_MAP_LEVEL2) > + return off - DCC_MAP_OFFSET4; > + } > + > + return off; > +} > + > +static int dcc_sram_writel(struct dcc_drvdata *drvdata, > + u32 val, u32 off) > +{ > + if (unlikely(off > (drvdata->ram_size - 4))) A comment here would be good too. > + return -EINVAL; > + > + writel(val, drvdata->ram_base + off); > + > + return 0; > +} > + > +static bool dcc_ready(struct dcc_drvdata *drvdata) > +{ > + u32 val; > + > + return !readl_poll_timeout((drvdata->base + dcc_offset_conv(drvdata, DCC_STATUS)), > + val, (FIELD_GET(GENMASK(1, 0), val) == 0), 1, TIMEOUT_US); "FIELD_GET(GENMASK(1, 0)" could be wrapped in a define. > + > +} > + > +static int dcc_read_status(struct dcc_drvdata *drvdata) > +{ > + int curr_list; > + u32 bus_status; > + u32 ll_cfg; > + u32 tmp_ll_cfg; > + > + for (curr_list = 0; curr_list < drvdata->nr_link_list; curr_list++) { > + if (!drvdata->enable[curr_list]) This looks wrong to me. Why can't you simply allocate N number of linked list structures based on the value read from hardware and do all list manipulations with it? Like, struct dcc_list { struct list_head cfg_head; bool enable; ... }; struct dcc_drvdata { ... struct dcc_list *lists; ... }; /* List allocation */ dcc->lists = devm_kzalloc(); ... /* List initialization */ for (i = 0; i < dcc->nr_link_list; i++) { list = dcc->lists[i]; INIT_LIST_HEAD(&list->cfg_head); } ... /* List manipulation */ list = dcc->lists[i]; list->enable = true; > + continue; > + > + bus_status = dcc_readl(drvdata, DCC_LL_BUS_ACCESS_STATUS(curr_list)); > + No new line needed here. I'm stopping here. For the next revision, please split this patch into multiple ones based on the functionality added. It is hard to review 1.3k LOC in a single patch. Thanks, Mani