ns16550.h 7.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250
  1. /*
  2. * NS16550 Serial Port
  3. * originally from linux source (arch/powerpc/boot/ns16550.h)
  4. *
  5. * Cleanup and unification
  6. * (C) 2009 by Detlev Zundel, DENX Software Engineering GmbH
  7. *
  8. * modified slightly to
  9. * have addresses as offsets from CONFIG_SYS_ISA_BASE
  10. * added a few more definitions
  11. * added prototypes for ns16550.c
  12. * reduced no of com ports to 2
  13. * modifications (c) Rob Taylor, Flying Pig Systems. 2000.
  14. *
  15. * added support for port on 64-bit bus
  16. * by Richard Danter (richard.danter@windriver.com), (C) 2005 Wind River Systems
  17. */
  18. /*
  19. * Note that the following macro magic uses the fact that the compiler
  20. * will not allocate storage for arrays of size 0
  21. */
  22. #include <linux/types.h>
  23. #ifdef CONFIG_DM_SERIAL
  24. /*
  25. * For driver model we always use one byte per register, and sort out the
  26. * differences in the driver
  27. */
  28. #define CONFIG_SYS_NS16550_REG_SIZE (-1)
  29. #endif
  30. #if !defined(CONFIG_SYS_NS16550_REG_SIZE) || (CONFIG_SYS_NS16550_REG_SIZE == 0)
  31. #error "Please define NS16550 registers size."
  32. #elif defined(CONFIG_SYS_NS16550_MEM32) && !defined(CONFIG_DM_SERIAL)
  33. #define UART_REG(x) u32 x
  34. #elif (CONFIG_SYS_NS16550_REG_SIZE > 0)
  35. #define UART_REG(x) \
  36. unsigned char prepad_##x[CONFIG_SYS_NS16550_REG_SIZE - 1]; \
  37. unsigned char x;
  38. #elif (CONFIG_SYS_NS16550_REG_SIZE < 0)
  39. #define UART_REG(x) \
  40. unsigned char x; \
  41. unsigned char postpad_##x[-CONFIG_SYS_NS16550_REG_SIZE - 1];
  42. #endif
  43. /**
  44. * struct ns16550_platdata - information about a NS16550 port
  45. *
  46. * @base: Base register address
  47. * @reg_width: IO accesses size of registers (in bytes)
  48. * @reg_shift: Shift size of registers (0=byte, 1=16bit, 2=32bit...)
  49. * @clock: UART base clock speed in Hz
  50. */
  51. struct ns16550_platdata {
  52. unsigned long base;
  53. int reg_width;
  54. int reg_shift;
  55. int reg_offset;
  56. int clock;
  57. u32 fcr;
  58. };
  59. struct udevice;
  60. struct NS16550 {
  61. UART_REG(rbr); /* 0 */
  62. UART_REG(ier); /* 1 */
  63. UART_REG(fcr); /* 2 */
  64. UART_REG(lcr); /* 3 */
  65. UART_REG(mcr); /* 4 */
  66. UART_REG(lsr); /* 5 */
  67. UART_REG(msr); /* 6 */
  68. UART_REG(spr); /* 7 */
  69. #ifdef CONFIG_SOC_DA8XX
  70. UART_REG(reg8); /* 8 */
  71. UART_REG(reg9); /* 9 */
  72. UART_REG(revid1); /* A */
  73. UART_REG(revid2); /* B */
  74. UART_REG(pwr_mgmt); /* C */
  75. UART_REG(mdr1); /* D */
  76. #else
  77. UART_REG(mdr1); /* 8 */
  78. UART_REG(reg9); /* 9 */
  79. UART_REG(regA); /* A */
  80. UART_REG(regB); /* B */
  81. UART_REG(regC); /* C */
  82. UART_REG(regD); /* D */
  83. UART_REG(regE); /* E */
  84. UART_REG(uasr); /* F */
  85. UART_REG(scr); /* 10*/
  86. UART_REG(ssr); /* 11*/
  87. #endif
  88. #ifdef CONFIG_DM_SERIAL
  89. struct ns16550_platdata *plat;
  90. #endif
  91. };
  92. #define thr rbr
  93. #define iir fcr
  94. #define dll rbr
  95. #define dlm ier
  96. typedef struct NS16550 *NS16550_t;
  97. /*
  98. * These are the definitions for the FIFO Control Register
  99. */
  100. #define UART_FCR_FIFO_EN 0x01 /* Fifo enable */
  101. #define UART_FCR_CLEAR_RCVR 0x02 /* Clear the RCVR FIFO */
  102. #define UART_FCR_CLEAR_XMIT 0x04 /* Clear the XMIT FIFO */
  103. #define UART_FCR_DMA_SELECT 0x08 /* For DMA applications */
  104. #define UART_FCR_TRIGGER_MASK 0xC0 /* Mask for the FIFO trigger range */
  105. #define UART_FCR_TRIGGER_1 0x00 /* Mask for trigger set at 1 */
  106. #define UART_FCR_TRIGGER_4 0x40 /* Mask for trigger set at 4 */
  107. #define UART_FCR_TRIGGER_8 0x80 /* Mask for trigger set at 8 */
  108. #define UART_FCR_TRIGGER_14 0xC0 /* Mask for trigger set at 14 */
  109. #define UART_FCR_RXSR 0x02 /* Receiver soft reset */
  110. #define UART_FCR_TXSR 0x04 /* Transmitter soft reset */
  111. /* Ingenic JZ47xx specific UART-enable bit. */
  112. #define UART_FCR_UME 0x10
  113. /* Clear & enable FIFOs */
  114. #define UART_FCR_DEFVAL (UART_FCR_FIFO_EN | \
  115. UART_FCR_RXSR | \
  116. UART_FCR_TXSR)
  117. /*
  118. * These are the definitions for the Modem Control Register
  119. */
  120. #define UART_MCR_DTR 0x01 /* DTR */
  121. #define UART_MCR_RTS 0x02 /* RTS */
  122. #define UART_MCR_OUT1 0x04 /* Out 1 */
  123. #define UART_MCR_OUT2 0x08 /* Out 2 */
  124. #define UART_MCR_LOOP 0x10 /* Enable loopback test mode */
  125. #define UART_MCR_AFE 0x20 /* Enable auto-RTS/CTS */
  126. #define UART_MCR_DMA_EN 0x04
  127. #define UART_MCR_TX_DFR 0x08
  128. /*
  129. * These are the definitions for the Line Control Register
  130. *
  131. * Note: if the word length is 5 bits (UART_LCR_WLEN5), then setting
  132. * UART_LCR_STOP will select 1.5 stop bits, not 2 stop bits.
  133. */
  134. #define UART_LCR_WLS_MSK 0x03 /* character length select mask */
  135. #define UART_LCR_WLS_5 0x00 /* 5 bit character length */
  136. #define UART_LCR_WLS_6 0x01 /* 6 bit character length */
  137. #define UART_LCR_WLS_7 0x02 /* 7 bit character length */
  138. #define UART_LCR_WLS_8 0x03 /* 8 bit character length */
  139. #define UART_LCR_STB 0x04 /* # stop Bits, off=1, on=1.5 or 2) */
  140. #define UART_LCR_PEN 0x08 /* Parity eneble */
  141. #define UART_LCR_EPS 0x10 /* Even Parity Select */
  142. #define UART_LCR_STKP 0x20 /* Stick Parity */
  143. #define UART_LCR_SBRK 0x40 /* Set Break */
  144. #define UART_LCR_BKSE 0x80 /* Bank select enable */
  145. #define UART_LCR_DLAB 0x80 /* Divisor latch access bit */
  146. /*
  147. * These are the definitions for the Line Status Register
  148. */
  149. #define UART_LSR_DR 0x01 /* Data ready */
  150. #define UART_LSR_OE 0x02 /* Overrun */
  151. #define UART_LSR_PE 0x04 /* Parity error */
  152. #define UART_LSR_FE 0x08 /* Framing error */
  153. #define UART_LSR_BI 0x10 /* Break */
  154. #define UART_LSR_THRE 0x20 /* Xmit holding register empty */
  155. #define UART_LSR_TEMT 0x40 /* Xmitter empty */
  156. #define UART_LSR_ERR 0x80 /* Error */
  157. #define UART_MSR_DCD 0x80 /* Data Carrier Detect */
  158. #define UART_MSR_RI 0x40 /* Ring Indicator */
  159. #define UART_MSR_DSR 0x20 /* Data Set Ready */
  160. #define UART_MSR_CTS 0x10 /* Clear to Send */
  161. #define UART_MSR_DDCD 0x08 /* Delta DCD */
  162. #define UART_MSR_TERI 0x04 /* Trailing edge ring indicator */
  163. #define UART_MSR_DDSR 0x02 /* Delta DSR */
  164. #define UART_MSR_DCTS 0x01 /* Delta CTS */
  165. /*
  166. * These are the definitions for the Interrupt Identification Register
  167. */
  168. #define UART_IIR_NO_INT 0x01 /* No interrupts pending */
  169. #define UART_IIR_ID 0x06 /* Mask for the interrupt ID */
  170. #define UART_IIR_MSI 0x00 /* Modem status interrupt */
  171. #define UART_IIR_THRI 0x02 /* Transmitter holding register empty */
  172. #define UART_IIR_RDI 0x04 /* Receiver data interrupt */
  173. #define UART_IIR_RLSI 0x06 /* Receiver line status interrupt */
  174. /*
  175. * These are the definitions for the Interrupt Enable Register
  176. */
  177. #define UART_IER_MSI 0x08 /* Enable Modem status interrupt */
  178. #define UART_IER_RLSI 0x04 /* Enable receiver line status interrupt */
  179. #define UART_IER_THRI 0x02 /* Enable Transmitter holding register int. */
  180. #define UART_IER_RDI 0x01 /* Enable receiver data interrupt */
  181. /* useful defaults for LCR */
  182. #define UART_LCR_8N1 0x03
  183. void NS16550_init(NS16550_t com_port, int baud_divisor);
  184. void NS16550_putc(NS16550_t com_port, char c);
  185. char NS16550_getc(NS16550_t com_port);
  186. int NS16550_tstc(NS16550_t com_port);
  187. void NS16550_reinit(NS16550_t com_port, int baud_divisor);
  188. /**
  189. * ns16550_calc_divisor() - calculate the divisor given clock and baud rate
  190. *
  191. * Given the UART input clock and required baudrate, calculate the divisor
  192. * that should be used.
  193. *
  194. * @port: UART port
  195. * @clock: UART input clock speed in Hz
  196. * @baudrate: Required baud rate
  197. * @return baud rate divisor that should be used
  198. */
  199. int ns16550_calc_divisor(NS16550_t port, int clock, int baudrate);
  200. /**
  201. * ns16550_serial_ofdata_to_platdata() - convert DT to platform data
  202. *
  203. * Decode a device tree node for an ns16550 device. This includes the
  204. * register base address and register shift properties. The caller must set
  205. * up the clock frequency.
  206. *
  207. * @dev: dev to decode platform data for
  208. * @return: 0 if OK, -EINVAL on error
  209. */
  210. int ns16550_serial_ofdata_to_platdata(struct udevice *dev);
  211. /**
  212. * ns16550_serial_probe() - probe a serial port
  213. *
  214. * This sets up the serial port ready for use, except for the baud rate
  215. * @return 0, or -ve on error
  216. */
  217. int ns16550_serial_probe(struct udevice *dev);
  218. /**
  219. * struct ns16550_serial_ops - ns16550 serial operations
  220. *
  221. * These should be used by the client driver for the driver's 'ops' member
  222. */
  223. extern const struct dm_serial_ops ns16550_serial_ops;