root/drivers/net/dsa/realtek/rtl83xx.c
// SPDX-License-Identifier: GPL-2.0+

#include <linux/module.h>
#include <linux/regmap.h>
#include <linux/of_mdio.h>
#include <linux/if_bridge.h>
#include <linux/etherdevice.h>

#include "realtek.h"
#include "rtl83xx.h"

/**
 * rtl83xx_lock() - Locks the mutex used by regmaps
 * @ctx: realtek_priv pointer
 *
 * This function is passed to regmap to be used as the lock function.
 * It is also used externally to block regmap before executing multiple
 * operations that must happen in sequence (which will use
 * realtek_priv.map_nolock instead).
 *
 * Context: Can sleep. Holds priv->map_lock lock.
 * Return: nothing
 */
void rtl83xx_lock(void *ctx)
{
        struct realtek_priv *priv = ctx;

        mutex_lock(&priv->map_lock);
}
EXPORT_SYMBOL_NS_GPL(rtl83xx_lock, "REALTEK_DSA");

/**
 * rtl83xx_unlock() - Unlocks the mutex used by regmaps
 * @ctx: realtek_priv pointer
 *
 * This function unlocks the lock acquired by rtl83xx_lock.
 *
 * Context: Releases priv->map_lock lock.
 * Return: nothing
 */
void rtl83xx_unlock(void *ctx)
{
        struct realtek_priv *priv = ctx;

        mutex_unlock(&priv->map_lock);
}
EXPORT_SYMBOL_NS_GPL(rtl83xx_unlock, "REALTEK_DSA");

static int rtl83xx_user_mdio_read(struct mii_bus *bus, int addr, int regnum)
{
        struct realtek_priv *priv = bus->priv;

        return priv->ops->phy_read(priv, addr, regnum);
}

static int rtl83xx_user_mdio_write(struct mii_bus *bus, int addr, int regnum,
                                   u16 val)
{
        struct realtek_priv *priv = bus->priv;

        return priv->ops->phy_write(priv, addr, regnum, val);
}

/**
 * rtl83xx_setup_user_mdio() - register the user mii bus driver
 * @ds: DSA switch associated with this user_mii_bus
 *
 * Registers the MDIO bus for built-in Ethernet PHYs, and associates it with
 * the mandatory 'mdio' child OF node of the switch.
 *
 * Context: Can sleep.
 * Return: 0 on success, negative value for failure.
 */
int rtl83xx_setup_user_mdio(struct dsa_switch *ds)
{
        struct realtek_priv *priv = ds->priv;
        struct device_node *mdio_np;
        struct mii_bus *bus;
        int ret = 0;

        mdio_np = of_get_child_by_name(priv->dev->of_node, "mdio");
        if (!mdio_np) {
                dev_err(priv->dev, "no MDIO bus node\n");
                return -ENODEV;
        }

        bus = devm_mdiobus_alloc(priv->dev);
        if (!bus) {
                ret = -ENOMEM;
                goto err_put_node;
        }

        bus->priv = priv;
        bus->name = "Realtek user MII";
        bus->read = rtl83xx_user_mdio_read;
        bus->write = rtl83xx_user_mdio_write;
        snprintf(bus->id, MII_BUS_ID_SIZE, "%s:user_mii", dev_name(priv->dev));
        bus->parent = priv->dev;

        ret = devm_of_mdiobus_register(priv->dev, bus, mdio_np);
        if (ret) {
                dev_err(priv->dev, "unable to register MDIO bus %s\n",
                        bus->id);
                goto err_put_node;
        }

        priv->user_mii_bus = bus;

err_put_node:
        of_node_put(mdio_np);

        return ret;
}
EXPORT_SYMBOL_NS_GPL(rtl83xx_setup_user_mdio, "REALTEK_DSA");

/**
 * rtl83xx_probe() - probe a Realtek switch
 * @dev: the device being probed
 * @interface_info: specific management interface info.
 *
 * This function initializes realtek_priv and reads data from the device tree
 * node. The switch is hard resetted if a method is provided.
 *
 * Context: Can sleep.
 * Return: Pointer to the realtek_priv or ERR_PTR() in case of failure.
 *
 * The realtek_priv pointer does not need to be freed as it is controlled by
 * devres.
 */
