master/ethernet.c
author Florian Pose <fp@igh-essen.com>
Mon, 08 May 2006 16:46:43 +0000
changeset 217 dcfd406e7786
parent 216 e7f3e485c5b8
child 218 80fb87518f3d
permissions -rw-r--r--
EoE - TX fragmenting works. TCP traffic possible.
/******************************************************************************
 *
 *  $Id$
 *
 *  Copyright (C) 2006  Florian Pose, Ingenieurgemeinschaft IgH
 *
 *  This file is part of the IgH EtherCAT Master.
 *
 *  The IgH EtherCAT Master is free software; you can redistribute it
 *  and/or modify it under the terms of the GNU General Public License
 *  as published by the Free Software Foundation; version 2 of the License.
 *
 *  The IgH EtherCAT Master is distributed in the hope that it will be
 *  useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with the IgH EtherCAT Master; if not, write to the Free Software
 *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 *
 *****************************************************************************/

/**
   \file
   Ethernet-over-EtherCAT (EoE).
*/

/*****************************************************************************/

#include <linux/etherdevice.h>

#include "../include/ecrt.h"
#include "globals.h"
#include "master.h"
#include "slave.h"
#include "mailbox.h"
#include "ethernet.h"

#define EOE_DEBUG_LEVEL 0

/*****************************************************************************/

void ec_eoe_flush(ec_eoe_t *);
void ec_eoedev_init(struct net_device *);
int ec_eoedev_open(struct net_device *);
int ec_eoedev_stop(struct net_device *);
int ec_eoedev_tx(struct sk_buff *, struct net_device *);
struct net_device_stats *ec_eoedev_stats(struct net_device *);
void ec_eoedev_rx(struct net_device *, const uint8_t *, size_t);

/*****************************************************************************/

/**
   EoE constructor.
*/

int ec_eoe_init(ec_eoe_t *eoe, ec_slave_t *slave)
{
    ec_eoe_t **priv;
    int result;

    eoe->slave = slave;
    eoe->state = EC_EOE_RX_START;
    eoe->opened = 0;
    eoe->skb = NULL;
    eoe->expected_fragment = 0;
    INIT_LIST_HEAD(&eoe->tx_queue);
    eoe->tx_queue_active = 0;
    eoe->queued_frames = 0;
    eoe->tx_queue_lock = SPIN_LOCK_UNLOCKED;
    eoe->tx_frame_number = 0xFF;
    memset(&eoe->stats, 0, sizeof(struct net_device_stats));

    if (!(eoe->dev =
          alloc_netdev(sizeof(ec_eoe_t *), "eoe%d", ec_eoedev_init))) {
        EC_ERR("Unable to allocate net_device for EoE object!\n");
        goto out_return;
    }

    // set EoE object reference
    priv = netdev_priv(eoe->dev);
    *priv = eoe;

    eoe->dev->mtu = slave->sii_rx_mailbox_size - ETH_HLEN - 10;

    // connect the net_device to the kernel
    if ((result = register_netdev(eoe->dev))) {
        EC_ERR("Unable to register net_device: error %i\n", result);
        goto out_free;
    }

    return 0;

 out_free:
    free_netdev(eoe->dev);
    eoe->dev = NULL;
 out_return:
    return -1;
}

/*****************************************************************************/

/**
   EoE destructor.
*/

void ec_eoe_clear(ec_eoe_t *eoe)
{
    if (eoe->dev) {
        unregister_netdev(eoe->dev);
        free_netdev(eoe->dev);
    }

    // empty transmit queue
    ec_eoe_flush(eoe);
}

/*****************************************************************************/

/**
   Empties the transmit queue.
*/

