root/drivers/pinctrl/meson/pinctrl-meson.c
// SPDX-License-Identifier: GPL-2.0-only
/*
 * Pin controller and GPIO driver for Amlogic Meson SoCs
 *
 * Copyright (C) 2014 Beniamino Galvani <b.galvani@gmail.com>
 */

/*
 * The available pins are organized in banks (A,B,C,D,E,X,Y,Z,AO,
 * BOOT,CARD for meson6, X,Y,DV,H,Z,AO,BOOT,CARD for meson8 and
 * X,Y,DV,H,AO,BOOT,CARD,DIF for meson8b) and each bank has a
 * variable number of pins.
 *
 * The AO bank is special because it belongs to the Always-On power
 * domain which can't be powered off; the bank also uses a set of
 * registers different from the other banks.
 *
 * For each pin controller there are 4 different register ranges that
 * control the following properties of the pins:
 *  1) pin muxing
 *  2) pull enable/disable
 *  3) pull up/down
 *  4) GPIO direction, output value, input value
 *
 * In some cases the register ranges for pull enable and pull
 * direction are the same and thus there are only 3 register ranges.
 *
 * Since Meson G12A SoC, the ao register ranges for gpio, pull enable
 * and pull direction are the same, so there are only 2 register ranges.
 *
 * For the pull and GPIO configuration every bank uses a contiguous
 * set of bits in the register sets described above; the same register
 * can be shared by more banks with different offsets.
 *
 * In addition to this there are some registers shared between all
 * banks that control the IRQ functionality. This feature is not
 * supported at the moment by the driver.
 */

#include <linux/device.h>
#include <linux/gpio/driver.h>
#include <linux/init.h>
#include <linux/io.h>
#include <linux/of.h>
#include <linux/of_address.h>
#include <linux/pinctrl/pinconf-generic.h>
#include <linux/pinctrl/pinconf.h>
#include <linux/pinctrl/pinctrl.h>
#include <linux/pinctrl/pinmux.h>
#include <linux/platform_device.h>
#include <linux/property.h>
#include <linux/regmap.h>
#include <linux/seq_file.h>

#include "../core.h"
#include "../pinctrl-utils.h"
#include "pinctrl-meson.h"

static const unsigned int meson_bit_strides[] = {
        1, 1, 1, 1, 1, 2, 1
};

/**
 * meson_get_bank() - find the bank containing a given pin
 *
 * @pc:         the pinctrl instance
 * @pin:        the pin number
 * @bank:       the found bank
 *
 * Return:      0 on success, a negative value on error
 */
static int meson_get_bank(struct meson_pinctrl *pc, unsigned int pin,
                          const struct meson_bank **bank)
{
        int i;

        for (i = 0; i < pc->data->num_banks; i++) {
                if (pin >= pc->data->banks[i].first &&
                    pin <= pc->data->banks[i].last) {
                        *bank = &pc->data->banks[i];
                        return 0;
                }
        }

        return -EINVAL;
}

/**
 * meson_calc_reg_and_bit() - calculate register and bit for a pin
 *
 * @bank:       the bank containing the pin
 * @pin:        the pin number
 * @reg_type:   the type of register needed (pull-enable, pull, etc...)
 * @reg:        the computed register offset
 * @bit:        the computed bit
 */
static void meson_calc_reg_and_bit(const struct meson_bank *bank,
                                   unsigned int pin,
                                   enum meson_reg_type reg_type,
                                   unsigned int *reg, unsigned int *bit)
{
        const struct meson_reg_desc *desc = &bank->regs[reg_type];

        *bit = (desc->bit + pin - bank->first) * meson_bit_strides[reg_type];
        *reg = (desc->reg + (*bit / 32)) * 4;
        *bit &= 0x1f;
}

static int meson_get_groups_count(struct pinctrl_dev *pcdev)
{
        struct meson_pinctrl *pc = pinctrl_dev_get_drvdata(pcdev);

        return pc->data->num_groups;
}

static const char *meson_get_group_name(struct pinctrl_dev *pcdev,
                                        unsigned selector)
{
        struct meson_pinctrl *pc = pinctrl_dev_get_drvdata(pcdev);

        return pc->data->groups[selector].name;
}