struct realtek_priv *
rtl83xx_probe(struct device *dev,
              const struct realtek_interface_info *interface_info)
{
        const struct realtek_variant *var;
        struct realtek_priv *priv;
        struct regmap_config rc = {
                .reg_bits = 10, /* A4..A0 R4..R0 */
                .val_bits = 16,
                .reg_stride = 1,
                .max_register = 0xffff,
                .reg_format_endian = REGMAP_ENDIAN_BIG,
                .reg_read = interface_info->reg_read,
                .reg_write = interface_info->reg_write,
                .cache_type = REGCACHE_NONE,
                .lock = rtl83xx_lock,
                .unlock = rtl83xx_unlock,
        };
        int ret;

        var = of_device_get_match_data(dev);
        if (!var)
                return ERR_PTR(-EINVAL);

        priv = devm_kzalloc(dev, size_add(sizeof(*priv), var->chip_data_sz),
                            GFP_KERNEL);
        if (!priv)
                return ERR_PTR(-ENOMEM);

        ret = devm_mutex_init(dev, &priv->map_lock);
        if (ret)
                return ERR_PTR(ret);

        ret = devm_mutex_init(dev, &priv->vlan_lock);
        if (ret)
                return ERR_PTR(ret);

        ret = devm_mutex_init(dev, &priv->l2_lock);
        if (ret)
                return ERR_PTR(ret);

        rc.lock_arg = priv;
        priv->map = devm_regmap_init(dev, NULL, priv, &rc);
        if (IS_ERR(priv->map)) {
                ret = PTR_ERR(priv->map);
                dev_err(dev, "regmap init failed: %d\n", ret);
                return ERR_PTR(ret);
        }

        rc.disable_locking = true;
        priv->map_nolock = devm_regmap_init(dev, NULL, priv, &rc);
        if (IS_ERR(priv->map_nolock)) {
                ret = PTR_ERR(priv->map_nolock);
                dev_err(dev, "regmap init failed: %d\n", ret);
                return ERR_PTR(ret);
        }

        /* Link forward and backward */
        priv->dev = dev;
        priv->variant = var;
        priv->ops = var->ops;
        priv->chip_data = (void *)priv + sizeof(*priv);

        spin_lock_init(&priv->lock);

        priv->leds_disabled = of_property_read_bool(dev->of_node,
                                                    "realtek,disable-leds");

        /* TODO: if power is software controlled, set up any regulators here */
        priv->reset_ctl = devm_reset_control_get_optional(dev, NULL);
        if (IS_ERR(priv->reset_ctl))
                return dev_err_cast_probe(dev, priv->reset_ctl,
                                          "failed to get reset control\n");

        priv->reset = devm_gpiod_get_optional(dev, "reset", GPIOD_OUT_LOW);
        if (IS_ERR(priv->reset)) {
                dev_err(dev, "failed to get RESET GPIO\n");
                return ERR_CAST(priv->reset);
        }

        dev_set_drvdata(dev, priv);

        if (priv->reset_ctl || priv->reset) {
                rtl83xx_reset_assert(priv);
                dev_dbg(dev, "asserted RESET\n");
                msleep(REALTEK_HW_STOP_DELAY);
                rtl83xx_reset_deassert(priv);
                msleep(REALTEK_HW_START_DELAY);
                dev_dbg(dev, "deasserted RESET\n");
        }

        return priv;
}
EXPORT_SYMBOL_NS_GPL(rtl83xx_probe, "REALTEK_DSA");

/**
 * rtl83xx_register_switch() - detects and register a switch
 * @priv: realtek_priv pointer
 *
 * This function first checks the switch chip ID and register a DSA
 * switch.
 *
 * Context: Can sleep. Takes and releases priv->map_lock.
 * Return: 0 on success, negative value for failure.
 */
int rtl83xx_register_switch(struct realtek_priv *priv)
{
        struct dsa_switch *ds = &priv->ds;
        int ret;

        ret = priv->ops->detect(priv);
        if (ret) {
                dev_err_probe(priv->dev, ret, "unable to detect switch\n");
                return ret;
        }

        ds->priv = priv;
        ds->dev = priv->dev;
        ds->ops = priv->variant->ds_ops;
        ds->phylink_mac_ops = priv->variant->phylink_mac_ops;
        ds->num_ports = priv->num_ports;

        ret = dsa_register_switch(ds);
        if (ret) {
                dev_err_probe(priv->dev, ret, "unable to register switch\n");
                return ret;
        }

        return 0;
}
EXPORT_SYMBOL_NS_GPL(rtl83xx_register_switch, "REALTEK_DSA");

