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_LINT = $(shell which yamllint || \ 7 echo "warning: python package 'yamllint' not installed, skipping" >&2) 8 9DT_SCHEMA_MIN_VERSION = 2023.9 10 11PHONY += check_dtschema_version 12check_dtschema_version: 13 @which $(DT_DOC_CHECKER) >/dev/null || \ 14 { echo "Error: '$(DT_DOC_CHECKER)' not found!" >&2; \ 15 echo "Ensure dtschema python package is installed and in your PATH." >&2; \ 16 echo "Current PATH is:" >&2; \ 17 echo "$$PATH" >&2; false; } 18 @{ echo $(DT_SCHEMA_MIN_VERSION); \ 19 $(DT_DOC_CHECKER) --version 2>/dev/null || echo 0; } | sort -Vc >/dev/null || \ 20 { echo "ERROR: dtschema minimum version is v$(DT_SCHEMA_MIN_VERSION)" >&2; false; } 21 22quiet_cmd_extract_ex = DTEX $@ 23 cmd_extract_ex = $(DT_EXTRACT_EX) $< > $@ 24 25$(obj)/%.example.dts: $(src)/%.yaml check_dtschema_version FORCE 26 $(call if_changed,extract_ex) 27 28find_all_cmd = find $(src) \( -name '*.yaml' ! \ 29 -name 'processed-schema*' \) 30 31find_cmd = $(find_all_cmd) | \ 32 sed 's|^$(srctree)/||' | \ 33 grep -F -e "$(subst :," -e ",$(DT_SCHEMA_FILES))" | \ 34 sed 's|^|$(srctree)/|' 35CHK_DT_EXAMPLES := $(patsubst $(srctree)/%.yaml,%.example.dtb, \ 36 $(shell $(find_cmd) | xargs grep -l '^examples:')) 37 38quiet_cmd_yamllint = LINT $(src) 39 cmd_yamllint = ($(find_cmd) | \ 40 xargs -n200 -P$$(nproc) \ 41 $(DT_SCHEMA_LINT) -f parsable -c $(src)/.yamllint >&2) \ 42 && touch $@ || true 43 44quiet_cmd_chk_bindings = CHKDT $(src) 45 cmd_chk_bindings = ($(find_cmd) | \ 46 xargs -n200 -P$$(nproc) $(DT_DOC_CHECKER) -u $(src)) \ 47 && touch $@ || true 48 49DT_CHK_STYLE = $(srctree)/scripts/dtc/dt-check-style 50 51# Feed the file list to the checker via @argfile in a single Python 52# process so the ruamel.yaml import is paid once. scripts/jobserver-exec 53# claims slots from the GNU make jobserver and exposes the count via 54# $PARALLELISM, which dt-check-style picks up to size its worker pool. 55quiet_cmd_chk_style = STYLE $(src) 56 cmd_chk_style = f=$$(mktemp) && $(find_cmd) > $$f && \ 57 $(PYTHON3) $(srctree)/scripts/jobserver-exec \ 58 $(PYTHON3) $(DT_CHK_STYLE) @$$f \ 59 && touch $@ || true; rm -f $$f 60 61quiet_cmd_mk_schema = SCHEMA $@ 62 cmd_mk_schema = f=$$(mktemp) ; \ 63 $(find_all_cmd) > $$f ; \ 64 $(DT_MK_SCHEMA) -j $(DT_MK_SCHEMA_FLAGS) @$$f > $@ ; \ 65 rm -f $$f 66 67DT_DOCS = $(patsubst $(srctree)/%,%,$(shell $(find_all_cmd))) 68 69override DTC_FLAGS := \ 70 -Wno-avoid_unnecessary_addr_size \ 71 -Wno-unique_unit_address \ 72 -Wunique_unit_address_if_enabled 73 74$(obj)/processed-schema.json: $(DT_DOCS) check_dtschema_version FORCE 75 $(call if_changed,mk_schema) 76 77targets += .dt-binding.checked .yamllint.checked .dt-style.checked 78$(obj)/.yamllint.checked: $(DT_DOCS) $(src)/.yamllint FORCE 79 $(if $(DT_SCHEMA_LINT),$(call if_changed,yamllint),) 80 81$(obj)/.dt-binding.checked: $(DT_DOCS) FORCE 82 $(call if_changed,chk_bindings) 83 84$(obj)/.dt-style.checked: $(DT_DOCS) FORCE 85 $(call if_changed,chk_style) 86 87always-y += processed-schema.json 88targets += $(patsubst $(obj)/%,%, $(CHK_DT_EXAMPLES)) 89targets += $(patsubst $(obj)/%.dtb,%.dts, $(CHK_DT_EXAMPLES)) 90 91# Hack: avoid 'Argument list too long' error for 'make clean'. Remove most of 92# build artifacts here before they are processed by scripts/Makefile.clean 93clean-files = $(shell find $(obj) \( -name '*.example.dts' -o \ 94 -name '*.example.dtb' \) -delete 2>/dev/null) 95 96dt_compatible_check: $(obj)/processed-schema.json 97 $(Q)$(srctree)/scripts/dtc/dt-extract-compatibles $(srctree) | xargs dt-check-compatible -v -s $< 98 99PHONY += dt_binding_check_one 100dt_binding_check_one: $(obj)/.dt-binding.checked $(obj)/.yamllint.checked $(obj)/.dt-style.checked 101 102PHONY += dt_binding_check 103dt_binding_check: dt_binding_check_one $(CHK_DT_EXAMPLES) 104