Hi all,
This series tries to make the correct thing to represent in schema
all the current documentation related with MIPS CPUs.
Current 'arch/mips/boot/dts' folder dts files are a bit messy
for cpu nodes, so I set additionalProperties to true and only
make required for 'compatible' in mips/cpus.yaml schema.
Broadcom cpus node is a bit special and need to use the property
'mips-hpt-frequency'. Since 'compatible' string is not in the
'cpus' parent node itself, we need a way to filter this to be valid
only for Broadcom SoCs. To make this possible I have introduced two
new schemas:
- One to describe the Broadcom SoCs and its compatibles.
- One to describe the BMIPS CPU's referring inside to 'brcm/soc.yaml'
and 'mips/cpus.yaml' schemas.
Another thing to notice is that the root-node schema requires 'model'
as property and there is no model at all in any real DTS file for any
cpus node in 'arch/mips/boot/dts'. I have just added it in the schema
sample to avoid the following check fail:
/: 'model' is a required property
>From schema: /home/sergio/.local/lib/python3.8/site-packages/dtschema/schemas/root-node.yaml
Don't really know if this is a way to go.
Thanks in advance for your time and comments.
Best regards,
Sergio Paracuellos
Changes in v3:
- cpus.yaml:
* address Krzysztof comment in v2:
* add Thomas as maintainer since this is architecture binding.
* s/cpu/CPU
* compatible goes first
* Add compatible 'mips,mips4Kc' as per Thomas request.
- Introduce two new schemas for Broadcom BMIPS:
* soc.yaml: describing the BRCM SoC's
* brcm,bmips-cpus.yaml: describing the cpu nodes for this platform.
Previous series:
v1: https://lore.kernel.org/all/CAMhs-H-eUTOHjAXAbywOXQJgc_j5Ex-1sB7eBZU_bWt1fpNVzA@xxxxxxxxxxxxxx/T/
v2: https://lore.kernel.org/all/20220918112245.GA5555@xxxxxxxxxxxxxxxx/T/
Thanks,
Sergio Paracuellos
Sergio Paracuellos (3):
dt-bindings: mips: add CPU bindings for MIPS architecture
dt-bindings: mips: brcm: convert Broadcom SoCs to schema
dt-bindings: mips: brcm: convert CPU bindings for BMIPS architecture
.../bindings/mips/brcm/brcm,bmips-cpus.yaml | 102 ++++++++++++++++++
.../bindings/mips/brcm/brcm,bmips.txt | 8 --
.../devicetree/bindings/mips/brcm/soc.yaml | 97 +++++++++++++++++
.../devicetree/bindings/mips/cpus.yaml | 66 ++++++++++++
4 files changed, 265 insertions(+), 8 deletions(-)
create mode 100644 Documentation/devicetree/bindings/mips/brcm/brcm,bmips-cpus.yaml
delete mode 100644 Documentation/devicetree/bindings/mips/brcm/brcm,bmips.txt
create mode 100644 Documentation/devicetree/bindings/mips/brcm/soc.yaml
create mode 100644 Documentation/devicetree/bindings/mips/cpus.yaml
--
2.25.1
