1 /* r3964 linediscipline for linux 2 * 3 * ----------------------------------------------------------- 4 * Copyright by 5 * Philips Automation Projects 6 * Kassel (Germany) 7 * ----------------------------------------------------------- 8 * This software may be used and distributed according to the terms of 9 * the GNU General Public License, incorporated herein by reference. 10 * 11 * Author: 12 * L. Haag 13 * 14 * $Log: r3964.h,v $ 15 * Revision 1.4 2005/12/21 19:54:24 Kurt Huwig <kurt huwig de> 16 * Fixed HZ usage on 2.6 kernels 17 * Removed unnecessary include 18 * 19 * Revision 1.3 2001/03/18 13:02:24 dwmw2 20 * Fix timer usage, use spinlocks properly. 21 * 22 * Revision 1.2 2001/03/18 12:53:15 dwmw2 23 * Merge changes in 2.4.2 24 * 25 * Revision 1.1.1.1 1998/10/13 16:43:14 dwmw2 26 * This'll screw the version control 27 * 28 * Revision 1.6 1998/09/30 00:40:38 dwmw2 29 * Updated to use kernel's N_R3964 if available 30 * 31 * Revision 1.4 1998/04/02 20:29:44 lhaag 32 * select, blocking, ... 33 * 34 * Revision 1.3 1998/02/12 18:58:43 root 35 * fixed some memory leaks 36 * calculation of checksum characters 37 * 38 * Revision 1.2 1998/02/07 13:03:17 root 39 * ioctl read_telegram 40 * 41 * Revision 1.1 1998/02/06 19:19:43 root 42 * Initial revision 43 * 44 * 45 */ 46 47 #ifndef __LINUX_N_R3964_H__ 48 #define __LINUX_N_R3964_H__ 49 50 /* line disciplines for r3964 protocol */ 51 52 #ifdef __KERNEL__ 53 54 #include <linux/param.h> 55 56 /* 57 * Common ascii handshake characters: 58 */ 59 60 #define STX 0x02 61 #define ETX 0x03 62 #define DLE 0x10 63 #define NAK 0x15 64 65 /* 66 * Timeouts (from milliseconds to jiffies) 67 */ 68 69 #define R3964_TO_QVZ ((550)*HZ/1000) 70 #define R3964_TO_ZVZ ((220)*HZ/1000) 71 #define R3964_TO_NO_BUF ((400)*HZ/1000) 72 #define R3964_NO_TX_ROOM ((100)*HZ/1000) 73 #define R3964_TO_RX_PANIC ((4000)*HZ/1000) 74 #define R3964_MAX_RETRIES 5 75 76 #endif 77 78 /* 79 * Ioctl-commands 80 */ 81 82 #define R3964_ENABLE_SIGNALS 0x5301 83 #define R3964_SETPRIORITY 0x5302 84 #define R3964_USE_BCC 0x5303 85 #define R3964_READ_TELEGRAM 0x5304 86 87 /* Options for R3964_SETPRIORITY */ 88 #define R3964_MASTER 0 89 #define R3964_SLAVE 1 90 91 /* Options for R3964_ENABLE_SIGNALS */ 92 #define R3964_SIG_ACK 0x0001 93 #define R3964_SIG_DATA 0x0002 94 #define R3964_SIG_ALL 0x000f 95 #define R3964_SIG_NONE 0x0000 96 #define R3964_USE_SIGIO 0x1000 97 98 /* 99 * r3964 operation states: 100 */ 101 #ifdef __KERNEL__ 102 103 enum { R3964_IDLE, 104 R3964_TX_REQUEST, R3964_TRANSMITTING, 105 R3964_WAIT_ZVZ_BEFORE_TX_RETRY, R3964_WAIT_FOR_TX_ACK, 106 R3964_WAIT_FOR_RX_BUF, 107 R3964_RECEIVING, R3964_WAIT_FOR_BCC, R3964_WAIT_FOR_RX_REPEAT 108 }; 109 110 /* 111 * All open file-handles are 'clients' and are stored in a linked list: 112 */ 113 114 struct r3964_message; 115 116 struct r3964_client_info { 117 spinlock_t lock; 118 struct pid *pid; 119 unsigned int sig_flags; 120 121 struct r3964_client_info *next; 122 123 struct r3964_message *first_msg; 124 struct r3964_message *last_msg; 125 struct r3964_block_header *next_block_to_read; 126 int msg_count; 127 }; 128 129 130 #endif 131 132 /* types for msg_id: */ 133 enum {R3964_MSG_ACK=1, R3964_MSG_DATA }; 134 135 #define R3964_MAX_MSG_COUNT 32 136 137 /* error codes for client messages */ 138 #define R3964_OK 0 /* no error. */ 139 #define R3964_TX_FAIL -1 /* transmission error, block NOT sent */ 140 #define R3964_OVERFLOW -2 /* msg queue overflow */ 141 142 /* the client gets this struct when calling read(fd,...): */ 143 struct r3964_client_message { 144 int msg_id; 145 int arg; 146 int error_code; 147 }; 148 149 #define R3964_MTU 256 150 151 152 #ifdef __KERNEL__ 153 154 struct r3964_block_header; 155 156 /* internal version of client_message: */ 157 struct r3964_message { 158 int msg_id; 159 int arg; 160 int error_code; 161 struct r3964_block_header *block; 162 struct r3964_message *next; 163 }; 164 165 /* 166 * Header of received block in rx_buf/tx_buf: 167 */ 168 169 struct r3964_block_header 170 { 171 unsigned int length; /* length in chars without header */ 172 unsigned char *data; /* usually data is located 173 immediately behind this struct */ 174 unsigned int locks; /* only used in rx_buffer */ 175 176 struct r3964_block_header *next; 177 struct r3964_client_info *owner; /* =NULL in rx_buffer */ 178 }; 179 180 /* 181 * If rx_buf hasn't enough space to store R3964_MTU chars, 182 * we will reject all incoming STX-requests by sending NAK. 183 */ 184 185 #define RX_BUF_SIZE 4000 186 #define TX_BUF_SIZE 4000 187 #define R3964_MAX_BLOCKS_IN_RX_QUEUE 100 188 189 #define R3964_PARITY 0x0001 190 #define R3964_FRAME 0x0002 191 #define R3964_OVERRUN 0x0004 192 #define R3964_UNKNOWN 0x0008 193 #define R3964_BREAK 0x0010 194 #define R3964_CHECKSUM 0x0020 195 #define R3964_ERROR 0x003f 196 #define R3964_BCC 0x4000 197 #define R3964_DEBUG 0x8000 198 199 200 struct r3964_info { 201 spinlock_t lock; 202 struct tty_struct *tty; 203 unsigned char priority; 204 unsigned char *rx_buf; /* ring buffer */ 205 unsigned char *tx_buf; 206 207 wait_queue_head_t read_wait; 208 //struct wait_queue *read_wait; 209 210 struct r3964_block_header *rx_first; 211 struct r3964_block_header *rx_last; 212 struct r3964_block_header *tx_first; 213 struct r3964_block_header *tx_last; 214 unsigned int tx_position; 215 unsigned int rx_position; 216 unsigned char last_rx; 217 unsigned char bcc; 218 unsigned int blocks_in_rx_queue; 219 220 221 struct r3964_client_info *firstClient; 222 unsigned int state; 223 unsigned int flags; 224 225 struct timer_list tmr; 226 int nRetry; 227 }; 228 229 #endif 230 231 #endif 232