void ec_eoe_flush(ec_eoe_t *eoe)
{
    ec_eoe_frame_t *frame, *next;

    spin_lock_bh(&eoe->tx_queue_lock);

    list_for_each_entry_safe(frame, next, &eoe->tx_queue, queue) {
        list_del(&frame->queue);
        dev_kfree_skb(frame->skb);
        kfree(frame);
    }
    eoe->queued_frames = 0;

    spin_unlock_bh(&eoe->tx_queue_lock);
}

/*****************************************************************************/

/**
   Sends a frame or the next fragment.
*/

int ec_eoe_send(ec_eoe_t *eoe)
{
    ec_eoe_frame_t *frame = eoe->tx_frame;
    size_t remaining_size, current_size, complete_offset;
    unsigned int last_fragment;
    uint8_t *data;
#if EOE_DEBUG_LEVEL > 1
    unsigned int i;
#endif

    remaining_size = frame->skb->len - eoe->tx_offset;

    if (remaining_size <= eoe->slave->sii_tx_mailbox_size - 10) {
        current_size = remaining_size;
        last_fragment = 1;
    }
    else {
        current_size = ((eoe->slave->sii_tx_mailbox_size - 10) / 32) * 32;
        last_fragment = 0;
    }

    if (eoe->tx_fragment_number) {
        complete_offset = eoe->tx_offset / 32;
    }
    else {
        complete_offset = remaining_size / 32 + 1;
    }

#if EOE_DEBUG_LEVEL > 0
    EC_DBG("EoE TX sending %sfragment %i with %i octets (%i)."
           " %i frames queued.\n", last_fragment ? "last " : "",
           eoe->tx_fragment_number, current_size, complete_offset,
           eoe->queued_frames);
#endif

#if EOE_DEBUG_LEVEL > 1
    EC_DBG("");
    for (i = 0; i < current_size; i++) {
        printk("%02X ", frame->skb->data[eoe->tx_offset + i]);
        if ((i + 1) % 16 == 0) {
            printk("\n");
            EC_DBG("");
        }
    }
    printk("\n");
#endif

    if (!(data = ec_slave_mbox_prepare_send(eoe->slave, 0x02,
                                            current_size + 4)))
        return -1;

    EC_WRITE_U8 (data,     0x00); // eoe fragment req.
    EC_WRITE_U8 (data + 1, last_fragment);
    EC_WRITE_U16(data + 2, ((eoe->tx_fragment_number & 0x3F) |
                            (complete_offset & 0x3F) << 6 |
                            (eoe->tx_frame_number & 0x0F) << 12));

    memcpy(data + 4, frame->skb->data + eoe->tx_offset, current_size);
    ec_master_queue_command(eoe->slave->master, &eoe->slave->mbox_command);

    eoe->tx_offset += current_size;
    eoe->tx_fragment_number++;

    return 0;
}

/*****************************************************************************/

/**
   Runs the EoE state machine.
*/

