device.h

Go to the documentation of this file.

/*****************************************************************************
 *
 *  Copyright (C) 2006-2008  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 version 2, as
 *  published by the Free Software Foundation.
 *
 *  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
 *
 ****************************************************************************/

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

#ifndef __EC_DEVICE_H__
#define __EC_DEVICE_H__

#include <linux/interrupt.h>

#include "../devices/ecdev.h"
#include "globals.h"

#define EC_TX_RING_SIZE 2

#ifdef EC_DEBUG_IF
#include "debug.h"
#endif

#ifdef EC_DEBUG_RING
#include <linux/version.h>
#define EC_DEBUG_RING_SIZE 10

typedef enum {
    TX, RX
} ec_debug_frame_dir_t;

typedef struct {
    ec_debug_frame_dir_t dir;
#if LINUX_VERSION_CODE >= KERNEL_VERSION(5, 6, 0)
    struct timespec64 t;
#else
    struct timeval t;
#endif
    uint8_t data[EC_MAX_DATA_SIZE];
    unsigned int data_size;
} ec_debug_frame_t;

#endif

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

struct ec_device
{
    ec_master_t *master; 
    struct net_device *dev; 
    ec_pollfunc_t poll; 
    struct module *module; 
    uint8_t open; 
    uint8_t link_state; 
    struct sk_buff *tx_skb[EC_TX_RING_SIZE]; 
    unsigned int tx_ring_index; 
#ifdef EC_HAVE_CYCLES
    cycles_t cycles_poll; 
#endif
#ifdef EC_DEBUG_RING
#if LINUX_VERSION_CODE >= KERNEL_VERSION(5, 6, 0)
    struct timespec64 timeval_poll;
#else
    struct timeval timeval_poll;
#endif
#endif
    unsigned long jiffies_poll; 
    // Frame statistics
    u64 tx_count; 
    u64 last_tx_count; 
    u64 rx_count; 
    u64 last_rx_count; 
    u64 tx_bytes; 
    u64 last_tx_bytes; 
    u64 rx_bytes; 
    u64 last_rx_bytes; 
    u64 tx_errors; 
    s32 tx_frame_rates[EC_RATE_COUNT]; 
    s32 rx_frame_rates[EC_RATE_COUNT]; 
    s32 tx_byte_rates[EC_RATE_COUNT]; 
    s32 rx_byte_rates[EC_RATE_COUNT]; 
#ifdef EC_DEBUG_IF
    ec_debug_t dbg; 
#endif
#ifdef EC_DEBUG_RING
    ec_debug_frame_t debug_frames[EC_DEBUG_RING_SIZE];
    unsigned int debug_frame_index;
    unsigned int debug_frame_count;
#endif
};

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

int ec_device_init(ec_device_t *, ec_master_t *);
void ec_device_clear(ec_device_t *);

void ec_device_attach(ec_device_t *, struct net_device *, ec_pollfunc_t,
        struct module *);
void ec_device_detach(ec_device_t *);

int ec_device_open(ec_device_t *);
int ec_device_close(ec_device_t *);

void ec_device_poll(ec_device_t *);
uint8_t *ec_device_tx_data(ec_device_t *);
void ec_device_send(ec_device_t *, size_t);
void ec_device_clear_stats(ec_device_t *);
void ec_device_update_stats(ec_device_t *);

#ifdef EC_DEBUG_RING
void ec_device_debug_ring_append(ec_device_t *, ec_debug_frame_dir_t,
        const void *, size_t);
void ec_device_debug_ring_print(const ec_device_t *);
#endif

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

#endif