static int meson_get_group_pins(struct pinctrl_dev *pcdev, unsigned selector,
                                const unsigned **pins, unsigned *num_pins)
{
        struct meson_pinctrl *pc = pinctrl_dev_get_drvdata(pcdev);

        *pins = pc->data->groups[selector].pins;
        *num_pins = pc->data->groups[selector].num_pins;

        return 0;
}

static void meson_pin_dbg_show(struct pinctrl_dev *pcdev, struct seq_file *s,
                               unsigned offset)
{
        seq_printf(s, " %s", dev_name(pcdev->dev));
}

static const struct pinctrl_ops meson_pctrl_ops = {
        .get_groups_count       = meson_get_groups_count,
        .get_group_name         = meson_get_group_name,
        .get_group_pins         = meson_get_group_pins,
        .dt_node_to_map         = pinconf_generic_dt_node_to_map_all,
        .dt_free_map            = pinctrl_utils_free_map,
        .pin_dbg_show           = meson_pin_dbg_show,
};

int meson_pmx_get_funcs_count(struct pinctrl_dev *pcdev)
{
        struct meson_pinctrl *pc = pinctrl_dev_get_drvdata(pcdev);

        return pc->data->num_funcs;
}
EXPORT_SYMBOL_GPL(meson_pmx_get_funcs_count);

const char *meson_pmx_get_func_name(struct pinctrl_dev *pcdev,
                                    unsigned selector)
{
        struct meson_pinctrl *pc = pinctrl_dev_get_drvdata(pcdev);

        return pc->data->funcs[selector].name;
}
EXPORT_SYMBOL_GPL(meson_pmx_get_func_name);

int meson_pmx_get_groups(struct pinctrl_dev *pcdev, unsigned selector,
                         const char * const **groups,
                         unsigned * const num_groups)
{
        struct meson_pinctrl *pc = pinctrl_dev_get_drvdata(pcdev);

        *groups = pc->data->funcs[selector].groups;
        *num_groups = pc->data->funcs[selector].num_groups;

        return 0;
}
EXPORT_SYMBOL_GPL(meson_pmx_get_groups);

static int meson_pinconf_set_gpio_bit(struct meson_pinctrl *pc,
                                      unsigned int pin,
                                      unsigned int reg_type,
                                      bool arg)
{
        const struct meson_bank *bank;
        unsigned int reg, bit;
        int ret;

        ret = meson_get_bank(pc, pin, &bank);
        if (ret)
                return ret;

        meson_calc_reg_and_bit(bank, pin, reg_type, &reg, &bit);
        return regmap_update_bits(pc->reg_gpio, reg, BIT(bit),
                                  arg ? BIT(bit) : 0);
}

static int meson_pinconf_get_gpio_bit(struct meson_pinctrl *pc,
                                      unsigned int pin,
                                      unsigned int reg_type)
{
        const struct meson_bank *bank;
        unsigned int reg, bit, val;
        int ret;

        ret = meson_get_bank(pc, pin, &bank);
        if (ret)
                return ret;

        meson_calc_reg_and_bit(bank, pin, reg_type, &reg, &bit);
        ret = regmap_read(pc->reg_gpio, reg, &val);
        if (ret)
                return ret;

        return BIT(bit) & val ? 1 : 0;
}

static int meson_pinconf_set_output(struct meson_pinctrl *pc,
                                    unsigned int pin,
                                    bool out)
{
        return meson_pinconf_set_gpio_bit(pc, pin, MESON_REG_DIR, !out);
}

static int meson_pinconf_get_output(struct meson_pinctrl *pc,
                                    unsigned int pin)
{
        int ret = meson_pinconf_get_gpio_bit(pc, pin, MESON_REG_DIR);

        if (ret < 0)
                return ret;

        return !ret;
}

static int meson_pinconf_set_drive(struct meson_pinctrl *pc,
                                   unsigned int pin,
                                   bool high)
{
        return meson_pinconf_set_gpio_bit(pc, pin, MESON_REG_OUT, high);
}

static int meson_pinconf_get_drive(struct meson_pinctrl *pc,
                                   unsigned int pin)
{
        return meson_pinconf_get_gpio_bit(pc, pin, MESON_REG_OUT);
}

static int meson_pinconf_set_output_drive(struct meson_pinctrl *pc,
                                          unsigned int pin,
                                          bool high)
{
        int ret;

        ret = meson_pinconf_set_output(pc, pin, true);
        if (ret)
                return ret;

        return meson_pinconf_set_drive(pc, pin, high);
}

