Hi Kenneth, > -----Original Message----- > From: Kenneth Sloat <ksl...@designlinxhs.com> > Sent: Thursday, August 20, 2020 2:18 PM > To: Hyun Kwon <hy...@xilinx.com>; linux-arm-ker...@lists.infradead.org > Cc: Michal Simek <mich...@xilinx.com>; dri-devel@lists.freedesktop.org; linux- > ker...@vger.kernel.org; laurent.pinch...@ideasonboard.com; > devicet...@vger.kernel.org; linux-ker...@vger.kernel.org; > mark.rutl...@arm.com > Subject: dt-bindings: display: xlnx: mixer: Inconsistent pixel format > terminology > in dt docs > > Hello, > > The Xilinx Video mixer IP uses the DRM fourcc string as a device tree binding > in > order to describe the format for a specific DRM layer/plane. Currently, in the > device tree doc in > "Documentation/devicetree/bindings/dma/xilinx/xilinx_frmbuf.txt" there is a > list > called "VIDEO FORMATS" with a table containing "Mixer IP Format" and > associated "Driver supported Format String" (fourcc). In general, this table > is not > helpful, because "Mixer IP Format" does not match the Xilinx IP datasheet > terminology for formats but rather some other commonly used nomenclature. > This is also inconsistent from other Xilinx dts binding docs which specify the > actual correct IP name and at times list other format nomenclature where > helpful (i.e. xilinx_frmbuf.txt) > > My suggestion is to remove the current "Mixer IP Format" strings in the doc > and > replace them with the actual IP names in the datasheet (which also match those > used in Xilinx's Vivado FPGA tool). Otherwise, the programmer must cross > reference other dts documentation or the code in order to figure these out. I > am > happy to provide a patch for this but wanted to throw out the suggestion > first.
I agree. The bindings should be in sync with datasheet and not rely on software definitions. Since the driver is only in Xilinx vendor tree, please send directly to g...@xilinx.com. Thanks! -hyun > > Thanks > > Sincerely, > Ken Sloat _______________________________________________ dri-devel mailing list dri-devel@lists.freedesktop.org https://lists.freedesktop.org/mailman/listinfo/dri-devel
