]> git.ipfire.org Git - people/ms/u-boot.git/blame - include/serial.h
Convert CONFIG_BOOTCOUNT_ENV to Kconfig
[people/ms/u-boot.git] / include / serial.h
CommitLineData
281e00a3
WD
1#ifndef __SERIAL_H__
2#define __SERIAL_H__
3
7b826c2f
MF
4#include <post.h>
5
281e00a3 6struct serial_device {
f6add132 7 /* enough bytes to match alignment of following func pointer */
78322d63 8 char name[16];
281e00a3 9
89143fb3
MV
10 int (*start)(void);
11 int (*stop)(void);
78322d63
MV
12 void (*setbrg)(void);
13 int (*getc)(void);
14 int (*tstc)(void);
15 void (*putc)(const char c);
16 void (*puts)(const char *s);
7b826c2f 17#if CONFIG_POST & CONFIG_SYS_POST_UART
78322d63 18 void (*loop)(int);
7b826c2f 19#endif
78322d63 20 struct serial_device *next;
281e00a3
WD
21};
22
bfb7d7a3
MV
23void default_serial_puts(const char *s);
24
281e00a3
WD
25extern struct serial_device serial_smc_device;
26extern struct serial_device serial_scc_device;
a6e6f7f4
GF
27extern struct serial_device *default_serial_console(void);
28
98f705c9 29#if defined(CONFIG_MPC83xx) || defined(CONFIG_MPC85xx) || \
064b55cf 30 defined(CONFIG_MPC86xx) || \
6d6c0bae 31 defined(CONFIG_TEGRA) || defined(CONFIG_SYS_COREBOOT) || \
7636ebe1 32 defined(CONFIG_MICROBLAZE)
ff36fd85
WD
33extern struct serial_device serial0_device;
34extern struct serial_device serial1_device;
abc0ed8d
MV
35#endif
36
0fd30252
WD
37extern struct serial_device eserial1_device;
38extern struct serial_device eserial2_device;
3d16389c
LV
39extern struct serial_device eserial3_device;
40extern struct serial_device eserial4_device;
41extern struct serial_device eserial5_device;
42extern struct serial_device eserial6_device;
ff36fd85 43
635f330f 44extern void serial_register(struct serial_device *);
281e00a3 45extern void serial_initialize(void);
52cb4d4f 46extern void serial_stdio_init(void);
7813ca9b 47extern int serial_assign(const char *name);
281e00a3
WD
48extern void serial_reinit_all(void);
49
6299487e 50/* For usbtty */
2ec1abea
TR
51#ifdef CONFIG_USB_TTY
52
6299487e
TR
53extern int usbtty_getc(void);
54extern void usbtty_putc(const char c);
55extern void usbtty_puts(const char *str);
56extern int usbtty_tstc(void);
57
2ec1abea
TR
58#else
59
60/* stubs */
61#define usbtty_getc() 0
62#define usbtty_putc(a)
63#define usbtty_puts(a)
64#define usbtty_tstc() 0
65
66#endif /* CONFIG_USB_TTY */
67
57d92753
SG
68struct udevice;
69
70/**
71 * struct struct dm_serial_ops - Driver model serial operations
72 *
73 * The uclass interface is implemented by all serial devices which use
74 * driver model.
75 */
76struct dm_serial_ops {
77 /**
78 * setbrg() - Set up the baud rate generator
79 *
80 * Adjust baud rate divisors to set up a new baud rate for this
81 * device. Not all devices will support all rates. If the rate
82 * cannot be supported, the driver is free to select the nearest
83 * available rate. or return -EINVAL if this is not possible.
84 *
85 * @dev: Device pointer
86 * @baudrate: New baud rate to use
87 * @return 0 if OK, -ve on error
88 */
89 int (*setbrg)(struct udevice *dev, int baudrate);
90 /**
91 * getc() - Read a character and return it
92 *
93 * If no character is available, this should return -EAGAIN without
94 * waiting.
95 *
96 * @dev: Device pointer
97 * @return character (0..255), -ve on error
98 */
99 int (*getc)(struct udevice *dev);
100 /**
101 * putc() - Write a character
102 *
103 * @dev: Device pointer
104 * @ch: character to write
105 * @return 0 if OK, -ve on error
106 */
107 int (*putc)(struct udevice *dev, const char ch);
108 /**
109 * pending() - Check if input/output characters are waiting
110 *
111 * This can be used to return an indication of the number of waiting
112 * characters if the driver knows this (e.g. by looking at the FIFO
113 * level). It is acceptable to return 1 if an indeterminant number
114 * of characters is waiting.
115 *
116 * This method is optional.
117 *
118 * @dev: Device pointer
119 * @input: true to check input characters, false for output
120 * @return number of waiting characters, 0 for none, -ve on error
121 */
122 int (*pending)(struct udevice *dev, bool input);
123 /**
124 * clear() - Clear the serial FIFOs/holding registers
125 *
126 * This method is optional.
127 *
128 * This quickly clears any input/output characters from the UART.
129 * If this is not possible, but characters still exist, then it
130 * is acceptable to return -EAGAIN (try again) or -EINVAL (not
131 * supported).
132 *
133 * @dev: Device pointer
134 * @return 0 if OK, -ve on error
135 */
136 int (*clear)(struct udevice *dev);
137#if CONFIG_POST & CONFIG_SYS_POST_UART
138 /**
139 * loop() - Control serial device loopback mode
140 *
141 * @dev: Device pointer
142 * @on: 1 to turn loopback on, 0 to turn if off
143 */
144 int (*loop)(struct udevice *dev, int on);
145#endif
146};
147
148/**
149 * struct serial_dev_priv - information about a device used by the uclass
150 *
3ca7a06a
SR
151 * @sdev: stdio device attached to this uart
152 *
153 * @buf: Pointer to the RX buffer
154 * @rd_ptr: Read pointer in the RX buffer
155 * @wr_ptr: Write pointer in the RX buffer
57d92753
SG
156 */
157struct serial_dev_priv {
158 struct stdio_dev *sdev;
3ca7a06a
SR
159
160 char *buf;
161 int rd_ptr;
162 int wr_ptr;
57d92753
SG
163};
164
165/* Access the serial operations for a device */
166#define serial_get_ops(dev) ((struct dm_serial_ops *)(dev)->driver->ops)
167
94a255df
JH
168void amirix_serial_initialize(void);
169void arc_serial_initialize(void);
170void arm_dcc_initialize(void);
171void asc_serial_initialize(void);
172void atmel_serial_initialize(void);
173void au1x00_serial_initialize(void);
174void bfin_jtag_initialize(void);
175void bfin_serial_initialize(void);
176void bmw_serial_initialize(void);
177void clps7111_serial_initialize(void);
178void cogent_serial_initialize(void);
179void cpci750_serial_initialize(void);
180void evb64260_serial_initialize(void);
181void imx_serial_initialize(void);
182void iop480_serial_initialize(void);
183void jz_serial_initialize(void);
94a255df
JH
184void leon2_serial_initialize(void);
185void leon3_serial_initialize(void);
186void lh7a40x_serial_initialize(void);
187void lpc32xx_serial_initialize(void);
188void marvell_serial_initialize(void);
189void max3100_serial_initialize(void);
190void mcf_serial_initialize(void);
191void ml2_serial_initialize(void);
94a255df
JH
192void mpc85xx_serial_initialize(void);
193void mpc8xx_serial_initialize(void);
194void mxc_serial_initialize(void);
195void mxs_auart_initialize(void);
196void ns16550_serial_initialize(void);
197void oc_serial_initialize(void);
198void p3mx_serial_initialize(void);
199void pl01x_serial_initialize(void);
200void pxa_serial_initialize(void);
201void s3c24xx_serial_initialize(void);
202void s5p_serial_initialize(void);
203void sa1100_serial_initialize(void);
204void sandbox_serial_initialize(void);
205void sconsole_serial_initialize(void);
206void sh_serial_initialize(void);
207void uartlite_serial_initialize(void);
208void zynq_serial_initialize(void);
209
281e00a3 210#endif