/**
 * rtl83xx_unregister_switch() - unregister a switch
 * @priv: realtek_priv pointer
 *
 * This function unregister a DSA switch.
 *
 * Context: Can sleep.
 * Return: Nothing.
 */
void rtl83xx_unregister_switch(struct realtek_priv *priv)
{
        struct dsa_switch *ds = &priv->ds;

        dsa_unregister_switch(ds);
}
EXPORT_SYMBOL_NS_GPL(rtl83xx_unregister_switch, "REALTEK_DSA");

/**
 * rtl83xx_shutdown() - shutdown a switch
 * @priv: realtek_priv pointer
 *
 * This function shuts down the DSA switch and cleans the platform driver data,
 * to prevent realtek_{smi,mdio}_remove() from running afterwards, which is
 * possible if the parent bus implements its own .shutdown() as .remove().
 *
 * Context: Can sleep.
 * Return: Nothing.
 */
void rtl83xx_shutdown(struct realtek_priv *priv)
{
        struct dsa_switch *ds = &priv->ds;

        dsa_switch_shutdown(ds);

        dev_set_drvdata(priv->dev, NULL);
}
EXPORT_SYMBOL_NS_GPL(rtl83xx_shutdown, "REALTEK_DSA");

/**
 * rtl83xx_remove() - Cleanup a realtek switch driver
 * @priv: realtek_priv pointer
 *
 * Placehold for common cleanup procedures.
 *
 * Context: Any
 * Return: nothing
 */
void rtl83xx_remove(struct realtek_priv *priv)
{
}
EXPORT_SYMBOL_NS_GPL(rtl83xx_remove, "REALTEK_DSA");

void rtl83xx_reset_assert(struct realtek_priv *priv)
{
        int ret;

        ret = reset_control_assert(priv->reset_ctl);
        if (ret)
                dev_warn(priv->dev,
                         "Failed to assert the switch reset control: %pe\n",
                         ERR_PTR(ret));

        gpiod_set_value(priv->reset, true);
}

void rtl83xx_reset_deassert(struct realtek_priv *priv)
{
        int ret;

        ret = reset_control_deassert(priv->reset_ctl);
        if (ret)
                dev_warn(priv->dev,
                         "Failed to deassert the switch reset control: %pe\n",
                         ERR_PTR(ret));

        gpiod_set_value(priv->reset, false);
}

/**
 * rtl83xx_port_bridge_join() - join a port to a bridge
 * @ds: DSA switch instance
 * @port: port index
 * @bridge: bridge being joined
 * @tx_forward_offload: if the switch can offload TX forwarding
 * @extack: netlink extended ack for reporting errors
 *
 * This function handles joining a port to a bridge. It updates the port
 * isolation masks and EFID.
 *
 * Context: Can sleep.
 * Return: 0 on success, negative value for failure.
 */
int rtl83xx_port_bridge_join(struct dsa_switch *ds, int port,
                             struct dsa_bridge bridge,
                             bool *tx_forward_offload,
                             struct netlink_ext_ack *extack)
{
        struct realtek_priv *priv = ds->priv;
        struct dsa_port *dp;
        u32 mask = 0;
        int ret;

        if (!priv->ops->port_add_isolation)
                return -EOPNOTSUPP;

        if (!priv->ops->port_set_learning)
                return -EOPNOTSUPP;

        dev_dbg(priv->dev, "bridge %d join port %d\n", bridge.num, port);

        /* Add this port to the isolation group of every other port
         * offloading this bridge.
         */
        dsa_switch_for_each_user_port(dp, ds) {
                /* Handle this port after */
                if (dp->index == port)
                        continue;

                /* Skip ports that are not in this bridge */
                if (!dsa_port_offloads_bridge(dp, &bridge))
                        continue;

                ret = priv->ops->port_add_isolation(priv, dp->index, BIT(port));
                if (ret)
                        goto undo_isolation;

                mask |= BIT(dp->index);
        }

        /* If we support cascade switches, it should also include the
         * downstream DSA ports to the isolation group.
         */

