1

/**

     2

    Network Driver for Beckhoff CCAT communication controller

     3

    Copyright (C) 2014  Beckhoff Automation GmbH

     4

    Author: Patrick Bruenn <p.bruenn@beckhoff.com>

     5

     6

    This program is free software; you can redistribute it and/or modify

     7

    it under the terms of the GNU General Public License as published by

     8

    the Free Software Foundation; either version 2 of the License, or

     9

    (at your option) any later version.

    10

    11

    This program is distributed in the hope that it will be useful,

    12

    but WITHOUT ANY WARRANTY; without even the implied warranty of

    13

    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    14

    GNU General Public License for more details.

    15

    16

    You should have received a copy of the GNU General Public License along

    17

    with this program; if not, write to the Free Software Foundation, Inc.,

    18

    51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

    19

*/

    20

    21

#ifndef _CCAT_H_

    22

#define _CCAT_H_

    23

    24

#include <linux/cdev.h>

    25

#include <linux/fs.h>

    26

#include <linux/hrtimer.h>

    27

#include <linux/kernel.h>

    28

#include <linux/pci.h>

    29

#include "../ecdev.h"

    30

    31

#define DRV_EXTRAVERSION "-ec"

    32

#define DRV_VERSION      "0.15" DRV_EXTRAVERSION

    33

#define DRV_DESCRIPTION  "Beckhoff CCAT Ethernet/EtherCAT Network Driver"

    34

    35

#undef pr_fmt

    36

#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt

    37

    38

extern const struct ccat_driver eth_eim_driver;

    39

extern const struct ccat_driver eth_dma_driver;

    40

#ifdef CONFIG_GPIO

    41

extern const struct ccat_driver gpio_driver;

    42

#endif

    43

extern const struct ccat_driver sram_driver;

    44

extern const struct ccat_driver update_driver;

    45

    46

    47

/**

    48

 * CCAT function type identifiers (u16)

    49

 */

    50

enum ccat_info_t {

    51

	CCATINFO_NOTUSED = 0,

    52

	CCATINFO_ETHERCAT_NODMA = 0x3,

    53

	CCATINFO_GPIO = 0xd,

    54

	CCATINFO_EPCS_PROM = 0xf,

    55

	CCATINFO_ETHERCAT_MASTER_DMA = 0x14,

    56

	CCATINFO_SRAM = 0x16,

    57

};

    58

    59

struct ccat_cdev {

    60

	atomic_t in_use;

    61

	void __iomem *ioaddr;

    62

	size_t iosize;

    63

	dev_t dev;

    64

	struct cdev cdev;

    65

	struct ccat_class *class;

    66

};

    67

    68

/**

    69

 * struct cdev_buffer

    70

 * @ccdev: referenced character device

    71

 * @data: buffer used for write operations

    72

 * @size: number of bytes written to the data buffer

    73

 */

    74

struct cdev_buffer {

    75

	struct ccat_cdev *ccdev;

    76

	size_t size;

    77

	char data[];

    78

};

    79

    80

extern int ccat_cdev_open(struct inode *const i, struct file *const f);

    81

extern int ccat_cdev_release(struct inode *const i, struct file *const f);

    82

    83

/**

    84

 * struct ccat_device - CCAT device representation

    85

 * @pdev: pointer to the pci object allocated by the kernel

    86

 * @bar_0: holding information about PCI BAR 0

    87

 * @bar_2: holding information about PCI BAR 2 (optional)

    88

 * @functions: list of available (driver loaded) FPGA functions

    89

 *

    90

 * One instance of a ccat_device should represent a physical CCAT. Since

    91

 * a CCAT is implemented as FPGA the available functions can vary.

    92

 */

    93

struct ccat_device {

    94

	void *pdev;

    95

	void __iomem *bar_0;

    96

	void __iomem *bar_2;

    97

	struct list_head functions;

    98

};

    99

   100

struct ccat_info_block {

   101

	u16 type;

   102

	u16 rev;

   103

	union {

   104

		u32 config;

   105

		u8 num_gpios;

   106

		struct {

   107

			u16 tx_size;

   108

			u16 rx_size;

   109

		};

   110

		struct {

   111

			u8 tx_dma_chan;

   112

			u8 rx_dma_chan;

   113

		};

   114

		struct {

   115

			u8 sram_width;

   116

			u8 sram_size;

   117

			u16 reserved;

   118

		};

   119

	};

   120

	u32 addr;

   121

	u32 size;

   122

};

   123

   124

struct ccat_function {

   125

	const struct ccat_driver *drv;

   126

	struct ccat_device *ccat;

   127

	struct ccat_info_block info;

   128

	struct list_head list;

   129

	void *private_data;

   130

};

   131

   132

struct ccat_class {

   133

	dev_t dev;

   134

	struct class *class;

   135

	atomic_t instances;

   136

	const unsigned count;

   137

	struct ccat_cdev *devices;

   138

	const char *name;

   139

	struct file_operations fops;

   140

};

   141

   142

extern void ccat_cdev_remove(struct ccat_function *func);

   143

extern int ccat_cdev_probe(struct ccat_function *func,

   144

			   struct ccat_class *cdev_class, size_t iosize);

   145

   146

/**

   147

 * struct ccat_driver - CCAT FPGA function

   148

 * @probe: add device instance

   149

 * @remove: remove device instance

   150

 * @type: type of the FPGA function supported by this driver

   151

 * @cdev_class: if not NULL that driver supports ccat_class_init()/_exit()

   152

 */

   153

struct ccat_driver {

   154

	int (*probe) (struct ccat_function * func);

   155

	void (*remove) (struct ccat_function * drv);

   156

	enum ccat_info_t type;

   157

	struct ccat_class *cdev_class;

   158

};

   159

   160

#endif /* #ifndef _CCAT_H_ */