| author | Florian Pose <fp@igh-essen.com> |
| Mon, 25 Jan 2010 17:42:07 +0100 | |
| changeset 1787 | 439f186185be |
| parent 1782 | 2ba454c790c5 |
| child 1795 | 16c9640493fa |
| permissions | -rw-r--r-- |
| 1569 | 1 |
/****************************************************************************** |
2 |
* |
|
3 |
* $Id$ |
|
4 |
* |
|
5 |
* Copyright (C) 2006-2008 Florian Pose, Ingenieurgemeinschaft IgH |
|
6 |
* |
|
7 |
* This file is part of the IgH EtherCAT master userspace library. |
|
8 |
* |
|
9 |
* The IgH EtherCAT master userspace library is free software; you can |
|
10 |
* redistribute it and/or modify it under the terms of the GNU Lesser General |
|
11 |
* Public License as published by the Free Software Foundation; version 2.1 |
|
12 |
* of the License. |
|
13 |
* |
|
14 |
* The IgH EtherCAT master userspace library is distributed in the hope that |
|
15 |
* it will be useful, but WITHOUT ANY WARRANTY; without even the implied |
|
16 |
* warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
|
17 |
* GNU Lesser General Public License for more details. |
|
18 |
* |
|
19 |
* You should have received a copy of the GNU Lesser General Public License |
|
20 |
* along with the IgH EtherCAT master userspace library. If not, see |
|
21 |
* <http://www.gnu.org/licenses/>. |
|
22 |
* |
|
23 |
* --- |
|
24 |
* |
|
25 |
* The license mentioned above concerns the source code only. Using the |
|
26 |
* EtherCAT technology and brand is only permitted in compliance with the |
|
27 |
* industrial property and similar rights of Beckhoff Automation GmbH. |
|
28 |
* |
|
29 |
*****************************************************************************/ |
|
30 |
||
31 |
/** \file |
|
32 |
* |
|
33 |
* EtherCAT virtual TTY interface. |
|
34 |
* |
|
35 |
* \defgroup TTYInterface EtherCAT Virtual TTY Interface |
|
36 |
* |
|
37 |
* @{
|
|
38 |
*/ |
|
39 |
||
40 |
/*****************************************************************************/ |
|
41 |
||
42 |
#ifndef __ECTTY_H__ |
|
43 |
#define __ECTTY_H__ |
|
44 |
||
45 |
/****************************************************************************** |
|
46 |
* Data types |
|
47 |
*****************************************************************************/ |
|
48 |
||
49 |
struct ec_tty; |
|
50 |
typedef struct ec_tty ec_tty_t; /**< \see ec_tty */ |
|
51 |
||
|
1787
439f186185be
Callback set via own structure.
Florian Pose <fp@igh-essen.com>
parents:
1782
diff
changeset
|
52 |
/** |
|
439f186185be
Callback set via own structure.
Florian Pose <fp@igh-essen.com>
parents:
1782
diff
changeset
|
53 |
* \param cflag_changed This callback function is called when the serial |
|
439f186185be
Callback set via own structure.
Florian Pose <fp@igh-essen.com>
parents:
1782
diff
changeset
|
54 |
* settings shall be changed. The \a cflag argument contains the new settings. |
|
439f186185be
Callback set via own structure.
Florian Pose <fp@igh-essen.com>
parents:
1782
diff
changeset
|
55 |
*/ |
|
439f186185be
Callback set via own structure.
Florian Pose <fp@igh-essen.com>
parents:
1782
diff
changeset
|
56 |
typedef struct {
|
|
439f186185be
Callback set via own structure.
Florian Pose <fp@igh-essen.com>
parents:
1782
diff
changeset
|
57 |
int (*cflag_changed)(void *, tcflag_t); |
|
439f186185be
Callback set via own structure.
Florian Pose <fp@igh-essen.com>
parents:
1782
diff
changeset
|
58 |
} ec_tty_operations_t; |
|
439f186185be
Callback set via own structure.
Florian Pose <fp@igh-essen.com>
parents:
1782
diff
changeset
|
59 |
|
| 1569 | 60 |
/****************************************************************************** |
61 |
* Global functions |
|
62 |
*****************************************************************************/ |
|
63 |
||
64 |
/** Create a virtual TTY interface. |
|
|
1779
9fab229d6ca9
Passing tty cflag to serial implementation.
Florian Pose <fp@igh-essen.com>
parents:
1577
diff
changeset
|
65 |
* |
|
1787
439f186185be
Callback set via own structure.
Florian Pose <fp@igh-essen.com>
parents:
1782
diff
changeset
|
66 |
* \param ops Set of callbacks. |
|
439f186185be
Callback set via own structure.
Florian Pose <fp@igh-essen.com>
parents:
1782
diff
changeset
|
67 |
* \param cb_data Arbitrary data, that is passed to any callback. |
|
1779
9fab229d6ca9
Passing tty cflag to serial implementation.
Florian Pose <fp@igh-essen.com>
parents:
1577
diff
changeset
|
68 |
* |
| 1569 | 69 |
* \return Pointer to the interface object, otherwise an ERR_PTR value. |
70 |
*/ |
|
|
1779
9fab229d6ca9
Passing tty cflag to serial implementation.
Florian Pose <fp@igh-essen.com>
parents:
1577
diff
changeset
|
71 |
ec_tty_t *ectty_create( |
|
1787
439f186185be
Callback set via own structure.
Florian Pose <fp@igh-essen.com>
parents:
1782
diff
changeset
|
72 |
const ec_tty_operations_t *ops, |
|
1779
9fab229d6ca9
Passing tty cflag to serial implementation.
Florian Pose <fp@igh-essen.com>
parents:
1577
diff
changeset
|
73 |
void *cb_data |
|
9fab229d6ca9
Passing tty cflag to serial implementation.
Florian Pose <fp@igh-essen.com>
parents:
1577
diff
changeset
|
74 |
); |
| 1569 | 75 |
|
76 |
/****************************************************************************** |
|
77 |
* TTY interface methods |
|
78 |
*****************************************************************************/ |
|
79 |
||
80 |
/** Releases a virtual TTY interface. |
|
81 |
*/ |
|
82 |
void ectty_free( |
|
83 |
ec_tty_t *tty /**< TTY interface. */ |
|
84 |
); |
|
85 |
||
| 1575 | 86 |
/** Reads data to send from the TTY interface. |
87 |
* |
|
88 |
* If there are data to send, they are copied into the \a buffer. At maximum, |
|
89 |
* \a size bytes are copied. The actual number of bytes copied is returned. |
|
90 |
* |
|
91 |
* \return Number of bytes copied. |
|
92 |
*/ |
|
93 |
unsigned int ectty_tx_data( |
|
94 |
ec_tty_t *tty, /**< TTY interface. */ |
|
95 |
uint8_t *buffer, /**< Buffer for data to transmit. */ |
|
96 |
size_t size /**< Available space in \a buffer. */ |
|
97 |
); |
|
98 |
||
|
1577
fa3f66b783c1
Implemented reading direction of tty driver.
Florian Pose <fp@igh-essen.com>
parents:
1575
diff
changeset
|
99 |
/** Pushes received data to the TTY interface. |
|
fa3f66b783c1
Implemented reading direction of tty driver.
Florian Pose <fp@igh-essen.com>
parents:
1575
diff
changeset
|
100 |
*/ |
|
fa3f66b783c1
Implemented reading direction of tty driver.
Florian Pose <fp@igh-essen.com>
parents:
1575
diff
changeset
|
101 |
void ectty_rx_data( |
|
fa3f66b783c1
Implemented reading direction of tty driver.
Florian Pose <fp@igh-essen.com>
parents:
1575
diff
changeset
|
102 |
ec_tty_t *tty, /**< TTY interface. */ |
|
fa3f66b783c1
Implemented reading direction of tty driver.
Florian Pose <fp@igh-essen.com>
parents:
1575
diff
changeset
|
103 |
const uint8_t *buffer, /**< Buffer with received data. */ |
|
fa3f66b783c1
Implemented reading direction of tty driver.
Florian Pose <fp@igh-essen.com>
parents:
1575
diff
changeset
|
104 |
size_t size /**< Number of bytes in \a buffer. */ |
|
fa3f66b783c1
Implemented reading direction of tty driver.
Florian Pose <fp@igh-essen.com>
parents:
1575
diff
changeset
|
105 |
); |
|
fa3f66b783c1
Implemented reading direction of tty driver.
Florian Pose <fp@igh-essen.com>
parents:
1575
diff
changeset
|
106 |
|
| 1569 | 107 |
/*****************************************************************************/ |
108 |
||
109 |
/** @} */ |
|
110 |
||
111 |
#endif |