Received: by 2002:a05:7208:9594:b0:7e:5202:c8b4 with SMTP id gs20csp1277938rbb; Mon, 26 Feb 2024 04:44:19 -0800 (PST) X-Forwarded-Encrypted: i=3; AJvYcCVuQGMMby8X+OQppx945b06dTmqqLNsZdxJGLefsVXA3Q1XU3khdZvBm5cE+K3Z4EO8mqc/6hEkzmH++xM0MC+/5/Jb14Yeu9ZALpbW1g== X-Google-Smtp-Source: AGHT+IFcB9AFNtRP29WElvV9bsEVUe84+ZJGl1KJhJMApUCBOVKFtcMFzSNcbKcPjwxP4azvajrS X-Received: by 2002:a17:902:6b81:b0:1dc:334:a87b with SMTP id p1-20020a1709026b8100b001dc0334a87bmr6675324plk.20.1708951459417; Mon, 26 Feb 2024 04:44:19 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1708951459; cv=pass; d=google.com; s=arc-20160816; b=aFu7hEfTqDdgbD3gKetvBD3pc9dFsh4jupCd5k8937oUFZaJpOh4F5QXJF0ny8RhTL 5dC5SIZxL0oT6JyPta9tObgXw4wfTBh/2gXr+WbzWktGsxOmY+YB/I8p2L4hvckhSiaU gehxKJsisVWMGKl+v08/COgLldAPW6p7R4CtscWaPGf3jSgc6FxhdylW/io9o/Bcftgn 4npiSu/ZyQe7NJClYrzIkCHLyYPEhw6cssYTeKel5nbgH1QPOElg8JR1dbxEyOt16J+e +LUpv7T2JWnQNTX/y4SoTedZOPfSDjuVWiR9L9NABa5+mYlPL+fheaBD5VVQvLtgNbt7 s47Q== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:list-unsubscribe:list-subscribe :list-id:precedence:dkim-signature; bh=Q+35+P4r2JIren/LNJaaaherP1wCOAvB2HpC0DyEeMg=; fh=QRtjUb/8GovRvsaBIXqZDPTgCATA4mozBpraZ1pa0TQ=; b=kalH595JekXRvGiQ0qdmhBgdHBb+R6o9VC7aU363RtE8LtaY2sWVLyqza8PFGjj4um gl+zBI5qkNctdN+qvlm5cIkOtuyy3HHtukT3+4VHXQG+3VzGxlw4ztIY7eacL86OTm/H ho3/QTW3PIP5XkXi88sqDDiVEn14Eguo+yuV3KSikeCQ9qWz/FKYgypirf+a7uHr9EA+ 0usjO5nxsIeZ69zE/QuzRkQarWgduSyXbwIfhxt+wzA31R95Th8iiszfOw5/TLUAaYfQ ZC0keqkqCBVFbxV83M9gyGJG58HXewpVIo6zrp/rGe9sGNSGoQ3hlZQGDOOnIhcVH5rr mr0g==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@google.com header.s=20230601 header.b=H8syFrFb; arc=pass (i=1 spf=pass spfdomain=google.com dkim=pass dkdomain=google.com dmarc=pass fromdomain=google.com); spf=pass (google.com: domain of linux-kernel+bounces-81398-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) smtp.mailfrom="linux-kernel+bounces-81398-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=google.com Return-Path: Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [139.178.88.99]) by mx.google.com with ESMTPS id i3-20020a17090332c300b001dcad9a75fcsi607823plr.49.2024.02.26.04.44.19 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 26 Feb 2024 04:44:19 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-81398-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) client-ip=139.178.88.99; Authentication-Results: mx.google.com; dkim=pass header.i=@google.com header.s=20230601 header.b=H8syFrFb; arc=pass (i=1 spf=pass spfdomain=google.com dkim=pass dkdomain=google.com dmarc=pass fromdomain=google.com); spf=pass (google.com: domain of linux-kernel+bounces-81398-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) smtp.mailfrom="linux-kernel+bounces-81398-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=google.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 sv.mirrors.kernel.org (Postfix) with ESMTPS id 126A4286949 for ; Mon, 26 Feb 2024 12:44:19 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id C417D80020; Mon, 26 Feb 2024 12:44:09 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b="H8syFrFb" Received: from mail-io1-f50.google.com (mail-io1-f50.google.com [209.85.166.50]) (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 6D51D7F49D for ; Mon, 26 Feb 2024 12:44:07 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.166.50 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1708951448; cv=none; b=R7n9VDJSZl83GONtqunWXAdNOA3D18gtrhzzQTnltpVZEjQeppV9pyeyP9nAL7P39OKjzt7FFvvxpisUQxUpCA5pKHlTzoEhVWnXynLumIri+3Jfu5ah9u/tDkaS0/8D51g3kQdbRuhpGox+2dRNZJdxL5EvjKFFG3ckbYPG0c8= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1708951448; c=relaxed/simple; bh=VGOF//hEPOKVInRy9u/t4EELWuVUy3vArJLdV3NkLOc=; h=MIME-Version:References:In-Reply-To:From:Date:Message-ID:Subject: To:Cc:Content-Type; b=YuVbiHxVDHnfAATTOEBO2AtEWxkDBz+0UFbJPWopmeCmJ9/2TiYATL0KYrFEAtnfkd23d8ONJGzCjiScYaRcMK5b5bPIOj3lZ50iaCYv4VsUQkqSxy+1q4d3e/TpV8n4v1H0GdenfO8UlFO9Hh30P8BwS+NdX+nXEZrKmjajhxg= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com; spf=pass smtp.mailfrom=google.com; dkim=pass (2048-bit key) header.d=google.com header.i=@google.com header.b=H8syFrFb; arc=none smtp.client-ip=209.85.166.50 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=google.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=google.com Received: by mail-io1-f50.google.com with SMTP id ca18e2360f4ac-7c72294e3d1so147961139f.1 for ; Mon, 26 Feb 2024 04:44:07 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1708951446; x=1709556246; darn=vger.kernel.org; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:from:to:cc:subject:date :message-id:reply-to; bh=Q+35+P4r2JIren/LNJaaaherP1wCOAvB2HpC0DyEeMg=; b=H8syFrFb9/7hwuQYGNNJLkZYo4lqzE58RFdyMuyd7KQR8uHVLXOY7wGlPvPl7y+2Bf oUDO+WKQkkBYTfZmQ/k2c8z6XKJ5Zg1EOVkSo9emX33xVX+toBsMwJiz5CZnY94oF0VN xbz34HTA9pdobQN2BSCR+i4TqLahgXt2SnbNcerhyZ574fKjjJLFFe+9nshMGsHyZCXp 2A5ZTZw9VYH9jkG4fwzXE/Fvh9z8pj23fEvEw2zQx8wESTc3kBcsUO1HTbczX2+OfN0o VZJZOkfyrsdKKZl8oSo7S8VTMoMxAT05VJYODHDNFN10t7W+3fOe2I1E2D7fodfGTQ+/ EUDw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1708951446; x=1709556246; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=Q+35+P4r2JIren/LNJaaaherP1wCOAvB2HpC0DyEeMg=; b=bUaViX0hUj10iEqCLSH50iuVmMUxmjznMrZFU8PlJkzjP8h2HCjNE1HZ1vaHASHM/E XSZldiIoLnWCVbIgmR49Y2hsfWZ6jx5D8qSqw/+ewlXDw9twK9yDPPlCqnj7Sy/Y/xFm 1DhvuS3coAlELravVKii3dBj6qxA6+utZGsB5ztdqatgPbCyEmLXTtNLD7NbfWVxpzHp w22W+RCFlJD5oaz6KwPuwaenXH8i99IC7dgBvfilsaz9SWb7/VXq2XYQAjuZ7ChH/Up6 WevgV9z18wKGJ9uooNUqkrPqRPcx8C6Rvqgo5ICxYod+vdxJXpIwrBIinoz5MfqhSzzx mXWw== X-Forwarded-Encrypted: i=1; AJvYcCWRJYTTFLLtyD9ueqkWKO5UUlZPSMsxL0ATcc2/IIPKeNRHYqDwP0h7RC55OnTC//duO/qPvxZ54h2ZuY0s3XjnBlsaAuJb7qZmnbJx X-Gm-Message-State: AOJu0YyTI+ZYJxN4jHZCMUaJyC7IotUmi1X3pe4zaUNlA9SAkE7kw6lG ftVPPcFiFbLx9En0sQs1/6S0M8uP9MKu7kQ5gOhkkeZmnYXbRzVRxXfRmiiSb4sSSJEd85O4VG7 XWC3t+lTYf+6tYHvb3xr5k3WJAjnXxr2Cv02K X-Received: by 2002:a6b:c8d8:0:b0:7c7:9646:827b with SMTP id y207-20020a6bc8d8000000b007c79646827bmr7806606iof.18.1708951446529; Mon, 26 Feb 2024 04:44:06 -0800 (PST) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 References: <20240221160215.484151-1-panikiel@google.com> <20240221160215.484151-9-panikiel@google.com> <13aeb2ff-72f4-49d9-b65e-ddc31569a936@linaro.org> In-Reply-To: From: =?UTF-8?Q?Pawe=C5=82_Anikiel?= Date: Mon, 26 Feb 2024 13:43:55 +0100 Message-ID: Subject: Re: [PATCH v2 8/9] media: dt-bindings: Add Intel Displayport RX IP To: Krzysztof Kozlowski Cc: airlied@gmail.com, akpm@linux-foundation.org, conor+dt@kernel.org, daniel@ffwll.ch, dinguyen@kernel.org, hverkuil-cisco@xs4all.nl, krzysztof.kozlowski+dt@linaro.org, maarten.lankhorst@linux.intel.com, mchehab@kernel.org, mripard@kernel.org, robh+dt@kernel.org, tzimmermann@suse.de, devicetree@vger.kernel.org, dri-devel@lists.freedesktop.org, linux-kernel@vger.kernel.org, linux-media@vger.kernel.org, chromeos-krk-upstreaming@google.com, ribalda@chromium.org Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Mon, Feb 26, 2024 at 1:06=E2=80=AFPM Krzysztof Kozlowski wrote: > > On 26/02/2024 11:59, Pawe=C5=82 Anikiel wrote: > >>> +properties: > >>> + compatible: > >>> + const: intel,dprx-20.0.1 > >>> + > >>> + reg: > >>> + maxItems: 1 > >>> + > >>> + interrupts: > >>> + maxItems: 1 > >>> + > >>> + intel,max-link-rate: > >>> + $ref: /schemas/types.yaml#/definitions/uint32 > >>> + description: Max link rate configuration parameter > >> > >> Please do not duplicate property name in description. It's useless. > >> Instead explain what is this responsible for. > >> > >> Why max-link-rate would differ for the same dprx-20.0.1? And why > >> standard properties cannot be used? > >> > >> Same for all questions below. > > > > These four properties are the IP configuration parameters mentioned in > > the device description. When generating the IP core you can set these > > parameters, which could make them differ for the same dprx-20.0.1. > > They are documented in the user guide, for which I also put a link in > > the description. Is that enough? Or should I also document these > > parameters here? > > user-guide is something for users, like user-space programmers or > end-users. I would never open it to look for any information related to > hardware. > > Anyway, external resources are a no-go. We have it clearly in submitting > patches: > > https://elixir.bootlin.com/linux/v6.8-rc6/source/Documentation/process/su= bmitting-patches.rst#L130 Okay, I will describe these properties in the bindings as well. > > > > >> > >>> + > >>> + intel,max-lane-count: > >>> + $ref: /schemas/types.yaml#/definitions/uint32 > >>> + description: Max lane count configuration parameter > >>> + > >>> + intel,multi-stream-support: > >>> + type: boolean > >>> + description: Multi-Stream Transport support configuration parame= ter > >>> + > >>> + intel,max-stream-count: > >>> + $ref: /schemas/types.yaml#/definitions/uint32 > >>> + description: Max stream count configuration parameter > >>> + > >>> + port: > >>> + $ref: /schemas/graph.yaml#/properties/port > >>> + description: SST main link > >> > >> I don't understand why you have both port and ports. Shouldn't this be > >> under ports? > > > > I put both so that you can use the shorter port property when the > > device only has one port (i.e. no MST support). It would work fine > > without it. If you think that's unnecessary, I can remove it (and use > > the ports property even if there is only one). > > No, it is fine, but then you need allOf: which will restrict to only one > of them: either port or ports. There already is an allOf below that says that ports is required for MST support and port is required otherwise. Isn't this enough?