Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.31 as permitted sender) client-ip=23.128.96.31;
From:   Inochi Amaoto <inochiama@outlook.com>
To:     Yu-Chien Peter Lin <peterlin@andestech.com>
Cc:     Inochi Amaoto <inochiama@outlook.com>, Guo Ren <guoren@kernel.org>,
        acme@kernel.org, adrian.hunter@intel.com, ajones@ventanamicro.com,
        alexander.shishkin@linux.intel.com, andre.przywara@arm.com,
        anup@brainfault.org, aou@eecs.berkeley.edu, atishp@atishpatra.org,
        conor+dt@kernel.org, conor.dooley@microchip.com, conor@kernel.org,
        devicetree@vger.kernel.org, dminus@andestech.com,
        evan@rivosinc.com, geert+renesas@glider.be, heiko@sntech.de,
        irogers@google.com, jernej.skrabec@gmail.com, jolsa@kernel.org,
        jszhang@kernel.org, krzysztof.kozlowski+dt@linaro.org,
        linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org,
        linux-perf-users@vger.kernel.org,
        linux-renesas-soc@vger.kernel.org, linux-riscv@lists.infradead.org,
        linux-sunxi@lists.linux.dev, locus84@andestech.com,
        magnus.damm@gmail.com, mark.rutland@arm.com, mingo@redhat.com,
        n.shubin@yadro.com, namhyung@kernel.org, palmer@dabbelt.com,
        paul.walmsley@sifive.com, peterz@infradead.org,
        prabhakar.mahadev-lad.rj@bp.renesas.com, rdunlap@infradead.org,
        robh+dt@kernel.org, samuel@sholland.org, sunilvl@ventanamicro.com,
        tglx@linutronix.de, tim609@andestech.com, uwu@icenowy.me,
        wens@csie.org, will@kernel.org, ycliang@andestech.com
