OSCL-LXR

0001 # SPDX-License-Identifier: GPL-2.0
0002 DT_DOC_CHECKER ?= dt-doc-validate
0003 DT_EXTRACT_EX ?= dt-extract-example
0004 DT_MK_SCHEMA ?= dt-mk-schema
0005
0006 DT_SCHEMA_LINT = $(shell which yamllint || \
0007   echo "warning: python package 'yamllint' not installed, skipping" >&2)
0008
0009 DT_SCHEMA_MIN_VERSION = 2022.3
0010
0011 PHONY += check_dtschema_version
0012 check_dtschema_version:
0013         @which $(DT_DOC_CHECKER) >/dev/null || \
0014                 { echo "Error: '$(DT_DOC_CHECKER)' not found!" >&2; \
0015                   echo "Ensure dtschema python package is installed and in your PATH." >&2; \
0016                   echo "Current PATH is:" >&2; \
0017                   echo "$$PATH" >&2; false; }
0018         @{ echo $(DT_SCHEMA_MIN_VERSION); \
0019         $(DT_DOC_CHECKER) --version 2>/dev/null || echo 0; } | sort -Vc >/dev/null || \
0020         { echo "ERROR: dtschema minimum version is v$(DT_SCHEMA_MIN_VERSION)" >&2; false; }
0021
0022 quiet_cmd_extract_ex = DTEX    $@
0023       cmd_extract_ex = $(DT_EXTRACT_EX) $< > $@
0024
0025 $(obj)/%.example.dts: $(src)/%.yaml check_dtschema_version FORCE
0026         $(call if_changed,extract_ex)
0027
0028 find_all_cmd = find $(srctree)/$(src) \( -name '*.yaml' ! \
0029                 -name 'processed-schema*' \)
0030
0031 find_cmd = $(find_all_cmd) | grep -F "$(DT_SCHEMA_FILES)"
0032 CHK_DT_DOCS := $(shell $(find_cmd))
0033
0034 quiet_cmd_yamllint = LINT    $(src)
0035       cmd_yamllint = ($(find_cmd) | \
0036                      xargs -n200 -P$$(nproc) \
0037                      $(DT_SCHEMA_LINT) -f parsable -c $(srctree)/$(src)/.yamllint >&2) || true
0038
0039 quiet_cmd_chk_bindings = CHKDT   $@
0040       cmd_chk_bindings = ($(find_cmd) | \
0041                          xargs -n200 -P$$(nproc) $(DT_DOC_CHECKER) -u $(srctree)/$(src)) || true
0042
0043 quiet_cmd_mk_schema = SCHEMA  $@
0044       cmd_mk_schema = f=$$(mktemp) ; \
0045                       $(find_all_cmd) > $$f ; \
0046                       $(DT_MK_SCHEMA) -j $(DT_MK_SCHEMA_FLAGS) @$$f > $@ ; \
0047                       rm -f $$f
0048
0049 define rule_chkdt
0050         $(if $(DT_SCHEMA_LINT),$(call cmd,yamllint),)
0051         $(call cmd,chk_bindings)
0052         $(call cmd,mk_schema)
0053 endef
0054
0055 DT_DOCS = $(patsubst $(srctree)/%,%,$(shell $(find_all_cmd)))
0056
0057 override DTC_FLAGS := \
0058         -Wno-avoid_unnecessary_addr_size \
0059         -Wno-graph_child_address \
0060         -Wno-interrupt_provider \
0061         -Wno-unique_unit_address \
0062         -Wunique_unit_address_if_enabled
0063
0064 # Disable undocumented compatible checks until warning free
0065 override DT_CHECKER_FLAGS ?=
0066
0067 $(obj)/processed-schema.json: $(DT_DOCS) $(src)/.yamllint check_dtschema_version FORCE
0068         $(call if_changed_rule,chkdt)
0069
0070 always-y += processed-schema.json
0071 always-$(CHECK_DT_BINDING) += $(patsubst $(srctree)/$(src)/%.yaml,%.example.dts, $(CHK_DT_DOCS))
0072 always-$(CHECK_DT_BINDING) += $(patsubst $(srctree)/$(src)/%.yaml,%.example.dtb, $(CHK_DT_DOCS))
0073
0074 # Hack: avoid 'Argument list too long' error for 'make clean'. Remove most of
0075 # build artifacts here before they are processed by scripts/Makefile.clean
0076 clean-files = $(shell find $(obj) \( -name '*.example.dts' -o \
0077                         -name '*.example.dtb' \) -delete 2>/dev/null)