static int meson_pinconf_disable_bias(struct meson_pinctrl *pc,
                                      unsigned int pin)
{
        const struct meson_bank *bank;
        unsigned int reg, bit = 0;
        int ret;

        ret = meson_get_bank(pc, pin, &bank);
        if (ret)
                return ret;

        meson_calc_reg_and_bit(bank, pin, MESON_REG_PULLEN, &reg, &bit);
        ret = regmap_update_bits(pc->reg_pullen, reg, BIT(bit), 0);
        if (ret)
                return ret;

        return 0;
}

static int meson_pinconf_enable_bias(struct meson_pinctrl *pc, unsigned int pin,
                                     bool pull_up)
{
        const struct meson_bank *bank;
        unsigned int reg, bit, val = 0;
        int ret;

        ret = meson_get_bank(pc, pin, &bank);
        if (ret)
                return ret;

        meson_calc_reg_and_bit(bank, pin, MESON_REG_PULL, &reg, &bit);
        if (pull_up)
                val = BIT(bit);

        ret = regmap_update_bits(pc->reg_pull, reg, BIT(bit), val);
        if (ret)
                return ret;

        meson_calc_reg_and_bit(bank, pin, MESON_REG_PULLEN, &reg, &bit);
        ret = regmap_update_bits(pc->reg_pullen, reg, BIT(bit), BIT(bit));
        if (ret)
                return ret;

        return 0;
}

static int meson_pinconf_set_drive_strength(struct meson_pinctrl *pc,
                                            unsigned int pin,
                                            u16 drive_strength_ua)
{
        const struct meson_bank *bank;
        unsigned int reg, bit, ds_val;
        int ret;

        if (!pc->reg_ds) {
                dev_err(pc->dev, "drive-strength not supported\n");
                return -ENOTSUPP;
        }

        ret = meson_get_bank(pc, pin, &bank);
        if (ret)
                return ret;

        meson_calc_reg_and_bit(bank, pin, MESON_REG_DS, &reg, &bit);

        if (drive_strength_ua <= 500) {
                ds_val = MESON_PINCONF_DRV_500UA;
        } else if (drive_strength_ua <= 2500) {
                ds_val = MESON_PINCONF_DRV_2500UA;
        } else if (drive_strength_ua <= 3000) {
                ds_val = MESON_PINCONF_DRV_3000UA;
        } else if (drive_strength_ua <= 4000) {
                ds_val = MESON_PINCONF_DRV_4000UA;
        } else {
                dev_warn_once(pc->dev,
                              "pin %u: invalid drive-strength : %d , default to 4mA\n",
                              pin, drive_strength_ua);
                ds_val = MESON_PINCONF_DRV_4000UA;
        }

        ret = regmap_update_bits(pc->reg_ds, reg, 0x3 << bit, ds_val << bit);
        if (ret)
                return ret;

        return 0;
}

static int meson_pinconf_set(struct pinctrl_dev *pcdev, unsigned int pin,
                             unsigned long *configs, unsigned num_configs)
{
        struct meson_pinctrl *pc = pinctrl_dev_get_drvdata(pcdev);
        enum pin_config_param param;
        unsigned int arg = 0;
        int i, ret;

        for (i = 0; i < num_configs; i++) {
                param = pinconf_to_config_param(configs[i]);

                switch (param) {
                case PIN_CONFIG_DRIVE_STRENGTH_UA:
                case PIN_CONFIG_OUTPUT_ENABLE:
                case PIN_CONFIG_LEVEL:
                        arg = pinconf_to_config_argument(configs[i]);
                        break;

                default:
                        break;
                }

                switch (param) {
                case PIN_CONFIG_BIAS_DISABLE:
                        ret = meson_pinconf_disable_bias(pc, pin);
                        break;
                case PIN_CONFIG_BIAS_PULL_UP:
                        ret = meson_pinconf_enable_bias(pc, pin, true);
                        break;
                case PIN_CONFIG_BIAS_PULL_DOWN:
                        ret = meson_pinconf_enable_bias(pc, pin, false);
                        break;
                case PIN_CONFIG_DRIVE_STRENGTH_UA:
                        ret = meson_pinconf_set_drive_strength(pc, pin, arg);
                        break;
                case PIN_CONFIG_OUTPUT_ENABLE:
                        ret = meson_pinconf_set_output(pc, pin, arg);
                        break;
                case PIN_CONFIG_LEVEL:
                        ret = meson_pinconf_set_output_drive(pc, pin, arg);
                        break;
                default:
                        ret = -ENOTSUPP;
                }

                if (ret)
                        return ret;
        }

        return 0;
}