Subject: Re: [PATCH v4 09/13] dt-bindings: riscv: Add T-Head PMU extension description
Date:   Thu, 30 Nov 2023 16:29:22 +0800
Message-ID: <IA1PR20MB49537364BDF1ADE185CA8FE4BB82A@IA1PR20MB4953.namprd20.prod.outlook.com>
In-Reply-To: <ZWb6-LEkyh5RRpcP@APC323>
References: <ZWb6-LEkyh5RRpcP@APC323>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
MIME-Version: 1.0
X-MS-Exchange-MessageSentRepresentingType: 1
X-MS-PublicTrafficType: Email
X-MS-TrafficTypeDiagnostic: IA1PR20MB4953:EE_|LV2PR20MB4677:EE_
X-MS-Office365-Filtering-Correlation-Id: 0a3eea9f-f97b-4dec-37bf-08dbf17e7561
X-Microsoft-Antispam: BCL:0;
X-Microsoft-Antispam-Message-Info: xisGXSkcn1uetDq33P2fZ8q455etabpBOtR7zrHsBtZfNJ9AOW526dIoHAXI4vDRJXYR9PVgKdP/RBenqVDdFrV02oVndu24TcYGBB33KeI+xsQ5yK6C/rj8VJjeeEzNCMOE46o4J24CVNdTSu6prKKLHW/7gMH6HHw3ZSke6FG0LT8tWKCkVsNq51eh/LGAKwreJSYYtoApROJJajk7SnufPUpvxS0np8bCkoLgwORe+2HRszVLhQYYj8DI93mcy81ohsyHCmdA51qA/bURIRPDlfZTkKjSfGOO3TuiCLPGkL3GvdOXM4gaBVwnCNFNOOL9I/Zl5tzuFRpLzk9CqmRb16iFLWMoiFu8if+WJizx/4m33qmEKD1RNneh0tVOp6JtmEQ01InwnNufS3/ewtr+ZBI1VVbPpqp2o85Hjcb/F/DRAWgc4so35ZRpeWTrG/egGCFRtL5zh9XnbfTgxTCNIEmYD8Z+DXgvjbnamK7wPpAC4pZ6ZjJKchMBfnjbhgaE/ZWTb7sBhczFd7qSLF30gTalc1q/EAVkBvMk5rZFD5BKca+rMcjjALSZhLhVrmJ47mBWP0jVQx/rZu/XC6IhHn7+1Nz3T3i0F+TPihUvImNiOkBgsosDC7KiRZe480fiVAgJl0giT5FgV3aMTnbOoeiRbCqmwxDe3fYkEhU=
X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1
X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?OExRSXhmenZtUms5SEpiekdUODRUREROM0NIL0EvTVBWbDV0YnBremhrZWNr?=
 =?utf-8?B?VmtSZWJldlhGbWI0M3hsc0lwUG4zV240L3BRdzJXTnVpS2dOVjloNE5NUVlx?=
 =?utf-8?B?SG9HVFRDTWgwVDI3RHFkZEVNTVpTWDZyOHplRmMvOXpXVWZLK2lmdVFzZGs4?=
 =?utf-8?B?ZDBSc1FUM1BiY1VPdWZhRVZ2cUFBdUx2L0pKNlVSMUQyOHdubkFIdWtKd01N?=
 =?utf-8?B?bGpJdG85ZFB3TDZ5WEhEc0ltVVdnckNXMTZkNGd4a25mZlFuSXRWVWJUR1Rt?=
 =?utf-8?B?bXpqWXRjRGtTTVlwcU5tWld4M1p4NzJaMzNlWjdEZlhiNjZjYjkrUXlwK2xT?=
 =?utf-8?B?MGJseVJ1di9zWTkrSWZCdkdYbVQxMVh6R1h0dHFnTHBPeFpLNGp3QjA3ek0y?=
 =?utf-8?B?aUVZT1JtVlExbmt6ekJ5d0pET05DWHo5eStPdzc5cExDTVp2TXZwMk5CMVE5?=
 =?utf-8?B?RmdodCtFeHpuazVYTXZrZWlUaEFWVFFKQjc3ODhEVk1yZVNqbFNBYWtsR0RL?=
 =?utf-8?B?Zy9PUUQ1azFFRk0rVXA5bW9QRnY5bXJ5RjV3N2hweERXdks4OUFoc2ZIL3gz?=
 =?utf-8?B?YTFwTGM3dmswbnFBWlp3aHR5VkNyTGMwTzJVbGkvMUY5K3g2bVBOTjdUaHl1?=
 =?utf-8?B?eThuUjlpSWJIWG5aRGJkaisxZ0xLODBlMDBIYlNVUDZkRjNSQ3p0eForbVZ5?=
 =?utf-8?B?SUxqbnpjVnZ5TVdHSkk4S1lnU0Z6b29TQkNuVGNpK1NETHQxMXU4azNxMjh5?=
 =?utf-8?B?ZGhwd2JrUGhodnVwdFpFTUkwVCtmMExIOHZ6MEdacU1EaTVYOFdtakJBV2Iv?=
 =?utf-8?B?bWxteS9nd2VZTVI4MEZyN2VLYlFNajNyVmRCQ3dDZ2dkcC9qQVMxbXJmak12?=
 =?utf-8?B?bDRSK244NDVURTFmK0JRakpJT3lIb1JneTAxbmxFQUNDZGh3MHNVRmtCank5?=
 =?utf-8?B?QjN2eEluUm5HY2s5dU5XQ0hwa0U2Q0FDVjg4dy9qc0ZzZlp0UUJKYXgrWnNL?=
 =?utf-8?B?ZVBTVGYrZ1BYUUhOQWpLWm93UktBcmd5MStOOFdYRFY0cjR0YW90Z0s4TTdM?=
 =?utf-8?B?OU45Y00vQmVvanVnUmhuSm84enNKSUhMeG5LSUdkbUc5OGFKWkZQTTB0QXRn?=
 =?utf-8?B?VnNzRlJjYkFaK0krSVBvMitIMk5PVFo1MU04QnN3TnY4VHpxUXluNWhqSDBU?=
 =?utf-8?B?cy8zdFZQQTlQampGTmV0TCtrZ1ltWUZBZUkyQ2tkSW5WQis1VXZGNDJaRGc3?=
 =?utf-8?B?ZnFyR2txd1dXalNqNDFLQzI4YjJieXJ5ZmVuTFFrbTJ3NGM3bUFpYWREZ3RJ?=
 =?utf-8?B?eTd1Uno4U0NoOEw2NW5yQit0Y1hROFcvcHhGS09kNldpZ0VoT1N5Y0cxVVVH?=
 =?utf-8?B?UU9MMGdTRjlXMlRadng2ODlRc3U0SENpS3Q0bnJ3QTZTV1pHZ0xzeStQSE1Q?=
 =?utf-8?B?N0czbC9FZndybGljTko4NUo3WGpFZktvTlRZeEtQWno0aHkrb3hrTXExWGV4?=
 =?utf-8?B?NUtvTnh5OXJkRkVBRk90S1lDTC96RFFDei92RWF3VUxXcWc2TVc2L1ZwL3B6?=
 =?utf-8?B?aFgwR2VvUDI4K3hsMmo4c2NyTlFJbnU1cDdKOUpDbFMwVUtkdTNWQmhrR2ZB?=
 =?utf-8?Q?zXKwDrWghnBg2h9P+9Lq+YQmkB3iGbEKZW/ow3LnF1cA=3D?=