        /* Add those ports to the isolation group of this port */
        ret = priv->ops->port_add_isolation(priv, port, mask);
        if (ret)
                goto undo_isolation;

        /* Use the bridge number as the EFID for this port */
        if (priv->ops->port_set_efid) {
                ret = priv->ops->port_set_efid(priv, port, bridge.num);
                if (ret)
                        goto undo_self_isolation;
        }

        ret = priv->ops->port_set_learning(priv, port, true);
        if (ret)
                goto undo_efid;

        return 0;

undo_efid:
        if (priv->ops->port_set_efid)
                priv->ops->port_set_efid(priv, port, 0);

undo_self_isolation:
        priv->ops->port_remove_isolation(priv, port, mask);

undo_isolation:
        dsa_switch_for_each_port(dp, ds) {
                if (mask & BIT(dp->index))
                        priv->ops->port_remove_isolation(priv, dp->index,
                                                         BIT(port));
        }

        return ret;
}
EXPORT_SYMBOL_NS_GPL(rtl83xx_port_bridge_join, "REALTEK_DSA");

/**
 * rtl83xx_port_bridge_leave() - leave a bridge
 * @ds: DSA switch instance
 * @port: port index
 * @bridge: bridge being left
 *
 * This function handles removing a port from a bridge. It updates the port
 * isolation masks and EFID.
 *
 * Context: Can sleep.
 * Return: nothing
 */
void rtl83xx_port_bridge_leave(struct dsa_switch *ds, int port,
                               struct dsa_bridge bridge)
{
        struct realtek_priv *priv = ds->priv;
        struct dsa_port *dp;
        u32 mask = 0;
        int ret;

        if (!priv->ops->port_remove_isolation)
                return;

        if (!priv->ops->port_set_learning)
                return;

        dev_dbg(priv->dev, "bridge %d leave port %d\n", bridge.num, port);

        /* Remove this port from the isolation group of every other
         * port offloading this bridge.
         */
        dsa_switch_for_each_user_port(dp, ds) {
                /* Handle this port after */
                if (dp->index == port)
                        continue;

                /* Skip ports that are not in this bridge */
                if (!dsa_port_offloads_bridge(dp, &bridge))
                        continue;

                ret = priv->ops->port_remove_isolation(priv, dp->index,
                                                       BIT(port));
                if (ret)
                        dev_err(priv->dev,
                                "failed to isolate port %d from port %d: %pe\n",
                                port, dp->index, ERR_PTR(ret));

                mask |= BIT(dp->index);
        }

        /* If we support cascade switches, it should also exclude the
         * downstream DSA ports from the isolation group.
         */

        ret = priv->ops->port_set_learning(priv, port, false);
        if (ret)
                dev_err(priv->dev,
                        "failed to disable learning on port %d: %pe\n",
                        port, ERR_PTR(ret));

        /* Remove those ports from the isolation group of this port */
        ret = priv->ops->port_remove_isolation(priv, port, mask);
        if (ret)
                dev_err(priv->dev,
                        "failed to remove isolation mask from port %d: %pe\n",
                        port, ERR_PTR(ret));

        /* Revert to the default EFID 0 for standalone mode */
        if (priv->ops->port_set_efid) {
                ret = priv->ops->port_set_efid(priv, port, 0);
                if (ret)
                        dev_err(priv->dev,
                                "failed to clear EFID on port %d: %pe\n",
                                port, ERR_PTR(ret));
        }
}
EXPORT_SYMBOL_NS_GPL(rtl83xx_port_bridge_leave, "REALTEK_DSA");

/**
 * rtl83xx_port_fast_age() - flush dynamic FDB entries learned on a port
 * @ds: DSA switch instance
 * @port: port index
 *
 * This function requests the switch to age out dynamic FDB entries learned on
 * @port.
 *
 * Context: Can sleep.
 * Return: Nothing.
 */
void rtl83xx_port_fast_age(struct dsa_switch *ds, int port)
{
        struct realtek_priv *priv = ds->priv;
        int ret;

        if (!priv->ops->l2_flush) {
                dev_warn_once(priv->dev, "l2_flush op not defined\n");
                return;
        }

        dev_dbg(priv->dev, "fast_age port %d\n", port);

        mutex_lock(&priv->l2_lock);
        ret = priv->ops->l2_flush(priv, port, 0);
        mutex_unlock(&priv->l2_lock);
        if (ret)
                dev_err(priv->dev, "failed to fast age on port %d: %d\n", port,
                        ret);
}
EXPORT_SYMBOL_NS_GPL(rtl83xx_port_fast_age, "REALTEK_DSA");

