Blame view

include/serial.h 5.98 KB
281e00a3b   wdenk   * Code cleanup
1
2
  #ifndef __SERIAL_H__
  #define __SERIAL_H__
7b826c2f3   Mike Frysinger   serial: implement...
3
  #include <post.h>
281e00a3b   wdenk   * Code cleanup
4
  struct serial_device {
f6add132f   Mike Frysinger   net/miiphy/serial...
5
  	/* enough bytes to match alignment of following func pointer */
78322d63e   Marek Vasut   serial: Coding st...
6
  	char	name[16];
281e00a3b   wdenk   * Code cleanup
7

89143fb3b   Marek Vasut   serial: Rename .i...
8
9
  	int	(*start)(void);
  	int	(*stop)(void);
78322d63e   Marek Vasut   serial: Coding st...
10
11
12
13
14
  	void	(*setbrg)(void);
  	int	(*getc)(void);
  	int	(*tstc)(void);
  	void	(*putc)(const char c);
  	void	(*puts)(const char *s);
7b826c2f3   Mike Frysinger   serial: implement...
15
  #if CONFIG_POST & CONFIG_SYS_POST_UART
78322d63e   Marek Vasut   serial: Coding st...
16
  	void	(*loop)(int);
7b826c2f3   Mike Frysinger   serial: implement...
17
  #endif
78322d63e   Marek Vasut   serial: Coding st...
18
  	struct serial_device	*next;
281e00a3b   wdenk   * Code cleanup
19
  };
bfb7d7a3d   Marek Vasut   serial: Implement...
20
  void default_serial_puts(const char *s);
281e00a3b   wdenk   * Code cleanup
21
22
  extern struct serial_device serial_smc_device;
  extern struct serial_device serial_scc_device;
a6e6f7f4d   Gerlando Falauto   serial: cosmetic ...
23
  extern struct serial_device *default_serial_console(void);
98f705c9c   Heiko Schocher   powerpc: remove 4...
24
  #if	defined(CONFIG_MPC83xx) || defined(CONFIG_MPC85xx) || \
064b55cfc   Heiko Schocher   powerpc, 5xxx, 51...
25
  	defined(CONFIG_MPC86xx) || \
6d6c0baeb   Tom Warren   Tegra30: Add gene...
26
  	defined(CONFIG_TEGRA) || defined(CONFIG_SYS_COREBOOT) || \
7636ebe1d   Michal Simek   serial: Support s...
27
  	defined(CONFIG_MICROBLAZE)
ff36fd859   wdenk   * Patch by Leif L...
28
29
  extern struct serial_device serial0_device;
  extern struct serial_device serial1_device;
abc0ed8da   Marek Vasut   serial: ns16550: ...
30
  #endif
0fd30252c   Wolfgang Denk   Make the serial d...
31
32
  extern struct serial_device eserial1_device;
  extern struct serial_device eserial2_device;
3d16389c9   Lokesh Vutla   board: am335x: Al...
33
34
35
36
  extern struct serial_device eserial3_device;
  extern struct serial_device eserial4_device;
  extern struct serial_device eserial5_device;
  extern struct serial_device eserial6_device;
ff36fd859   wdenk   * Patch by Leif L...
37

635f330fc   Mike Frysinger   Blackfin: uart: a...
38
  extern void serial_register(struct serial_device *);
281e00a3b   wdenk   * Code cleanup
39
  extern void serial_initialize(void);
52cb4d4fb   Jean-Christophe PLAGNIOL-VILLARD   stdio/device: rew...
40
  extern void serial_stdio_init(void);
7813ca9b6   Gerlando Falauto   serial: constify ...
41
  extern int serial_assign(const char *name);
281e00a3b   wdenk   * Code cleanup
42
  extern void serial_reinit_all(void);
6299487ef   Tom Rix   USBTTY make some ...
43
  /* For usbtty */
2ec1abea4   Tom Rix   OMAP3 zoom2 Use u...
44
  #ifdef CONFIG_USB_TTY
6299487ef   Tom Rix   USBTTY make some ...
45
46
47
48
  extern int usbtty_getc(void);
  extern void usbtty_putc(const char c);
  extern void usbtty_puts(const char *str);
  extern int usbtty_tstc(void);
2ec1abea4   Tom Rix   OMAP3 zoom2 Use u...
49
50
51
52
53
54
55
56
57
  #else
  
  /* stubs */
  #define usbtty_getc() 0
  #define usbtty_putc(a)
  #define usbtty_puts(a)
  #define usbtty_tstc() 0
  
  #endif /* CONFIG_USB_TTY */