static int meson_pinconf_get_pull(struct meson_pinctrl *pc, unsigned int pin)
{
        const struct meson_bank *bank;
        unsigned int reg, bit, val;
        int ret, conf;

        ret = meson_get_bank(pc, pin, &bank);
        if (ret)
                return ret;

        meson_calc_reg_and_bit(bank, pin, MESON_REG_PULLEN, &reg, &bit);

        ret = regmap_read(pc->reg_pullen, reg, &val);
        if (ret)
                return ret;

        if (!(val & BIT(bit))) {
                conf = PIN_CONFIG_BIAS_DISABLE;
        } else {
                meson_calc_reg_and_bit(bank, pin, MESON_REG_PULL, &reg, &bit);

                ret = regmap_read(pc->reg_pull, reg, &val);
                if (ret)
                        return ret;

                if (val & BIT(bit))
                        conf = PIN_CONFIG_BIAS_PULL_UP;
                else
                        conf = PIN_CONFIG_BIAS_PULL_DOWN;
        }

        return conf;
}

static int meson_pinconf_get_drive_strength(struct meson_pinctrl *pc,
                                            unsigned int pin,
                                            u16 *drive_strength_ua)
{
        const struct meson_bank *bank;
        unsigned int reg, bit;
        unsigned int val;
        int ret;

        if (!pc->reg_ds)
                return -ENOTSUPP;

        ret = meson_get_bank(pc, pin, &bank);
        if (ret)
                return ret;

        meson_calc_reg_and_bit(bank, pin, MESON_REG_DS, &reg, &bit);

        ret = regmap_read(pc->reg_ds, reg, &val);
        if (ret)
                return ret;

        switch ((val >> bit) & 0x3) {
        case MESON_PINCONF_DRV_500UA:
                *drive_strength_ua = 500;
                break;
        case MESON_PINCONF_DRV_2500UA:
                *drive_strength_ua = 2500;
                break;
        case MESON_PINCONF_DRV_3000UA:
                *drive_strength_ua = 3000;
                break;
        case MESON_PINCONF_DRV_4000UA:
                *drive_strength_ua = 4000;
                break;
        default:
                return -EINVAL;
        }

        return 0;
}

static int meson_pinconf_get(struct pinctrl_dev *pcdev, unsigned int pin,
                             unsigned long *config)
{
        struct meson_pinctrl *pc = pinctrl_dev_get_drvdata(pcdev);
        enum pin_config_param param = pinconf_to_config_param(*config);
        u16 arg;
        int ret;

        switch (param) {
        case PIN_CONFIG_BIAS_DISABLE:
        case PIN_CONFIG_BIAS_PULL_DOWN:
        case PIN_CONFIG_BIAS_PULL_UP:
                if (meson_pinconf_get_pull(pc, pin) == param)
                        arg = 60000;
                else
                        return -EINVAL;
                break;
        case PIN_CONFIG_DRIVE_STRENGTH_UA:
                ret = meson_pinconf_get_drive_strength(pc, pin, &arg);
                if (ret)
                        return ret;
                break;
        case PIN_CONFIG_OUTPUT_ENABLE:
                ret = meson_pinconf_get_output(pc, pin);
                if (ret <= 0)
                        return -EINVAL;
                arg = 1;
                break;
        case PIN_CONFIG_LEVEL:
                ret = meson_pinconf_get_output(pc, pin);
                if (ret <= 0)
                        return -EINVAL;

                ret = meson_pinconf_get_drive(pc, pin);
                if (ret < 0)
                        return -EINVAL;

                arg = ret;
                break;

        default:
                return -ENOTSUPP;
        }

        *config = pinconf_to_config_packed(param, arg);
        dev_dbg(pc->dev, "pinconf for pin %u is %lu\n", pin, *config);

        return 0;
}