void ec_eoe_run(ec_eoe_t *eoe)
{
    uint8_t *data;
    ec_master_t *master;
    size_t rec_size, data_size;
    off_t offset;
    uint8_t fragment_number, frame_number, last_fragment, time_appended;
    uint8_t fragment_offset, frame_type;
    ec_eoe_frame_t *frame;
    unsigned int wakeup = 0;
#if EOE_DEBUG_LEVEL > 1
    unsigned int i;
#endif

    if (!eoe->opened) return;

    master = eoe->slave->master;

    switch (eoe->state) {
        case EC_EOE_RX_START:
            ec_slave_mbox_prepare_check(eoe->slave);
            ec_master_queue_command(master, &eoe->slave->mbox_command);
            eoe->state = EC_EOE_RX_CHECK;
            break;

        case EC_EOE_RX_CHECK:
            if (eoe->slave->mbox_command.state != EC_CMD_RECEIVED) {
                eoe->stats.rx_errors++;
                eoe->state = EC_EOE_TX_START;
                break;
            }
            if (!ec_slave_mbox_check(eoe->slave)) {
                eoe->state = EC_EOE_TX_START;
                break;
            }
            ec_slave_mbox_prepare_fetch(eoe->slave);
            ec_master_queue_command(master, &eoe->slave->mbox_command);
            eoe->state = EC_EOE_RX_FETCH;
            break;

        case EC_EOE_RX_FETCH:
            if (eoe->slave->mbox_command.state != EC_CMD_RECEIVED) {
                eoe->stats.rx_errors++;
                eoe->state = EC_EOE_TX_START;
                break;
            }
            if (!(data = ec_slave_mbox_fetch(eoe->slave, 0x02, &rec_size))) {
                eoe->stats.rx_errors++;
                eoe->state = EC_EOE_TX_START;
                break;
            }

            frame_type = EC_READ_U16(data) & 0x000F;

            if (frame_type == 0x00) { // EoE Fragment Request
                last_fragment = (EC_READ_U16(data) >> 8) & 0x0001;
                time_appended = (EC_READ_U16(data) >> 9) & 0x0001;
                fragment_number = EC_READ_U16(data + 2) & 0x003F;
                fragment_offset = (EC_READ_U16(data + 2) >> 6) & 0x003F;
                frame_number = (EC_READ_U16(data + 2) >> 12) & 0x000F;

#if EOE_DEBUG_LEVEL > 0
                EC_DBG("EoE RX fragment %i, offset %i, frame %i%s%s,"
                       " %i octets\n", fragment_number, fragment_offset,
                       frame_number,
                       last_fragment ? ", last fragment" : "",
                       time_appended ? ", + timestamp" : "",
                       time_appended ? rec_size - 8 : rec_size - 4);

#if EOE_DEBUG_LEVEL > 1
                EC_DBG("");
                for (i = 0; i < rec_size - 4; i++) {
                    printk("%02X ", data[i + 4]);
                    if ((i + 1) % 16 == 0) {
                        printk("\n");
                        EC_DBG("");
                    }
                }
                printk("\n");
#endif
#endif

                data_size = time_appended ? rec_size - 8 : rec_size - 4;

                if (!fragment_number) {
                    if (eoe->skb) {
                        EC_WARN("EoE RX freeing old socket buffer...\n");
                        dev_kfree_skb(eoe->skb);
                    }

                    // new socket buffer
                    if (!(eoe->skb = dev_alloc_skb(fragment_offset * 32))) {
                        if (printk_ratelimit())
                            EC_WARN("EoE RX low on mem. frame dropped.\n");
                        eoe->stats.rx_dropped++;
                        eoe->state = EC_EOE_TX_START;
                        break;
                    }
                    eoe->skb_offset = 0;
                    eoe->skb_size = fragment_offset * 32;
                    eoe->expected_fragment = 0;
                }
                else {
                    if (!eoe->skb) {
                        eoe->stats.rx_dropped++;
                        eoe->state = EC_EOE_TX_START;
                        break;
                    }

                    offset = fragment_offset * 32;
                    if (offset != eoe->skb_offset ||
                        offset + data_size > eoe->skb_size ||
                        fragment_number != eoe->expected_fragment) {
                        eoe->stats.rx_errors++;
                        eoe->state = EC_EOE_TX_START;
                        dev_kfree_skb(eoe->skb);
                        eoe->skb = NULL;
                        break;
                    }
                }

                // copy fragment into socket buffer
                memcpy(skb_put(eoe->skb, data_size), data + 4, data_size);
                eoe->skb_offset += data_size;

                if (last_fragment) {
                    // update statistics
                    eoe->stats.rx_packets++;
                    eoe->stats.rx_bytes += eoe->skb->len;

#if EOE_DEBUG_LEVEL > 0
                    EC_DBG("EoE RX frame completed with %u octets.\n",
                           eoe->skb->len);
#endif

                    // pass socket buffer to network stack
                    eoe->skb->dev = eoe->dev;
                    eoe->skb->protocol = eth_type_trans(eoe->skb, eoe->dev);
                    eoe->skb->ip_summed = CHECKSUM_UNNECESSARY;
                    //eoe->skb->pkt_type = PACKET_HOST;
                    if (netif_rx(eoe->skb)) {
                        EC_WARN("EoE RX netif_rx failed.\n");
                    }
                    eoe->skb = NULL;

                    eoe->state = EC_EOE_TX_START;
                }
                else {
                    eoe->expected_fragment++;
#if EOE_DEBUG_LEVEL > 0
                    EC_DBG("EoE RX expecting fragment %i\n",
                           eoe->expected_fragment);
#endif
                    eoe->state = EC_EOE_RX_START;
                }
            }
            else {
#if EOE_DEBUG_LEVEL > 0
                EC_DBG("other frame received.\n");
#endif
                eoe->stats.rx_dropped++;
                eoe->state = EC_EOE_TX_START;
            }
            break;

        case EC_EOE_TX_START:
            spin_lock_bh(&eoe->tx_queue_lock);

            if (!eoe->queued_frames || list_empty(&eoe->tx_queue)) {
                spin_unlock_bh(&eoe->tx_queue_lock);
                eoe->state = EC_EOE_RX_START;
                break;
            }

            // take the first frame out of the queue
            frame = list_entry(eoe->tx_queue.next, ec_eoe_frame_t, queue);
            list_del(&frame->queue);
            if (!eoe->tx_queue_active &&
                eoe->queued_frames == EC_EOE_TX_QUEUE_SIZE / 2) {
                netif_wake_queue(eoe->dev);
                eoe->tx_queue_active = 1;
                wakeup = 1;
            }
            eoe->queued_frames--;
            spin_unlock_bh(&eoe->tx_queue_lock);

            eoe->tx_frame_number++;
            eoe->tx_frame_number %= 16;
            eoe->tx_frame = frame;
            eoe->tx_fragment_number = 0;
            eoe->tx_offset = 0;

            if (ec_eoe_send(eoe)) {
                dev_kfree_skb(frame->skb);
                kfree(frame);
                eoe->stats.tx_errors++;
                eoe->state = EC_EOE_RX_START;
                break;
            }

#if EOE_DEBUG_LEVEL > 0
            if (wakeup) EC_DBG("waking up TX queue...\n");
#endif

            eoe->state = EC_EOE_TX_SENT;
            break;

        case EC_EOE_TX_SENT:
            if (eoe->slave->mbox_command.state != EC_CMD_RECEIVED) {
                eoe->stats.tx_errors++;
                eoe->state = EC_EOE_RX_START;
                break;
            }
            if (eoe->slave->mbox_command.working_counter != 1) {
                eoe->stats.tx_errors++;
                eoe->state = EC_EOE_RX_START;
                break;
            }

            // frame completely sent
            if (eoe->tx_offset >= eoe->tx_frame->skb->len) {
                eoe->stats.tx_packets++;
                eoe->stats.tx_bytes += eoe->tx_frame->skb->len;
                dev_kfree_skb(eoe->tx_frame->skb);
                kfree(eoe->tx_frame);
                eoe->state = EC_EOE_RX_START;
            }
            else { // send next fragment
                if (ec_eoe_send(eoe)) {
                    dev_kfree_skb(eoe->tx_frame->skb);
                    kfree(eoe->tx_frame);
                    eoe->stats.tx_errors++;
                    eoe->state = EC_EOE_RX_START;
                    break;
                }
            }

            break;

        default:
            break;
    }
}

