README
======
This README discusses issues unique to NuttX configurations for the Spark Core board from Spark Devices (http://www.spark.io). This board features the STM32103CBT6 MCU from STMicro.
Microprocessor: 32-bit ARM Cortex M3 at 72MHz STM32F103CBT6
Memory: 120 KB Flash and 20 KB SRAM, 2M serial Flash
I/O Pins Out: 37, 17 On the Connector
Network: TI CC3000 Wifi Module
ADCs: 9 (at 12-bit resolution)
Peripherals: 4 timers, 2 I2Cs, 2 SPI ports, 3 USARTs, 2 led's one Blue and one RGB.
Other: Sleep, stop, and standby modes; serial wire debug and JTAG interfaces
During the development of the SparkCore, the hardware was in limited supply
As a work around David Sidrane <david_s5@nscdg.com> created a SparkCore Big board
(http://nscdg.com/spark/sparkBB.png) that will interface with a maple mini
(http://leaflabs.com/docs/hardware/maple-mini.html), and a CC3000BOOST
(https://estore.ti.com/CC3000BOOST-CC3000-BoosterPack-P4258.aspx)
It breaks out the Tx, Rx to connect to a FTDI TTL-232RG-VREG3V3-WE for the console and
wires in the spark LEDs and serial flash to the same I/O as the sparkcore. It has a Jlink
compatible Jtag connector on it.
Contents
========
- Hardware
- Core Pin out
- LEDs
- Buttons
- USARTS and Serial Consoles
- DFU and JTAG
- Spark -specific Configuration Options
- Configurations
DFU and JTAG
============
Enbling Support for the DFU Bootloader
--------------------------------------
The linker files in these projects can be configured to indicate that you
will be loading code using STMicro built-in USB Device Firmware Upgrade (DFU)
loader or via some JTAG emulator. You can specify the DFU bootloader by
adding the following line:
CONFIG_STM32_DFU=y
to your .config file. Most of the configurations in this directory are set
up to use the DFU loader.
If CONFIG_STM32_DFU is defined, the code will not be positioned at the beginning
of FLASH (0x08000000) but will be offset to 0x08005000. This offset is needed
to make space for the DFU loader and 0x08005000 is where the DFU loader expects
to find new applications at boot time. If you need to change that origin for some
other bootloader, you will need to edit the file(s) ld.script.dfu for the
configuration.
For Linux or Mac:
----------------
While on Linux or Mac, we can use dfu-util to upload nuttx binary.
1. Make sure we have installed dfu-util. (From yum, apt-get or build from source.)
2. Start the DFU loader (bootloader) on the Spark board. You do this by
resetting the board while holding the "Key" button. Windows should
recognize that the DFU loader has been installed.
3. Flash the nuttx.bin to the board use dfu-util. Here's an example:
$ dfu-util -a1 -d 1eaf:0003 -D nuttx.bin -R
For anything not clear, we can refer to LeafLabs official document:
http://leaflabs.com/docs/unix-toolchain.html
For Windows:
-----------
The DFU SE PC-based software is available from the STMicro website,
http://www.st.com. General usage instructions:
1. Convert the NuttX Intel Hex file (nuttx.hex) into a special DFU
file (nuttx.dfu)... see below for details.
2. Connect the M3 Wildfire board to your computer using a USB
cable.
3. Start the DFU loader on the M3 Wildfire board. You do this by
resetting the board while holding the "Key" button. Windows should
recognize that the DFU loader has been installed.
3. Run the DFU SE program to load nuttx.dfu into FLASH.
What if the DFU loader is not in FLASH? The loader code is available
inside of the Demo dirctory of the USBLib ZIP file that can be downloaded
from the STMicro Website. You can build it using RIDE (or other toolchains);
you will need a JTAG emulator to burn it into FLASH the first time.
In order to use STMicro's built-in DFU loader, you will have to get
the NuttX binary into a special format with a .dfu extension. The
DFU SE PC_based software installation includes a file "DFU File Manager"
conversion program that a file in Intel Hex format to the special DFU
format. When you successfully build NuttX, you will find a file called
nutt.hex in the top-level directory. That is the file that you should
provide to the DFU File Manager. You will end up with a file called
nuttx.dfu that you can use with the STMicro DFU SE program.
Enabling JTAG
-------------
If you are not using the DFU, then you will probably also need to enable
JTAG support. By default, all JTAG support is disabled but there NuttX
configuration options to enable JTAG in various different ways.
These configurations effect the setting of the SWJ_CFG[2:0] bits in the AFIO
MAPR register. These bits are used to configure the SWJ and trace alternate function I/Os.
The SWJ (SerialWire JTAG) supports JTAG or SWD access to the Cortex debug port.
The default state in this port is for all JTAG support to be disable.
CONFIG_STM32_JTAG_FULL_ENABLE - sets SWJ_CFG[2:0] to 000 which enables full
SWJ (JTAG-DP + SW-DP)
CONFIG_STM32_JTAG_NOJNTRST_ENABLE - sets SWJ_CFG[2:0] to 001 which enable
full SWJ (JTAG-DP + SW-DP) but without JNTRST.
CONFIG_STM32_JTAG_SW_ENABLE - sets SWJ_CFG[2:0] to 010 which would set JTAG-DP
disabled and SW-DP enabled
The default setting (none of the above defined) is SWJ_CFG[2:0] set to 100
which disable JTAG-DP and SW-DP.
Hardware
========
The Spark comprises a STM32F103CB 72 Mhz, 128 Flash, 20K Ram, with 37 IO Pins, and
a TI CC3000 Wifi Module. It has a 2MB serial flash, onboad regulation and 2 led's
one Blue and one RGB.
During the development of the SparkCore, the hardware was in limited supply
As a work around david_s5 created a SparkCore Big board (http://nscdg.com/spark/sparkBB.png)
that will interface with a maple mini (http://leaflabs.com/docs/hardware/maple-mini.html),
and a CC3000BOOST (https://estore.ti.com/CC3000BOOST-CC3000-BoosterPack-P4258.aspx)
It breaks out the Tx, Rx to connect to a FTDI TTL-232RG-VREG3V3-WE for the console and
wires in the spark LEDs and serial flash to the same I/O as the sparkcore. It has a Jlink
compatible Jtag connector on it.
Core Pin out
============
There are 24 pis on the Spark Core module.
Spark Spark Function STM32F103CBT6
Name Pin # Pin #
-------- ------ ------------------------------------------------ ---------------
RAW JP1-1 Input Power N/A
GND JP1-2 GND
TX JP1-3 PA[02] USART2_TX/ADC12_IN2/TIM2_CH3 12
RX JP1-4 PA[03] USART2_RX/ADC12_IN3/TIM2_CH4 13
A7 JP1-5 PB[01] ADC12_IN9/TIM3_CH4 19
A6 JP1-6 PB[00] ADC12_IN8/TIM3_CH3 18
A5 JP1-7 PA[07] SPI1_MOSI/ADC12_IN7/TIM3_CH2 17
A4 JP1-8 PA[06] SPI1_MISO/ADC12_IN6/TIM3_CH1 16
A3 JP1-9 PA[05] SPI1_SCK/ADC12_IN5 15
A2 JP1-10 PA[04] SPI1_NSS/USART2_CK/ADC12_IN4 14
A1 JP1-11 PA[01] USART2_RTS/ADC12_IN1/TIM2_CH2 11
A0 JP1-12 PA[00] WKUP/USART2_CTS/ADC12_IN0/TIM2_CH1_ETR 10
+3V3 JP2-1 V3.3 Out of Core NA
RST JP2-2 NRST 7
VDDA JP2-3 ADC Voltage 9
GND JP2-4 GND
D7 JP2-5 PA[13] JTMS/SWDIO 34 Common with Blue LED LED_USR
D6 JP2-6 PA[14] JTCK/SWCLK 37
D5 JP2-7 PA[15] JTDI 38
D4 JP2-8 PB[03] JTDO 39
D3 JP2-9 PB[04] NJTRST 40
D2 JP2-10 PB[05] I2C1_SMBA 41
D1 JP2-11 PB[06] I2C1_SCL/TIM4_CH1 42
D0 JP2-12 PB[07] I2C1_SDA/TIM4_CH2 43
Core Internal IO
================
Spark Function STM32F103CBT6
Name Pin #
-------- ------------------------------------------------ ---------------
BTN PB[02] BOOT1 20
LED1,D7 PA[13] JTMS/SWDIO 34
LED2 PA[08] USART1_CK/TIM1_CH1/MCO 29
LED3 PA[09] USART1_TX/TIM1_CH2 30
LED4 PA[10] USART1_RX/TIM1_CH3 31
MEM_CS PB[09] TIM4_CH4 46 SST25VF016B Chip Select
SPI_CLK PB[13] SPI2_SCK/USART3_CTS/TIM1_CH1N 26
SPI_MISO PB[14] SPI2_MISO/USART3_RTS/TIM1_CH2N 27
SPI_MOSI PB[15] SPI2_MOSI/TIM1_CH3N 28
USB_DISC PB[10] I2C2_SCL/USART3_TX 21
WIFI_CS PB[12] SPI2_NSS/I2C2_SMBA/USART3_CK/TIM1_BKIN 25 CC3000 Chip Select
WIFI_EN PB[08] TIM4_CH3 45 CC3000 Module enable
WIFI_INT PB[11] I2C2_SDA/USART3_RX 22 CC3000 Host interface SPI interrupt
Buttons and LEDs
================
Buttons
-------
The Spark has two mechanical buttons. One button is the RESET button
connected to the STM32F103CB's reset line via /RST and the other is a
generic user configurable button labeled BTN and connected to GPIO
PB2/BOOT1. Since on the Spark, BOOT0 is tied to GND it is a moot point
that BTN signal is connected to the BOOT1 signal. When a button is
pressed it will drive the I/O line to GND.
LEDs
----
There are 4 user-controllable LEDs in two packages on board the Spark board:
Sigal Location Color GPIO Active
------- ------------ ----------- ----- -----------
LED1 LED_USR Blue LED PA13 High Common With D7
LED2 LED_RGB Red LED PA8 Low
LED3 LED_RGB Blue LED PA9 Low
LED4 LED_RGB Green LED PA10 Low
LED1 is connected to ground and can be illuminated by driving the PA13
output high, it shares the Sparks D7 output. The LED2,LED3 and LED4
are pulled high and can be illuminated by driving the corresponding GPIO output
to low.
The RGB LEDs are not used by the board port unless CONFIG_ARCH_LEDS is
defined. In that case, the usage by the board port is defined in
include/board.h and src/up_leds.c. The LEDs are used to encode OS-related
events as follows:
SYMBOL Meaning LED2 LED3 LED4
red blue green Color
------------------- ----------------------- ------- ------- ------ ---------
LED_STARTED NuttX has been started ON OFF OFF Red
LED_HEAPALLOCATE Heap has been allocated OFF ON OFF Blue
LED_IRQSENABLED Interrupts enabled ON OFF ON Orange
LED_STACKCREATED Idle stack created OFF OFF ON Green
LED_INIRQ In an interrupt** ON N/C N/C Orange Glow
LED_SIGNAL In a signal handler*** N/C ON N/C Blue Glow
LED_ASSERTION An assertion failed ON ON ON White
LED_PANIC The system has crashed ON N/C N/C Red Flashing
LED_IDLE STM32 is is sleep mode (Optional, not used)
* If LED2, LED3, LED4 are statically on, then NuttX probably failed to boot
and these LEDs will give you some indication of where the failure was
** The normal state is LED4 ON and LED2 faintly glowing. This faint glow
is because of timer interrupts that result in the LED being illuminated
on a small proportion of the time.
*** LED3 may also flicker normally if signals are processed.
Serial Consoles
===============
USART2
-----
If you have a 3.3 V TTL to RS-232 convertor then this is the most convenient
serial console to use. UART2 is the default in all of these
configurations.
USART2 RX PA3 JP1 pin 4
USART2 TX PA2 JP1 pin 3
GND JP1 pin 2
V3.3 JP2 pin 1
Virtual COM Port
----------------
Yet another option is to use UART0 and the USB virtual COM port. This
option may be more convenient for long term development, but was
painful to use during board bring-up.
Spark -specific Configuration Options
==============
WIP
Configurations
==============
Composite: The composite is a super set of all the functions in nsh,
usbserial, usbmsc. (usbnsh has not been rung out).
Build it with
make distclean;cd tools;./configure.sh spark/composite;cd ..
then run make menuconfig if you wish to customize things.
N.B. Memory is tight, both Flash and RAM are taxed. If you enable
debugging you will need to add -Os following the line -g in the line:
ifeq ($(CONFIG_DEBUG_SYMBOLS),y)
ARCHOPTIMIZATION = -g
in the top level Make.degs or the code will not fit.
Stack space has been hand optimized using the stack coloring by enabling
"Stack coloration" (CONFIG_STACK_COLORATION) in Build Setup-> Debug
Options. I have selected values that have 8-16 bytes of headroom with
network debugging on. If you enable more debugging and get a hard fault
or any weirdness like commands hanging. Then the Idle, main or Interrupt
stack my be too small. Stop the target and have a look a memory for a
blown stack: No DEADBEEF at the lowest address of a given stack.
Given the RAM memory constraints it is not possible to be running the
network and USB CDC/ACM and MSC at the same time. But on the bright
side, you can export the FLASH memory to the PC. Write files on the
Flash. Reboot and mount the FAT FS and run network code that will have
access the files.
You can use the scripts/cdc-acm.inf file to install the windows
composite device.
SPI2 is enabled and support is included for the FAT file system on the
16Mbit (2M) SST25 device and control of the CC3000 on the spark core.
When the system boots, you should have a dev/mtdblock0 that can be
mounted using the command:
mount -t vfat /dev/mtdblock0 /mnt/p0
or /dev/mtdblock0 can be exported as MSC on the USB interface along with
a Virtual serial port as a CDC/ACM interface.
Use the command conn* and disconn to manage the USB interface.
N.B. *If /dev/mtdblock0 is mounted then You must unmount it prior to
exporting it via the conn command. Bad things will happen if not.
Network control is facilitated by running the c3b (cc3000basic) application.
Run c3b from the nsh prompt.
+-------------------------------------------+
| Nuttx CC3000 Demo Program |
+-------------------------------------------+
01 - Initialize the CC3000
02 - Show RX & TX buffer sizes, & free RAM
03 - Start Smart Config
04 - Manually connect to AP
05 - Manually add connection profile
06 - List access points
07 - Show CC3000 information
08 - Telnet
Type 01-07 to select above option:
Select 01. Then use 03 and the TI Smart config application running on an
IOS or Android device to configure join your network.
Use 07 to see the IP address of the device.
(On the next reboot running c3b 01 the CC3000 will automaticaly rejoin the
network after the 01 give it a few seconds and enter 07 or 08)
Use 08 to start Telnet. Then you can connect to the device using the
address listed in command 07.
qq will exit the c3b with the telnet deamon running (if started)
Slow.... You will be thinking 300 bps. This is because of packet sizes and
how the select thread runs in the telnet session. Telnet is not the best
showcase for the CC3000, but simply a proof of network connectivity.
http POST and GET should be more efficient.
