xref: /linux/Documentation/devicetree/bindings/Makefile (revision d8db9dc348712bbe972e1edd952b67279e774ecc) 
1# SPDX-License-Identifier: GPL-2.0
2DT_DOC_CHECKER ?= dt-doc-validate
3DT_EXTRACT_EX ?= dt-extract-example
4DT_MK_SCHEMA ?= dt-mk-schema
5
6DT_SCHEMA_MIN_VERSION = 2020.8.1
7
8PHONY += check_dtschema_version
9check_dtschema_version:
10	@{ echo $(DT_SCHEMA_MIN_VERSION); \
11	$(DT_DOC_CHECKER) --version 2>/dev/null || echo 0; } | sort -VC || \
12	{ echo "ERROR: dtschema minimum version is v$(DT_SCHEMA_MIN_VERSION)" >&2; false; }
13
14quiet_cmd_extract_ex = DTEX    $@
15      cmd_extract_ex = $(DT_EXTRACT_EX) $< > $@
16
17$(obj)/%.example.dts: $(src)/%.yaml check_dtschema_version FORCE
18	$(call if_changed,extract_ex)
19
20# Use full schemas when checking %.example.dts
21DT_TMP_SCHEMA := $(obj)/processed-schema-examples.json
22
23find_cmd = find $(srctree)/$(src) \( -name '*.yaml' ! \
24		-name 'processed-schema*' ! \
25		-name '*.example.dt.yaml' \)
26
27quiet_cmd_chk_bindings = CHKDT   $@
28      cmd_chk_bindings = $(find_cmd) | \
29                         xargs -n200 -P$$(nproc) $(DT_DOC_CHECKER) -u $(srctree)/$(src)
30
31quiet_cmd_mk_schema = SCHEMA  $@
32      cmd_mk_schema = f=$$(mktemp) ; \
33                      $(if $(DT_MK_SCHEMA_FLAGS), \
34                           echo $(real-prereqs), \
35                           $(find_cmd)) > $$f ; \
36                      $(DT_MK_SCHEMA) -j $(DT_MK_SCHEMA_FLAGS) @$$f > $@ ; \
37		      rm -f $$f
38
39define rule_chkdt
40	$(call cmd,chk_bindings)
41	$(call cmd,mk_schema)
42endef
43
44DT_DOCS = $(shell $(find_cmd) | sed -e 's|^$(srctree)/||')
45
46override DTC_FLAGS := \
47	-Wno-avoid_unnecessary_addr_size \
48	-Wno-graph_child_address \
49	-Wno-interrupt_provider
50
51$(obj)/processed-schema-examples.json: $(DT_DOCS) check_dtschema_version FORCE
52	$(call if_changed_rule,chkdt)
53
54ifeq ($(DT_SCHEMA_FILES),)
55
56# Unless DT_SCHEMA_FILES is specified, use the full schema for dtbs_check too.
57# Just copy processed-schema-examples.json
58
59$(obj)/processed-schema.json: $(obj)/processed-schema-examples.json FORCE
60	$(call if_changed,copy)
61
62DT_SCHEMA_FILES = $(DT_DOCS)
63
64else
65
66# If DT_SCHEMA_FILES is specified, use it for processed-schema.json
67
68$(obj)/processed-schema.json: DT_MK_SCHEMA_FLAGS := -u
69$(obj)/processed-schema.json: $(DT_SCHEMA_FILES) check_dtschema_version FORCE
70	$(call if_changed,mk_schema)
71
72endif
73
74extra-$(CHECK_DT_BINDING) += processed-schema-examples.json
75extra-$(CHECK_DTBS) += processed-schema.json
76extra-$(CHECK_DT_BINDING) += $(patsubst $(src)/%.yaml,%.example.dts, $(DT_SCHEMA_FILES))
77extra-$(CHECK_DT_BINDING) += $(patsubst $(src)/%.yaml,%.example.dt.yaml, $(DT_SCHEMA_FILES))
78
79# Hack: avoid 'Argument list too long' error for 'make clean'. Remove most of
80# build artifacts here before they are processed by scripts/Makefile.clean
81clean-files = $(shell find $(obj) \( -name '*.example.dts' -o \
82			-name '*.example.dt.yaml' \) -delete 2>/dev/null)
83