On 9/10/2023 1:46 AM, Mukesh Ojha wrote:
Hi All,

This is to continuation from the conversation happened at v4



We have put abstract on LPC on this topic as well as initiated a mail thread
with other SoC vendors but did not get much traction on it.


We explored most of possiblity present in kernel to address this issue[1] but
solution like kdump/fadump does not seems safe/secure/performant from our

Hence, with this series we tried to make the minidump kernel driver, simple
and tied with pstore frontends, so that it collects the present available
frontends data like dmesg, ftrace, pmsg, ftrace., Also, we will be working
towards enhancing generic pstore to capture more debug data which will be
helpful for first hand of debugging that can benefit both other pstore users
as well as us as minidump users.

One of the proposal made here,

Looking forward for your comments.


Minidump is a best effort mechanism to collect useful and predefined data
for first level of debugging on end user devices running on Qualcomm SoCs.
It is built on the premise that System on Chip (SoC) or subsystem part of
SoC crashes, due to a range of hardware and software bugs. Hence, the
ability to collect accurate data is only a best-effort. The data collected
could be invalid or corrupted, data collection itself could fail, and so on.

Qualcomm devices in engineering mode provides a mechanism for generating
full system ramdumps for post mortem debugging. But in some cases it's
however not feasible to capture the entire content of RAM. The minidump
mechanism provides the means for selecting which snippets should be
included in the ramdump.

The core of SMEM based minidump feature is part of Qualcomm's boot
firmware code. It initializes shared memory (SMEM), which is a part of
DDR and allocates a small section of SMEM to minidump table i.e also
called global table of content (G-ToC). Each subsystem (APSS, ADSP, ...)
has their own table of segments to be included in the minidump and all
get their reference from G-ToC. Each segment/region has some details
like name, physical address and it's size etc. and it could be anywhere
scattered in the DDR.

Existing upstream Qualcomm remoteproc driver[1] already supports SMEM
based minidump feature for remoteproc instances like ADSP, MODEM, ...
where predefined selective segments of subsystem region can be dumped
as part of coredump collection which generates smaller size artifacts
compared to complete coredump of subsystem on crash.


In addition to managing and querying the APSS minidump description,
the Linux driver maintains a ELF header in a segment. This segment
gets updated with section/program header whenever a new entry gets

Changes in v5:
  - On suggestion from Pavan.k, to have single function call for minidump 
    from remoteproc driver, separated the logic to have separate minidump file 
    qcom_rproc_minidump.c and also renamed the function from qcom_minidump() to
    qcom_rproc_minidump(); however, dropped his suggestion about rework on lazy 
    during region unregister in this series, will pursue it in next series.

  - To simplify the minidump driver, removed the complication for frontend and 
    backend from Greg suggestion, will pursue this once main driver gets 

  - Move the dynamic ramoops region allocation from Device tree approach to 
command line
    approch with the introduction command line parsing and memblock reservation 
    early boot up; Not added documentation about it yet, will add if it gets 

  - Exporting linux banner from kernel to make minidump build also as module, 
    minidump is a debug module and should be kernel built to get most debug 
    from kernel.

  - Tried to address comments given on dload patch series.

Changes in v4: 
  - Redesigned the driver and divided the driver into front end and backend 
(smem) so
    that any new backend can be attached easily to avoid code duplication.
  - Patch reordering as per the driver and subsystem to easier review of the 
  - Removed minidump specific code from remoteproc to minidump smem based 
  - Enabled the all the driver as modules.
  - Address comments made on documentation and yaml and Device tree file 
  - Address comments made qcom_pstore_minidump driver and given its Device tree
    same set of properties as ramoops. [Luca/Kees]
  - Added patch for MAINTAINER file.
  - Include defconfig change as one patch as per [Krzysztof] suggestion.
  - Tried to remove the redundant file scope variables from the module as per 
[Krzysztof] suggestion.
  - Addressed comments made on dload mode patch v6 version

Changes in v3: 
  - Addressed most of the comments by Srini on v2 and refactored the minidump 
     - Added platform device support
     - Unregister region support.
  - Added update region for clients.
  - Added pending region support.
  - Modified the documentation guide accordingly.
  - Added qcom_pstore_ramdump client driver which happen to add ramoops platform
    device and also registers ramoops region with minidump.
  - Added download mode patch series with this minidump series.

Changes in v2: 
  - Addressed review comment made by [quic_tsoni/bmasney] to add documentation.
  - Addressed comments made by [srinivas.kandagatla]
  - Dropped pstore 6/6 from the last series, till i get conclusion to get pstore
    region in minidump.
  - Fixed issue reported by kernel test robot.

Changes in v1: 

