Re: [PATCH 1/2] Documentation: devicetree: Add document bindings for mtk-cir
From: Sean Wang <hidden>
Date: 2017-01-10 02:36:20
Also in:
linux-arm-kernel, linux-media, linux-mediatek, lkml
Hi Rob, thanks for your effort for reviewing. I added comments inline. On Mon, 2017-01-09 at 12:32 -0600, Rob Herring wrote:
On Fri, Jan 06, 2017 at 12:06:23AM +0800, sean.wang-NuS5LvNUpcJWk0Htik3J/w@public.gmane.org wrote:quoted
From: Sean Wang <sean.wang-NuS5LvNUpcJWk0Htik3J/w@public.gmane.org> This patch adds documentation for devicetree bindings for Mediatek IR controller. Signed-off-by: Sean Wang <sean.wang-NuS5LvNUpcJWk0Htik3J/w@public.gmane.org> --- .../devicetree/bindings/media/mtk-cir.txt | 23 ++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 linux-4.8.rc1_p0/Documentation/devicetree/bindings/media/mtk-cir.txtdiff --git a/Documentation/devicetree/bindings/media/mtk-cir.txt b/Documentation/devicetree/bindings/media/mtk-cir.txt new file mode 100644 index 0000000..bbedd71 --- /dev/null +++ b/Documentation/devicetree/bindings/media/mtk-cir.txt@@ -0,0 +1,23 @@ +Device-Tree bindings for Mediatek IR controller found in Mediatek SoC family + +Required properties: +- compatible : "mediatek,mt7623-ir" +- clocks : list of clock specifiers, corresponding to + entries in clock-names property; +- clock-names : should contain "clk" entries; +- interrupts : should contain IR IRQ number; +- reg : should contain IO map address for IR. + +Optional properties: +- linux,rc-map-name : Remote control map name.Would 'label' be appropriate here instead? If not, this needs to be documented in a common location and explained better.
I checked with how the way applied in other IR drivers is and found that most IR driver also use the same label to identify the scan/key table they prefer to use such as gpio-ir-recv, ir-hix5hd2, meson-ir and sunxi-cir or use hard coding inside the driver. So I thought it should be appropriate here currently.
quoted
+ +Example: + +cir: cir@0x10013000 {Drop the '0x'.
okay, I will.
quoted
+ compatible = "mediatek,mt7623-ir"; + reg = <0 0x10013000 0 0x1000>; + interrupts = <GIC_SPI 87 IRQ_TYPE_LEVEL_LOW>; + clocks = <&infracfg CLK_INFRA_IRRX>; + clock-names = "clk"; + linux,rc-map-name = "rc-rc6-mce"; +}; -- 1.9.1
-- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org More majordomo info at http://vger.kernel.org/majordomo-info.html