hte: tegra194: improve the GPIO-related comment
authorBartosz Golaszewski <bartosz.golaszewski@linaro.org>
Mon, 11 Sep 2023 09:44:43 +0000 (11:44 +0200)
committerDipen Patel <dipenp@nvidia.com>
Thu, 5 Oct 2023 23:03:20 +0000 (16:03 -0700)
Using any of the GPIO interfaces using the global numberspace is
deprecated. Make it clear in the comment.

Signed-off-by: Bartosz Golaszewski <bartosz.golaszewski@linaro.org>
Acked-by: Linus Walleij <linus.walleij@linaro.org>
Reviewed-by: Dipen Patel <dipenp@nvidia.com>
Signed-off-by: Dipen Patel <dipenp@nvidia.com>
drivers/hte/hte-tegra194.c

index 6fe6897..9fd3c00 100644 (file)
@@ -407,12 +407,15 @@ static int tegra_hte_line_xlate(struct hte_chip *gc,
                return -EINVAL;
 
        /*
+        * GPIO consumers can access GPIOs in two ways:
         *
-        * There are two paths GPIO consumers can take as follows:
-        * 1) The consumer (gpiolib-cdev for example) which uses GPIO global
-        * number which gets assigned run time.
-        * 2) The consumer passing GPIO from the DT which is assigned
-        * statically for example by using TEGRA194_AON_GPIO gpio DT binding.
+        * 1) Using the global GPIO numberspace.
+        *
+        * This is the old, now DEPRECATED method and should not be used in
+        * new code. TODO: Check if tegra is even concerned by this.
+        *
+        * 2) Using GPIO descriptors that can be assigned to consumer devices
+        * using device-tree, ACPI or lookup tables.
         *
         * The code below addresses both the consumer use cases and maps into
         * HTE/GTE namespace.