dt-bindings: pinctrl: samsung: deprecate header with register constants
authorKrzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Tue, 16 Aug 2022 13:30:16 +0000 (16:30 +0300)
committerKrzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Fri, 19 Aug 2022 13:54:10 +0000 (16:54 +0300)
For convenience (less code duplication, some meaning added to raw
number), the pin controller pin configuration register values
were defined in the bindings header.  These are not some IDs or other
abstraction layer but raw numbers used in the registers

These constants do not fit the purpose of bindings.  They do not provide
any abstraction, any hardware and driver independent ID.  With minor
exceptions, the Linux drivers actually do not use the bindings header at
all.

All of the constants were moved already to headers local to DTS
(residing in DTS directory) and to Samsung pinctrl driver (where
applicable), so remove any references to the bindings header and add a
warning tha tit is deprecated.

Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
Reviewed-by: Chanho Park <chanho61.park@samsung.com>
Acked-by: Rob Herring <robh@kernel.org>
Reviewed-by: Linus Walleij <linus.walleij@linaro.org>
Link: https://lore.kernel.org/r/20220816133016.77553-3-krzysztof.kozlowski@linaro.org
include/dt-bindings/pinctrl/samsung.h

index 9509706..d1da5ff 100644 (file)
 #ifndef __DT_BINDINGS_PINCTRL_SAMSUNG_H__
 #define __DT_BINDINGS_PINCTRL_SAMSUNG_H__
 
+/*
+ * These bindings are deprecated, because they do not match the actual
+ * concept of bindings but rather contain pure register values.
+ * Instead include the header in the DTS source directory.
+ */
+#warning "These bindings are deprecated. Instead use the header in the DTS source directory."
+
 #define EXYNOS_PIN_PULL_NONE           0
 #define EXYNOS_PIN_PULL_DOWN           1
 #define EXYNOS_PIN_PULL_UP             3