ns16550.h 7.7 KB

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