/**
 * rtl83xx_port_fdb_add() - add a static FDB entry to a port database
 * @ds: DSA switch instance
 * @port: port index
 * @addr: MAC address to add
 * @vid: VLAN ID associated with @addr
 * @db: database where the entry should be added
 *
 * This function adds a static unicast FDB entry to the standalone port
 * database or to a bridge database.
 *
 * Context: Can sleep.
 * Return: 0 on success, negative value for failure.
 */
int rtl83xx_port_fdb_add(struct dsa_switch *ds, int port,
                         const unsigned char *addr, u16 vid,
                         struct dsa_db db)
{
        struct realtek_priv *priv = ds->priv;
        int efid;
        int ret;

        if (is_multicast_ether_addr(addr))
                return -EOPNOTSUPP;

        if (!priv->ops->l2_add_uc)
                return -EOPNOTSUPP;

        if (db.type != DSA_DB_PORT && db.type != DSA_DB_BRIDGE)
                return -EOPNOTSUPP;

        /* Bridge ports use bridge.num as EFID, while standalone ports use
         * EFID 0. FDB entries for the CPU port follow the bridge EFID due
         * to assisted learning.
         */
        efid = db.type == DSA_DB_BRIDGE ? db.bridge.num : 0;

        dev_dbg(priv->dev, "%s: port:%d addr:%pM efid:%d vid:%d dbtype:%d\n",
                __func__, port, addr, efid, vid, db.type);

        mutex_lock(&priv->l2_lock);
        ret = priv->ops->l2_add_uc(priv, port, addr, efid, vid);

        mutex_unlock(&priv->l2_lock);

        if (ret)
                dev_err(priv->dev, "fdb_add ERROR %pe\n", ERR_PTR(ret));
        return ret;
}
EXPORT_SYMBOL_NS_GPL(rtl83xx_port_fdb_add, "REALTEK_DSA");

/**
 * rtl83xx_port_fdb_del() - delete a static FDB entry from a port database
 * @ds: DSA switch instance
 * @port: port index
 * @addr: MAC address to delete
 * @vid: VLAN ID associated with @addr
 * @db: database where the entry should be removed
 *
 * This function deletes a static unicast FDB entry from the standalone port
 * database or from a bridge database.
 *
 * Context: Can sleep.
 * Return: 0 on success, negative value for failure.
 */
int rtl83xx_port_fdb_del(struct dsa_switch *ds, int port,
                         const unsigned char *addr, u16 vid,
                         struct dsa_db db)
{
        struct realtek_priv *priv = ds->priv;
        int efid;
        int ret;

        if (is_multicast_ether_addr(addr))
                return -EOPNOTSUPP;

        if (!priv->ops->l2_del_uc)
                return -EOPNOTSUPP;

        if (db.type != DSA_DB_PORT && db.type != DSA_DB_BRIDGE)
                return -EOPNOTSUPP;

        /*
         * DSA_DB_BRIDGE ports use bridge number [1..N] as EFID, while
         * DSA_DB_PORT use the default EFID (0), not used by any bridge.
         */
        efid = db.type == DSA_DB_BRIDGE ? db.bridge.num : 0;

        dev_dbg(priv->dev, "%s: port:%d addr:%pM efid:%d vid:%d dbtype:%d\n",
                __func__, port, addr, efid, vid, db.type);

        mutex_lock(&priv->l2_lock);
        ret = priv->ops->l2_del_uc(priv, port, addr, efid, vid);
        mutex_unlock(&priv->l2_lock);

        if (ret)
                dev_err(priv->dev, "fdb_del ERROR %pe\n", ERR_PTR(ret));
        return ret;
}
EXPORT_SYMBOL_NS_GPL(rtl83xx_port_fdb_del, "REALTEK_DSA");

/**
 * rtl83xx_port_fdb_dump() - iterate over FDB entries associated with a port
 * @ds: DSA switch instance
 * @port: port index
 * @cb: callback invoked for each entry
 * @data: opaque pointer passed to @cb
 *
 * This function walks the unicast FDB entries associated with @port and calls
 * @cb for each matching entry.
 *
 * Context: Can sleep.
 * Return: 0 on success, or negative value for failure.
 */
