2 * arch/arm/plat-omap/include/mach/mcbsp.h
4 * Defines for Multi-Channel Buffered Serial Port
6 * Copyright (C) 2002 RidgeRun, Inc.
7 * Author: Steve Johnson
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
24 #ifndef __ASM_ARCH_OMAP_MCBSP_H
25 #define __ASM_ARCH_OMAP_MCBSP_H
27 #include <linux/completion.h>
28 #include <linux/spinlock.h>
30 #include <mach/hardware.h>
31 #include <plat/clock.h>
33 /* macro for building platform_device for McBSP ports */
34 #define OMAP_MCBSP_PLATFORM_DEVICE(port_nr) \
35 static struct platform_device omap_mcbsp##port_nr = { \
36 .name = "omap-mcbsp-dai", \
37 .id = OMAP_MCBSP##port_nr, \
40 #define MCBSP_CONFIG_TYPE2 0x2
41 #define MCBSP_CONFIG_TYPE3 0x3
42 #define MCBSP_CONFIG_TYPE4 0x4
44 #define OMAP7XX_MCBSP1_BASE 0xfffb1000
45 #define OMAP7XX_MCBSP2_BASE 0xfffb1800
47 #define OMAP1510_MCBSP1_BASE 0xe1011800
48 #define OMAP1510_MCBSP2_BASE 0xfffb1000
49 #define OMAP1510_MCBSP3_BASE 0xe1017000
51 #define OMAP1610_MCBSP1_BASE 0xe1011800
52 #define OMAP1610_MCBSP2_BASE 0xfffb1000
53 #define OMAP1610_MCBSP3_BASE 0xe1017000
55 #ifdef CONFIG_ARCH_OMAP1
57 #define OMAP_MCBSP_REG_DRR2 0x00
58 #define OMAP_MCBSP_REG_DRR1 0x02
59 #define OMAP_MCBSP_REG_DXR2 0x04
60 #define OMAP_MCBSP_REG_DXR1 0x06
61 #define OMAP_MCBSP_REG_DRR 0x02
62 #define OMAP_MCBSP_REG_DXR 0x06
63 #define OMAP_MCBSP_REG_SPCR2 0x08
64 #define OMAP_MCBSP_REG_SPCR1 0x0a
65 #define OMAP_MCBSP_REG_RCR2 0x0c
66 #define OMAP_MCBSP_REG_RCR1 0x0e
67 #define OMAP_MCBSP_REG_XCR2 0x10
68 #define OMAP_MCBSP_REG_XCR1 0x12
69 #define OMAP_MCBSP_REG_SRGR2 0x14
70 #define OMAP_MCBSP_REG_SRGR1 0x16
71 #define OMAP_MCBSP_REG_MCR2 0x18
72 #define OMAP_MCBSP_REG_MCR1 0x1a
73 #define OMAP_MCBSP_REG_RCERA 0x1c
74 #define OMAP_MCBSP_REG_RCERB 0x1e
75 #define OMAP_MCBSP_REG_XCERA 0x20
76 #define OMAP_MCBSP_REG_XCERB 0x22
77 #define OMAP_MCBSP_REG_PCR0 0x24
78 #define OMAP_MCBSP_REG_RCERC 0x26
79 #define OMAP_MCBSP_REG_RCERD 0x28
80 #define OMAP_MCBSP_REG_XCERC 0x2A
81 #define OMAP_MCBSP_REG_XCERD 0x2C
82 #define OMAP_MCBSP_REG_RCERE 0x2E
83 #define OMAP_MCBSP_REG_RCERF 0x30
84 #define OMAP_MCBSP_REG_XCERE 0x32
85 #define OMAP_MCBSP_REG_XCERF 0x34
86 #define OMAP_MCBSP_REG_RCERG 0x36
87 #define OMAP_MCBSP_REG_RCERH 0x38
88 #define OMAP_MCBSP_REG_XCERG 0x3A
89 #define OMAP_MCBSP_REG_XCERH 0x3C
91 /* Dummy defines, these are not available on omap1 */
92 #define OMAP_MCBSP_REG_XCCR 0x00
93 #define OMAP_MCBSP_REG_RCCR 0x00
97 #define OMAP_MCBSP_REG_DRR2 0x00
98 #define OMAP_MCBSP_REG_DRR1 0x04
99 #define OMAP_MCBSP_REG_DXR2 0x08
100 #define OMAP_MCBSP_REG_DXR1 0x0C
101 #define OMAP_MCBSP_REG_DRR 0x00
102 #define OMAP_MCBSP_REG_DXR 0x08
103 #define OMAP_MCBSP_REG_SPCR2 0x10
104 #define OMAP_MCBSP_REG_SPCR1 0x14
105 #define OMAP_MCBSP_REG_RCR2 0x18
106 #define OMAP_MCBSP_REG_RCR1 0x1C
107 #define OMAP_MCBSP_REG_XCR2 0x20
108 #define OMAP_MCBSP_REG_XCR1 0x24
109 #define OMAP_MCBSP_REG_SRGR2 0x28
110 #define OMAP_MCBSP_REG_SRGR1 0x2C
111 #define OMAP_MCBSP_REG_MCR2 0x30
112 #define OMAP_MCBSP_REG_MCR1 0x34
113 #define OMAP_MCBSP_REG_RCERA 0x38
114 #define OMAP_MCBSP_REG_RCERB 0x3C
115 #define OMAP_MCBSP_REG_XCERA 0x40
116 #define OMAP_MCBSP_REG_XCERB 0x44
117 #define OMAP_MCBSP_REG_PCR0 0x48
118 #define OMAP_MCBSP_REG_RCERC 0x4C
119 #define OMAP_MCBSP_REG_RCERD 0x50
120 #define OMAP_MCBSP_REG_XCERC 0x54
121 #define OMAP_MCBSP_REG_XCERD 0x58
122 #define OMAP_MCBSP_REG_RCERE 0x5C
123 #define OMAP_MCBSP_REG_RCERF 0x60
124 #define OMAP_MCBSP_REG_XCERE 0x64
125 #define OMAP_MCBSP_REG_XCERF 0x68
126 #define OMAP_MCBSP_REG_RCERG 0x6C
127 #define OMAP_MCBSP_REG_RCERH 0x70
128 #define OMAP_MCBSP_REG_XCERG 0x74
129 #define OMAP_MCBSP_REG_XCERH 0x78
130 #define OMAP_MCBSP_REG_SYSCON 0x8C
131 #define OMAP_MCBSP_REG_THRSH2 0x90
132 #define OMAP_MCBSP_REG_THRSH1 0x94
133 #define OMAP_MCBSP_REG_IRQST 0xA0
134 #define OMAP_MCBSP_REG_IRQEN 0xA4
135 #define OMAP_MCBSP_REG_WAKEUPEN 0xA8
136 #define OMAP_MCBSP_REG_XCCR 0xAC
137 #define OMAP_MCBSP_REG_RCCR 0xB0
138 #define OMAP_MCBSP_REG_XBUFFSTAT 0xB4
139 #define OMAP_MCBSP_REG_RBUFFSTAT 0xB8
140 #define OMAP_MCBSP_REG_SSELCR 0xBC
142 #define OMAP_ST_REG_REV 0x00
143 #define OMAP_ST_REG_SYSCONFIG 0x10
144 #define OMAP_ST_REG_IRQSTATUS 0x18
145 #define OMAP_ST_REG_IRQENABLE 0x1C
146 #define OMAP_ST_REG_SGAINCR 0x24
147 #define OMAP_ST_REG_SFIRCR 0x28
148 #define OMAP_ST_REG_SSELCR 0x2C
152 /************************** McBSP SPCR1 bit definitions ***********************/
156 #define RSYNC_ERR 0x0008
157 #define RINTM(value) ((value)<<4) /* bits 4:5 */
160 #define CLKSTP(value) ((value)<<11) /* bits 11:12 */
161 #define RJUST(value) ((value)<<13) /* bits 13:14 */
165 /************************** McBSP SPCR2 bit definitions ***********************/
168 #define XEMPTY 0x0004
169 #define XSYNC_ERR 0x0008
170 #define XINTM(value) ((value)<<4) /* bits 4:5 */
176 /************************** McBSP PCR bit definitions *************************/
181 #define DR_STAT 0x0010
182 #define DX_STAT 0x0020
183 #define CLKS_STAT 0x0040
184 #define SCLKME 0x0080
191 #define IDLE_EN 0x4000
193 /************************** McBSP RCR1 bit definitions ************************/
194 #define RWDLEN1(value) ((value)<<5) /* Bits 5:7 */
195 #define RFRLEN1(value) ((value)<<8) /* Bits 8:14 */
197 /************************** McBSP XCR1 bit definitions ************************/
198 #define XWDLEN1(value) ((value)<<5) /* Bits 5:7 */
199 #define XFRLEN1(value) ((value)<<8) /* Bits 8:14 */
201 /*************************** McBSP RCR2 bit definitions ***********************/
202 #define RDATDLY(value) (value) /* Bits 0:1 */
204 #define RCOMPAND(value) ((value)<<3) /* Bits 3:4 */
205 #define RWDLEN2(value) ((value)<<5) /* Bits 5:7 */
206 #define RFRLEN2(value) ((value)<<8) /* Bits 8:14 */
207 #define RPHASE 0x8000
209 /*************************** McBSP XCR2 bit definitions ***********************/
210 #define XDATDLY(value) (value) /* Bits 0:1 */
212 #define XCOMPAND(value) ((value)<<3) /* Bits 3:4 */
213 #define XWDLEN2(value) ((value)<<5) /* Bits 5:7 */
214 #define XFRLEN2(value) ((value)<<8) /* Bits 8:14 */
215 #define XPHASE 0x8000
217 /************************* McBSP SRGR1 bit definitions ************************/
218 #define CLKGDV(value) (value) /* Bits 0:7 */
219 #define FWID(value) ((value)<<8) /* Bits 8:15 */
221 /************************* McBSP SRGR2 bit definitions ************************/
222 #define FPER(value) (value) /* Bits 0:11 */
228 /************************* McBSP MCR1 bit definitions *************************/
230 #define RCBLK(value) ((value)<<2) /* Bits 2:4 */
231 #define RPABLK(value) ((value)<<5) /* Bits 5:6 */
232 #define RPBBLK(value) ((value)<<7) /* Bits 7:8 */
234 /************************* McBSP MCR2 bit definitions *************************/
235 #define XMCM(value) (value) /* Bits 0:1 */
236 #define XCBLK(value) ((value)<<2) /* Bits 2:4 */
237 #define XPABLK(value) ((value)<<5) /* Bits 5:6 */
238 #define XPBBLK(value) ((value)<<7) /* Bits 7:8 */
240 /*********************** McBSP XCCR bit definitions *************************/
241 #define EXTCLKGATE 0x8000
242 #define PPCONNECT 0x4000
243 #define DXENDLY(value) ((value)<<12) /* Bits 12:13 */
244 #define XFULL_CYCLE 0x0800
246 #define XDMAEN 0x0008
247 #define XDISABLE 0x0001
249 /********************** McBSP RCCR bit definitions *************************/
250 #define RFULL_CYCLE 0x0800
251 #define RDMAEN 0x0008
252 #define RDISABLE 0x0001
254 /********************** McBSP SYSCONFIG bit definitions ********************/
255 #define CLOCKACTIVITY(value) ((value)<<8)
256 #define SIDLEMODE(value) ((value)<<3)
257 #define ENAWAKEUP 0x0004
258 #define SOFTRST 0x0002
260 /********************** McBSP SSELCR bit definitions ***********************/
261 #define SIDETONEEN 0x0400
263 /********************** McBSP Sidetone SYSCONFIG bit definitions ***********/
264 #define ST_AUTOIDLE 0x0001
266 /********************** McBSP Sidetone SGAINCR bit definitions *************/
267 #define ST_CH1GAIN(value) ((value<<16)) /* Bits 16:31 */
268 #define ST_CH0GAIN(value) (value) /* Bits 0:15 */
270 /********************** McBSP Sidetone SFIRCR bit definitions **************/
271 #define ST_FIRCOEFF(value) (value) /* Bits 0:15 */
273 /********************** McBSP Sidetone SSELCR bit definitions **************/
274 #define ST_COEFFWRDONE 0x0004
275 #define ST_COEFFWREN 0x0002
276 #define ST_SIDETONEEN 0x0001
278 /********************** McBSP DMA operating modes **************************/
279 #define MCBSP_DMA_MODE_ELEMENT 0
280 #define MCBSP_DMA_MODE_THRESHOLD 1
281 #define MCBSP_DMA_MODE_FRAME 2
283 /********************** McBSP WAKEUPEN bit definitions *********************/
284 #define XEMPTYEOFEN 0x4000
285 #define XRDYEN 0x0400
286 #define XEOFEN 0x0200
287 #define XFSXEN 0x0100
288 #define XSYNCERREN 0x0080
289 #define RRDYEN 0x0008
290 #define REOFEN 0x0004
291 #define RFSREN 0x0002
292 #define RSYNCERREN 0x0001
294 /* CLKR signal muxing options */
295 #define CLKR_SRC_CLKR 0
296 #define CLKR_SRC_CLKX 1
298 /* FSR signal muxing options */
299 #define FSR_SRC_FSR 0
300 #define FSR_SRC_FSX 1
302 /* McBSP functional clock sources */
303 #define MCBSP_CLKS_PRCM_SRC 0
304 #define MCBSP_CLKS_PAD_SRC 1
306 /* we don't do multichannel for now */
307 struct omap_mcbsp_reg_cfg {
343 typedef int __bitwise omap_mcbsp_io_type_t;
344 #define OMAP_MCBSP_IRQ_IO ((__force omap_mcbsp_io_type_t) 1)
345 #define OMAP_MCBSP_POLL_IO ((__force omap_mcbsp_io_type_t) 2)
348 OMAP_MCBSP_WORD_8 = 0,
354 } omap_mcbsp_word_length;
356 /* Platform specific configuration */
357 struct omap_mcbsp_ops {
358 void (*request)(unsigned int);
359 void (*free)(unsigned int);
360 int (*set_clks_src)(u8, u8);
363 struct omap_mcbsp_platform_data {
364 unsigned long phys_base;
365 u8 dma_rx_sync, dma_tx_sync;
367 struct omap_mcbsp_ops *ops;
368 #ifdef CONFIG_ARCH_OMAP3
369 /* Sidetone block for McBSP 2 and 3 */
370 unsigned long phys_base_st;
373 unsigned int mcbsp_config_type;
376 struct omap_mcbsp_st_data {
377 void __iomem *io_base_st;
380 s16 taps[128]; /* Sidetone filter coefficients */
381 int nr_taps; /* Number of filter coefficients in use */
388 unsigned long phys_base;
389 unsigned long phys_dma_base;
390 void __iomem *io_base;
393 omap_mcbsp_word_length rx_word_length;
394 omap_mcbsp_word_length tx_word_length;
396 omap_mcbsp_io_type_t io_type; /* IRQ or poll */
397 /* IRQ based TX/RX */
407 /* Completion queues */
408 struct completion tx_irq_completion;
409 struct completion rx_irq_completion;
410 struct completion tx_dma_completion;
411 struct completion rx_dma_completion;
413 /* Protect the field .free, while checking if the mcbsp is in use */
415 struct omap_mcbsp_platform_data *pdata;
417 #ifdef CONFIG_ARCH_OMAP3
418 struct omap_mcbsp_st_data *st_data;
424 unsigned int mcbsp_config_type;
428 * omap_mcbsp_dev_attr - OMAP McBSP device attributes for omap_hwmod
429 * @sidetone: name of the sidetone device
431 struct omap_mcbsp_dev_attr {
432 const char *sidetone;
435 extern struct omap_mcbsp **mcbsp_ptr;
436 extern int omap_mcbsp_count, omap_mcbsp_cache_size;
438 #define omap_mcbsp_check_valid_id(id) (id < omap_mcbsp_count)
439 #define id_to_mcbsp_ptr(id) mcbsp_ptr[id];
441 int omap_mcbsp_init(void);
442 void omap_mcbsp_register_board_cfg(struct resource *res, int res_count,
443 struct omap_mcbsp_platform_data *config, int size);
444 void omap_mcbsp_config(unsigned int id, const struct omap_mcbsp_reg_cfg * config);
445 #ifdef CONFIG_ARCH_OMAP3
446 void omap_mcbsp_set_tx_threshold(unsigned int id, u16 threshold);
447 void omap_mcbsp_set_rx_threshold(unsigned int id, u16 threshold);
448 u16 omap_mcbsp_get_max_tx_threshold(unsigned int id);
449 u16 omap_mcbsp_get_max_rx_threshold(unsigned int id);
450 u16 omap_mcbsp_get_fifo_size(unsigned int id);
451 u16 omap_mcbsp_get_tx_delay(unsigned int id);
452 u16 omap_mcbsp_get_rx_delay(unsigned int id);
453 int omap_mcbsp_get_dma_op_mode(unsigned int id);
455 static inline void omap_mcbsp_set_tx_threshold(unsigned int id, u16 threshold)
457 static inline void omap_mcbsp_set_rx_threshold(unsigned int id, u16 threshold)
459 static inline u16 omap_mcbsp_get_max_tx_threshold(unsigned int id) { return 0; }
460 static inline u16 omap_mcbsp_get_max_rx_threshold(unsigned int id) { return 0; }
461 static inline u16 omap_mcbsp_get_fifo_size(unsigned int id) { return 0; }
462 static inline u16 omap_mcbsp_get_tx_delay(unsigned int id) { return 0; }
463 static inline u16 omap_mcbsp_get_rx_delay(unsigned int id) { return 0; }
464 static inline int omap_mcbsp_get_dma_op_mode(unsigned int id) { return 0; }
466 int omap_mcbsp_request(unsigned int id);
467 void omap_mcbsp_free(unsigned int id);
468 void omap_mcbsp_start(unsigned int id, int tx, int rx);
469 void omap_mcbsp_stop(unsigned int id, int tx, int rx);
470 void omap_mcbsp_xmit_word(unsigned int id, u32 word);
471 u32 omap_mcbsp_recv_word(unsigned int id);
473 int omap_mcbsp_xmit_buffer(unsigned int id, dma_addr_t buffer, unsigned int length);
474 int omap_mcbsp_recv_buffer(unsigned int id, dma_addr_t buffer, unsigned int length);
476 /* McBSP functional clock source changing function */
477 extern int omap2_mcbsp_set_clks_src(u8 id, u8 fck_src_id);
479 /* Polled read/write functions */
480 int omap_mcbsp_pollread(unsigned int id, u16 * buf);
481 int omap_mcbsp_pollwrite(unsigned int id, u16 buf);
482 int omap_mcbsp_set_io_type(unsigned int id, omap_mcbsp_io_type_t io_type);
484 /* McBSP signal muxing API */
485 void omap2_mcbsp1_mux_clkr_src(u8 mux);
486 void omap2_mcbsp1_mux_fsr_src(u8 mux);
488 int omap_mcbsp_dma_ch_params(unsigned int id, unsigned int stream);
489 int omap_mcbsp_dma_reg_params(unsigned int id, unsigned int stream);
491 #ifdef CONFIG_ARCH_OMAP3
492 /* Sidetone specific API */
493 int omap_st_set_chgain(unsigned int id, int channel, s16 chgain);
494 int omap_st_get_chgain(unsigned int id, int channel, s16 *chgain);
495 int omap_st_enable(unsigned int id);
496 int omap_st_disable(unsigned int id);
497 int omap_st_is_enabled(unsigned int id);
499 static inline int omap_st_set_chgain(unsigned int id, int channel,
500 s16 chgain) { return 0; }
501 static inline int omap_st_get_chgain(unsigned int id, int channel,
502 s16 *chgain) { return 0; }
503 static inline int omap_st_enable(unsigned int id) { return 0; }
504 static inline int omap_st_disable(unsigned int id) { return 0; }
505 static inline int omap_st_is_enabled(unsigned int id) { return 0; }