57d92753d   Simon Glass   dm: Add a uclass ...
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
  struct udevice;
  
  /**
   * struct struct dm_serial_ops - Driver model serial operations
   *
   * The uclass interface is implemented by all serial devices which use
   * driver model.
   */
  struct dm_serial_ops {
  	/**
  	 * setbrg() - Set up the baud rate generator
  	 *
  	 * Adjust baud rate divisors to set up a new baud rate for this
  	 * device. Not all devices will support all rates. If the rate
  	 * cannot be supported, the driver is free to select the nearest
  	 * available rate. or return -EINVAL if this is not possible.
  	 *
  	 * @dev: Device pointer
  	 * @baudrate: New baud rate to use
  	 * @return 0 if OK, -ve on error
  	 */
  	int (*setbrg)(struct udevice *dev, int baudrate);
  	/**
  	 * getc() - Read a character and return it
  	 *
  	 * If no character is available, this should return -EAGAIN without
  	 * waiting.
  	 *
  	 * @dev: Device pointer
  	 * @return character (0..255), -ve on error
  	 */
  	int (*getc)(struct udevice *dev);
  	/**
aa08894ff   Peng Fan   MLK-20373-2 dm: s...
91
92
93
94
95
96
97
98
  	 * puts() - puts a string
  	 *
  	 * @dev: Device pointer
  	 * @str: string to write
  	 * @return 0 if OK, -ve on error
  	 */
  	int (*puts)(struct udevice *dev, const char *str);
  	/**
57d92753d   Simon Glass   dm: Add a uclass ...
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
  	 * putc() - Write a character
  	 *
  	 * @dev: Device pointer
  	 * @ch: character to write
  	 * @return 0 if OK, -ve on error
  	 */
  	int (*putc)(struct udevice *dev, const char ch);
  	/**
  	 * pending() - Check if input/output characters are waiting
  	 *
  	 * This can be used to return an indication of the number of waiting
  	 * characters if the driver knows this (e.g. by looking at the FIFO
  	 * level). It is acceptable to return 1 if an indeterminant number
  	 * of characters is waiting.
  	 *
  	 * This method is optional.
  	 *
  	 * @dev: Device pointer
  	 * @input: true to check input characters, false for output
  	 * @return number of waiting characters, 0 for none, -ve on error
  	 */
  	int (*pending)(struct udevice *dev, bool input);
  	/**
  	 * clear() - Clear the serial FIFOs/holding registers
  	 *
  	 * This method is optional.
  	 *
  	 * This quickly clears any input/output characters from the UART.
  	 * If this is not possible, but characters still exist, then it
  	 * is acceptable to return -EAGAIN (try again) or -EINVAL (not
  	 * supported).
  	 *
  	 * @dev: Device pointer
  	 * @return 0 if OK, -ve on error
  	 */
  	int (*clear)(struct udevice *dev);
  #if CONFIG_POST & CONFIG_SYS_POST_UART
  	/**
  	 * loop() - Control serial device loopback mode
  	 *
  	 * @dev: Device pointer
  	 * @on: 1 to turn loopback on, 0 to turn if off
  	 */
  	int (*loop)(struct udevice *dev, int on);
  #endif
  };
  
  /**
   * struct serial_dev_priv - information about a device used by the uclass
   *
3ca7a06af   Stefan Roese   serial: serial-uc...
149
150
151
152
153
   * @sdev:	stdio device attached to this uart
   *
   * @buf:	Pointer to the RX buffer
   * @rd_ptr:	Read pointer in the RX buffer
   * @wr_ptr:	Write pointer in the RX buffer
57d92753d   Simon Glass   dm: Add a uclass ...
154
155
156
   */
  struct serial_dev_priv {
  	struct stdio_dev *sdev;
3ca7a06af   Stefan Roese   serial: serial-uc...
157
158
159
160
  
  	char *buf;
  	int rd_ptr;
  	int wr_ptr;
57d92753d   Simon Glass   dm: Add a uclass ...
161
162
163
164
  };
  
  /* Access the serial operations for a device */
  #define serial_get_ops(dev)	((struct dm_serial_ops *)(dev)->driver->ops)
94a255dfb   Jeroen Hofstee   serial: add proto...
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
  void amirix_serial_initialize(void);
  void arc_serial_initialize(void);
  void arm_dcc_initialize(void);
  void asc_serial_initialize(void);
  void atmel_serial_initialize(void);
  void au1x00_serial_initialize(void);
  void bfin_jtag_initialize(void);
  void bfin_serial_initialize(void);
  void bmw_serial_initialize(void);
  void clps7111_serial_initialize(void);
  void cogent_serial_initialize(void);
  void cpci750_serial_initialize(void);
  void evb64260_serial_initialize(void);
  void imx_serial_initialize(void);
  void iop480_serial_initialize(void);
  void jz_serial_initialize(void);
94a255dfb   Jeroen Hofstee   serial: add proto...
181
182
183
184
185
186
187
188
  void leon2_serial_initialize(void);
  void leon3_serial_initialize(void);
  void lh7a40x_serial_initialize(void);
  void lpc32xx_serial_initialize(void);
  void marvell_serial_initialize(void);
  void max3100_serial_initialize(void);
  void mcf_serial_initialize(void);
  void ml2_serial_initialize(void);
94a255dfb   Jeroen Hofstee   serial: add proto...
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
  void mpc85xx_serial_initialize(void);
  void mpc8xx_serial_initialize(void);
  void mxc_serial_initialize(void);
  void mxs_auart_initialize(void);
  void ns16550_serial_initialize(void);
  void oc_serial_initialize(void);
  void p3mx_serial_initialize(void);
  void pl01x_serial_initialize(void);
  void pxa_serial_initialize(void);
  void s3c24xx_serial_initialize(void);
  void s5p_serial_initialize(void);
  void sa1100_serial_initialize(void);
  void sandbox_serial_initialize(void);
  void sconsole_serial_initialize(void);
  void sh_serial_initialize(void);
  void uartlite_serial_initialize(void);
  void zynq_serial_initialize(void);
281e00a3b   wdenk   * Code cleanup
206
  #endif