1 /* SPDX-License-Identifier: GPL-2.0-or-later */ 2 /* 3 * Copyright (C) 2006 Freescale Semiconductor, Inc. All rights reserved. 4 * 5 * Authors: Shlomi Gridish <gridish@freescale.com> 6 * Li Yang <leoli@freescale.com> 7 * 8 * Description: 9 * Internal header file for UCC SLOW unit routines. 10 */ 11 #ifndef __UCC_SLOW_H__ 12 #define __UCC_SLOW_H__ 13 14 #include <linux/kernel.h> 15 16 #include <soc/fsl/qe/immap_qe.h> 17 #include <soc/fsl/qe/qe.h> 18 19 #include <soc/fsl/qe/ucc.h> 20 21 /* transmit BD's status */ 22 #define T_R 0x80000000 /* ready bit */ 23 #define T_PAD 0x40000000 /* add pads to short frames */ 24 #define T_W 0x20000000 /* wrap bit */ 25 #define T_I 0x10000000 /* interrupt on completion */ 26 #define T_L 0x08000000 /* last */ 27 28 #define T_A 0x04000000 /* Address - the data transmitted as address 29 chars */ 30 #define T_TC 0x04000000 /* transmit CRC */ 31 #define T_CM 0x02000000 /* continuous mode */ 32 #define T_DEF 0x02000000 /* collision on previous attempt to transmit */ 33 #define T_P 0x01000000 /* Preamble - send Preamble sequence before 34 data */ 35 #define T_HB 0x01000000 /* heartbeat */ 36 #define T_NS 0x00800000 /* No Stop */ 37 #define T_LC 0x00800000 /* late collision */ 38 #define T_RL 0x00400000 /* retransmission limit */ 39 #define T_UN 0x00020000 /* underrun */ 40 #define T_CT 0x00010000 /* CTS lost */ 41 #define T_CSL 0x00010000 /* carrier sense lost */ 42 #define T_RC 0x003c0000 /* retry count */ 43 44 /* Receive BD's status */ 45 #define R_E 0x80000000 /* buffer empty */ 46 #define R_W 0x20000000 /* wrap bit */ 47 #define R_I 0x10000000 /* interrupt on reception */ 48 #define R_L 0x08000000 /* last */ 49 #define R_C 0x08000000 /* the last byte in this buffer is a cntl 50 char */ 51 #define R_F 0x04000000 /* first */ 52 #define R_A 0x04000000 /* the first byte in this buffer is address 53 byte */ 54 #define R_CM 0x02000000 /* continuous mode */ 55 #define R_ID 0x01000000 /* buffer close on reception of idles */ 56 #define R_M 0x01000000 /* Frame received because of promiscuous 57 mode */ 58 #define R_AM 0x00800000 /* Address match */ 59 #define R_DE 0x00800000 /* Address match */ 60 #define R_LG 0x00200000 /* Break received */ 61 #define R_BR 0x00200000 /* Frame length violation */ 62 #define R_NO 0x00100000 /* Rx Non Octet Aligned Packet */ 63 #define R_FR 0x00100000 /* Framing Error (no stop bit) character 64 received */ 65 #define R_PR 0x00080000 /* Parity Error character received */ 66 #define R_AB 0x00080000 /* Frame Aborted */ 67 #define R_SH 0x00080000 /* frame is too short */ 68 #define R_CR 0x00040000 /* CRC Error */ 69 #define R_OV 0x00020000 /* Overrun */ 70 #define R_CD 0x00010000 /* CD lost */ 71 #define R_CL 0x00010000 /* this frame is closed because of a 72 collision */ 73 74 /* Rx Data buffer must be 4 bytes aligned in most cases.*/ 75 #define UCC_SLOW_RX_ALIGN 4 76 #define UCC_SLOW_MRBLR_ALIGNMENT 4 77 #define UCC_SLOW_PRAM_SIZE 0x100 78 #define ALIGNMENT_OF_UCC_SLOW_PRAM 64 79 80 /* UCC Slow Channel Protocol Mode */ 81 enum ucc_slow_channel_protocol_mode { 82 UCC_SLOW_CHANNEL_PROTOCOL_MODE_QMC = 0x00000002, 83 UCC_SLOW_CHANNEL_PROTOCOL_MODE_UART = 0x00000004, 84 UCC_SLOW_CHANNEL_PROTOCOL_MODE_BISYNC = 0x00000008, 85 }; 86 87 /* UCC Slow Transparent Transmit CRC (TCRC) */ 88 enum ucc_slow_transparent_tcrc { 89 /* 16-bit CCITT CRC (HDLC). (X16 + X12 + X5 + 1) */ 90 UCC_SLOW_TRANSPARENT_TCRC_CCITT_CRC16 = 0x00000000, 91 /* CRC16 (BISYNC). (X16 + X15 + X2 + 1) */ 92 UCC_SLOW_TRANSPARENT_TCRC_CRC16 = 0x00004000, 93 /* 32-bit CCITT CRC (Ethernet and HDLC) */ 94 UCC_SLOW_TRANSPARENT_TCRC_CCITT_CRC32 = 0x00008000, 95 }; 96 97 /* UCC Slow oversampling rate for transmitter (TDCR) */ 98 enum ucc_slow_tx_oversampling_rate { 99 /* 1x clock mode */ 100 UCC_SLOW_OVERSAMPLING_RATE_TX_TDCR_1 = 0x00000000, 101 /* 8x clock mode */ 102 UCC_SLOW_OVERSAMPLING_RATE_TX_TDCR_8 = 0x00010000, 103 /* 16x clock mode */ 104 UCC_SLOW_OVERSAMPLING_RATE_TX_TDCR_16 = 0x00020000, 105 /* 32x clock mode */ 106 UCC_SLOW_OVERSAMPLING_RATE_TX_TDCR_32 = 0x00030000, 107 }; 108 109 /* UCC Slow Oversampling rate for receiver (RDCR) 110 */ 111 enum ucc_slow_rx_oversampling_rate { 112 /* 1x clock mode */ 113 UCC_SLOW_OVERSAMPLING_RATE_RX_RDCR_1 = 0x00000000, 114 /* 8x clock mode */ 115 UCC_SLOW_OVERSAMPLING_RATE_RX_RDCR_8 = 0x00004000, 116 /* 16x clock mode */ 117 UCC_SLOW_OVERSAMPLING_RATE_RX_RDCR_16 = 0x00008000, 118 /* 32x clock mode */ 119 UCC_SLOW_OVERSAMPLING_RATE_RX_RDCR_32 = 0x0000c000, 120 }; 121 122 /* UCC Slow Transmitter encoding method (TENC) 123 */ 124 enum ucc_slow_tx_encoding_method { 125 UCC_SLOW_TRANSMITTER_ENCODING_METHOD_TENC_NRZ = 0x00000000, 126 UCC_SLOW_TRANSMITTER_ENCODING_METHOD_TENC_NRZI = 0x00000100 127 }; 128 129 /* UCC Slow Receiver decoding method (RENC) 130 */ 131 enum ucc_slow_rx_decoding_method { 132 UCC_SLOW_RECEIVER_DECODING_METHOD_RENC_NRZ = 0x00000000, 133 UCC_SLOW_RECEIVER_DECODING_METHOD_RENC_NRZI = 0x00000800 134 }; 135 136 /* UCC Slow Diagnostic mode (DIAG) 137 */ 138 enum ucc_slow_diag_mode { 139 UCC_SLOW_DIAG_MODE_NORMAL = 0x00000000, 140 UCC_SLOW_DIAG_MODE_LOOPBACK = 0x00000040, 141 UCC_SLOW_DIAG_MODE_ECHO = 0x00000080, 142 UCC_SLOW_DIAG_MODE_LOOPBACK_ECHO = 0x000000c0 143 }; 144 145 struct ucc_slow_info { 146 int ucc_num; 147 int protocol; /* QE_CR_PROTOCOL_xxx */ 148 enum qe_clock rx_clock; 149 enum qe_clock tx_clock; 150 phys_addr_t regs; 151 int irq; 152 u16 uccm_mask; 153 int data_mem_part; 154 int init_tx; 155 int init_rx; 156 u32 tx_bd_ring_len; 157 u32 rx_bd_ring_len; 158 int rx_interrupts; 159 int brkpt_support; 160 int grant_support; 161 int tsa; 162 int cdp; 163 int cds; 164 int ctsp; 165 int ctss; 166 int rinv; 167 int tinv; 168 int rtsm; 169 int rfw; 170 int tci; 171 int tend; 172 int tfl; 173 int txsy; 174 u16 max_rx_buf_length; 175 enum ucc_slow_transparent_tcrc tcrc; 176 enum ucc_slow_channel_protocol_mode mode; 177 enum ucc_slow_diag_mode diag; 178 enum ucc_slow_tx_oversampling_rate tdcr; 179 enum ucc_slow_rx_oversampling_rate rdcr; 180 enum ucc_slow_tx_encoding_method tenc; 181 enum ucc_slow_rx_decoding_method renc; 182 }; 183 184 struct ucc_slow_private { 185 struct ucc_slow_info *us_info; 186 struct ucc_slow __iomem *us_regs; /* Ptr to memory map of UCC regs */ 187 struct ucc_slow_pram *us_pram; /* a pointer to the parameter RAM */ 188 s32 us_pram_offset; 189 int enabled_tx; /* Whether channel is enabled for Tx (ENT) */ 190 int enabled_rx; /* Whether channel is enabled for Rx (ENR) */ 191 int stopped_tx; /* Whether channel has been stopped for Tx 192 (STOP_TX, etc.) */ 193 int stopped_rx; /* Whether channel has been stopped for Rx */ 194 struct list_head confQ; /* frames passed to chip waiting for tx */ 195 u32 first_tx_bd_mask; /* mask is used in Tx routine to save status 196 and length for first BD in a frame */ 197 s32 tx_base_offset; /* first BD in Tx BD table offset (In MURAM) */ 198 s32 rx_base_offset; /* first BD in Rx BD table offset (In MURAM) */ 199 struct qe_bd *confBd; /* next BD for confirm after Tx */ 200 struct qe_bd *tx_bd; /* next BD for new Tx request */ 201 struct qe_bd *rx_bd; /* next BD to collect after Rx */ 202 void *p_rx_frame; /* accumulating receive frame */ 203 u16 *p_ucce; /* a pointer to the event register in memory. 204 */ 205 u16 *p_uccm; /* a pointer to the mask register in memory */ 206 u16 saved_uccm; /* a saved mask for the RX Interrupt bits */ 207 #ifdef STATISTICS 208 u32 tx_frames; /* Transmitted frames counters */ 209 u32 rx_frames; /* Received frames counters (only frames 210 passed to application) */ 211 u32 rx_discarded; /* Discarded frames counters (frames that 212 were discarded by the driver due to 213 errors) */ 214 #endif /* STATISTICS */ 215 }; 216 217 /* ucc_slow_init 218 * Initializes Slow UCC according to provided parameters. 219 * 220 * us_info - (In) pointer to the slow UCC info structure. 221 * uccs_ret - (Out) pointer to the slow UCC structure. 222 */ 223 int ucc_slow_init(struct ucc_slow_info * us_info, struct ucc_slow_private ** uccs_ret); 224 225 /* ucc_slow_free 226 * Frees all resources for slow UCC. 227 * 228 * uccs - (In) pointer to the slow UCC structure. 229 */ 230 void ucc_slow_free(struct ucc_slow_private * uccs); 231 232 /* ucc_slow_enable 233 * Enables a fast UCC port. 234 * This routine enables Tx and/or Rx through the General UCC Mode Register. 235 * 236 * uccs - (In) pointer to the slow UCC structure. 237 * mode - (In) TX, RX, or both. 238 */ 239 void ucc_slow_enable(struct ucc_slow_private * uccs, enum comm_dir mode); 240 241 /* ucc_slow_disable 242 * Disables a fast UCC port. 243 * This routine disables Tx and/or Rx through the General UCC Mode Register. 244 * 245 * uccs - (In) pointer to the slow UCC structure. 246 * mode - (In) TX, RX, or both. 247 */ 248 void ucc_slow_disable(struct ucc_slow_private * uccs, enum comm_dir mode); 249 250 /* ucc_slow_graceful_stop_tx 251 * Smoothly stops transmission on a specified slow UCC. 252 * 253 * uccs - (In) pointer to the slow UCC structure. 254 */ 255 void ucc_slow_graceful_stop_tx(struct ucc_slow_private * uccs); 256 257 /* ucc_slow_stop_tx 258 * Stops transmission on a specified slow UCC. 259 * 260 * uccs - (In) pointer to the slow UCC structure. 261 */ 262 void ucc_slow_stop_tx(struct ucc_slow_private * uccs); 263 264 /* ucc_slow_restart_tx 265 * Restarts transmitting on a specified slow UCC. 266 * 267 * uccs - (In) pointer to the slow UCC structure. 268 */ 269 void ucc_slow_restart_tx(struct ucc_slow_private *uccs); 270 271 u32 ucc_slow_get_qe_cr_subblock(int uccs_num); 272 273 #endif /* __UCC_SLOW_H__ */ 274