56529d2944
- migrated /README are removed from /boards - there are a lot of READMEs that should be further converted to rst. At the moment they are moved to Documentation/platforms and included in rst files
113 lines
3.0 KiB
Plaintext
113 lines
3.0 KiB
Plaintext
README
|
|
======
|
|
|
|
This README provides some information about the port of NuttX to the TI
|
|
Hercules TMS570LS31x USB Kit featuring the Hercules TMS570LS3137ZWT chip.
|
|
|
|
Contents
|
|
========
|
|
|
|
- Status
|
|
- Toolchain
|
|
- LEDs and Buttons
|
|
- Serial Console
|
|
- Debugging
|
|
- Configurations
|
|
|
|
Status
|
|
======
|
|
|
|
2017-10-18:
|
|
The basic port to the TMS570 is complete. The NSH with basic commands is
|
|
up and running. There is support for SCI communication and RTI.
|
|
|
|
Toolchain
|
|
=========
|
|
|
|
Build Platform
|
|
--------------
|
|
All of these configurations are set up to build with Ubuntu.
|
|
|
|
Endian-ness Issues
|
|
------------------
|
|
I used a version of the NuttX buildroot toolchain that can be built like
|
|
this:
|
|
|
|
cd buildroot/
|
|
cp boards/cortexr4f-eabi-defconfig-4.8.5 .config
|
|
make oldconfig
|
|
make
|
|
|
|
Before building the compiler I installed the following packages which
|
|
are needed for the compiler build.
|
|
|
|
# install or update all apt-get dependencies
|
|
sudo apt-get update
|
|
sudo apt-get upgrade
|
|
sudo apt-get install gcc # not cross
|
|
sudo apt-get install g++
|
|
sudo apt-get install make
|
|
sudo apt-get install bison
|
|
sudo apt-get install flex
|
|
sudo apt-get install gawk
|
|
sudo apt-get install libgmp3-dev
|
|
sudo apt-get install libmpfr-dev libmpfr-doc libmpfr4 libmpfr4-dbg
|
|
sudo apt-get install mpc
|
|
sudo apt-get install texinfo # optional
|
|
sudo apt-get install libcloog-isl-dev # optional
|
|
sudo apt-get install build-essential
|
|
sudo apt-get install glibc-devel
|
|
sudo apt-get -y install gcc-multilib libc6-i386
|
|
|
|
Serial Console
|
|
==============
|
|
|
|
This TMS570ls3137 has a single SCI and one combined SCI/LIN interface.
|
|
The SCI_RX and TX pins are connected to the FTDI chip which provides a
|
|
virtual COM port for the usb kit.
|
|
|
|
Debugging
|
|
=========
|
|
|
|
I used the On Board Debugger.
|
|
|
|
Configurations
|
|
==============
|
|
|
|
Information Common to All Configurations
|
|
----------------------------------------
|
|
Each TMS570LS31X Usb Kit configuration is maintained in a sub-directory and
|
|
can be selected as follow:
|
|
|
|
tools/configure.sh tms570ls31x-usb-kit:<subdir>
|
|
|
|
Before building, make sure the PATH environment variable includes the
|
|
correct path to the directory than holds your toolchain binaries.
|
|
|
|
And then build NuttX by simply typing the following. At the conclusion of
|
|
the make, the nuttx binary will reside in an ELF file called, simply, nuttx.
|
|
|
|
make oldconfig
|
|
make
|
|
|
|
The <subdir> that is provided above as an argument to the tools/configure.sh
|
|
must be is one of the following.
|
|
|
|
NOTES:
|
|
|
|
1. These configurations use the mconf-based configuration tool. To
|
|
change any of these configurations using that tool, you should:
|
|
|
|
a. Build and install the kconfig-mconf tool. See nuttx/README.txt
|
|
see additional README.txt files in the NuttX tools repository.
|
|
|
|
b. Execute 'make menuconfig' in nuttx/ in order to start the
|
|
reconfiguration process.
|
|
|
|
Configuration sub-directories
|
|
-----------------------------
|
|
|
|
nsh:
|
|
|
|
Configures the NuttShell (nsh) located at examples/nsh.
|