Re: [PATCH v4] dt-bindings: fpga: Convert fpga-region binding to yaml

[Rob Herring]

On Mon, 29 Jan 2024 13:18:53 +0100, Michal Simek wrote:
> Convert the generic fpga region DT binding to json-schema.
> There are some differences compare to txt version.
> 1. DT overlay can't be described in example that's why directly include
> information from overlay to node which was referenced. It is visible in
> example with /* DT Overlay contains: &... */
> 
> 2. All example have been rewritten to be simpler and describe only full
> reconfiguration and partial reconfiguration with one bridge.
> Completely drop the case where fpga region can inside partial
> reconfiguration region which is already described in description
> 
> 3. Fixed some typos in descriptions compare to txt version but most of it
> is just c&p from txt file.
> 
> Signed-off-by: Michal Simek <michal.simek@xxxxxxx>
> ---
> 
> Changes in v4:
> - permit only object type as additionalProperties
> - describe also optional reg/ranges properties and remove required
>   #address/size-cells properties
> 
> Changes in v3:
> - drop fpga bridge and mgr descriptions in example
> - use additionalProperties: true
> - use fixed-factor-clock instead
> - fixed matching pattern
> 
> Changes in v2:
> - Fix typo in subject
> - Fix comment in bridge example
> - Change license back to gpl-2.0 only
> - Do not define firware-name type and add maxItems 1
> - Make fpga-bridge phandle-array
> - Drop ranges property because of missing reg property of fpga-region
> - Also describe case with fixed clock node and axi bus
> - Fix fpga-region names in example
> 
> Please let me know if there is a way to describe overlays to dt root to be
> able to reference fpga region back.
> 
> fpga-region without MMIO access is also permitted that's why there is no
> need to describe reg/ranges and #.*cells properties for these cases.
> 
> ---
>  .../devicetree/bindings/fpga/fpga-region.txt  | 479 ------------------
>  .../devicetree/bindings/fpga/fpga-region.yaml | 358 +++++++++++++
>  2 files changed, 358 insertions(+), 479 deletions(-)
>  delete mode 100644 Documentation/devicetree/bindings/fpga/fpga-region.txt
>  create mode 100644 Documentation/devicetree/bindings/fpga/fpga-region.yaml
> 

Applied, thanks!