xref: /freebsd/sys/contrib/device-tree/Bindings/Makefile (revision 7d0873ebb83b19ba1e8a89e679470d885efe12e3)
1c66ec88fSEmmanuel Vadot# SPDX-License-Identifier: GPL-2.0
2c66ec88fSEmmanuel VadotDT_DOC_CHECKER ?= dt-doc-validate
3c66ec88fSEmmanuel VadotDT_EXTRACT_EX ?= dt-extract-example
4c66ec88fSEmmanuel VadotDT_MK_SCHEMA ?= dt-mk-schema
5c66ec88fSEmmanuel Vadot
6c9ccf3a3SEmmanuel VadotDT_SCHEMA_LINT = $(shell which yamllint || \
7c9ccf3a3SEmmanuel Vadot  echo "warning: python package 'yamllint' not installed, skipping" >&2)
86be33864SEmmanuel Vadot
984943d6fSEmmanuel VadotDT_SCHEMA_MIN_VERSION = 2023.9
10c66ec88fSEmmanuel Vadot
11c66ec88fSEmmanuel VadotPHONY += check_dtschema_version
12c66ec88fSEmmanuel Vadotcheck_dtschema_version:
138cc087a1SEmmanuel Vadot	@which $(DT_DOC_CHECKER) >/dev/null || \
148cc087a1SEmmanuel Vadot		{ echo "Error: '$(DT_DOC_CHECKER)' not found!" >&2; \
158cc087a1SEmmanuel Vadot		  echo "Ensure dtschema python package is installed and in your PATH." >&2; \
168cc087a1SEmmanuel Vadot		  echo "Current PATH is:" >&2; \
178cc087a1SEmmanuel Vadot		  echo "$$PATH" >&2; false; }
18c66ec88fSEmmanuel Vadot	@{ echo $(DT_SCHEMA_MIN_VERSION); \
195def4c47SEmmanuel Vadot	$(DT_DOC_CHECKER) --version 2>/dev/null || echo 0; } | sort -Vc >/dev/null || \
20c66ec88fSEmmanuel Vadot	{ echo "ERROR: dtschema minimum version is v$(DT_SCHEMA_MIN_VERSION)" >&2; false; }
21c66ec88fSEmmanuel Vadot
226be33864SEmmanuel Vadotquiet_cmd_extract_ex = DTEX    $@
236be33864SEmmanuel Vadot      cmd_extract_ex = $(DT_EXTRACT_EX) $< > $@
24c66ec88fSEmmanuel Vadot
25c66ec88fSEmmanuel Vadot$(obj)/%.example.dts: $(src)/%.yaml check_dtschema_version FORCE
266be33864SEmmanuel Vadot	$(call if_changed,extract_ex)
27c66ec88fSEmmanuel Vadot
28*7d0873ebSEmmanuel Vadotfind_all_cmd = find $(src) \( -name '*.yaml' ! \
29c9ccf3a3SEmmanuel Vadot		-name 'processed-schema*' \)
30c66ec88fSEmmanuel Vadot
318d13bc63SEmmanuel Vadotfind_cmd = $(find_all_cmd) | \
328d13bc63SEmmanuel Vadot		sed 's|^$(srctree)/||' | \
338d13bc63SEmmanuel Vadot		grep -F -e "$(subst :," -e ",$(DT_SCHEMA_FILES))" | \
348d13bc63SEmmanuel Vadot		sed 's|^|$(srctree)/|'
35*7d0873ebSEmmanuel VadotCHK_DT_EXAMPLES := $(patsubst $(srctree)/%.yaml,%.example.dtb, $(shell $(find_cmd)))
368cc087a1SEmmanuel Vadot
376be33864SEmmanuel Vadotquiet_cmd_yamllint = LINT    $(src)
385def4c47SEmmanuel Vadot      cmd_yamllint = ($(find_cmd) | \
398cc087a1SEmmanuel Vadot                     xargs -n200 -P$$(nproc) \
40*7d0873ebSEmmanuel Vadot		     $(DT_SCHEMA_LINT) -f parsable -c $(src)/.yamllint >&2) \
41*7d0873ebSEmmanuel Vadot		     && touch $@ || true
426be33864SEmmanuel Vadot
43*7d0873ebSEmmanuel Vadotquiet_cmd_chk_bindings = CHKDT   $(src)
445def4c47SEmmanuel Vadot      cmd_chk_bindings = ($(find_cmd) | \
45*7d0873ebSEmmanuel Vadot			  xargs -n200 -P$$(nproc) $(DT_DOC_CHECKER) -u $(src)) \
46*7d0873ebSEmmanuel Vadot			  && touch $@ || true
476be33864SEmmanuel Vadot
48c66ec88fSEmmanuel Vadotquiet_cmd_mk_schema = SCHEMA  $@
496be33864SEmmanuel Vadot      cmd_mk_schema = f=$$(mktemp) ; \
50b97ee269SEmmanuel Vadot                      $(find_all_cmd) > $$f ; \
516be33864SEmmanuel Vadot                      $(DT_MK_SCHEMA) -j $(DT_MK_SCHEMA_FLAGS) @$$f > $@ ; \
526be33864SEmmanuel Vadot		      rm -f $$f
536be33864SEmmanuel Vadot
548cc087a1SEmmanuel VadotDT_DOCS = $(patsubst $(srctree)/%,%,$(shell $(find_all_cmd)))
55c66ec88fSEmmanuel Vadot
56c66ec88fSEmmanuel Vadotoverride DTC_FLAGS := \
57c66ec88fSEmmanuel Vadot	-Wno-avoid_unnecessary_addr_size \
58c66ec88fSEmmanuel Vadot	-Wno-graph_child_address \
59e67e8565SEmmanuel Vadot	-Wno-interrupt_provider \
60e67e8565SEmmanuel Vadot	-Wno-unique_unit_address \
61e67e8565SEmmanuel Vadot	-Wunique_unit_address_if_enabled
62c66ec88fSEmmanuel Vadot
63*7d0873ebSEmmanuel Vadot$(obj)/processed-schema.json: $(DT_DOCS) check_dtschema_version FORCE
64*7d0873ebSEmmanuel Vadot	$(call if_changed,mk_schema)
65*7d0873ebSEmmanuel Vadot
66*7d0873ebSEmmanuel Vadottargets += .dt-binding.checked .yamllint.checked
67*7d0873ebSEmmanuel Vadot$(obj)/.yamllint.checked: $(DT_DOCS) $(src)/.yamllint FORCE
68*7d0873ebSEmmanuel Vadot	$(if $(DT_SCHEMA_LINT),$(call if_changed,yamllint),)
69*7d0873ebSEmmanuel Vadot
70*7d0873ebSEmmanuel Vadot$(obj)/.dt-binding.checked: $(DT_DOCS) FORCE
71*7d0873ebSEmmanuel Vadot	$(call if_changed,chk_bindings)
72c66ec88fSEmmanuel Vadot
73c9ccf3a3SEmmanuel Vadotalways-y += processed-schema.json
74*7d0873ebSEmmanuel Vadottargets += $(patsubst $(obj)/%,%, $(CHK_DT_EXAMPLES))
75*7d0873ebSEmmanuel Vadottargets += $(patsubst $(obj)/%.dtb,%.dts, $(CHK_DT_EXAMPLES))
76c66ec88fSEmmanuel Vadot
77c66ec88fSEmmanuel Vadot# Hack: avoid 'Argument list too long' error for 'make clean'. Remove most of
78c66ec88fSEmmanuel Vadot# build artifacts here before they are processed by scripts/Makefile.clean
79c66ec88fSEmmanuel Vadotclean-files = $(shell find $(obj) \( -name '*.example.dts' -o \
80c9ccf3a3SEmmanuel Vadot			-name '*.example.dtb' \) -delete 2>/dev/null)
817ef62cebSEmmanuel Vadot
827ef62cebSEmmanuel Vadotdt_compatible_check: $(obj)/processed-schema.json
837ef62cebSEmmanuel Vadot	$(Q)$(srctree)/scripts/dtc/dt-extract-compatibles $(srctree) | xargs dt-check-compatible -v -s $<
84*7d0873ebSEmmanuel Vadot
85*7d0873ebSEmmanuel VadotPHONY += dt_binding_check
86*7d0873ebSEmmanuel Vadotdt_binding_check: $(obj)/.dt-binding.checked $(obj)/.yamllint.checked $(CHK_DT_EXAMPLES)
87