Change filename and macros from AT91SAM3.. to SAM3.. to conform to Atmel's official...
[bertos.git] / bertos / cpu / cortex-m3 / io / sam3_spi.h
1 /**
2  * \file
3  * <!--
4  * This file is part of BeRTOS.
5  *
6  * Bertos is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
19  *
20  * As a special exception, you may use this file as part of a free software
21  * library without restriction.  Specifically, if other files instantiate
22  * templates or use macros or inline functions from this file, or you compile
23  * this file and link it with other files to produce an executable, this
24  * file does not by itself cause the resulting executable to be covered by
25  * the GNU General Public License.  This exception does not however
26  * invalidate any other reasons why the executable file might be covered by
27  * the GNU General Public License.
28  *
29  * Copyright 2007,2010 Develer S.r.l. (http://www.develer.com/)
30  *
31  * -->
32  *
33  *
34  * \author Francesco Sacchi <batt@develer.com>
35  *
36  * Atmel SAM3 SPI register definitions.
37  * This file is based on NUT/OS implementation. See license below.
38
39  */
40
41 /*
42  * Copyright (C) 2006-2007 by egnite Software GmbH. All rights reserved.
43  *
44  * Redistribution and use in source and binary forms, with or without
45  * modification, are permitted provided that the following conditions
46  * are met:
47  *
48  * 1. Redistributions of source code must retain the above copyright
49  *    notice, this list of conditions and the following disclaimer.
50  * 2. Redistributions in binary form must reproduce the above copyright
51  *    notice, this list of conditions and the following disclaimer in the
52  *    documentation and/or other materials provided with the distribution.
53  * 3. Neither the name of the copyright holders nor the names of
54  *    contributors may be used to endorse or promote products derived
55  *    from this software without specific prior written permission.
56  *
57  * THIS SOFTWARE IS PROVIDED BY EGNITE SOFTWARE GMBH AND CONTRIBUTORS
58  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
59  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
60  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL EGNITE
61  * SOFTWARE GMBH OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
62  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
63  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
64  * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
65  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
66  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
67  * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
68  * SUCH DAMAGE.
69  *
70  * For additional information see http://www.ethernut.de/
71
72  */
73
74 #ifndef SAM3_SPI_H
75 #define SAM3_SPI_H
76
77 /**
78  * SPI base addresses.
79  */
80 #define SPI0_BASE  0x40008000
81
82 /**
83  * SPI Control Register
84  */
85 /*\{*/
86 #define SPI_CR_OFF          0x00000000  ///< Control register offset.
87
88 #define SPI_SPIEN                0  ///< SPI enable.
89 #define SPI_SPIDIS               1  ///< SPI disable.
90 #define SPI_SWRST                7  ///< Software reset.
91 #define SPI_LASTXFER            24  ///< Last transfer.
92 /*\}*/
93
94 /**
95  * SPI Mode Register
96  */
97 /*\{*/
98 #define SPI_MR_OFF              0x00000004  ///< Mode register offset.
99
100 #define SPI_MSTR                 0  ///< Master mode.
101 #define SPI_PS                   1  ///< Peripheral select.
102 #define SPI_PCSDEC               2 ///< Chip select decode.
103 #define SPI_FDIV                 3  ///< Clock selection.
104 #define SPI_MODFDIS              4  ///< Mode fault detection.
105 #define SPI_LLB                  7  ///< Local loopback enable.
106 #define SPI_PCS         0x000F0000  ///< Peripheral chip select mask.
107 #define SPI_PCS_0       0x000E0000  ///< Peripheral chip select 0.
108 #define SPI_PCS_1       0x000D0000  ///< Peripheral chip select 1.
109 #define SPI_PCS_2       0x000B0000  ///< Peripheral chip select 2.
110 #define SPI_PCS_3       0x00070000  ///< Peripheral chip select 3.
111 #define SPI_PCS_SHIFT           16  ///< Least significant bit of peripheral chip select.
112 #define SPI_DLYBCS      0xFF000000  ///< Mask for delay between chip selects.
113 #define SPI_DLYBCS_SHIFT        24  ///< Least significant bit of delay between chip selects.
114 /*\}*/
115
116 /**
117  * SPI Receive Data Register
118  */
119 /*\{*/
120 #define SPI_RDR_OFF             0x00000008  ///< Receive data register offset.
121
122 #define SPI_RD          0x0000FFFF  ///< Receive data mask.
123 #define SPI_RD_SHIFT             0  ///< Least significant bit of receive data.
124 /*\}*/
125
126 /**
127  * SPI Transmit Data Register
128  */
129 /*\{*/
130 #define SPI_TDR_OFF             0x0000000C  ///< Transmit data register offset.
131
132 #define SPI_TD          0x0000FFFF  ///< Transmit data mask.
133 #define SPI_TD_SHIFT             0  ///< Least significant bit of transmit data.
134 /*\}*/
135
136 /**
137  * SPI Status and Interrupt Register
138  */
139 /*\{*/
140 #define SPI_SR_OFF              0x00000010  ///< Status register offset.
141 #define SPI_IER_OFF             0x00000014  ///< Interrupt enable register offset.
142 #define SPI_IDR_OFF             0x00000018  ///< Interrupt disable register offset.
143 #define SPI_IMR_OFF             0x0000001C  ///< Interrupt mask register offset.
144
145 #define SPI_RDRF                 0  ///< Receive data register full.
146 #define SPI_TDRE                 1  ///< Transmit data register empty.
147 #define SPI_MODF                 2  ///< Mode fault error.
148 #define SPI_OVRES                3  ///< Overrun error status.
149 #define SPI_ENDRX                4  ///< End of RX buffer.
150 #define SPI_ENDTX                5  ///< End of TX buffer.
151 #define SPI_RXBUFF               6  ///< RX buffer full.
152 #define SPI_TXBUFE               7  ///< TX buffer empty.
153 #define SPI_NSSR                 8  ///< NSS rising.
154 #define SPI_TXEMPTY              9  ///< Transmission register empty.
155 #define SPI_SPIENS              16  ///< SPI enable status.
156 /*\}*/
157
158 /**
159  * SPI Chip Select Registers
160  */
161 /*\{*/
162 #define SPI_CSR0_OFF    0x00000030  ///< Chip select register 0 offset.
163 #define SPI_CSR1_OFF    0x00000034  ///< Chip select register 1 offset.
164 #define SPI_CSR2_OFF    0x00000038  ///< Chip select register 2 offset.
165 #define SPI_CSR3_OFF    0x0000003C  ///< Chip select register 3 offset.
166
167 #define SPI_CPOL                 0  ///< Clock polarity.
168 #define SPI_NCPHA                1  ///< Clock phase.
169 #define SPI_CSAAT                3  ///< Chip select active after transfer.
170 #define SPI_BITS        0x000000F0  ///< Bits per transfer mask.
171 #define SPI_BITS_8      0x00000000  ///< 8 bits per transfer.
172 #define SPI_BITS_9      0x00000010  ///< 9 bits per transfer.
173 #define SPI_BITS_10     0x00000020  ///< 10 bits per transfer.
174 #define SPI_BITS_11     0x00000030  ///< 11 bits per transfer.
175 #define SPI_BITS_12     0x00000040  ///< 12 bits per transfer.
176 #define SPI_BITS_13     0x00000050  ///< 13 bits per transfer.
177 #define SPI_BITS_14     0x00000060  ///< 14 bits per transfer.
178 #define SPI_BITS_15     0x00000070  ///< 15 bits per transfer.
179 #define SPI_BITS_16     0x00000080  ///< 16 bits per transfer.
180 #define SPI_BITS_SHIFT           4  ///< Least significant bit of bits per transfer.
181 #define SPI_SCBR        0x0000FF00  ///< Serial clock baud rate mask.
182 #define SPI_SCBR_SHIFT           8  ///< Least significant bit of serial clock baud rate.
183 #define SPI_DLYBS       0x00FF0000  ///< Delay before SPCK mask.
184 #define SPI_DLYBS_SHIFT         16  ///< Least significant bit of delay before SPCK.
185 #define SPI_DLYBCT      0xFF000000  ///< Delay between consecutive transfers mask.
186 #define SPI_DLYBCT_SHIFT        24  ///< Least significant bit of delay between consecutive transfers.
187 /*\}*/
188
189 /**
190  * Single SPI Register Addresses
191  */
192 /*\{*/
193 #if defined(SPI_BASE)
194         #define SPI0_BASE   SPI_BASE
195         #define SPI_CR          (*((reg32_t *)(SPI0_BASE + SPI0_CR_OFF)))     ///< SPI Control Register Write-only.
196         #define SPI_MR          (*((reg32_t *)(SPI0_BASE + SPI0_MR_OFF)))     ///< SPI Mode Register Read/Write Reset=0x0.
197         #define SPI_RDR         (*((reg32_t *)(SPI0_BASE + SPI0_RDR_OFF)))    ///< SPI Receive Data Register Read-only Reset=0x0.
198         #define SPI_TDR         (*((reg32_t *)(SPI0_BASE + SPI0_TDR_OFF)))    ///< SPI Transmit Data Register Write-only .
199         #define SPI_SR          (*((reg32_t *)(SPI0_BASE + SPI0_SR_OFF)))     ///< SPI Status Register Read-only Reset=0x000000F0.
200         #define SPI_IER         (*((reg32_t *)(SPI0_BASE + SPI0_IER_OFF)))    ///< SPI Interrupt Enable Register Write-only.
201         #define SPI_IDR         (*((reg32_t *)(SPI0_BASE + SPI0_IDR_OFF)))    ///< SPI Interrupt Disable Register Write-only.
202         #define SPI_IMR         (*((reg32_t *)(SPI0_BASE + SPI0_IMR_OFF)))    ///< SPI Interrupt Mask Register Read-only Reset=0x0.
203         #define SPI_CSR0        (*((reg32_t *)(SPI0_BASE + SPI0_CSR0_OFF)))   ///< SPI Chip Select Register 0 Read/Write Reset=0x0.
204         #define SPI_CSR1        (*((reg32_t *)(SPI0_BASE + SPI0_CSR1_OFF)))   ///< SPI Chip Select Register 1 Read/Write Reset=0x0.
205         #define SPI_CSR2        (*((reg32_t *)(SPI0_BASE + SPI0_CSR2_OFF)))   ///< SPI Chip Select Register 2 Read/Write Reset=0x0.
206         #define SPI_CSR3        (*((reg32_t *)(SPI0_BASE + SPI0_CSR3_OFF)))   ///< SPI Chip Select Register 3 Read/Write Reset=0x0.
207         #if defined(SPI_HAS_PDC)
208                 #define SPI_RPR     (*((reg32_t *)(SPI0_BASE + SPI0_RPR_OFF)))    ///< PDC channel 0 receive pointer register.
209                 #define SPI_RCR     (*((reg32_t *)(SPI0_BASE + SPI0_RCR_OFF)))    ///< PDC channel 0 receive counter register.
210                 #define SPI_TPR     (*((reg32_t *)(SPI0_BASE + SPI0_TPR_OFF)))    ///< PDC channel 0 transmit pointer register.
211                 #define SPI_TCR     (*((reg32_t *)(SPI0_BASE + SPI0_TCR_OFF)))    ///< PDC channel 0 transmit counter register.
212                 #define SPI_RNPR    (*((reg32_t *)(SPI0_BASE + SPI0_RNPR_OFF)))   ///< PDC channel 0 receive next pointer register.
213                 #define SPI_RNCR    (*((reg32_t *)(SPI0_BASE + SPI0_RNCR_OFF)))   ///< PDC channel 0 receive next counter register.
214                 #define SPI_TNPR    (*((reg32_t *)(SPI0_BASE + SPI0_TNPR_OFF)))   ///< PDC channel 0 transmit next pointer register.
215                 #define SPI_TNCR    (*((reg32_t *)(SPI0_BASE + SPI0_TNCR_OFF)))   ///< PDC channel 0 transmit next counter register.
216                 #define SPI_PTCR    (*((reg32_t *)(SPI0_BASE + SPI0_PTCR_OFF)))   ///< PDC channel 0 transfer control register.
217                 #define SPI_PTSR    (*((reg32_t *)(SPI0_BASE + SPI0_PTSR_OFF)))   ///< PDC channel 0 transfer status register.
218         #endif /* SPI_HAS_PDC */
219 #endif /* SPI_BASE */
220 /*\}*/
221
222 /**
223  * SPI 0 Register Addresses
224  */
225 /*\{*/
226 #if defined(SPI0_BASE)
227         #define SPI0_CR         (*((reg32_t *)(SPI0_BASE + SPI_CR_OFF)))        ///< SPI Control Register Write-only.
228         #define SPI0_MR         (*((reg32_t *)(SPI0_BASE + SPI_MR_OFF)))        ///< SPI Mode Register Read/Write Reset=0x0.
229         #define SPI0_RDR        (*((reg32_t *)(SPI0_BASE + SPI_RDR_OFF)))       ///< SPI Receive Data Register Read-only Reset=0x0.
230         #define SPI0_TDR        (*((reg32_t *)(SPI0_BASE + SPI_TDR_OFF)))       ///< SPI Transmit Data Register Write-only .
231         #define SPI0_SR         (*((reg32_t *)(SPI0_BASE + SPI_SR_OFF)))        ///< SPI Status Register Read-only Reset=0x000000F0.
232         #define SPI0_IER        (*((reg32_t *)(SPI0_BASE + SPI_IER_OFF)))       ///< SPI Interrupt Enable Register Write-only.
233         #define SPI0_IDR        (*((reg32_t *)(SPI0_BASE + SPI_IDR_OFF)))       ///< SPI Interrupt Disable Register Write-only.
234         #define SPI0_IMR        (*((reg32_t *)(SPI0_BASE + SPI_IMR_OFF)))       ///< SPI Interrupt Mask Register Read-only Reset=0x0.
235         #define SPI0_CSR0       (*((reg32_t *)(SPI0_BASE + SPI_CSR0_OFF)))      ///< SPI Chip Select Register 0 Read/Write Reset=0x0.
236         #define SPI0_CSR1       (*((reg32_t *)(SPI0_BASE + SPI_CSR1_OFF)))      ///< SPI Chip Select Register 1 Read/Write Reset=0x0.
237         #define SPI0_CSR2       (*((reg32_t *)(SPI0_BASE + SPI_CSR2_OFF)))      ///< SPI Chip Select Register 2 Read/Write Reset=0x0.
238         #define SPI0_CSR3       (*((reg32_t *)(SPI0_BASE + SPI_CSR3_OFF)))      ///< SPI Chip Select Register 3 Read/Write Reset=0x0.
239         #if defined(SPI_HAS_PDC)
240                 #define SPI0_RPR    (*((reg32_t *)(SPI0_BASE + PERIPH_RPR_OFF)))    ///< PDC channel 0 receive pointer register.
241                 #define SPI0_RCR    (*((reg32_t *)(SPI0_BASE + PERIPH_RCR_OFF)))    ///< PDC channel 0 receive counter register.
242                 #define SPI0_TPR    (*((reg32_t *)(SPI0_BASE + PERIPH_TPR_OFF)))    ///< PDC channel 0 transmit pointer register.
243                 #define SPI0_TCR    (*((reg32_t *)(SPI0_BASE + PERIPH_TCR_OFF)))    ///< PDC channel 0 transmit counter register.
244                 #define SPI0_RNPR   (*((reg32_t *)(SPI0_BASE + PERIPH_RNPR_OFF)))   ///< PDC channel 0 receive next pointer register.
245                 #define SPI0_RNCR   (*((reg32_t *)(SPI0_BASE + PERIPH_RNCR_OFF)))   ///< PDC channel 0 receive next counter register.
246                 #define SPI0_TNPR   (*((reg32_t *)(SPI0_BASE + PERIPH_TNPR_OFF)))   ///< PDC channel 0 transmit next pointer register.
247                 #define SPI0_TNCR   (*((reg32_t *)(SPI0_BASE + PERIPH_TNCR_OFF)))   ///< PDC channel 0 transmit next counter register.
248                 #define SPI0_PTCR   (*((reg32_t *)(SPI0_BASE + PERIPH_PTCR_OFF)))   ///< PDC channel 0 transfer control register.
249                 #define SPI0_PTSR   (*((reg32_t *)(SPI0_BASE + PERIPH_PTSR_OFF)))   ///< PDC channel 0 transfer status register.
250         #endif /* SPI_HAS_PDC */
251 #endif /* SPI0_BASE */
252 /*\}*/
253
254 /**
255  * SPI 1 Register Addresses
256  */
257 /*\{*/
258 #if defined(SPI1_BASE)
259         #define SPI1_CR         (*((reg32_t *)(SPI1_BASE + SPI_CR_OFF)))        ///< SPI Control Register Write-only.
260         #define SPI1_MR         (*((reg32_t *)(SPI1_BASE + SPI_MR_OFF)))        ///< SPI Mode Register Read/Write Reset=0x0.
261         #define SPI1_RDR        (*((reg32_t *)(SPI1_BASE + SPI_RDR_OFF)))       ///< SPI Receive Data Register Read-only Reset=0x0.
262         #define SPI1_TDR        (*((reg32_t *)(SPI1_BASE + SPI_TDR_OFF)))       ///< SPI Transmit Data Register Write-only .
263         #define SPI1_SR         (*((reg32_t *)(SPI1_BASE + SPI_SR_OFF)))        ///< SPI Status Register Read-only Reset=0x000000F0.
264         #define SPI1_IER        (*((reg32_t *)(SPI1_BASE + SPI_IER_OFF)))       ///< SPI Interrupt Enable Register Write-only.
265         #define SPI1_IDR        (*((reg32_t *)(SPI1_BASE + SPI_IDR_OFF)))       ///< SPI Interrupt Disable Register Write-only.
266         #define SPI1_IMR        (*((reg32_t *)(SPI1_BASE + SPI_IMR_OFF)))       ///< SPI Interrupt Mask Register Read-only Reset=0x0.
267         #define SPI1_CSR0       (*((reg32_t *)(SPI1_BASE + SPI_CSR0_OFF)))      ///< SPI Chip Select Register 0 Read/Write Reset=0x0.
268         #define SPI1_CSR1       (*((reg32_t *)(SPI1_BASE + SPI_CSR1_OFF)))      ///< SPI Chip Select Register 1 Read/Write Reset=0x0.
269         #define SPI1_CSR2       (*((reg32_t *)(SPI1_BASE + SPI_CSR2_OFF)))      ///< SPI Chip Select Register 2 Read/Write Reset=0x0.
270         #define SPI1_CSR3       (*((reg32_t *)(SPI1_BASE + SPI_CSR3_OFF)))      ///< SPI Chip Select Register 3 Read/Write Reset=0x0.
271         #if defined(SPI_HAS_PDC)
272                 #define SPI1_RPR    (*((reg32_t *)(SPI1_BASE + PERIPH_RPR_OFF)))    ///< PDC channel 1 receive pointer register.
273                 #define SPI1_RCR    (*((reg32_t *)(SPI1_BASE + PERIPH_RCR_OFF)))    ///< PDC channel 1 receive counter register.
274                 #define SPI1_TPR    (*((reg32_t *)(SPI1_BASE + PERIPH_TPR_OFF)))    ///< PDC channel 1 transmit pointer register.
275                 #define SPI1_TCR    (*((reg32_t *)(SPI1_BASE + PERIPH_TCR_OFF)))    ///< PDC channel 1 transmit counter register.
276                 #define SPI1_RNPR   (*((reg32_t *)(SPI1_BASE + PERIPH_RNPR_OFF)))   ///< PDC channel 1 receive next pointer register.
277                 #define SPI1_RNCR   (*((reg32_t *)(SPI1_BASE + PERIPH_RNCR_OFF)))   ///< PDC channel 1 receive next counter register.
278                 #define SPI1_TNPR   (*((reg32_t *)(SPI1_BASE + PERIPH_TNPR_OFF)))   ///< PDC channel 1 transmit next pointer register.
279                 #define SPI1_TNCR   (*((reg32_t *)(SPI1_BASE + PERIPH_TNCR_OFF)))   ///< PDC channel 1 transmit next counter register.
280                 #define SPI1_PTCR   (*((reg32_t *)(SPI1_BASE + PERIPH_PTCR_OFF)))   ///< PDC channel 1 transfer control register.
281                 #define SPI1_PTSR   (*((reg32_t *)(SPI1_BASE + PERIPH_PTSR_OFF)))   ///< PDC channel 1 transfer status register.
282         #endif /* SPI_HAS_PDC */
283 #endif /* SPI1_BASE */
284 /*\}*/
285
286 #endif  /* SAM3_SPI_H */