/*****************************************************************************/

/**
   Prints EoE object information.
*/

void ec_eoe_print(const ec_eoe_t *eoe)
{
    EC_INFO("  EoE slave %i\n", eoe->slave->ring_position);
    EC_INFO("    State %i\n", eoe->state);
    EC_INFO("    Assigned device: %s (%s)\n", eoe->dev->name,
            eoe->opened ? "opened" : "closed");
}

/*****************************************************************************/

/**
   Initializes a net_device structure for an EoE object.
*/

void ec_eoedev_init(struct net_device *dev /**< pointer to the net_device */)
{
    ec_eoe_t *priv;
    unsigned int i;

    // initialize net_device
    ether_setup(dev);
    dev->open = ec_eoedev_open;
    dev->stop = ec_eoedev_stop;
    dev->hard_start_xmit = ec_eoedev_tx;
    dev->get_stats = ec_eoedev_stats;

    for (i = 0; i < ETH_ALEN; i++)
        dev->dev_addr[i] = i | (i << 4);

    // initialize private data
    priv = netdev_priv(dev);
    memset(priv, 0, sizeof(ec_eoe_t *));
}

/*****************************************************************************/

/**
   Opens the virtual network device.
*/

int ec_eoedev_open(struct net_device *dev /**< EoE net_device */)
{
    ec_eoe_t *eoe = *((ec_eoe_t **) netdev_priv(dev));
    ec_eoe_flush(eoe);
    eoe->opened = 1;
    netif_start_queue(dev);
    eoe->tx_queue_active = 1;
    EC_INFO("%s (slave %i) opened.\n", dev->name, eoe->slave->ring_position);
    return 0;
}

