From patchwork Wed Dec 27 17:57:38 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Samuel Holland X-Patchwork-Id: 183533 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:6f82:b0:100:9c79:88ff with SMTP id tb2csp1579733dyb; Wed, 27 Dec 2023 09:57:59 -0800 (PST) X-Google-Smtp-Source: AGHT+IHML9QIoTlMAK7NEfkULzGQ1SXFLmgR8jhhe4rUFZRDjPNGiOZ5kFFEVwBbJWUVDI7t2qqa X-Received: by 2002:a17:906:518c:b0:a26:fcdf:baab with SMTP id y12-20020a170906518c00b00a26fcdfbaabmr1772958ejk.61.1703699879141; Wed, 27 Dec 2023 09:57:59 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1703699879; cv=none; d=google.com; s=arc-20160816; b=BHw/et8McI//51B5BX/tRcJOPKaesSHxvu6AvHXvsRAB3x1cVsLyeHuahRC/+nGcbz dO0q0XHqWBYMT8v0JOkJYRs4Q5XfR2GrXygULc1L8hSEphKQ+uX5VxGRrT0+02arXKiN jpJgd8bxWl4LQ4wZbyROGYAuCtV5V37D9bvEKn/i7RBuPdSCNGfaBA8lnXheEP90ebmK Cl8+Mr9Rn+E9JJpz8/s9G0bYpXvQ0n8Vl60OQfMIVXH7j8OWsETlIq/qgrx398oI5G0g P1biPsy/7+93G80rO6+cKC5IaMbY/r5zy68aB8G2in/X0nGNzRZVcND+I4wOJuAW+0Jx 31Yw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:message-id:date:subject:cc:to :from:dkim-signature; bh=qFdk5z5GkjX88rNpaFiaLGBWYiEnPzJT6afZDm+eY4c=; fh=b5aloRD0FTNhjHaRZyfCWcsstd/aRhLr7buWjIN7P2g=; b=hEMUV0lkpEsZZRTfLNQUMSulezutb5soVBcxPQ0fEvDuYlOwhJSUCW6aOfCTK/IVfr jND0318amxaQkauKZLc4Du+52OBY9qH5t9Z1vjpuUBn4pF8bWy1ogacXHSYq3wUGLzZR h81uywRnvGx0yPzXjUh+JAenNdZhQ3QMxMGP3FBLDHhDgIP7MijhGDIsRI58bpcfOpBB PKzpPBzPGDN/5tQY4Tj2IGzAKJerjDqWTm1bcfsqYEinLQTkCzQwPNCVWEQ/U/wga0oc 9D2kOsxGEe2F7KvAfyrqum/U6fvQOzmD+SlAcMeHneT2e2E7qwrdgWHClXuhLU0//J3H LVRQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@sifive.com header.s=google header.b=RkJA4PFc; spf=pass (google.com: domain of linux-kernel+bounces-12189-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-12189-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=sifive.com Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [147.75.80.249]) by mx.google.com with ESMTPS id k15-20020a170906680f00b00a26aa994725si5830738ejr.26.2023.12.27.09.57.58 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 27 Dec 2023 09:57:59 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-12189-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) client-ip=147.75.80.249; Authentication-Results: mx.google.com; dkim=pass header.i=@sifive.com header.s=google header.b=RkJA4PFc; spf=pass (google.com: domain of linux-kernel+bounces-12189-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-12189-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=sifive.com Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by am.mirrors.kernel.org (Postfix) with ESMTPS id BD6F21F21DCD for ; Wed, 27 Dec 2023 17:57:58 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 85B6346B91; Wed, 27 Dec 2023 17:57:46 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=sifive.com header.i=@sifive.com header.b="RkJA4PFc" X-Original-To: linux-kernel@vger.kernel.org Received: from mail-pf1-f170.google.com (mail-pf1-f170.google.com [209.85.210.170]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 80EAF46538 for ; Wed, 27 Dec 2023 17:57:42 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=sifive.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=sifive.com Received: by mail-pf1-f170.google.com with SMTP id d2e1a72fcca58-6d9b13fe9e9so2226365b3a.2 for ; Wed, 27 Dec 2023 09:57:42 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sifive.com; s=google; t=1703699862; x=1704304662; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=qFdk5z5GkjX88rNpaFiaLGBWYiEnPzJT6afZDm+eY4c=; b=RkJA4PFc1fPlGPeup903dlfZcEiqEV+5E8gOOr9f9qcjFlAKUY+qRYmxi3blePvH3I RCUu0tFNhy69ZsAqYE67ZQ1WzqZOEa/e+XYdra1c2naVAj/t6goggAn/oE2mgTIwQpI5 EkIdqqQEIr8+lxSmsXhopAq/+WtZY4iMI9son/X2VbgcfukVvKsDJy928hfWEa3CTib+ dMRJGNtuB8gUXUPPt/HSm5wduE+c8bcKykqlOKSk7UbnhjwV0C8LhhFRoF1pF/gTeW1M bQ6Ly5wfVZVW9lUI3Ysbzjs+PjvL1MQ8lUVfxEKwVPcrFq7fqd7CByBAPrUUmR/TIZZs u7qQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1703699862; x=1704304662; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=qFdk5z5GkjX88rNpaFiaLGBWYiEnPzJT6afZDm+eY4c=; b=FGl6Fa5qPEKX30bn6aUKabvJvOovoG+Vb1G4f4MRIAwmjazCyJY+SUA0kLCHJxcLi3 /tqlSG0E/nhOiZfdWhP2LSSXYhB6TbYa78ifAurlHf0uMkZbcKBAIiAWX+nUA437upK/ x80UXiQR0qFnB6SysnDN8mHZtPsZmCAl4t7Gdm9zIIXGm8JNRXnFSTIr6dd/lyIP1eAi r/nDi5z3DxFwuJxv5MOiv7qTqPI0SKT4oE7bB2nlt1GHmqG5NfhB9V2Him5OPoS2Jm1H Adc4YitgXAywqrGqiuiQPEB2WwTCP+KrzH+CWVlLnz3OcK0k5LZDp39xdcUIgdOu5tsY wB8w== X-Gm-Message-State: AOJu0YzMwBrc7Kdd4CRqScFvWLXyuzxEO/ltPW1DgsqsolHoExnZDgqE 96pB2een7o8Km7+ReVwgCat6RhkgqC6FkQ== X-Received: by 2002:a05:6a20:4da6:b0:18c:64b7:b217 with SMTP id gj38-20020a056a204da600b0018c64b7b217mr9235433pzb.22.1703699861863; Wed, 27 Dec 2023 09:57:41 -0800 (PST) Received: from sw06.internal.sifive.com ([4.53.31.132]) by smtp.gmail.com with ESMTPSA id u5-20020a056a00098500b006d9bf35dd1fsm5198094pfg.142.2023.12.27.09.57.40 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 27 Dec 2023 09:57:41 -0800 (PST) From: Samuel Holland To: linux-riscv@lists.infradead.org Cc: Samuel Holland , Albert Ou , Conor Dooley , Krzysztof Kozlowski , Palmer Dabbelt , Paul Walmsley , Rob Herring , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH] dt-bindings: riscv: cpus: Clarify mmu-type interpretation Date: Wed, 27 Dec 2023 09:57:38 -0800 Message-ID: <20231227175739.1453782-1-samuel.holland@sifive.com> X-Mailer: git-send-email 2.42.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1786458804712732882 X-GMAIL-MSGID: 1786458804712732882 The current description implies that only a single address translation mode is available to the operating system. However, some implementations support multiple address translation modes, and the operating system is free to choose between them. Per the RISC-V privileged specification, Sv48 implementations must also implement Sv39, and likewise Sv57 implies support for Sv48. This means it is possible to describe all supported address translation modes using a single value, by naming the largest supported mode. This appears to have been the intended usage of the property, so note it explicitly. Fixes: 4fd669a8c487 ("dt-bindings: riscv: convert cpu binding to json-schema") Signed-off-by: Samuel Holland Reviewed-by: Conor Dooley --- Documentation/devicetree/bindings/riscv/cpus.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/devicetree/bindings/riscv/cpus.yaml b/Documentation/devicetree/bindings/riscv/cpus.yaml index f392e367d673..f166c729c482 100644 --- a/Documentation/devicetree/bindings/riscv/cpus.yaml +++ b/Documentation/devicetree/bindings/riscv/cpus.yaml @@ -62,8 +62,8 @@ properties: mmu-type: description: - Identifies the MMU address translation mode used on this - hart. These values originate from the RISC-V Privileged + Identifies the largest MMU address translation mode supported by + this hart. These values originate from the RISC-V Privileged Specification document, available from https://riscv.org/specifications/ $ref: /schemas/types.yaml#/definitions/string