static int meson_pinconf_group_set(struct pinctrl_dev *pcdev,
                                   unsigned int num_group,
                                   unsigned long *configs, unsigned num_configs)
{
        struct meson_pinctrl *pc = pinctrl_dev_get_drvdata(pcdev);
        const struct meson_pmx_group *group = &pc->data->groups[num_group];
        int i;

        dev_dbg(pc->dev, "set pinconf for group %s\n", group->name);

        for (i = 0; i < group->num_pins; i++) {
                meson_pinconf_set(pcdev, group->pins[i], configs,
                                  num_configs);
        }

        return 0;
}

static int meson_pinconf_group_get(struct pinctrl_dev *pcdev,
                                   unsigned int group, unsigned long *config)
{
        return -ENOTSUPP;
}

static const struct pinconf_ops meson_pinconf_ops = {
        .pin_config_get         = meson_pinconf_get,
        .pin_config_set         = meson_pinconf_set,
        .pin_config_group_get   = meson_pinconf_group_get,
        .pin_config_group_set   = meson_pinconf_group_set,
        .is_generic             = true,
};

static int meson_gpio_get_direction(struct gpio_chip *chip, unsigned gpio)
{
        struct meson_pinctrl *pc = gpiochip_get_data(chip);
        int ret;

        ret = meson_pinconf_get_output(pc, gpio);
        if (ret < 0)
                return ret;

        return ret ? GPIO_LINE_DIRECTION_OUT : GPIO_LINE_DIRECTION_IN;
}

static int meson_gpio_direction_input(struct gpio_chip *chip, unsigned gpio)
{
        return meson_pinconf_set_output(gpiochip_get_data(chip), gpio, false);
}

static int meson_gpio_direction_output(struct gpio_chip *chip, unsigned gpio,
                                       int value)
{
        return meson_pinconf_set_output_drive(gpiochip_get_data(chip),
                                              gpio, value);
}

static int meson_gpio_set(struct gpio_chip *chip, unsigned int gpio, int value)
{
        return meson_pinconf_set_drive(gpiochip_get_data(chip), gpio, value);
}

static int meson_gpio_get(struct gpio_chip *chip, unsigned gpio)
{
        struct meson_pinctrl *pc = gpiochip_get_data(chip);
        const struct meson_bank *bank;
        unsigned int reg, bit, val;
        int ret;

        ret = meson_get_bank(pc, gpio, &bank);
        if (ret)
                return ret;

        meson_calc_reg_and_bit(bank, gpio, MESON_REG_IN, &reg, &bit);
        regmap_read(pc->reg_gpio, reg, &val);

        return !!(val & BIT(bit));
}

static int meson_gpiolib_register(struct meson_pinctrl *pc)
{
        int ret;

        pc->chip.label = pc->data->name;
        pc->chip.parent = pc->dev;
        pc->chip.fwnode = pc->fwnode;
        pc->chip.request = gpiochip_generic_request;
        pc->chip.free = gpiochip_generic_free;
        pc->chip.set_config = gpiochip_generic_config;
        pc->chip.get_direction = meson_gpio_get_direction;
        pc->chip.direction_input = meson_gpio_direction_input;
        pc->chip.direction_output = meson_gpio_direction_output;
        pc->chip.get = meson_gpio_get;
        pc->chip.set = meson_gpio_set;
        pc->chip.base = -1;
        pc->chip.ngpio = pc->data->num_pins;
        pc->chip.can_sleep = true;

        ret = gpiochip_add_data(&pc->chip, pc);
        if (ret) {
                dev_err(pc->dev, "can't add gpio chip %s\n",
                        pc->data->name);
                return ret;
        }

        return 0;
}

static struct regmap_config meson_regmap_config = {
        .reg_bits = 32,
        .val_bits = 32,
        .reg_stride = 4,
};

static struct regmap *meson_map_resource(struct meson_pinctrl *pc,
                                         struct device_node *node, char *name)
{
        struct resource res;
        void __iomem *base;
        int i;

        i = of_property_match_string(node, "reg-names", name);
        if (of_address_to_resource(node, i, &res))
                return NULL;

        base = devm_ioremap_resource(pc->dev, &res);
        if (IS_ERR(base))
                return ERR_CAST(base);

