UltraSoC - SoC 하드웨어 지원 추적

UltraSoC SMB 개요

이 문서는 Qi Liu가 2023년 1월 작성했으며 GPL-2.0을 따른다.

UltraSoC SMB는 SCCL(Super CPU Cluster)마다 존재하는 hardware다. shared system memory의 한 영역에 CPU trace message를 buffer하고 저장하는 방법을 제공한다.

이 device는 CoreSight sink device로 동작하고, 대응하는 trace generator인 ETM은 source device로 연결된다.

.. SPDX-License-Identifier: GPL-2.0

======================================
UltraSoc - HW Assisted Tracing on SoC
======================================
   :Author:   Qi Liu <[email protected]>
   :Date:     January 2023

Introduction
------------

UltraSoc SMB is a per SCCL (Super CPU Cluster) hardware. It provides a
way to buffer and store CPU trace messages in a region of shared system
memory. The device acts as a coresight sink device and the
corresponding trace generators (ETM) are attached as source devices.

Sysfs device와 관리 register

SMB device는 다른 device와 함께 기존 CoreSight bus의 `/sys/bus/coresight/devices/`에 나타난다. 예시 system에는 `ultra_smb0`부터 `ultra_smb3`까지 네 device가 있다.

`ultra_smb<N>`은 특정 SCCL에 연결된 SMB device의 이름이다. device directory에는 `enable_sink`와 `mgmt`가 있으며, `mgmt` 아래에는 `buf_size`, `buf_status`, `read_pos`, `write_pos`가 있다.

`read_pos`는 read pointer register 값을, `write_pos`는 write pointer register 값을 보여 준다. `buf_status`는 status register 값을 보여 주며 BIT(0)이 0이면 buffer가 비어 있다는 뜻이다. `buf_size`는 각 device의 buffer size를 보여 준다.

Sysfs files and directories
---------------------------

The SMB devices appear on the existing coresight bus alongside other
devices::

	$# ls /sys/bus/coresight/devices/
	ultra_smb0   ultra_smb1   ultra_smb2   ultra_smb3

The ``ultra_smb<N>`` names SMB device associated with SCCL.::

	$# ls /sys/bus/coresight/devices/ultra_smb0
	enable_sink   mgmt
	$# ls /sys/bus/coresight/devices/ultra_smb0/mgmt
	buf_size  buf_status  read_pos  write_pos

Key file items are:

   * ``read_pos``: Shows the value on the read pointer register.
   * ``write_pos``: Shows the value on the write pointer register.
   * ``buf_status``: Shows the value on the status register.
     BIT(0) is zero value which means the buffer is empty.
   * ``buf_size``: Shows the buffer size of each device.

ACPI firmware binding과 graph

이 device는 ACPI에서만 지원된다. binding은 device identifier, resource information, graph structure를 기술한다.

device의 ACPI HID는 `HISI03A1`이다. resource는 `_CRS` method로 할당하며 각 device는 base address 두 개를 제시해야 한다.

첫 번째 base address는 device configuration 영역이다. 두 번째는 shared system memory의 32-bit base address다. 예시에서는 non-cacheable configuration resource가 `0x95100000`부터 `0x951FFFFF`까지 1 MiB이고, cacheable shared-memory resource가 `0x50000000`부터 `0x53FFFFFF`까지 64 MiB다.

`_DSD` package는 CoreSight Graph ACPI binding UUID를 사용해 연결 topology를 기술한다. 예시는 graph package에 여덟 endpoint를 두고 `0x8`부터 `0xf`까지를 `F008`부터 `F015` device에 각각 연결한다. ASL 구문과 namespace path는 원문 그대로 보존한다.

Firmware Bindings
-----------------

The device is only supported with ACPI. Its binding describes device
identifier, resource information and graph structure.

The device is identified as ACPI HID "HISI03A1". Device resources are allocated
using the _CRS method. Each device must present two base address; the first one
is the configuration base address of the device, the second one is the 32-bit
base address of shared system memory.

Example::

    Device(USMB) {                                               \
      Name(_HID, "HISI03A1")                                     \
      Name(_CRS, ResourceTemplate() {                            \
          QWordMemory (ResourceConsumer, , MinFixed, MaxFixed, NonCacheable, \
		       ReadWrite, 0x0, 0x95100000, 0x951FFFFF, 0x0, 0x100000) \
          QWordMemory (ResourceConsumer, , MinFixed, MaxFixed, Cacheable, \
		       ReadWrite, 0x0, 0x50000000, 0x53FFFFFF, 0x0, 0x4000000) \
      })                                                         \
      Name(_DSD, Package() {                                     \
        ToUUID("ab02a46b-74c7-45a2-bd68-f7d344ef2153"),          \
	/* Use CoreSight Graph ACPI bindings to describe connections topology */
        Package() {                                              \
          0,                                                     \
          1,                                                     \
          Package() {                                            \
            1,                                                   \
            ToUUID("3ecbc8b6-1d0e-4fb3-8107-e627f805c6cd"),      \
            8,                                                   \
            Package() {0x8, 0, \_SB.S00.SL11.CL28.F008, 0},       \
            Package() {0x9, 0, \_SB.S00.SL11.CL29.F009, 0},       \
            Package() {0xa, 0, \_SB.S00.SL11.CL2A.F010, 0},       \
            Package() {0xb, 0, \_SB.S00.SL11.CL2B.F011, 0},       \
            Package() {0xc, 0, \_SB.S00.SL11.CL2C.F012, 0},       \
            Package() {0xd, 0, \_SB.S00.SL11.CL2D.F013, 0},       \
            Package() {0xe, 0, \_SB.S00.SL11.CL2E.F014, 0},       \
            Package() {0xf, 0, \_SB.S00.SL11.CL2F.F015, 0},       \
          }                                                      \
        }                                                        \
      })                                                         \
    }