Testing of the patches has been done on sm8450 target after enabling config like
CONFIG_PSTORE_RAM and CONFIG_PSTORE_CONSOLE and once the device boots up.

  echo mini > /sys/module/qcom_scm/parameters/download_mode

Try crashing it via devmem2 0xf11c000(this is known to create xpu violation and
and put the device in download mode) on command prompt.

Default storage type is set to via USB, so minidump would be downloaded with the
help of x86_64 machine (running PCAT tool) attached to Qualcomm device which has
backed minidump boot firmware support.

This will make the device go to download mode and collect the minidump on to the
attached x86 machine running the Qualcomm PCAT tool(This comes as part Qualcomm
package manager kit).

After that we will see a bunch of predefined registered region as binary blobs 
starts with md_* downloaded on the x86 machine on given location in PCAT tool 
the target device, more about this can be found in qualcomm minidump guide 

Mukesh Ojha (17):
   docs: qcom: Add qualcomm minidump guide
   soc: qcom: Add qcom_rproc_minidump module
   remoteproc: qcom_q6v5_pas: Use qcom_rproc_minidump()
   remoteproc: qcom: Remove minidump related data from qcom_common.c
   init: export linux_banner data variable
   soc: qcom: Add Qualcomm APSS minidump kernel driver
   soc: qcom: minidump: Add pending region registration
   arm64: mm: Add dynamic ramoops region support through command line
   pstore/ram: Use dynamic ramoops reserve resource
   pstore: Add pstore_region_defined() helper and export it
   qcom_minidump: Register ramoops region with minidump
   MAINTAINERS: Add entry for minidump related files

Based on last discussion[1], I posted the V5 of the below three patches[2] separately. I don't mind clubbing these again back to Minidump series as long as three patches can be picked up separately.

   firmware: qcom_scm: provide a read-modify-write function
   pinctrl: qcom: Use qcom_scm_io_update_field()
   firmware: scm: Modify only the download bits in TCSR register

[1] https://lore.kernel.org/linux-arm-msm/d77f5601-2b08-a7c7-1400-7ab68b8ad...@quicinc.com/

[2] https://lore.kernel.org/linux-arm-msm/20230720070408.1093698-1-quic_kathi...@quicinc.com/

   firmware: qcom_scm: Refactor code to support multiple download mode
   firmware: qcom_scm: Add multiple download mode support

  Documentation/admin-guide/index.rst         |   1 +
  Documentation/admin-guide/qcom_minidump.rst | 272 +++++++++++
  MAINTAINERS                                 |  10 +
  arch/arm64/mm/init.c                        |  94 ++++
  drivers/firmware/Kconfig                    |  11 -
  drivers/firmware/qcom_scm.c                 |  90 +++-
  drivers/pinctrl/qcom/pinctrl-msm.c          |  10 +-
  drivers/remoteproc/Kconfig                  |   1 +
  drivers/remoteproc/qcom_common.c            | 150 ------
  drivers/remoteproc/qcom_q6v5_pas.c          |   3 +-
  drivers/soc/qcom/Kconfig                    |  24 +
  drivers/soc/qcom/Makefile                   |   3 +
  drivers/soc/qcom/qcom_minidump.c            | 727 ++++++++++++++++++++++++++++
  drivers/soc/qcom/qcom_minidump_internal.h   |  74 +++
  drivers/soc/qcom/qcom_ramoops_minidump.c    |  88 ++++
  drivers/soc/qcom/qcom_ramoops_minidump.h    |  10 +
  drivers/soc/qcom/qcom_rproc_minidump.c      | 111 +++++
  drivers/soc/qcom/smem.c                     |  18 +
  fs/pstore/platform.c                        |  15 +
  fs/pstore/ram.c                             |  52 +-
  include/linux/firmware/qcom/qcom_scm.h      |   2 +
  include/linux/init.h                        |   3 +
  include/linux/pstore.h                      |   6 +
  include/linux/pstore_ram.h                  |   2 +
  include/linux/soc/qcom/smem.h               |   2 +
  include/soc/qcom/qcom_minidump.h            |  56 +++
  init/version-timestamp.c                    |   3 +
  27 files changed, 1659 insertions(+), 179 deletions(-)
  create mode 100644 Documentation/admin-guide/qcom_minidump.rst
  create mode 100644 drivers/soc/qcom/qcom_minidump.c
  create mode 100644 drivers/soc/qcom/qcom_minidump_internal.h
  create mode 100644 drivers/soc/qcom/qcom_ramoops_minidump.c
  create mode 100644 drivers/soc/qcom/qcom_ramoops_minidump.h
  create mode 100644 drivers/soc/qcom/qcom_rproc_minidump.c
  create mode 100644 include/soc/qcom/qcom_minidump.h

Reply via email to