forked from tp-freeforall/prod
/
11_Release_Notes
163 lines (117 loc) · 7.14 KB
/
11_Release_Notes
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
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
91
92
93
94
95
96
97
98
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
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
Major Changes to the msp430 core software:
(branch: gh:tp-freeforall/prod(msp430-int)
Last Update: 2011-12-18, cire
msp430-int-next merged into msp430-int. 2011-12-16
Msp430-Int (msp430 integration branch) is a major rework of the core tinyos
msp430 files. Originally, tinyos msp430 support was for the first generation
msp430 cpus. Later the MSP430X and MSP430XV2 processor chips were released by
TI. As newer cpu chips have been ported to TinyOS the architecture of the
core msp430 s/w has needed changes.
Major areas of impact include: peripheral register access, clock modules, dma
support, usart vs. usci support, and interrupt architecture. In addition the
s/w has been reorganized to support major differences between the cpus by
grouping support into families (see below for what this means).
This release has also had initial testing done on newer toolchains. The msp430
core has been modified to support toolchains listed below. Test builds have been
done using the following:
mspgcc3.2.3: original tinyos 2.1.1 toolchain
mspgcc3.2.3-z1 z1 modified toolchain (supports MSP430X architectural
changes, 26xx processors. Does not properly support
x5 chips.
mspgcc4.4.5(20110312) Initial mspgcc4 supports x5 chips. experimental.
mspgcc4.5.2 (mspgcc) Uniarch variant supports all chips. experimental.
(20110612) slated to become new main toolchain.
mspgcc4.5.3 (LTS 20110716) long term support of uniarch (pre-20bit)
mspgcc4.5.3 (20111008) later version of LTS20110716 with patches through 1008.
see http://tinyprod.net/repos/debian-dev.
It is recommended that all verification work be done using the latest toolchain
available. The sooner we get that toolchain squared away the better.
Families:
A family is a group of similar msp430 processor chips that have been instantiated
in TinyOS. The overlap between cpus is not just cpu features but can include clocks
and other peripherals.
x1: 1st generation MSP430. Supported: msp430f149, msp430f1611 (telosb)
x2: 2nd generation MSP430X. Modified cpu ISA, 20 bit addresses.
Supported: msp430f2616, 2617, 2618, 2619
x5: 3rd generation MSP430X. Modified instruction timings. Peripheral modifications.
Supported: cc430f5137, msp430f5438, 5438a.
Other notable changes:
* Revise nesc_{en,dis}able_interrupt to generate better code. Also force
these routines to be inline regardless of the optimization level.
* Remove duplicate files between original x1 and Z1 (x2). Msp430-int has
been fully integrated with the tinyos-main trunk as of 2011-09-30 which
includes an updated Z1 (x2) core. All duplicated files between x1 and Z1
have been removed.
* change low level usci port naming back to h/w centric.
ie. Msp430Uart0 -> Msp430UartA0. Better matches what will come in with
the x5 code where there are lots of ports.
* The main cpu clock for the 3 families is defaulted to 4 MiHz. This is done
for a number of reasons. 1) low power and 2) the 5438a starts off in low
power mode and doesn't support faster than 8 MHz (note decimal MHz not
binary).
* use common clock module for x1 and x2. msp430/clock_bcs. Handles
basic_clock and bc2.
* add basic_clock configuration mechanism to allow easy configuration of
MCLK (cpu freq), SMCLK (peripheral clock), and 1 uis ticker (TimerA). See
clock_bcs/Msp430ClockP.nc and Msp430DcoSpec.h (various locations).
* gdb files to support different processor families,
tos/chips/msp430/99_gdb/gdb{x1,x2,x5}. See tos/chips/msp430/99_gdb/gdbinit
for details on how to use these files.
* add stack checking module. This module allows one to monitor how much of the
stack is being use. See tos/chips/msp430/Stack*.
* Change DCO specifications from KHZ to HZ to eliminate confusion with decimal vs.
binary frequency specs. Make Z1 use binary clocks.
WARNING: The whole issue of binary vs. decimal clocks needs to revisted. For
various good reasons (32768 = power of two, and is XT1/ACLK which is used to
stabilize the main DCO clock which runs everything else (SMCLK which drives
the peripherals). Anyway, TinyOS wants binary clocks but TI states that upper
limits for the various processors is in decimal (ie. 8MHz). It is generally
dangerous to overclock the TI parts and is asking for flakey behaviour.
* Revised DCO calibrator to work with both 1611 and Z1 2617/1618.
* Device configuration blocks by default moved to ROM. This saves start up cpu
cycles and space in RAM. Config blocks can still be placed in RAM and modified
if needed.
* ADC12 mods:
o 16 input channels supported. inch (input channel) in the control structure
expanded to 5 bits. Additional channel place holders defined.
o ADC12 and ADC12_PLUS supported. Newer chips provide the ADC12_PLUS module.
o PLATFORM_ADC support added for per platfrom configuration of timer and i/o pins.
Backward compatible with prior configuration mechanism.
o ADC12_PINS_AVAILABLE defined to denote how many pins are available for ADC use.
o headers include bitfield structures for use of new TI HEADERS.
o ADC pins in configurations now named An vs. previous PortMN.
* DMA rework.
- Simplify Hpl and make more easily adaptable cross cpu (handles x1, x2, and x5).
- unified driver for x1, x2 and x5.
- Make module naming clearer.
- simplify interfaces for setTrigger.
- msp430 dma: nuke ABORT. ABORT was used to determine the error return from
transferDone. Only comes from NMI abort if ENNMI was on. This doesn't really
buy anything still need to use a timer for DMA hangs. Further there are no
known users of the error return and it isn't checked.
- make DmaControl.reset do a full reset. Simplifies code in Msp430DmaControlP.reset
and makes better sense then doing it piece meal.
- force src/dst addresses to be 16 bits (was void *). Be blatant.
- make interrupts be parameterized. This routes dma interrupts to the appropriate
channel handler.
* X5 additions:
- X5 (T0A, T1A) Msp430Timers. T0A 32KiHz, T1A 1MiHz timebase.
- X5 UCS clock driver. tos/chips/x5xxx/timer/Msp430XV2Clock*.
- X5 add support for cc430f5137 and PeoplePower Co. Surf board.
- X5 pmm, rtc, crc16, flash, onewire, rf1a, wdt support
* Other Additions
- KeyValueRecord code. Used by Surf radio code.
- Better documentation on differences between x2 USCI and x5 USCI
tos/chips/msp430/02_Serial.
- Better documentation about what chips are supported. 00_Chip_Notes and 01_Dependencies.
- Using TI functional presence indicators (__MSP430_HAS_<stuff>) protect
modules from being included if the cpu being used doesn't have them. This
makes figuring out what is happening much easier when adding new processors.
WARNING: tosthreads hasn't been modified for the new core msp430 structure.
TosThreads duplicated files rather than modified in place. This creates
a lot more work and is not recommended. Cloning for tosthreads creates a
maintanence headache.
TosThreads should be modified to place any necessary hooks into the actual device
drivers themselves rather than duplicating the files and then shadowing. Kevin
Klues at one point evaluated using in place code and for some reason went the other
way. The reasoning wasn't documented.