int rtl83xx_port_fdb_dump(struct dsa_switch *ds, int port,
                          dsa_fdb_dump_cb_t *cb, void *data)
{
        struct realtek_fdb_entry entry = { 0 };
        struct realtek_priv *priv = ds->priv;
        u16 start_addr, addr = 0;
        int ret = 0;

        if (!priv->ops->l2_get_next_uc)
                return -EOPNOTSUPP;

        mutex_lock(&priv->l2_lock);
        while (true) {
                start_addr = addr;

                dev_dbg(priv->dev, "l2_get_next_uc, addr:%d, port:%d\n",
                        addr, port);
                ret = priv->ops->l2_get_next_uc(priv, &addr, port, &entry);
                dev_dbg(priv->dev,
                        "%s addr:%d mac:%pM vid:%d static:%d ret:%pe\n",
                        __func__, addr, entry.mac_addr, entry.vid,
                        entry.is_static, ERR_PTR(ret));

                if (ret == -ENOENT) {
                        /* If the table is empty, returns without errors. Note
                         * that the l2_get_next_uc overflow to the first match
                         * when it reaches the end of the table.
                         */
                        ret = 0;
                        break;
                }

                if (ret)
                        break;

                /* When the addr returned is before the requested one, it
                 * indicates that we reached the end.
                 */
                if (addr < start_addr)
                        break;

                ret = cb(entry.mac_addr, entry.vid, entry.is_static, data);
                if (ret)
                        break;

                addr++;
        }
        mutex_unlock(&priv->l2_lock);

        return ret;
}
EXPORT_SYMBOL_NS_GPL(rtl83xx_port_fdb_dump, "REALTEK_DSA");

/**
 * rtl83xx_port_mdb_add() - add a multicast database entry to a port database
 * @ds: DSA switch instance
 * @port: port index
 * @mdb: multicast database entry to add
 * @db: database where the entry should be added
 *
 * This function adds a multicast database entry to the standalone port
 * database or to a bridge database.
 *
 * Context: Can sleep.
 * Return: 0 on success, negative value for failure.
 */
int rtl83xx_port_mdb_add(struct dsa_switch *ds, int port,
                         const struct switchdev_obj_port_mdb *mdb,
                         struct dsa_db db)
{
        struct realtek_priv *priv = ds->priv;
        const unsigned char *addr = mdb->addr;
        u16 vid = mdb->vid;
        int efid;
        int ret;

        if (!priv->ops->l2_add_mc)
                return -EOPNOTSUPP;

        if (db.type != DSA_DB_PORT && db.type != DSA_DB_BRIDGE)
                return -EOPNOTSUPP;

        /* EFID is not used by hardware MDB entries; debugging only */
        efid = db.type == DSA_DB_BRIDGE ? db.bridge.num : 0;

        dev_dbg(priv->dev, "%s: port:%d addr:%pM efid:%d vid:%d dbtype:%d\n",
                __func__, port, addr, efid, vid, db.type);

        mutex_lock(&priv->l2_lock);
        ret = priv->ops->l2_add_mc(priv, port, addr, vid);
        mutex_unlock(&priv->l2_lock);

        if (ret)
                dev_err(priv->dev, "mdb_add ERROR %pe\n", ERR_PTR(ret));
        return ret;
}
EXPORT_SYMBOL_NS_GPL(rtl83xx_port_mdb_add, "REALTEK_DSA");

/**
 * rtl83xx_port_mdb_del() - delete a multicast database entry from a port
 * database
 * @ds: DSA switch instance
 * @port: port index
 * @mdb: multicast database entry to delete
 * @db: database where the entry should be removed
 *
 * This function deletes a multicast database entry from the standalone port
 * database or from a bridge database.
 *
 * Context: Can sleep.
 * Return: 0 on success, negative value for failure.
 */
int rtl83xx_port_mdb_del(struct dsa_switch *ds, int port,
                         const struct switchdev_obj_port_mdb *mdb,
                         struct dsa_db db)
{
        struct realtek_priv *priv = ds->priv;
        const unsigned char *addr = mdb->addr;
        u16 vid = mdb->vid;
        int efid;
        int ret;

        if (!priv->ops->l2_del_mc)
                return -EOPNOTSUPP;

