nuttx

History

chao.an b88561299b make/expression: improving up asm/C/C++ compile times In the current compilation environment, the recursive assignment(=) for compile flags will be delayed until every file is actually need to be compile. For example: -------------------------------------------------------------------------------- arch/arm/src/Makefile: INCLUDES += ${shell $(INCDIR) "$(CC)" $(ARCH_SRCDIR)$(DELIM)chip} INCLUDES += ${shell $(INCDIR) "$(CC)" $(ARCH_SRCDIR)$(DELIM)common} INCLUDES += ${shell $(INCDIR) "$(CC)" $(ARCH_SRCDIR)$(DELIM)$(ARCH_SUBDIR)} INCLUDES += ${shell $(INCDIR) "$(CC)" $(TOPDIR)$(DELIM)sched} CPPFLAGS += $(INCLUDES) $(EXTRAFLAGS) CFLAGS += $(INCLUDES) $(EXTRAFLAGS) CXXFLAGS += $(INCLUDES) $(EXTRAFLAGS) AFLAGS += $(INCLUDES) $(EXTRAFLAGS) -------------------------------------------------------------------------------- All compilation options will be included recursively, which will be delayed until the compilation options are actually used: tools/Config.mk: -------------------------------------------------------------------------------- define COMPILE @echo "CC: $1" $(Q) $(CC) -c $(CFLAGS) $($(strip $1)_CFLAGS) $1 -o $2 endef -------------------------------------------------------------------------------- All compile flags to be reexecuted $(INCDIR) as long as one file needs to be compiled, but in fact, the compilation options have not changed in the current directory. So the we recommand to change the syntax of assignment From Recursive (=) To Simple (:=) In this way, we can ensure that all compilation options are expanded only once and reducing repeated works. Signed-off-by: chao.an <anchao@xiaomi.com>		2020-11-02 07:53:53 -08:00
..
configs/nsh	libc/stdio: Allocate file_struct dynamically	2020-09-11 17:58:17 +08:00
include
scripts	make/expression: improving up asm/C/C++ compile times	2020-11-02 07:53:53 -08:00
src	drivers/led: Extend userled_set_t from 8bits to 32bits	2020-06-07 19:28:10 +01:00
Kconfig
README.txt

README.txt

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.