/*****************************************************************************/

/**
   Stops the virtual network device.
*/

int ec_eoedev_stop(struct net_device *dev /**< EoE net_device */)
{
    ec_eoe_t *eoe = *((ec_eoe_t **) netdev_priv(dev));
    netif_stop_queue(dev);
    eoe->tx_queue_active = 0;
    eoe->opened = 0;
    ec_eoe_flush(eoe);
    EC_INFO("%s (slave %i) stopped.\n", dev->name, eoe->slave->ring_position);
    return 0;
}

/*****************************************************************************/

/**
   Transmits data via the virtual network device.
*/

int ec_eoedev_tx(struct sk_buff *skb, /**< transmit socket buffer */
                 struct net_device *dev /**< EoE net_device */
                )
{
    ec_eoe_t *eoe = *((ec_eoe_t **) netdev_priv(dev));
    ec_eoe_frame_t *frame;

#if 0
    if (skb->len > eoe->slave->sii_tx_mailbox_size - 10) {
        EC_WARN("EoE TX frame (%i octets) exceeds MTU. dropping.\n", skb->len);
        dev_kfree_skb(skb);
        eoe->stats.tx_dropped++;
        return 0;
    }
#endif

    if (!(frame =
          (ec_eoe_frame_t *) kmalloc(sizeof(ec_eoe_frame_t), GFP_ATOMIC))) {
        if (printk_ratelimit())
            EC_WARN("EoE TX: low on mem. frame dropped.\n");
        return 1;
    }

    frame->skb = skb;

    spin_lock_bh(&eoe->tx_queue_lock);
    list_add_tail(&frame->queue, &eoe->tx_queue);
    eoe->queued_frames++;
    if (eoe->queued_frames == EC_EOE_TX_QUEUE_SIZE) {
        netif_stop_queue(dev);
        eoe->tx_queue_active = 0;
    }
    spin_unlock_bh(&eoe->tx_queue_lock);

#if EOE_DEBUG_LEVEL > 0
    EC_DBG("EoE TX queued frame with %i octets (%i frames queued).\n",
           skb->len, eoe->queued_frames);
    if (!eoe->tx_queue_active)
        EC_WARN("EoE TX queue is now full.\n");
#endif

    return 0;
}

/*****************************************************************************/

/**
   Gets statistics about the virtual network device.
*/

struct net_device_stats *ec_eoedev_stats(struct net_device *dev
                                         /**< EoE net_device */)
{
    ec_eoe_t *eoe = *((ec_eoe_t **) netdev_priv(dev));
    return &eoe->stats;
}

/*****************************************************************************/