device.h

Go to the documentation of this file.

/******************************************************************************
 *
 *  $Id$
 *
 *  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
 *
 *  ---
 *
 *  The license mentioned above concerns the source code only. Using the
 *  EtherCAT technology and brand is only permitted in compliance with the
 *  industrial property and similar rights of Beckhoff Automation GmbH.
 *
 *****************************************************************************/

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

#ifndef __EC_DEVICE_H__
#define __EC_DEVICE_H__

#include <linux/interrupt.h>
#include <linux/version.h>

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

#define EC_TX_RING_SIZE 0x10

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

#if LINUX_VERSION_CODE >= KERNEL_VERSION(5, 6, 0)
struct timeval {
    __kernel_old_time_t tv_sec;     /* seconds */
    __kernel_suseconds_t    tv_usec;    /* microseconds */
};
#endif


#ifdef EC_DEBUG_RING
#define EC_DEBUG_RING_SIZE 10

typedef enum {
    TX, RX
} ec_debug_frame_dir_t;

typedef struct {
    ec_debug_frame_dir_t dir;
    struct timeval t;
    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
#if defined(EC_DEBUG_RING) || !defined(EC_RTDM)
    struct timeval timeval_poll;
#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
};

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

typedef struct {
    u32 magic_number;   /* magic number */
    u16 version_major;  /* major version number */
    u16 version_minor;  /* minor version number */
    s32 thiszone;       /* GMT to local correction */
    u32 sigfigs;        /* accuracy of timestamps */
    u32 snaplen;        /* max length of captured packets, in octets */
    u32 network;        /* data link type */
} pcap_hdr_t;

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

typedef struct {
    u32 ts_sec;         /* timestamp seconds */
    u32 ts_usec;        /* timestamp microseconds */
    u32 incl_len;       /* number of octets of packet saved in file */
    u32 orig_len;       /* actual length of packet */
} pcaprec_hdr_t;

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

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