X-OriginatorOrg: outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 0a3eea9f-f97b-4dec-37bf-08dbf17e7561
X-MS-Exchange-CrossTenant-AuthSource: IA1PR20MB4953.namprd20.prod.outlook.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 30 Nov 2023 08:29:24.2850
 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa
X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg: 00000000-0000-0000-0000-000000000000
X-MS-Exchange-Transport-CrossTenantHeadersStamped: LV2PR20MB4677
X-Spam-Status: No, score=-0.6 required=5.0 tests=DKIM_SIGNED,DKIM_VALID,
	DKIM_VALID_AU,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM,
	HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,SPF_HELO_NONE,
	SPF_PASS,T_SCC_BODY_TEXT_LINE autolearn=unavailable autolearn_force=no
	version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on morse.vger.email
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org
X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (morse.vger.email [0.0.0.0]); Thu, 30 Nov 2023 00:29:37 -0800 (PST)

>
>Hi Guo Ren,
>
>On Thu, Nov 23, 2023 at 05:14:30AM +0800, Guo Ren wrote:
>> On Wed, Nov 22, 2023 at 8:17 PM Yu Chien Peter Lin
>> <peterlin@andestech.com> wrote:
>>>
>>> Document the ISA string for T-Head performance monitor extension
>>> which provides counter overflow interrupt mechanism.
>>>
>>> Signed-off-by: Yu Chien Peter Lin <peterlin@andestech.com>
>>> ---
>>> Changes v2 -> v3:
>>>   - New patch
>>> Changes v3 -> v4:
>>>   - No change
>>> ---
>>>  Documentation/devicetree/bindings/riscv/extensions.yaml | 6 ++++++
>>>  1 file changed, 6 insertions(+)
>>>
>>> diff --git a/Documentation/devicetree/bindings/riscv/extensions.yaml b/Documentation/devicetree/bindings/riscv/extensions.yaml
>>> index c91ab0e46648..694efaea8fce 100644
>>> --- a/Documentation/devicetree/bindings/riscv/extensions.yaml
>>> +++ b/Documentation/devicetree/bindings/riscv/extensions.yaml
>>> @@ -258,5 +258,11 @@ properties:
>>>              in commit 2e5236 ("Ztso is now ratified.") of the
>>>              riscv-isa-manual.
>>>
>>> +        - const: xtheadpmu
>>> +          description:
>>> +            The T-Head performance monitor extension for counter overflow. For more
>>> +            details, see the chapter 12 in the Xuantie C906 user manual.
>>> +            https://github.com/T-head-Semi/openc906/tree/main/doc
>>> +
>>>  additionalProperties: true
>>>  ...
>>> --
>>> 2.34.1
>>>
>> Reviewed-by: Guo Ren <guoren@kernel.org>
>
>Thanks for the review.
>Would you share document about T-Head PMU?
>

Hi, Peter Lin:

You can use the following two document to get all events:
https://github.com/T-head-Semi/openc906/tree/main/doc
https://github.com/T-head-Semi/openc910/tree/main/doc

There are also some RTL code can describe these events:
https://github.com/T-head-Semi/openc910/blob/e0c4ad8ec7f8c70f649d826ebd6c949086453272/C910_RTL_FACTORY/gen_rtl/pmu/rtl/ct_hpcp_top.v#L1123
https://github.com/T-head-Semi/openc906/blob/af5614d72de7e5a4b8609c427d2e20af1deb21c4/C906_RTL_FACTORY/gen_rtl/pmu/rtl/aq_hpcp_top.v#L543

The perf events json can also be used as document, this is already
applied (with more detailed explanation):
https://lore.kernel.org/all/IA1PR20MB495325FCF603BAA841E29281BBBAA@IA1PR20MB4953.namprd20.prod.outlook.com/

Best regards,
Inochi