        meson_regmap_config.max_register = resource_size(&res) - 4;
        meson_regmap_config.name = devm_kasprintf(pc->dev, GFP_KERNEL,
                                                  "%pOFn-%s", node,
                                                  name);
        if (!meson_regmap_config.name)
                return ERR_PTR(-ENOMEM);

        return devm_regmap_init_mmio(pc->dev, base, &meson_regmap_config);
}

static int meson_pinctrl_parse_dt(struct meson_pinctrl *pc)
{
        struct device_node *gpio_np;
        unsigned int chips;

        chips = gpiochip_node_count(pc->dev);
        if (!chips) {
                dev_err(pc->dev, "no gpio node found\n");
                return -EINVAL;
        }
        if (chips > 1) {
                dev_err(pc->dev, "multiple gpio nodes\n");
                return -EINVAL;
        }

        pc->fwnode = gpiochip_node_get_first(pc->dev);
        gpio_np = to_of_node(pc->fwnode);

        pc->reg_mux = meson_map_resource(pc, gpio_np, "mux");
        if (IS_ERR_OR_NULL(pc->reg_mux)) {
                dev_err(pc->dev, "mux registers not found\n");
                return pc->reg_mux ? PTR_ERR(pc->reg_mux) : -ENOENT;
        }

        pc->reg_gpio = meson_map_resource(pc, gpio_np, "gpio");
        if (IS_ERR_OR_NULL(pc->reg_gpio)) {
                dev_err(pc->dev, "gpio registers not found\n");
                return pc->reg_gpio ? PTR_ERR(pc->reg_gpio) : -ENOENT;
        }

        pc->reg_pull = meson_map_resource(pc, gpio_np, "pull");
        if (IS_ERR(pc->reg_pull))
                pc->reg_pull = NULL;

        pc->reg_pullen = meson_map_resource(pc, gpio_np, "pull-enable");
        if (IS_ERR(pc->reg_pullen))
                pc->reg_pullen = NULL;

        pc->reg_ds = meson_map_resource(pc, gpio_np, "ds");
        if (IS_ERR(pc->reg_ds)) {
                dev_dbg(pc->dev, "ds registers not found - skipping\n");
                pc->reg_ds = NULL;
        }

        if (pc->data->parse_dt)
                return pc->data->parse_dt(pc);

        return 0;
}

int meson8_aobus_parse_dt_extra(struct meson_pinctrl *pc)
{
        if (!pc->reg_pull)
                return -EINVAL;

        pc->reg_pullen = pc->reg_pull;

        return 0;
}
EXPORT_SYMBOL_GPL(meson8_aobus_parse_dt_extra);

int meson_a1_parse_dt_extra(struct meson_pinctrl *pc)
{
        pc->reg_pull = pc->reg_gpio;
        pc->reg_pullen = pc->reg_gpio;
        pc->reg_ds = pc->reg_gpio;

        return 0;
}
EXPORT_SYMBOL_GPL(meson_a1_parse_dt_extra);

int meson_pinctrl_probe(struct platform_device *pdev)
{
        struct device *dev = &pdev->dev;
        struct meson_pinctrl *pc;
        int ret;

        pc = devm_kzalloc(dev, sizeof(struct meson_pinctrl), GFP_KERNEL);
        if (!pc)
                return -ENOMEM;

        pc->dev = dev;
        pc->data = (struct meson_pinctrl_data *) of_device_get_match_data(dev);

        ret = meson_pinctrl_parse_dt(pc);
        if (ret)
                return ret;

        pc->desc.name           = "pinctrl-meson";
        pc->desc.owner          = THIS_MODULE;
        pc->desc.pctlops        = &meson_pctrl_ops;
        pc->desc.pmxops         = pc->data->pmx_ops;
        pc->desc.confops        = &meson_pinconf_ops;
        pc->desc.pins           = pc->data->pins;
        pc->desc.npins          = pc->data->num_pins;

        pc->pcdev = devm_pinctrl_register(pc->dev, &pc->desc, pc);
        if (IS_ERR(pc->pcdev)) {
                dev_err(pc->dev, "can't register pinctrl device");
                return PTR_ERR(pc->pcdev);
        }

        return meson_gpiolib_register(pc);
}
EXPORT_SYMBOL_GPL(meson_pinctrl_probe);

MODULE_DESCRIPTION("Amlogic Meson SoCs core pinctrl driver");
MODULE_LICENSE("GPL v2");