Contiki 3.x
platform-conf.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2010, Swedish Institute of Computer Science.
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  * notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  * notice, this list of conditions and the following disclaimer in the
12  * documentation and/or other materials provided with the distribution.
13  * 3. Neither the name of the Institute nor the names of its contributors
14  * may be used to endorse or promote products derived from this software
15  * without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
18  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20  * ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
21  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27  * SUCH DAMAGE.
28  */
29 
30 /**
31  * \file
32  * Platform configuration for the Z1 platform
33  * \author
34  * Joakim Eriksson <joakime@sics.se>
35  */
36 
37 #ifndef PLATFORM_CONF_H_
38 #define PLATFORM_CONF_H_
39 
40 /*
41  * Definitions below are dictated by the hardware and not really
42  * changeable!
43  */
44 #define ZOLERTIA_Z1 1 /* Enric */
45 
46 /* Delay between GO signal and SFD: radio fixed delay + 4Bytes preample + 1B SFD -- 1Byte time is 32us
47  * ~327us + 129preample = 456 us */
48 #define RADIO_DELAY_BEFORE_TX ((unsigned)US_TO_RTIMERTICKS(456))
49 /* Delay between GO signal and start listening
50  * ~50us delay + 129preample + ?? = 183 us */
51 #define RADIO_DELAY_BEFORE_RX ((unsigned)US_TO_RTIMERTICKS(183))
52 /* Delay between the SFD finishes arriving and it is detected in software */
53 #define RADIO_DELAY_BEFORE_DETECT 0
54 
55 #define PLATFORM_HAS_LEDS 1
56 #define PLATFORM_HAS_BUTTON 1
57 #define PLATFORM_HAS_RADIO 1
58 #define PLATFORM_HAS_BATTERY 1
59 
60 /* CPU target speed in Hz */
61 #define F_CPU 8000000uL /* 8MHz by default */
62 
63 /* Our clock resolution, this is the same as Unix HZ. */
64 #define CLOCK_CONF_SECOND 128UL
65 
66 #define BAUD2UBR(baud) ((F_CPU / baud))
67 
68 #define CCIF
69 #define CLIF
70 
71 #define HAVE_STDINT_H
72 #include "msp430def.h"
73 
74 /* XXX Temporary place for defines that are lacking in mspgcc4's gpio.h */
75 #ifdef __IAR_SYSTEMS_ICC__
76 #ifndef P1SEL2_
77 #define P1SEL2_ (0x0041u) /* Port 1 Selection 2*/
78 DEFC(P1SEL2, P1SEL2_)
79 #endif
80 #ifndef P5SEL2_
81 #define P5SEL2_ (0x0045u) /* Port 5 Selection 2*/
82 DEFC(P5SEL2, P5SEL2_)
83 #endif
84 #else /* __IAR_SYSTEMS_ICC__ */
85 #ifdef __GNUC__
86 #ifndef P1SEL2_
87 #define P1SEL2_ 0x0041 /* Port 1 Selection 2*/
88 sfrb(P1SEL2, P1SEL2_);
89 #endif
90 #ifndef P5SEL2_
91 #define P5SEL2_ 0x0045 /* Port 5 Selection 2*/
92 sfrb(P5SEL2, P5SEL2_);
93 #endif
94 #endif /* __GNUC__ */
95 #endif /* __IAR_SYSTEMS_ICC__ */
96 
97 /* Types for clocks and uip_stats */
98 typedef unsigned short uip_stats_t;
99 typedef unsigned long clock_time_t;
100 typedef unsigned long off_t;
101 
102 /* the low-level radio driver */
103 #define NETSTACK_CONF_RADIO cc2420_driver
104 
105 /*
106  * Definitions below are dictated by the hardware and not really
107  * changeable!
108  */
109 
110 /* LED ports */
111 #ifdef Z1_IS_Z1SP
112 #define LEDS_PxDIR P4DIR
113 #define LEDS_PxOUT P4OUT
114 #define LEDS_CONF_RED 0x04
115 #define LEDS_CONF_GREEN 0x01
116 #define LEDS_CONF_YELLOW 0x80
117 #else
118 #define LEDS_PxDIR P5DIR
119 #define LEDS_PxOUT P5OUT
120 #define LEDS_CONF_RED 0x10
121 #define LEDS_CONF_GREEN 0x40
122 #define LEDS_CONF_YELLOW 0x20
123 #endif /* Z1_IS_Z1SP */
124 
125 /* DCO speed resynchronization for more robust UART, etc. */
126 #define DCOSYNCH_CONF_ENABLED 0
127 #define DCOSYNCH_CONF_PERIOD 30
128 
129 #define ROM_ERASE_UNIT_SIZE 512
130 #define XMEM_ERASE_UNIT_SIZE (64 * 1024L)
131 
132 #define CFS_CONF_OFFSET_TYPE long
133 
134 /* Use the first 64k of external flash for node configuration */
135 #define NODE_ID_XMEM_OFFSET (0 * XMEM_ERASE_UNIT_SIZE)
136 
137 /* Use the second 64k of external flash for codeprop. */
138 #define EEPROMFS_ADDR_CODEPROP (1 * XMEM_ERASE_UNIT_SIZE)
139 
140 #define CFS_XMEM_CONF_OFFSET (2 * XMEM_ERASE_UNIT_SIZE)
141 #define CFS_XMEM_CONF_SIZE (1 * XMEM_ERASE_UNIT_SIZE)
142 
143 #define CFS_RAM_CONF_SIZE 4096
144 
145 /*
146  * SPI bus configuration for the Z1 mote.
147  */
148 
149 /* SPI input/output registers. */
150 #define SPI_TXBUF UCB0TXBUF
151 #define SPI_RXBUF UCB0RXBUF
152 
153 /* USART0 Tx ready? */
154 #define SPI_WAITFOREOTx() while((UCB0STAT & UCBUSY) != 0)
155 /* USART0 Rx ready? */
156 #define SPI_WAITFOREORx() while((IFG2 & UCB0RXIFG) == 0)
157 /* USART0 Tx buffer ready? */
158 #define SPI_WAITFORTxREADY() while((IFG2 & UCB0TXIFG) == 0)
159 
160 #define MOSI 1 /* P3.1 - Output: SPI Master out - slave in (MOSI) */
161 #define MISO 2 /* P3.2 - Input: SPI Master in - slave out (MISO) */
162 #define SCK 3 /* P3.3 - Output: SPI Serial Clock (SCLK) */
163 
164 /*
165  * SPI bus - M25P80 external flash configuration.
166  */
167 /* FLASH_PWR P4.3 Output ALWAYS POWERED ON Z1 */
168 #define FLASH_CS 4 /* P4.4 Output */
169 #define FLASH_HOLD 7 /* P5.7 Output */
170 
171 /* Enable/disable flash access to the SPI bus (active low). */
172 
173 #define SPI_FLASH_ENABLE() (P4OUT &= ~BV(FLASH_CS))
174 #define SPI_FLASH_DISABLE() (P4OUT |= BV(FLASH_CS))
175 
176 #define SPI_FLASH_HOLD() (P5OUT &= ~BV(FLASH_HOLD))
177 #define SPI_FLASH_UNHOLD() (P5OUT |= BV(FLASH_HOLD))
178 
179 /*
180  * SPI bus - CC2420 pin configuration.
181  */
182 
183 #define CC2420_CONF_SYMBOL_LOOP_COUNT 1302 /* 326us msp430X @ 8MHz */
184 
185 /* P1.2 - Input: FIFOP from CC2420 */
186 #define CC2420_FIFOP_PORT(type) P1##type
187 #define CC2420_FIFOP_PIN 2
188 /* P1.3 - Input: FIFO from CC2420 */
189 #define CC2420_FIFO_PORT(type) P1##type
190 #define CC2420_FIFO_PIN 3
191 /* P1.4 - Input: CCA from CC2420 */
192 #define CC2420_CCA_PORT(type) P1##type
193 #define CC2420_CCA_PIN 4
194 /* P4.1 - Input: SFD from CC2420 */
195 #define CC2420_SFD_PORT(type) P4##type
196 #define CC2420_SFD_PIN 1
197 /* P3.0 - Output: SPI Chip Select (CS_N) */
198 #define CC2420_CSN_PORT(type) P3##type
199 #define CC2420_CSN_PIN 0
200 /* P4.5 - Output: VREG_EN to CC2420 */
201 #define CC2420_VREG_PORT(type) P4##type
202 #define CC2420_VREG_PIN 5
203 /* P4.6 - Output: RESET_N to CC2420 */
204 #define CC2420_RESET_PORT(type) P4##type
205 #define CC2420_RESET_PIN 6
206 
207 #define CC2420_IRQ_VECTOR PORT1_VECTOR
208 
209 /* Pin status. */
210 #define CC2420_FIFOP_IS_1 (!!(CC2420_FIFOP_PORT(IN) & BV(CC2420_FIFOP_PIN)))
211 #define CC2420_FIFO_IS_1 (!!(CC2420_FIFO_PORT(IN) & BV(CC2420_FIFO_PIN)))
212 #define CC2420_CCA_IS_1 (!!(CC2420_CCA_PORT(IN) & BV(CC2420_CCA_PIN)))
213 #define CC2420_SFD_IS_1 (!!(CC2420_SFD_PORT(IN) & BV(CC2420_SFD_PIN)))
214 
215 /* The CC2420 reset pin. */
216 #define SET_RESET_INACTIVE() (CC2420_RESET_PORT(OUT) |= BV(CC2420_RESET_PIN))
217 #define SET_RESET_ACTIVE() (CC2420_RESET_PORT(OUT) &= ~BV(CC2420_RESET_PIN))
218 
219 /* CC2420 voltage regulator enable pin. */
220 #define SET_VREG_ACTIVE() (CC2420_VREG_PORT(OUT) |= BV(CC2420_VREG_PIN))
221 #define SET_VREG_INACTIVE() (CC2420_VREG_PORT(OUT) &= ~BV(CC2420_VREG_PIN))
222 
223 /* CC2420 rising edge trigger for external interrupt 0 (FIFOP). */
224 #define CC2420_FIFOP_INT_INIT() do { \
225  CC2420_FIFOP_PORT(IES) &= ~BV(CC2420_FIFOP_PIN); \
226  CC2420_CLEAR_FIFOP_INT(); \
227 } while(0)
228 
229 /* FIFOP on external interrupt 0. */
230 #define CC2420_ENABLE_FIFOP_INT() do { CC2420_FIFOP_PORT(IE) |= BV(CC2420_FIFOP_PIN); } while(0)
231 #define CC2420_DISABLE_FIFOP_INT() do { CC2420_FIFOP_PORT(IE) &= ~BV(CC2420_FIFOP_PIN); } while(0)
232 #define CC2420_CLEAR_FIFOP_INT() do { CC2420_FIFOP_PORT(IFG) &= ~BV(CC2420_FIFOP_PIN); } while(0)
233 
234 /*
235  * Enables/disables CC2420 access to the SPI bus (not the bus).
236  * (Chip Select)
237  */
238 
239 /* ENABLE CSn (active low) */
240 #define CC2420_SPI_ENABLE() (CC2420_CSN_PORT(OUT) &= ~BV(CC2420_CSN_PIN))
241 /* DISABLE CSn (active low) */
242 #define CC2420_SPI_DISABLE() (CC2420_CSN_PORT(OUT) |= BV(CC2420_CSN_PIN))
243 #define CC2420_SPI_IS_ENABLED() ((CC2420_CSN_PORT(OUT) & BV(CC2420_CSN_PIN)) != BV(CC2420_CSN_PIN))
244 
245 /*
246  * I2C configuration
247  */
248 
249 #define I2C_PxDIR P5DIR
250 #define I2C_PxIN P5IN
251 #define I2C_PxOUT P5OUT
252 #define I2C_PxSEL P5SEL
253 #define I2C_PxSEL2 P5SEL2
254 #define I2C_PxREN P5REN
255 
256 #define I2C_SDA (1 << 1) /* SDA == P5.1 */
257 #define I2C_SCL (1 << 2) /* SCL == P5.2 */
258 #define I2C_PRESC_1KHZ_LSB 0x00
259 #define I2C_PRESC_1KHZ_MSB 0x20
260 #define I2C_PRESC_100KHZ_LSB 0x50
261 #define I2C_PRESC_100KHZ_MSB 0x00
262 #define I2C_PRESC_400KHZ_LSB 0x14
263 #define I2C_PRESC_400KHZ_MSB 0x00
264 
265 /* Set rate as high as possible by default */
266 #ifndef I2C_PRESC_Z1_LSB
267 #define I2C_PRESC_Z1_LSB I2C_PRESC_400KHZ_LSB
268 #endif
269 
270 #ifndef I2C_PRESC_Z1_MSB
271 #define I2C_PRESC_Z1_MSB I2C_PRESC_400KHZ_MSB
272 #endif
273 
274 /* I2C configuration with RX interrupts */
275 #ifdef I2C_CONF_RX_WITH_INTERRUPT
276 #define I2C_RX_WITH_INTERRUPT I2C_CONF_RX_WITH_INTERRUPT
277 #else /* I2C_CONF_RX_WITH_INTERRUPT */
278 #define I2C_RX_WITH_INTERRUPT 1
279 #endif /* I2C_CONF_RX_WITH_INTERRUPT */
280 
281 #endif /* PLATFORM_CONF_H_ */