Hello Florian, thank you for taking the time to comments. My responses inline.
On Sun, Mar 2, 2014 at 6:59 PM, Florian Fainelli <f.fainelli@xxxxxxxxx> wrote:
> Hello Vince,
>
> It might help reviewing the patches by breaking the patches into:
>
> - the SGDMA bits
> - the MSGDMA bits
> - the Ethernet MAC driver per-se
I'll break down the next submission.
>
> BTW, it does look like the SGDMA code could/should be a dmaengine driver?
I did consider this, but after studying the dmaengine api I found the
API definitions and semantics were not a match to the way the SGDMA
and MSGDMA behave collectively. Moreover, I could not find an example
of an Ethernet driver that made use of the dmaengine API - only the
Micrel driver seems to use it. When studying what components actually
used the dmaengine API I concluded the dmaengine API was defined for
use cases different than Ethernet.
>
> Le 02/03/2014 12:42, Vince Bridgers a écrit :
> [snip]
>
>
>> + iowrite32(buffer->dma_addr, &desc->read_addr_lo);
>> + iowrite32(0, &desc->read_addr_hi);
>> + iowrite32(0, &desc->write_addr_lo);
>> + iowrite32(0, &desc->write_addr_hi);
>
I see, will do.
>
> Since there is a HI/LO pair, you might want to break buffer->dma_addr using
> lower_32bits/upper_32bits such that things don't start breaking when a
> platform using that driver is 64-bits/LPAE capable.
>
>
>> + iowrite32(buffer->len, &desc->len);
>> + iowrite32(0, &desc->burst_seq_num);
>> + iowrite32(MSGDMA_DESC_TX_STRIDE, &desc->stride);
>> + iowrite32(MSGDMA_DESC_CTL_TX_SINGLE, &desc->control);
>> + return 0;
>> +}
>
>
> [snip]
>
>
>> +
>> +/* Put buffer to the mSGDMA RX FIFO
>> + */
>> +int msgdma_add_rx_desc(struct altera_tse_private *priv,
>> + struct tse_buffer *rxbuffer)
>> +{
>> + struct msgdma_extended_desc *desc = priv->rx_dma_desc;
>> + u32 len = priv->rx_dma_buf_sz;
>> + dma_addr_t dma_addr = rxbuffer->dma_addr;
>> + u32 control = (MSGDMA_DESC_CTL_END_ON_EOP
>> + | MSGDMA_DESC_CTL_END_ON_LEN
>> + | MSGDMA_DESC_CTL_TR_COMP_IRQ
>> + | MSGDMA_DESC_CTL_EARLY_IRQ
>> + | MSGDMA_DESC_CTL_TR_ERR_IRQ
>> + | MSGDMA_DESC_CTL_GO);
>> +
>> + iowrite32(0, &desc->read_addr_lo);
>> + iowrite32(0, &desc->read_addr_hi);
>> + iowrite32(dma_addr, &desc->write_addr_lo);
>> + iowrite32(0, &desc->write_addr_hi);
>
>
> Same here
Noted
>
>
>> + iowrite32(len, &desc->len);
>> + iowrite32(0, &desc->burst_seq_num);
>> + iowrite32(0x00010001, &desc->stride);
>> + iowrite32(control, &desc->control);
>> + return 1;
>
> [snip]
>
>
>> +
>> +#define RX_DESCRIPTORS 64
>> +static int dma_rx_num = RX_DESCRIPTORS;
>> +module_param(dma_rx_num, int, S_IRUGO | S_IWUSR);
>> +MODULE_PARM_DESC(dma_rx_num, "Number of descriptors in the RX list");
>> +
>> +#define TX_DESCRIPTORS 64
>> +static int dma_tx_num = TX_DESCRIPTORS;
>> +module_param(dma_tx_num, int, S_IRUGO | S_IWUSR);
>> +MODULE_PARM_DESC(dma_tx_num, "Number of descriptors in the TX list");
>
>
> Is this the software number of descriptors or hardware number of
> descriptors?
This number applies to the number of descriptors as limited by the
MSGDMA capabilities. The SGDMA has different limitations and issues,
but the maximum number of descriptors for either DMA engine that can
be used is represented as shown above. This is important since an
unusual hardware configuration could support both SGDMA and MSGDMA
simultaneously for more than one TSE instance. I used a design that
supported a single SGDMA with TSE and a single MSGDMA with TSE for
testing purposes (among other designs). So this a hardware defined
number of descriptors and is fixed.
>
> [snip]
>
>
>> +
>> +static int altera_tse_mdio_create(struct net_device *dev, unsigned int
>> id)
>> +{
>> + struct altera_tse_private *priv = netdev_priv(dev);
>> + int ret;
>> + int i;
>> + struct device_node *mdio_node;
>> + struct mii_bus *mdio;
>> +
>> + mdio_node = of_find_compatible_node(priv->device->of_node, NULL,
>> + "altr,tse-mdio");
>> +
>> + if (mdio_node) {
>> + dev_warn(priv->device, "FOUND MDIO subnode\n");
>> + } else {
>> + dev_warn(priv->device, "NO MDIO subnode\n");
>> + return 0;
>> + }
>> +
>> + mdio = mdiobus_alloc();
>> + if (mdio == NULL) {
>> + dev_err(priv->device, "Error allocating MDIO bus\n");
>> + return -ENOMEM;
>> + }
>> +
>> + mdio->name = ALTERA_TSE_RESOURCE_NAME;
>> + mdio->read = &altera_tse_mdio_read;
>> + mdio->write = &altera_tse_mdio_write;
>> + snprintf(mdio->id, MII_BUS_ID_SIZE, "%s-%u", mdio->name, id);
>
>
> You could use something more user-friendly such as mdio_node->full_name.
The full name will exceed the characters available in that particular
structure data member. MII_BUS_ID_SIZE is defined as (20-3) in
include/linux/phy.h. The full name would exceed the allocated space in
that structure. That's why this method was chosen.
>
>
>> +
>> + mdio->irq = kcalloc(PHY_MAX_ADDR, sizeof(int), GFP_KERNEL);
>> + if (mdio->irq == NULL) {
>> + dev_err(priv->device, "%s: Cannot allocate memory\n",
>> __func__);
>> + ret = -ENOMEM;
>> + goto out_free_mdio;
>> + }
>> + for (i = 0; i < PHY_MAX_ADDR; i++)
>> + mdio->irq[i] = PHY_POLL;
>> +
>> + mdio->priv = (void *)priv->mac_dev;
>
>
> No need for the cast here, this is already a void *.
Noted.
>
>
>> + mdio->parent = priv->device;
>
>
> [snip]
>
>
>> + /* make cache consistent with receive packet buffer */
>> + dma_sync_single_for_cpu(priv->device,
>> + priv->rx_ring[entry].dma_addr,
>> + priv->rx_ring[entry].len,
>> + DMA_FROM_DEVICE);
>> +
>> + dma_unmap_single(priv->device,
>> priv->rx_ring[entry].dma_addr,
>> + priv->rx_ring[entry].len,
>> DMA_FROM_DEVICE);
>> +
>> + /* make sure all pending memory updates are complete */
>> + rmb();
>
>
> Are you sure this does something in your case? I am fairly sure that the
> dma_unmap_single() call would have done that implicitely for you here.
I wrote the code this way intentionally to be explicit. I'll check the
API for behavior as you describe for both ARM and NIOS and if not
handled this barrier should probably remain.
>
> [snip]
>
>
>> + if (txcomplete+rxcomplete != budget) {
>> + napi_gro_flush(napi, false);
>> + __napi_complete(napi);
>> +
>> + dev_dbg(priv->device,
>> + "NAPI Complete, did %d packets with budget %d\n",
>> + txcomplete+rxcomplete, budget);
>> + }
>
>
> That is a bit unusual, a driver usually checks for the RX completion return
> to match upto "budget"; you should reclaim as many TX buffers as needed.
This was an oversight from some churn in this area, will address.
>
>
>> + spin_lock_irqsave(&priv->rxdma_irq_lock, flags);
>> + priv->enable_rxirq(priv);
>> + priv->enable_txirq(priv);
>> + spin_unlock_irqrestore(&priv->rxdma_irq_lock, flags);
>> + return rxcomplete + txcomplete;
>> +}
>> +
>> +/* DMA TX & RX FIFO interrupt routing
>> + */
>> +static irqreturn_t altera_isr(int irq, void *dev_id)
>> +{
>> + struct net_device *dev = dev_id;
>> + struct altera_tse_private *priv;
>> + unsigned long int flags;
>> +
>> +
>> + if (unlikely(!dev)) {
>> + pr_err("%s: invalid dev pointer\n", __func__);
>> + return IRQ_NONE;
>> + }
>> + priv = netdev_priv(dev);
>> +
>> + /* turn off desc irqs and enable napi rx */
>> + spin_lock_irqsave(&priv->rxdma_irq_lock, flags);
>> +
>> + if (likely(napi_schedule_prep(&priv->napi))) {
>> + priv->disable_rxirq(priv);
>> + priv->disable_txirq(priv);
>> + __napi_schedule(&priv->napi);
>> + }
>> +
>> + /* reset IRQs */
>> + priv->clear_rxirq(priv);
>> + priv->clear_txirq(priv);
>> +
>> + spin_unlock_irqrestore(&priv->rxdma_irq_lock, flags);
>> +
>> + return IRQ_HANDLED;
>> +}
>> +
>> +/* Transmit a packet (called by the kernel). Dispatches
>> + * either the SGDMA method for transmitting or the
>> + * MSGDMA method, assumes no scatter/gather support,
>> + * implying an assumption that there's only one
>> + * physically contiguous fragment starting at
>> + * skb->data, for length of skb_headlen(skb).
>> + */
>> +static int tse_start_xmit(struct sk_buff *skb, struct net_device *dev)
>> +{
>> + struct altera_tse_private *priv = netdev_priv(dev);
>> + unsigned int txsize = priv->tx_ring_size;
>> + unsigned int entry;
>> + struct tse_buffer *buffer = NULL;
>> + int nfrags = skb_shinfo(skb)->nr_frags;
>> + unsigned int nopaged_len = skb_headlen(skb);
>> + enum netdev_tx ret = NETDEV_TX_OK;
>> + dma_addr_t dma_addr;
>> + int txcomplete = 0;
>> +
>> + spin_lock_bh(&priv->tx_lock);
>> +
>> + if (unlikely(nfrags)) {
>> + dev_err(priv->device,
>> + "%s: nfrags must be 0, SG not supported\n",
>> __func__);
>> + ret = NETDEV_TX_BUSY;
>> + goto out;
>> + }
>
>
> I am not sure this will even be triggered if you want do not advertise
> NETIF_F_SG, so you might want to drop that entirely.
The intent was to add Scatter Gather capabilities at some point in the
future, so this was a form of documenting. I'll just drop the code and
add a comment instead if you agree.
>
>
>> +
>> + if (unlikely(tse_tx_avail(priv) < nfrags + 1)) {
>> + if (!netif_queue_stopped(dev)) {
>> + netif_stop_queue(dev);
>> + /* This is a hard error, log it. */
>> + dev_err(priv->device,
>> + "%s: Tx list full when queue awake\n",
>> + __func__);
>> + }
>> + ret = NETDEV_TX_BUSY;
>> + goto out;
>> + }
>> +
>> + /* Map the first skb fragment */
>> + entry = priv->tx_prod % txsize;
>> + buffer = &priv->tx_ring[entry];
>> +
>> + dma_addr = dma_map_single(priv->device, skb->data, nopaged_len,
>> + DMA_TO_DEVICE);
>> + if (dma_mapping_error(priv->device, dma_addr)) {
>> + dev_err(priv->device, "%s: DMA mapping error\n",
>> __func__);
>> + ret = NETDEV_TX_BUSY;
>
>
> NETDEV_TX_BUSY should only be returned in case you are attempting to queue
> more packets than available, you want to return NETDEV_TX_OK here.
Noted
>
>
>> + goto out;
>> + }
>> +
>> + buffer->skb = skb;
>> + buffer->dma_addr = dma_addr;
>> + buffer->len = nopaged_len;
>> +
>> + /* Push data out of the cache hierarchy into main memory */
>> + dma_sync_single_for_device(priv->device, buffer->dma_addr,
>> + buffer->len, DMA_TO_DEVICE);
>> +
>> + /* Make sure the write buffers are bled ahead of initiated the I/O
>> */
>> + wmb();
>> +
>> + txcomplete = priv->tx_buffer(priv, buffer);
>> +
>> + priv->tx_prod++;
>> + dev->stats.tx_bytes += skb->len;
>> +
>> + if (unlikely(tse_tx_avail(priv) <= 2)) {
>
>
> Why the value 2? Use a constant for this.
Noted, will change the "magic number" to a constant
>
> [snip]
>
>
>> +/* Initialize driver's PHY state, and attach to the PHY
>> + */
>> +static int init_phy(struct net_device *dev)
>> +{
>> + struct altera_tse_private *priv = netdev_priv(dev);
>> + struct phy_device *phydev;
>> + struct device_node *phynode;
>> +
>> + priv->oldlink = 0;
>> + priv->oldspeed = 0;
>> + priv->oldduplex = -1;
>> +
>> + phynode = of_parse_phandle(priv->device->of_node, "phy-handle",
>> 0);
>> +
>> + if (!phynode) {
>> + netdev_warn(dev, "no phy-handle found\n");
>> + if (!priv->mdio) {
>> + netdev_err(dev,
>> + "No phy-handle nor local mdio
>> specified\n");
>> + return -ENODEV;
>> + }
>> + phydev = connect_local_phy(dev);
>> + } else {
>> + netdev_warn(dev, "phy-handle found\n");
>> + phydev = of_phy_connect(dev, phynode,
>> + &altera_tse_adjust_link, 0, priv->phy_iface);
>> + }
>> +
>> + /* Stop Advertising 1000BASE Capability if interface is not GMII
>> + * Note: Checkpatch throws CHECKs for the camel case defines
>> below,
>> + * it's ok to ignore.
>> + */
>> + if ((priv->phy_iface == PHY_INTERFACE_MODE_MII) ||
>> + (priv->phy_iface == PHY_INTERFACE_MODE_RMII))
>> + phydev->advertising &= ~(SUPPORTED_1000baseT_Half |
>> + SUPPORTED_1000baseT_Full);
>> +
>> + /* Broken HW is sometimes missing the pull-up resistor on the
>> + * MDIO line, which results in reads to non-existent devices
>> returning
>> + * 0 rather than 0xffff. Catch this here and treat 0 as a
>> non-existent
>> + * device as well.
>> + * Note: phydev->phy_id is the result of reading the UID PHY
>> registers.
>> + */
>> + if (phydev->phy_id == 0) {
>> + netdev_err(dev, "Bad PHY UID 0x%08x\n", phydev->phy_id);
>> + phy_disconnect(phydev);
>> + return -ENODEV;
>> + }
>> +
>> + dev_dbg(priv->device, "attached to PHY %d UID 0x%08x Link = %d\n",
>> + phydev->addr, phydev->phy_id, phydev->link);
>> +
>> + priv->phydev = phydev;
>> + return 0;
>
>
> You might rather do this during your driver probe function rather than in
> the ndo_open() callback.
This seems to be the normal place to probe and initialize the phy from
examination of existing code. Perhaps I missed something, could you
provide an example of where this is done differently?
>
> [snip]
>
>
>> + /* Stop and disconnect the PHY */
>> + if (priv->phydev) {
>> + phy_stop(priv->phydev);
>> + phy_disconnect(priv->phydev);
>> + priv->phydev = NULL;
>> + }
>> +
>> + netif_stop_queue(dev);
>> + napi_disable(&priv->napi);
>> +
>> + /* Disable DMA interrupts */
>> + spin_lock_irqsave(&priv->rxdma_irq_lock, flags);
>> + priv->disable_rxirq(priv);
>> + priv->disable_txirq(priv);
>> + spin_unlock_irqrestore(&priv->rxdma_irq_lock, flags);
>> +
>> + /* Free the IRQ lines */
>> + free_irq(priv->rx_irq, dev);
>> + free_irq(priv->tx_irq, dev);
>> +
>> + /* disable and reset the MAC, empties fifo */
>> + spin_lock(&priv->mac_cfg_lock);
>> + spin_lock(&priv->tx_lock);
>> +
>> + ret = reset_mac(priv);
>> + if (ret)
>> + netdev_err(dev, "Cannot reset MAC core (error: %d)\n",
>> ret);
>> + priv->reset_dma(priv);
>> + free_skbufs(dev);
>> +
>> + spin_unlock(&priv->tx_lock);
>> + spin_unlock(&priv->mac_cfg_lock);
>> +
>> + priv->uninit_dma(priv);
>> +
>> + netif_carrier_off(dev);
>
>
> phy_stop() does that already.
If you mean phy_stop calls netif_carrier_off, I don't see it in that
function (phy/phy.c). Common usage in the intree drivers seems to be
calling netif_carrier_off in this context, but perhaps the drivers I
examined have not been updated. Is there some more specific feedback
or comments that you could provide here? Do you mean that
netif_carrier_off is unnecessary here?
>
>
>> +
>> + return 0;
>> +}
>> +
>> +static struct net_device_ops altera_tse_netdev_ops = {
>> + .ndo_open = tse_open,
>> + .ndo_stop = tse_shutdown,
>> + .ndo_start_xmit = tse_start_xmit,
>> + .ndo_set_mac_address = eth_mac_addr,
>> + .ndo_set_rx_mode = tse_set_rx_mode,
>> + .ndo_change_mtu = tse_change_mtu,
>> + .ndo_validate_addr = eth_validate_addr,
>> +};
>> +
>> +static int altera_tse_get_of_prop(struct platform_device *pdev,
>> + const char *name, unsigned int *val)
>> +{
>> + const __be32 *tmp;
>> + int len;
>> + char buf[strlen(name)+1];
>> +
>> + tmp = of_get_property(pdev->dev.of_node, name, &len);
>> + if (!tmp && !strncmp(name, "altr,", 5)) {
>> + strcpy(buf, name);
>> + strncpy(buf, "ALTR,", 5);
>> + tmp = of_get_property(pdev->dev.of_node, buf, &len);
>> + }
>> + if (!tmp || (len < sizeof(__be32)))
>> + return -ENODEV;
>> +
>> + *val = be32_to_cpup(tmp);
>> + return 0;
>> +}
>
>
> Do we really need that abstration?
The intent here is to support legacy device trees that were created
with upper case "ALTR".
>
>
>> +
>> +static int altera_tse_get_phy_iface_prop(struct platform_device *pdev,
>> + phy_interface_t *iface)
>> +{
>> + const void *prop;
>> + int len;
>> +
>> + prop = of_get_property(pdev->dev.of_node, "phy-mode", &len);
>> + if (!prop)
>> + return -ENOENT;
>> + if (len < 4)
>> + return -EINVAL;
>> +
>> + if (!strncmp((char *)prop, "mii", 3)) {
>> + *iface = PHY_INTERFACE_MODE_MII;
>> + return 0;
>> + } else if (!strncmp((char *)prop, "gmii", 4)) {
>> + *iface = PHY_INTERFACE_MODE_GMII;
>> + return 0;
>> + } else if (!strncmp((char *)prop, "rgmii-id", 8)) {
>> + *iface = PHY_INTERFACE_MODE_RGMII_ID;
>> + return 0;
>> + } else if (!strncmp((char *)prop, "rgmii", 5)) {
>> + *iface = PHY_INTERFACE_MODE_RGMII;
>> + return 0;
>> + } else if (!strncmp((char *)prop, "sgmii", 5)) {
>> + *iface = PHY_INTERFACE_MODE_SGMII;
>> + return 0;
>> + }
>
>
> of_get_phy_mode() does that for you.
Will address this. Thank you.
>
>
>> +
>> + return -EINVAL;
>> +}
>> +
>> +static int request_and_map(struct platform_device *pdev, const char
>> *name,
>> + struct resource **res, void __iomem **ptr)
>> +{
>> + struct resource *region;
>> + struct device *device = &pdev->dev;
>> +
>> + *res = platform_get_resource_byname(pdev, IORESOURCE_MEM, name);
>> + if (*res == NULL) {
>> + dev_err(device, "resource %s not defined\n", name);
>> + return -ENODEV;
>> + }
>> +
>> + region = devm_request_mem_region(device, (*res)->start,
>> + resource_size(*res),
>> dev_name(device));
>> + if (region == NULL) {
>> + dev_err(device, "unable to request %s\n", name);
>> + return -EBUSY;
>> + }
>> +
>> + *ptr = devm_ioremap_nocache(device, region->start,
>> + resource_size(region));
>> + if (*ptr == NULL) {
>> + dev_err(device, "ioremap_nocache of %s failed!", name);
>> + return -ENOMEM;
>> + }
>> +
>> + return 0;
>> +}
>> +
>> +/* Probe Altera TSE MAC device
>> + */
>> +static int altera_tse_probe(struct platform_device *pdev)
>> +{
>> + struct net_device *ndev;
>> + int ret = -ENODEV;
>> + struct resource *control_port;
>> + struct resource *dma_res;
>> + struct altera_tse_private *priv;
>> + int len;
>> + const unsigned char *macaddr;
>> + struct device_node *np = pdev->dev.of_node;
>> + unsigned int descmap;
>> +
>> + ndev = alloc_etherdev(sizeof(struct altera_tse_private));
>> + if (!ndev) {
>> + dev_err(&pdev->dev, "Could not allocate network
>> device\n");
>> + return -ENODEV;
>> + }
>> +
>> + SET_NETDEV_DEV(ndev, &pdev->dev);
>> +
>> + priv = netdev_priv(ndev);
>> + priv->device = &pdev->dev;
>> + priv->dev = ndev;
>> + priv->msg_enable = netif_msg_init(debug, default_msg_level);
>> +
>> + if (of_device_is_compatible(np, "altr,tse-1.0") ||
>> + of_device_is_compatible(np, "ALTR,tse-1.0")) {
>
>
> Use the .data pointer associated with the compatible string to help you do
> that, see below.
Noted. If we can agree that use of the dmaengine api is inappropriate
in this case, I'll update the code to use a .data pointer as
suggested. Thank you for the comment.
>
> [snip]
>
>
>> + /* get supplemental address settings for this instance */
>> + ret = altera_tse_get_of_prop(pdev, "altr,enable-sup-addr",
>> + &priv->added_unicast);
>> + if (ret)
>> + priv->added_unicast = 0;
>> +
>> + /* Max MTU is 1500, ETH_DATA_LEN */
>> + priv->max_mtu = ETH_DATA_LEN;
>
>
> How about VLANs? If this is always 1500, just let the core ethernet
> functions configure the MTU for your interface.
The TSE core handles frame size expansion for VLAN tagged frames, so
it's ok (tested). At some point, frame sizes > 1518 may be supported
(the core supports Jumbo frames, the driver is intentionally simple
for initial submission). Your comment is noted, I accept the
suggestion.
>
>
>> +
>> + /* The DMA buffer size already accounts for an alignment bias
>> + * to avoid unaligned access exceptions for the NIOS processor,
>> + */
>> + priv->rx_dma_buf_sz = ALTERA_RXDMABUFFER_SIZE;
>> +
>> + /* get default MAC address from device tree */
>> + macaddr = of_get_property(pdev->dev.of_node, "local-mac-address",
>> &len);
>> + if (macaddr && len == ETH_ALEN)
>> + memcpy(ndev->dev_addr, macaddr, ETH_ALEN);
>> +
>> + /* If we didn't get a valid address, generate a random one */
>> + if (!is_valid_ether_addr(ndev->dev_addr))
>> + eth_hw_addr_random(ndev);
>> +
>> + ret = altera_tse_get_phy_iface_prop(pdev, &priv->phy_iface);
>> + if (ret == -ENOENT) {
>> + /* backward compatability, assume RGMII */
>> + dev_warn(&pdev->dev,
>> + "cannot obtain PHY interface mode, assuming
>> RGMII\n");
>> + priv->phy_iface = PHY_INTERFACE_MODE_RGMII;
>> + } else if (ret) {
>> + dev_err(&pdev->dev, "unknown PHY interface mode\n");
>> + goto out_free;
>> + }
>> +
>> + /* try to get PHY address from device tree, use PHY autodetection
>> if
>> + * no valid address is given
>> + */
>> + ret = altera_tse_get_of_prop(pdev, "altr,phy-addr",
>> &priv->phy_addr);
>> + if (ret)
>> + priv->phy_addr = POLL_PHY;
>
>
> Please do not use such as custom property, either you use an Ethernet PHY
> device tree node as described in ePAPR; or you do not and use a fixed-link
> property instead.
Agreed, the code tries phy handles as described in the ePAPR v1.1
specification, then falls back to the method in question. The intent
is to support legacy device trees as well. Is there a preferred way to
handle legacy configurations that we may encounter in the wild?
>
>
>> +
>> + if (!((priv->phy_addr == POLL_PHY) ||
>> + ((priv->phy_addr >= 0) && (priv->phy_addr < PHY_MAX_ADDR))))
>> {
>> + dev_err(&pdev->dev, "invalid altr,phy-addr specified
>> %d\n",
>> + priv->phy_addr);
>> + goto out_free;
>> + }
>> +
>> + /* Create/attach to MDIO bus */
>> + ret = altera_tse_mdio_create(ndev,
>> + atomic_add_return(1,
>> &instance_count));
>> +
>> + if (ret)
>> + goto out_free;
>> +
>> + /* initialize netdev */
>> + ether_setup(ndev);
>> + ndev->mem_start = control_port->start;
>> + ndev->mem_end = control_port->end;
>> + ndev->netdev_ops = &altera_tse_netdev_ops;
>> + altera_tse_set_ethtool_ops(ndev);
>> +
>> + altera_tse_netdev_ops.ndo_set_rx_mode = tse_set_rx_mode;
>> +
>> + if (priv->hash_filter)
>> + altera_tse_netdev_ops.ndo_set_rx_mode =
>> + tse_set_rx_mode_hashfilter;
>> +
>> + /* Scatter/gather IO is not supported,
>> + * so it is turned off
>> + */
>> + ndev->hw_features &= ~NETIF_F_SG;
>> + ndev->features |= ndev->hw_features | NETIF_F_HIGHDMA;
>> +
>> + /* VLAN offloading of tagging, stripping and filtering is not
>> + * supported by hardware, but driver will accommodate the
>> + * extra 4-byte VLAN tag for processing by upper layers
>> + */
>> + ndev->features |= NETIF_F_HW_VLAN_CTAG_RX;
>> +
>> + /* setup NAPI interface */
>> + netif_napi_add(ndev, &priv->napi, tse_poll, NAPI_POLL_WEIGHT);
>> +
>> + spin_lock_init(&priv->mac_cfg_lock);
>> + spin_lock_init(&priv->tx_lock);
>> + spin_lock_init(&priv->rxdma_irq_lock);
>> +
>> + ret = register_netdev(ndev);
>> + if (ret) {
>> + dev_err(&pdev->dev, "failed to register TSE net
>> device\n");
>> + goto out_free_mdio;
>> + }
>> +
>> + platform_set_drvdata(pdev, ndev);
>> +
>> + priv->revision = ioread32(&priv->mac_dev->megacore_revision);
>> +
>> + if (netif_msg_probe(priv))
>> + dev_info(&pdev->dev, "Altera TSE MAC version %d.%d at
>> 0x%08lx irq %d/%d\n",
>> + (priv->revision >> 8) & 0xff,
>> + priv->revision & 0xff,
>> + (unsigned long) control_port->start,
>> priv->rx_irq,
>> + priv->tx_irq);
>> + return 0;
>> +
>> +out_free_mdio:
>> + altera_tse_mdio_destroy(ndev);
>> +out_free:
>> + free_netdev(ndev);
>> + return ret;
>> +}
>> +
>> +/* Remove Altera TSE MAC device
>> + */
>> +static int altera_tse_remove(struct platform_device *pdev)
>> +{
>> + struct net_device *ndev = platform_get_drvdata(pdev);
>> +
>> + platform_set_drvdata(pdev, NULL);
>> + if (ndev) {
>> + altera_tse_mdio_destroy(ndev);
>> + netif_carrier_off(ndev);
>
>
> That call is not needed; the interface would be brought down before. Is
> there a case where we might get called with ndev NULLL?
Noted. There is not a case I'm aware of. The author was being cautious.
>
>
>> + unregister_netdev(ndev);
>> + free_netdev(ndev);
>> + }
>> +
>> + return 0;
>> +}
>> +
>> +static struct of_device_id altera_tse_of_match[] = {
>> + { .compatible = "altr,tse-1.0", },
>> + { .compatible = "ALTR,tse-1.0", },
>> + { .compatible = "altr,tse-msgdma-1.0", },
>
>
> I would use a .data pointer here to help assigning the DMA engine
> configuration which is done in the probe routine of the driver, see the FEC
> or bcmgenet driver for examples.
Noted.
>
>
>> + {},
>> +};
>> +MODULE_DEVICE_TABLE(of, altera_tse_of_match);
>> +
>> +static struct platform_driver altera_tse_driver = {
>> + .probe = altera_tse_probe,
>> + .remove = altera_tse_remove,
>> + .suspend = NULL,
>> + .resume = NULL,
>> + .driver = {
>> + .name = ALTERA_
>
>
> ,
>>
>> + .owner = THIS_MODULE,
>> + .of_match_table = altera_tse_of_match,
>> + },
>> +};
>> +
>> +module_platform_driver(altera_tse_driver);
>> +
>> +MODULE_AUTHOR("Altera Corporation");
>> +MODULE_DESCRIPTION("Altera Triple Speed Ethernet MAC driver");
>> +MODULE_LICENSE("GPL v2");
>
>
> [snip]
>
>> +static void tse_get_drvinfo(struct net_device *dev,
>> + struct ethtool_drvinfo *info)
>>
>> +{
>> + struct altera_tse_private *priv = netdev_priv(dev);
>> + u32 rev = ioread32(&priv->mac_dev->megacore_revision);
>> +
>> + strcpy(info->driver, "Altera TSE MAC IP Driver");
>> + strcpy(info->version, "v8.0");
>> + snprintf(info->fw_version, ETHTOOL_FWVERS_LEN, "v%d.%d",
>> + rev & 0xFFFF, (rev & 0xFFFF0000) >> 16);
>> + sprintf(info->bus_info, "AVALON");
>
>
> "platform" would be more traditional than "AVALON" which is supposedly some
> internal SoC bussing right? In general we want to tell user-space whether
> this is PCI(e), USB, on-chip or something entirely different.
Noted, I'll change to platform. Thank you.
> --
> Florian
--
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