        if (db.type != DSA_DB_PORT && db.type != DSA_DB_BRIDGE)
                return -EOPNOTSUPP;

        /* EFID is not used by hardware MDB entries; debugging only */
        efid = db.type == DSA_DB_BRIDGE ? db.bridge.num : 0;

        dev_dbg(priv->dev, "%s: port:%d addr:%pM efid:%d vid:%d dbtype:%d\n",
                __func__, port, addr, efid, vid, db.type);

        mutex_lock(&priv->l2_lock);
        ret = priv->ops->l2_del_mc(priv, port, addr, vid);
        mutex_unlock(&priv->l2_lock);

        if (ret)
                dev_err(priv->dev, "mdb_del ERROR %pe\n", ERR_PTR(ret));
        return ret;
}
EXPORT_SYMBOL_NS_GPL(rtl83xx_port_mdb_del, "REALTEK_DSA");

/**
 * rtl83xx_port_bridge_flags() - set port bridge flags
 * @ds: DSA switch instance
 * @port: port index
 * @flags: bridge port flags
 * @extack: netlink extended ack for reporting errors
 *
 * This function handles setting bridge port flags like learning and flooding.
 *
 * Context: Can sleep.
 * Return: 0 on success, negative value for failure.
 */
int rtl83xx_port_bridge_flags(struct dsa_switch *ds, int port,
                              struct switchdev_brport_flags flags,
                              struct netlink_ext_ack *extack)
{
        struct realtek_priv *priv = ds->priv;
        bool enable;
        int ret;

        if (flags.mask & BR_LEARNING) {
                if (!priv->ops->port_set_learning)
                        return -EOPNOTSUPP;

                enable = !!(flags.val & BR_LEARNING);
                ret = priv->ops->port_set_learning(priv, port, enable);
                if (ret)
                        return ret;
        }

        if (flags.mask & BR_FLOOD) {
                if (!priv->ops->port_set_ucast_flood)
                        return -EOPNOTSUPP;

                enable = !!(flags.val & BR_FLOOD);
                ret = priv->ops->port_set_ucast_flood(priv, port, enable);
                if (ret)
                        return ret;
        }

        if (flags.mask & BR_MCAST_FLOOD) {
                if (!priv->ops->port_set_mcast_flood)
                        return -EOPNOTSUPP;

                enable = !!(flags.val & BR_MCAST_FLOOD);
                ret = priv->ops->port_set_mcast_flood(priv, port, enable);
                if (ret)
                        return ret;
        }

        if (flags.mask & BR_BCAST_FLOOD) {
                if (!priv->ops->port_set_bcast_flood)
                        return -EOPNOTSUPP;

                enable = !!(flags.val & BR_BCAST_FLOOD);
                ret = priv->ops->port_set_bcast_flood(priv, port, enable);
                if (ret)
                        return ret;
        }

        return 0;
}
EXPORT_SYMBOL_NS_GPL(rtl83xx_port_bridge_flags, "REALTEK_DSA");

/**
 * rtl83xx_setup_port_flood_control() - setup default flood control for a port
 * @priv: realtek_priv pointer
 * @port: port index
 *
 * This function enables flooding for a given port.
 *
 * Context: Can sleep.
 * Return: 0 on success, negative value for failure.
 */
int rtl83xx_setup_port_flood_control(struct realtek_priv *priv, int port)
{
        int ret;

        if (priv->ops->port_set_ucast_flood) {
                ret = priv->ops->port_set_ucast_flood(priv, port, true);
                if (ret)
                        return ret;
        }

        if (priv->ops->port_set_mcast_flood) {
                ret = priv->ops->port_set_mcast_flood(priv, port, true);
                if (ret)
                        return ret;
        }

        if (priv->ops->port_set_bcast_flood) {
                ret = priv->ops->port_set_bcast_flood(priv, port, true);
                if (ret)
                        return ret;
        }

        return 0;
}
EXPORT_SYMBOL_NS_GPL(rtl83xx_setup_port_flood_control, "REALTEK_DSA");

MODULE_AUTHOR("Luiz Angelo Daros de Luca <luizluca@gmail.com>");
MODULE_AUTHOR("Linus Walleij <linus.walleij@linaro.org>");
MODULE_DESCRIPTION("Realtek DSA switches common module");
MODULE_LICENSE("GPL");