drivers/pinctrl/meson/pinctrl-meson.h

   1 /* SPDX-License-Identifier: GPL-2.0-only */
   2 /*
   3  * Pin controller and GPIO driver for Amlogic Meson SoCs
   4  *
   5  * Copyright (C) 2014 Beniamino Galvani <b.galvani@gmail.com>
   6  */
   7
   8 #include <linux/gpio/driver.h>
   9 #include <linux/pinctrl/pinctrl.h>
  10 #include <linux/platform_device.h>
  11 #include <linux/regmap.h>
  12 #include <linux/types.h>
  13 #include <linux/module.h>
  14
  15 struct meson_pinctrl;
  16
  17 /**
  18  * struct meson_pmx_group - a pinmux group
  19  *
  20  * @name:       group name
  21  * @pins:       pins in the group
  22  * @num_pins:   number of pins in the group
  23  * @is_gpio:    whether the group is a single GPIO group
  24  * @reg:        register offset for the group in the domain mux registers
  25  * @bit         bit index enabling the group
  26  * @domain:     index of the domain this group belongs to
  27  */
  28 struct meson_pmx_group {
  29         const char *name;
  30         const unsigned int *pins;
  31         unsigned int num_pins;
  32         const void *data;
  33 };
  34
  35 /**
  36  * struct meson_pmx_func - a pinmux function
  37  *
  38  * @name:       function name
  39  * @groups:     groups in the function
  40  * @num_groups: number of groups in the function
  41  */
  42 struct meson_pmx_func {
  43         const char *name;
  44         const char * const *groups;
  45         unsigned int num_groups;
  46 };
  47
  48 /**
  49  * struct meson_reg_desc - a register descriptor
  50  *
  51  * @reg:        register offset in the regmap
  52  * @bit:        bit index in register
  53  *
  54  * The structure describes the information needed to control pull,
  55  * pull-enable, direction, etc. for a single pin
  56  */
  57 struct meson_reg_desc {
  58         unsigned int reg;
  59         unsigned int bit;
  60 };
  61
  62 /**
  63  * enum meson_reg_type - type of registers encoded in @meson_reg_desc
  64  */
  65 enum meson_reg_type {
  66         REG_PULLEN,
  67         REG_PULL,
  68         REG_DIR,
  69         REG_OUT,
  70         REG_IN,
  71         REG_DS,
  72         NUM_REG,
  73 };
  74
  75 /**
  76  * enum meson_pinconf_drv - value of drive-strength supported
  77  */
  78 enum meson_pinconf_drv {
  79         MESON_PINCONF_DRV_500UA,
  80         MESON_PINCONF_DRV_2500UA,
  81         MESON_PINCONF_DRV_3000UA,
  82         MESON_PINCONF_DRV_4000UA,
  83 };
  84
  85 /**
  86  * struct meson bank
  87  *
  88  * @name:       bank name
  89  * @first:      first pin of the bank
  90  * @last:       last pin of the bank
  91  * @irq:        hwirq base number of the bank
  92  * @regs:       array of register descriptors
  93  *
  94  * A bank represents a set of pins controlled by a contiguous set of
  95  * bits in the domain registers. The structure specifies which bits in
  96  * the regmap control the different functionalities. Each member of
  97  * the @regs array refers to the first pin of the bank.
  98  */
  99 struct meson_bank {
 100         const char *name;
 101         unsigned int first;
 102         unsigned int last;
 103         int irq_first;
 104         int irq_last;
 105         struct meson_reg_desc regs[NUM_REG];
 106 };
 107
 108 struct meson_pinctrl_data {
 109         const char *name;
 110         const struct pinctrl_pin_desc *pins;
 111         struct meson_pmx_group *groups;
 112         struct meson_pmx_func *funcs;
 113         unsigned int num_pins;
 114         unsigned int num_groups;
 115         unsigned int num_funcs;
 116         struct meson_bank *banks;
 117         unsigned int num_banks;
 118         const struct pinmux_ops *pmx_ops;
 119         void *pmx_data;
 120         int (*parse_dt)(struct meson_pinctrl *pc);
 121 };
 122
 123 struct meson_pinctrl {
 124         struct device *dev;
 125         struct pinctrl_dev *pcdev;
 126         struct pinctrl_desc desc;
 127         struct meson_pinctrl_data *data;
 128         struct regmap *reg_mux;
 129         struct regmap *reg_pullen;
 130         struct regmap *reg_pull;
 131         struct regmap *reg_gpio;
 132         struct regmap *reg_ds;
 133         struct gpio_chip chip;
 134         struct device_node *of_node;
 135 };
 136
 137 #define FUNCTION(fn)                                                    \
 138         {                                                               \
 139                 .name = #fn,                                            \
 140                 .groups = fn ## _groups,                                \
 141                 .num_groups = ARRAY_SIZE(fn ## _groups),                \
 142         }
 143
 144 #define BANK_DS(n, f, l, fi, li, per, peb, pr, pb, dr, db, or, ob, ir, ib,     \
 145                 dsr, dsb)                                                      \
 146         {                                                               \
 147                 .name           = n,                                    \
 148                 .first          = f,                                    \
 149                 .last           = l,                                    \
 150                 .irq_first      = fi,                                   \
 151                 .irq_last       = li,                                   \
 152                 .regs = {                                               \
 153                         [REG_PULLEN]    = { per, peb },                 \
 154                         [REG_PULL]      = { pr, pb },                   \
 155                         [REG_DIR]       = { dr, db },                   \
 156                         [REG_OUT]       = { or, ob },                   \
 157                         [REG_IN]        = { ir, ib },                   \
 158                         [REG_DS]        = { dsr, dsb },                 \
 159                 },                                                      \
 160          }
 161
 162 #define BANK(n, f, l, fi, li, per, peb, pr, pb, dr, db, or, ob, ir, ib) \
 163         BANK_DS(n, f, l, fi, li, per, peb, pr, pb, dr, db, or, ob, ir, ib, 0, 0)
 164
 165 #define MESON_PIN(x) PINCTRL_PIN(x, #x)
 166
 167 /* Common pmx functions */
 168 int meson_pmx_get_funcs_count(struct pinctrl_dev *pcdev);
 169 const char *meson_pmx_get_func_name(struct pinctrl_dev *pcdev,
 170                                     unsigned selector);
 171 int meson_pmx_get_groups(struct pinctrl_dev *pcdev,
 172                          unsigned selector,
 173                          const char * const **groups,
 174                          unsigned * const num_groups);
 175
 176 /* Common probe function */
 177 int meson_pinctrl_probe(struct platform_device *pdev);
 178 /* Common ao groups extra dt parse function for SoCs before g12a  */
 179 int meson8_aobus_parse_dt_extra(struct meson_pinctrl *pc);
 180 /* Common extra dt parse function for SoCs like A1  */
 181 int meson_a1_parse_dt_extra(struct meson_pinctrl *pc);