1 ; -*- coding: utf-8 -*-
3 ; Fast Forth For Texas Instrument MSP430FR5739
4 ; Tested on MSP-EXP430FR2355 launchpad
6 ; Copyright (C) <2018> <J.M. THOORENS>
8 ; This program is free software: you can redistribute it and/or modify
9 ; it under the terms of the GNU General Public License as published by
10 ; the Free Software Foundation, either version 3 of the License, or
11 ; (at your option) any later version.
13 ; This program is distributed in the hope that it will be useful,
14 ; but WITHOUT ANY WARRANTY; without even the implied warranty of
15 ; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 ; GNU General Public License for more details.
18 ; You should have received a copy of the GNU General Public License
19 ; along with this program. If not, see <http://www.gnu.org/licenses/>.
21 ; ======================================================================
22 ; INIT MSP-EXP430FR2355 board
23 ; ======================================================================
28 ; "TXD" <--- P4.3 == UCA0TXD <-- UCA0TXDBUf
29 ; "RXD" ---> P4.2 == UCA0RXD --> UCA0RXDBUF
56 ; J3.23 - P1.4 A4 SEED
61 ; J3.28 - P1.1 A1 SEED
93 ; ======================================================================
94 ; MSP-EXP430FR2355 LAUNCHPAD <--> OUTPUT WORLD
95 ; ======================================================================
97 ; +--4k7-< DeepRST switch <-- GND
99 ; P4.3 - UCA1 TXD J101.6 - <-+-> RX UARTtoUSB bridge
100 ; P4.2 - UCA1 RXD J101.8 - <---- TX UARTtoUSB bridge
101 ; P2.0 - RTS J2.19 - ----> CTS UARTtoUSB bridge (TERMINAL4WIRES)
102 ; P2.1 - CTS J4.40 - <---- RTS UARTtoUSB bridge (TERMINAL5WIRES)
104 ; P1.2 - UCB0 SDA J1.10 - <---> SDA I2C Master_Slave
105 ; P1.3 - UCB0 SCL J1.9 - ----> SCL I2C Master_Slave
107 ; P2.2 - J2.18 - <---- TSSOP32236 (IR RC5)
109 ; P2.5 - J2.13 - <---- SD_CD (Card Detect)
110 ; P4.4 - J2.12 - ----> SD_CS (Card Select)
111 ; P4.5 - UCB1 CLK J1.7 - ----> SD_CLK
112 ; P4.6 - UCB1 SIMO J2.15 - ----> SD_SDI
113 ; P4.7 - UCB1 SOMI J2.14 - <---- SD_SDO
115 ; P6.0 - J4.39 - ----> SCL I2C Soft_Master
116 ; P6.1 - J4.38 - <---> SDA I2C Soft_Master
118 ; ----------------------------------------------------------------------
119 ; POWER ON RESET AND INITIALIZATION : I/O
120 ; ----------------------------------------------------------------------
122 ; ----------------------------------------------------------------------
123 ; POWER ON RESET AND INITIALIZATION : PORT1/2
124 ; ----------------------------------------------------------------------
126 ; reset state : Px{DIR,REN,SEL0,SEL1,SELC,IE,IFG,IV} = 0 ; Px{IN,OUT,IES} = ?
132 LED1 .equ 1 ; P1.0 LED1 red
138 BUS_TERM .equ 0Ch ; P1.2=SDA, P1.3=SCL
142 ; UART RTS P2.0 - J2.19 ----> CTS UARTtoUSB bridge (TERMINAL4WIRES)
143 ; UART CTS P2.1 - J4.40 <---- RTS UARTtoUSB bridge (TERMINAL5WIRES)
145 ; P2.5 - J2.10 <---- SD_CD (Card Detect)
147 BIS #-1,&PAREN ; all inputs with pull up/down resistors
148 MOV #0FFFEh,&PAOUT ; all pins with pullup resistors else LED1
150 .IFDEF TERMINAL4WIRES
151 ; RTS output is wired to the CTS input of UART2USB bridge
152 ; configure RTS as output high (false) to disable RX TERM during start FORTH
153 HANDSHAKOUT .equ P2OUT
156 BIS.B #RTS,&P2DIR ; RTS as output high
157 .IFDEF TERMINAL5WIRES
158 ; CTS input must be wired to the RTS output of UART2USB bridge
159 ; configure CTS as input low (true) to avoid lock when CTS is not wired
161 BIC.B #CTS,&P2OUT ; CTS input resistor is pulled down
162 .ENDIF ; TERMINAL5WIRES
163 .ENDIF ; TERMINAL4WIRES
167 SW2 .equ 8 ; P2.3 = S2
170 CD_SD .equ 20h ; P2.5
172 ; ----------------------------------------------------------------------
173 ; POWER ON RESET AND INITIALIZATION : PORT3-4
174 ; ----------------------------------------------------------------------
176 ; reset state : Px{DIR,REN,SEL0,SEL1,SELC,IE,IFG,IV} = 0 ; Px{IN,OUT,IES} = ?
181 ; UCA1 RXD P4.2 - J101.8 <---- TX UARTtoUSB bridge
182 ; UCA1 TXD P4.3 - J101.6 ----> RX UARTtoUSB bridge
183 ; P4.4 - J2.9 ----> SD_CS(Card Select)
184 ; UCB1 CLK P4.5 - J1.7 ----> SD_CLK
185 ; UCB1 SIMO P4.6 - J2.15 ----> SD_SDI
186 ; UCB1 SOMI P4.7 - J2.14 <---- SD_SDO
188 BIS #-1,&PBREN ; all pins with pull resistors
189 MOV #-1,&PBOUT ; pullup resistors for all pins
192 SW1 .equ 2 ; P4.1 = S1
195 IO_WIPE .equ 2 ; P4.1 = S1 = FORTH Deep_RST pin
198 ; UCA1 RXD P4.2 - J101.8 <---- TX UARTtoUSB bridge
199 ; UCA1 TXD P4.3 - J101.6 ----> RX UARTtoUSB bridge
203 RXD .equ 4 ; P4.2 = RXD
204 TXD .equ 8 ; P4.3 = TXD
211 CS_SD .equ 10h ; P4.4
213 SD_SEL .equ PBSEL0 ; to configure UCB1
214 SD_REN .equ PBREN ; to configure pullup resistors
215 BUS_SD .equ 0E000h ; pins P4.5 as UCA1CLK, P4.6 as UCA1SIMO & P4.7 as UCA1SOMI
217 ; ----------------------------------------------------------------------
218 ; POWER ON RESET AND INITIALIZATION : PORT5-6
219 ; ----------------------------------------------------------------------
221 ; reset state : Px{DIR,REN,SEL0,SEL1,SELC,IE,IFG,IV} = 0 ; Px{IN,OUT,IES} = ?
226 LED2 .equ 40h ; P6.6 LED2 green
228 BIS.B #-1,&P6REN ; all pins with pull up/down resistors
229 MOV.B #0BFh,&P6OUT ; all pins with pull up resistors else P6.6
231 ; ----------------------------------------------------------------------
233 ; ----------------------------------------------------------------------
235 .IF (FREQUENCY >8 ) && ( FREQUENCY <= 16)
236 MOV.B #0A5h, &FRCTL0_H ; enable FRCTL0 access
237 MOV.B #10h, &FRCTL0 ; 1 waitstate @ 16 MHz
238 MOV.B #01h, &FRCTL0_H ; disable FRCTL0 access
239 .ELSEIF FREQUENCY > 16
240 MOV.B #0A5h, &FRCTL0_H ; enable FRCTL0 access
241 MOV.B #20h, &FRCTL0 ; 2 waitstate @ 24 MHz
242 MOV.B #01h, &FRCTL0_H ; disable FRCTL0 access
245 ; ----------------------------------------------------------------------
246 ; POWER ON RESET SYS config
247 ; ----------------------------------------------------------------------
249 MOV #0A500h,&SYSCFG0 ; enable write MAIN + INFO
251 ; ----------------------------------------------------------------------
252 ; POWER ON RESET AND INITIALIZATION : CLOCK SYSTEM
253 ; ----------------------------------------------------------------------
255 ; CS code for MSP430FR2355
257 ; to measure SMCLK frequency, wires SMCLK on P1.0:
261 ; to measure REFO frequency, wires ACLK on P1.1:
267 MOV #1ED1h,&CSCTL0 ; preset MOD=31, DCO = measured value @ 0x180 (209)
268 MOV #00B0h,&CSCTL1 ; Set 1MHZ DCORSEL,enable DCOFTRIM=3h ,enable Modulation to reduce EMI
269 ; ===================================== ; fCOCLKDIV = REFO x (FLLN+1)
270 ; MOV #100Dh,&CSCTL2 ; Set FLLD=1 (DCOCLKCDIV=DCO/2),set FLLN=0Dh
271 ; fCOCLKDIV = 32768 x (13+1) = 0.459 MHz ; measured : MHz
272 MOV #100Eh,&CSCTL2 ; Set FLLD=1 (DCOCLKCDIV=DCO/2),set FLLN=0Eh
273 ; fCOCLKDIV = 32768 x (14+1) = 0.491 MHz ; measured : MHz
274 ; MOV #100Fh,&CSCTL2 ; Set FLLD=1 (DCOCLKCDIV=DCO/2),set FLLN=0Fh
275 ; fCOCLKDIV = 32768 x (15+1) = 0.524 MHz ; measured : MHz
276 ; =====================================
279 .ELSEIF FREQUENCY = 1
281 MOV #1EFFh,&CSCTL0 ; preset MOD=31, DCO=255
282 MOV #00B0h,&CSCTL1 ; Set 1MHZ DCORSEL,enable DCOFTRIM=3h ,enable Modulation to reduce EMI
283 ; ===================================== ; fCOCLKDIV = REFO x (FLLN+1)
284 ; MOV #001Dh,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=1Dh
285 ; fCOCLKDIV = 32768 x (29+1) = 0.983 MHz ; measured : 0.989MHz
286 MOV #001Eh,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=1Eh
287 ; fCOCLKDIV = 32768 x (30+1) = 1.015 MHz ; measured : 1.013MHz
288 ; MOV #001Fh,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=1Fh
289 ; fCOCLKDIV = 32768 x (31+1) = 1.049 MHz ; measured : 1.046MHz
290 ; =====================================
293 .ELSEIF FREQUENCY = 2
295 MOV #1EFFh,&CSCTL0 ; preset MOD=31, DCO=255
296 MOV #00B2h,&CSCTL1 ; Set 2MHZ DCORSEL,enable DCOFTRIM=3h ,enable Modulation to reduce EMI
297 ; ===================================== ; fCOCLKDIV = REFO x (FLLN+1)
298 ; MOV #003Bh,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=3Bh
299 ; fCOCLKDIV = 32768 x (59+1) = 1.966 MHz ; measured : MHz
300 MOV #003Ch,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=3Ch
301 ; fCOCLKDIV = 32768 x (60+1) = 1.998 MHz ; measured : MHz
302 ; MOV #003Dh,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=3Dh
303 ; fCOCLKDIV = 32768 x (61+1) = 2.031 MHz ; measured : MHz
304 ; =====================================
307 .ELSEIF FREQUENCY = 4
309 MOV #1EFFh,&CSCTL0 ; preset MOD=31, DCO=255
310 MOV #00B4h,&CSCTL1 ; Set 4MHZ DCORSEL,enable DCOFTRIM=3h ,enable Modulation to reduce EMI
311 ; ===================================== ; fCOCLKDIV = REFO x (FLLN+1)
312 ; MOV #0078h,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=78h
313 ; fCOCLKDIV = 32768 x (120+1) = 3.965 MHz ; measured : 3.96MHz
315 MOV #0079h,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=79h
316 ; fCOCLKDIV = 32768 x (121+1) = 3.997 MHz ; measured : 3.99MHz
318 ; MOV #007Ah,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=7Ah
319 ; fCOCLKDIV = 32768 x (122+1) = 4.030 MHz ; measured : 4.020MHz
320 ; =====================================
323 .ELSEIF FREQUENCY = 8
325 MOV #1EFFh,&CSCTL0 ; preset MOD=31, DCO=255
326 MOV #00B6h,&CSCTL1 ; Set 8MHZ DCORSEL,enable DCOFTRIM=3h ,enable Modulation to reduce EMI
327 ; ===================================== ; fCOCLKDIV = REFO x (FLLN+1)
328 MOV #00F3h,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=F3h
329 ; fCOCLKDIV = 32768 x (243+1) = 7.995 MHz ; measured : 7.976MHz
330 ; MOV #00F4h,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=F4h
331 ; fCOCLKDIV = 32768 x (244+1) = 8.028 MHz ; measured : 8.009MHz
333 ; MOV #00F5h,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=F5h
334 ; fCOCLKDIV = 32768 x (245+1) = 8.061 MHz ; measured : 8.042MHz
335 ; =====================================
338 .ELSEIF FREQUENCY = 12
340 MOV #1EFFh,&CSCTL0 ; preset MOD=31, DCO=255
341 MOV #00B8h,&CSCTL1 ; Set 12MHZ DCORSEL,enable DCOFTRIM=3h ,enable Modulation to reduce EMI
342 ; ===================================== ; fCOCLKDIV = REFO x (FLLN+1)
343 MOV #016Dh,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=1E7h
344 ; fCOCLKDIV = 32768 x 365+1) = 11.993 MHz ; measured : 11.xxxMHz
345 ; MOV #016Eh,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=1E8h
346 ; fCOCLKDIV = 32768 x 366+1) = 12.025 MHz ; measured : 12.xxxMHz
347 ; MOV #016Fh,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=1E9h
348 ; fCOCLKDIV = 32768 x 367+1) = 12.058 MHz ; measured : 12.xxxMHz
349 ; =====================================
352 .ELSEIF FREQUENCY = 16
354 MOV #1EFFh,&CSCTL0 ; preset MOD=31, DCO=255
355 MOV #00BAh,&CSCTL1 ; Set 16MHZ DCORSEL,enable DCOFTRIM=3h ,enable Modulation to reduce EMI
356 ; ===================================== ; fCOCLKDIV = REFO x (FLLN+1)
357 ; MOV #01E7h,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=1E7h
358 ; fCOCLKDIV = 32768 x 487+1) = 15.991 MHz ; measured : 15.95MHz
359 MOV #01E8h,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=1E8h
360 ; fCOCLKDIV = 32768 x 488+1) = 16.023 MHz ; measured : 15.99MHz
361 ; MOV #01E9h,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=1E9h
362 ; fCOCLKDIV = 32768 x 489+1) = 16.056 MHz ; measured : 16.02MHz
363 ; =====================================
366 .ELSEIF FREQUENCY = 20
368 MOV #1EFFh,&CSCTL0 ; preset MOD=31, DCO=255
369 MOV #00BCh,&CSCTL1 ; Set 20MHZ DCORSEL,enable DCOFTRIM=3h ,enable Modulation to reduce EMI
370 ; ===================================== ; fCOCLKDIV = REFO x (FLLN+1)
371 ; MOV #0261h,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=261h
372 ; fCOCLKDIV = 32768 x 609+1) = 19.988 MHz ; measured : 19.xxxMHz
373 MOV #0262h,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=262h
374 ; fCOCLKDIV = 32768 x 610+1) = 20.021 MHz ; measured : 20.xxxMHz
375 ; MOV #0263h,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=263h
376 ; fCOCLKDIV = 32768 x 611+1) = 20.054 MHz ; measured : 20.xxxMHz
377 ; =====================================
380 .ELSEIF FREQUENCY = 24
382 MOV #1EFFh,&CSCTL0 ; preset MOD=31, DCO=255
383 MOV #00BEh,&CSCTL1 ; Set 24MHZ DCORSEL,enable DCOFTRIM=3h ,enable Modulation to reduce EMI
384 ; ===================================== ; fCOCLKDIV = REFO x (FLLN+1)
385 ; MOV #02DBh,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=2DBh
386 ; fCOCLKDIV = 32768 x 731+1) = 23.986 MHz ; measured : 23.xxxMHz
387 MOV #02DCh,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=2DCh
388 ; fCOCLKDIV = 32768 x 732+1) = 24.019 MHz ; measured : 23.xxxMHz
389 ; MOV #02DDh,&CSCTL2 ; Set FLLD=0 (DCOCLKCDIV=DCO),set FLLN=2DDh
390 ; fCOCLKDIV = 32768 x 733+1) = 24.051 MHz ; measured : 24.xxxMHz
391 ; =====================================
395 .error "bad frequency setting, only 0.5,1,2,4,8,12,16,20,24 MHz"
399 ; MOV #0000h,&CSCTL3 ; FLL select XT1, FLLREFDIV=0 (default value)
400 MOV #0000h,&CSCTL4 ; ACLOCK select XT1, MCLK & SMCLK select DCOCLKDIV
401 ; BIC.B #1,&CSCTL6 ; disable XT1AUTOOFF
403 BIS.B #0C0h,&P2SEL1 ; P2.6 as XOUT, P2.7 as XIN
406 BIS #0010h,&CSCTL3 ; FLL select REFCLOCK
407 ; MOV #0100h,&CSCTL4 ; ACLOCK select REFO, MCLK & SMCLK select DCOCLKDIV (default value)
411 BIS &SYSRSTIV,&SAVE_SYSRSTIV; store volatile SYSRSTIV preserving a pending request for DEEP_RST
412 ; MOV &SAVE_SYSRSTIV,TOS ;
413 ; CMP #2,TOS ; POWER ON ?
414 ; JZ ClockWaitX ; yes
415 ; RRUM #1,X ; wait only 250 ms
416 ClockWaitX MOV #5209,Y ; wait 0.5s before starting after POR
417 ; ...because FLL lock time = 280 ms
418 ClockWaitY SUB #1,Y ;1
419 JNZ ClockWaitY ;2 5209x3 = 15625 cycles delay = 15.625ms @ 1MHz
420 SUB #1,X ; x 32 @ 1 MHZ = 500ms
421 JNZ ClockWaitX ; time to stabilize power source ( 500ms )
423 ;WAITFLL BIT #300h,&CSCTL7 ; wait FLL lock