{"id":814816,"url":"http://patchwork.ozlabs.org/api/patches/814816/?format=json","web_url":"http://patchwork.ozlabs.org/project/devicetree-bindings/patch/1505723105-16238-2-git-send-email-sakari.ailus@linux.intel.com/","project":{"id":37,"url":"http://patchwork.ozlabs.org/api/projects/37/?format=json","name":"Devicetree Bindings","link_name":"devicetree-bindings","list_id":"devicetree.vger.kernel.org","list_email":"devicetree@vger.kernel.org","web_url":"","scm_url":"","webscm_url":"","list_archive_url":"","list_archive_url_format":"","commit_url_format":""},"msgid":"<1505723105-16238-2-git-send-email-sakari.ailus@linux.intel.com>","list_archive_url":null,"date":"2017-09-18T08:25:04","name":"[1/2] dt: bindings: media: Document port and endpoint numbering","commit_ref":null,"pull_url":null,"state":"not-applicable","archived":true,"hash":"8f7cd17ac58ad563e30e2efdcf83d7283ac85139","submitter":{"id":65485,"url":"http://patchwork.ozlabs.org/api/people/65485/?format=json","name":"Sakari Ailus","email":"sakari.ailus@linux.intel.com"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/devicetree-bindings/patch/1505723105-16238-2-git-send-email-sakari.ailus@linux.intel.com/mbox/","series":[{"id":3583,"url":"http://patchwork.ozlabs.org/api/series/3583/?format=json","web_url":"http://patchwork.ozlabs.org/project/devicetree-bindings/list/?series=3583","date":"2017-09-18T08:25:05","name":"Improve generic DT binding documentation for media devices","version":1,"mbox":"http://patchwork.ozlabs.org/series/3583/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/814816/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/814816/checks/","tags":{},"related":[],"headers":{"Return-Path":"","X-Original-To":"incoming-dt@patchwork.ozlabs.org","Delivered-To":"patchwork-incoming-dt@bilbo.ozlabs.org","Authentication-Results":"ozlabs.org;\n\tspf=none (mailfrom) smtp.mailfrom=vger.kernel.org\n\t(client-ip=209.132.180.67; helo=vger.kernel.org;\n\tenvelope-from=devicetree-owner@vger.kernel.org; receiver=)","Received":["from vger.kernel.org (vger.kernel.org [209.132.180.67])\n\tby ozlabs.org (Postfix) with ESMTP id 3xwfJw0gv8z9s7M\n\tfor ;\n\tMon, 18 Sep 2017 18:28:00 +1000 (AEST)","(majordomo@vger.kernel.org) by vger.kernel.org via listexpand\n\tid S1752611AbdIRI16 (ORCPT\n\t);\n\tMon, 18 Sep 2017 04:27:58 -0400","from mga06.intel.com ([134.134.136.31]:27964 \"EHLO mga06.intel.com\"\n\trhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP\n\tid S1752721AbdIRI14 (ORCPT );\n\tMon, 18 Sep 2017 04:27:56 -0400","from fmsmga003.fm.intel.com ([10.253.24.29])\n\tby orsmga104.jf.intel.com with ESMTP; 18 Sep 2017 01:27:51 -0700","from paasikivi.fi.intel.com ([10.237.72.42])\n\tby FMSMGA003.fm.intel.com with ESMTP; 18 Sep 2017 01:27:50 -0700","from nauris.fi.intel.com (nauris.localdomain [192.168.240.2])\n\tby paasikivi.fi.intel.com (Postfix) with ESMTP id 1EC492031C;\n\tMon, 18 Sep 2017 11:27:49 +0300 (EEST)","by nauris.fi.intel.com (Postfix, from userid 1000)\n\tid 497BF20146; Mon, 18 Sep 2017 11:25:05 +0300 (EEST)"],"X-ExtLoop1":"1","X-IronPort-AV":"E=Sophos;i=\"5.42,411,1500966000\"; d=\"scan'208\";a=\"901256386\"","From":"Sakari Ailus ","To":"linux-media@vger.kernel.org","Cc":"devicetree@vger.kernel.org","Subject":"[PATCH 1/2] dt: bindings: media: Document port and endpoint\n\tnumbering","Date":"Mon, 18 Sep 2017 11:25:04 +0300","Message-Id":"<1505723105-16238-2-git-send-email-sakari.ailus@linux.intel.com>","X-Mailer":"git-send-email 2.7.4","In-Reply-To":"<1505723105-16238-1-git-send-email-sakari.ailus@linux.intel.com>","References":"<1505723105-16238-1-git-send-email-sakari.ailus@linux.intel.com>","Sender":"devicetree-owner@vger.kernel.org","Precedence":"bulk","List-ID":"","X-Mailing-List":"devicetree@vger.kernel.org"},"content":"A lot of devices do not need and do not document port or endpoint\nnumbering at all, e.g. in case where there's just a single port and a\nsingle endpoint. Whereas this is just common sense, document it to make it\nexplicit.\n\nSigned-off-by: Sakari Ailus \n---\n Documentation/devicetree/bindings/media/video-interfaces.txt | 12 ++++++++++++\n 1 file changed, 12 insertions(+)","diff":"diff --git a/Documentation/devicetree/bindings/media/video-interfaces.txt b/Documentation/devicetree/bindings/media/video-interfaces.txt\nindex 852041a..4e0527d 100644\n--- a/Documentation/devicetree/bindings/media/video-interfaces.txt\n+++ b/Documentation/devicetree/bindings/media/video-interfaces.txt\n@@ -55,6 +55,18 @@ divided into two separate ITU-R BT.656 8-bit busses. In such case bus-width\n and data-shift properties can be used to assign physical data lines to each\n endpoint node (logical bus).\n \n+Port and endpoint numbering\n+---------------------------\n+\n+While the port and endpoint numbers are ultimately specific to a device,\n+most devices have more limited scope than what the interface allows. They\n+may, for instance, only support a single endpoint on a port. Or there may\n+be only a single port on a device.\n+\n+Therefore, if ports are not explicitly documented for a device, only port\n+number zero shall be used. The same applies to endpoints: if endpoint\n+numbers are not explicitly documented, only endpoint number zero shall be\n+used.\n \n Required properties\n -------------------\n","prefixes":["1/2"]}