From b35a140636219256e74967bdb40b516bb2375944 Mon Sep 17 00:00:00 2001 From: Gregory Nutt Date: Sat, 19 Jan 2019 10:31:06 -0600 Subject: [PATCH] About the NuttX 'About' document in preparation for the 7.28 release. --- ChangeLog | 4 +- Documentation/NuttShell.html | 6 +- Documentation/NuttX.html | 351 ++++++++++++++++++++++----- ReleaseNotes | 5 +- configs/launchxl-cc1312r1/README.txt | 2 +- 5 files changed, 298 insertions(+), 70 deletions(-) diff --git a/ChangeLog b/ChangeLog index 750848a094..ed119954c8 100644 --- a/ChangeLog +++ b/ChangeLog @@ -22518,7 +22518,7 @@ Mateusz Sfafoni (2019-01-09). * include/nuttx/compiler.h: Correct support of C-version-specific features. Cannot depend on GCC version because -std=c89 may be used on - comomand line. Need instead to use __STDC_VERSION__ to determine if a + command line. Need instead to use __STDC_VERSION__ to determine if a feature is supported. Also add conditional support inline, depending on C99. From Gregory Nutt (2019-01-09). * With these changes, I am able to access NSH on Beaglebone Black. I @@ -22606,5 +22606,7 @@ And, of course, completely untested. Support for the CC26x2, which is nearly identical to the CC13x2 is fragmentary. From Gregory Nutt (2019-01-17). + * arch/arm/include/kinetis/kinetis_sim.h: Remove extra characters following + #undef. From Daniel Agar (2018-01-19). 7.29 2019-xx-xx Gregory Nutt diff --git a/Documentation/NuttShell.html b/Documentation/NuttShell.html index e87fc817d0..3fbbbb03fb 100644 --- a/Documentation/NuttShell.html +++ b/Documentation/NuttShell.html @@ -8,7 +8,7 @@

NuttShell (NSH)

-

Last Updated: October 2, 2018

+

Last Updated: January 19, 2019

@@ -1241,6 +1241,7 @@ test <expression>

Command Syntax:

Synopsis. @@ -1263,6 +1264,9 @@ nsh> addroute addroute 11.0.0.0 255.255.255.0 10.0.0.2

+

+ The second form of the addroute command can be used to set the default gateway. +

diff --git a/Documentation/NuttX.html b/Documentation/NuttX.html index bcb8f65e35..89e4d02a6f 100644 --- a/Documentation/NuttX.html +++ b/Documentation/NuttX.html @@ -8,7 +8,7 @@

NuttX RTOS

-

Last Updated: January 2, 2019

+

Last Updated: January 19, 2019
@@ -534,6 +534,16 @@

+ +
+ +

+

  • + LittleFS. FLASH file system from ARM mbed.. +
    • +

    + +
    @@ -1451,11 +1461,11 @@

    Released Versions

    In addition to the ever-changing GIT repository, there are frozen released versions of NuttX available. - The current release is NuttX 7.27. - NuttX 7.27 is the 127th release of NuttX. - It was released on November 15, 2018, and is available for download from the + The current release is NuttX 7.28. + NuttX 7.28 is the 128th release of NuttX. + It was released on January 19, 2019, and is available for download from the Bitbucket.org website. - Note that the release consists of two tarballs: nuttx-7.27.tar.gz and apps-7.27.tar.gz. + Note that the release consists of two tarballs: nuttx-7.28.tar.gz and apps-7.28.tar.gz. Both may be needed (see the top-level nuttx/README.txt file for build information).

    @@ -1464,7 +1474,7 @@ +
  • Maxim Integrated + +
  • MicroChip
  • NXP/Freescale (Continued)
  • Texas Instruments (some formerly Luminary)
  • ZiLOG @@ -2432,6 +2451,39 @@ + +
    +
    + + +
    + +

    + TI/Sitara AM335x. + These following boards are based on the TI/Sitara AM335x are supported by NuttX: +

    +
      +
    • +

      + Beaglebone Black. + A port of NuttX to the Beaglebone Black board was first released in NuttX-7.28. + This port was contributed by Petro Karashchenko. + This board is based on the TI/Sitara AM3358 Cortex-A8 CPU running 1GHz. +

      +

      + STATUS. + This initial port in NuttX-7.28 is very sparse. + While not ready for prodcution use, the Beaglebone Black port is functional and will be the basis for a more extensive development. + Additional work in progress to extend this port and more capable is anticipated in NuttX-7.29. +

      +

      + Refer to the Beaglebone Black board README file for further, up-to-date information. +

      +
      • +
    + + + @@ -2518,9 +2570,6 @@ - - - @@ -2857,6 +2906,19 @@ nsh>
    + +
    + +

    + TI/Stellaris LM3S9B92. + Architectural support for the LM3S9B92 was contributed by Lwazi Dube in NuttX 7.28. No board support for boards using the LM3S9B92 are currently available. +

    + + + +
    +
    +
    @@ -2873,6 +2935,20 @@ nsh>
    + +
    + +

    + TI/SimpleLink CC13x0. + Basic, unverified architectural support for the CC13x0 was added in NuttX-7.28. + This is a work in progress and, with any luck, a fully verified port will be available in NuttX-7.29. +

    + + + +
    +
    +
    @@ -3004,50 +3080,67 @@ nsh>

    STMicro STM32L152 (STM32L "EnergyLite" Line). - This is a port of NuttX to the STMicro STM32L-Discovery development board. - The STM32L-Discovery board is based on the STM32L152RBT6 MCU (128KB FLASH and 16KB of SRAM). -

    + Two boards are supported: +

      -

      - The STM32L-Discovery and STM32L152C DISCOVERY kits are functionally equivalent. - The difference is the internal Flash memory size (STM32L152RBT6 with 128 Kbytes or STM32L152RCT6 with 256 Kbytes). - Both boards feature: -

      -
        -
      • An ST-LINK/V2 embedded debug tool interface,
        • -
      • LCD (24 segments, 4 commons),
        • -
      • LEDs,
        • -
      • Pushbuttons,
        • -
      • A linear touch sensor, and
        • -
      • Four touchkeys.
        • -
      -

      - STATUS. - Initial support for the STM32L-Discovery was released in NuttX-6.28. - Addition (architecture-only) support for the STM32L152xC family was added in NuttX-7.21. - This initial support includes a configuration using the NuttShell (NSH) that might be the basis for an application development. - A driver for the on-board segment LCD is included as well as an option to drive the segment LCD from an NSH "built-in" command. - As of this writing, a few more things are needed to make this a more complete port: 1) Verfication of more device drivers (timers, quadrature encoders, PWM, etc.), and 2) logic that actually uses the low-power consumption modes of the EnergyLite part. - Refer to the NuttX board README file for further information. -

      -

      - Memory Usage. - For a full-featured RTOS such as NuttX, providing support in a usable and meaningful way within the tiny memories of the STM32L152RBT6 demonstrates the scalability of NuttX. The STM32L152RBT6 comes in a 64-pin package and has 128KB FLASH and 16KB of SRAM. -

      -

      - Static memory usage can be shown with size command: -

      - 
        +      
      • 
+        
        STM32L-Discovery.
+          This is a port of NuttX to the STMicro STM32L-Discovery development board.
+          The STM32L-Discovery board is based on the STM32L152RBT6 MCU (128KB FLASH and 16KB of SRAM).
+        
        
+        
        
+          The STM32L-Discovery and STM32L152C DISCOVERY kits are functionally equivalent.
+          The difference is the internal Flash memory size (STM32L152RBT6 with 128 Kbytes or STM32L152RCT6 with 256 Kbytes).
+          Both boards feature:
+        
        
+        
          
+          
        • An ST-LINK/V2 embedded debug tool interface,
          • 
+          
        • LCD (24 segments, 4 commons),
          • 
+          
        • LEDs,
          • 
+          
        • Pushbuttons,
          • 
+          
        • A linear touch sensor, and
          • 
+          
        • Four touchkeys.
          • 
+        
        
+      
        • 
+      
      • 
+        
        Nucleo-L152RE.
+        Board support for the Nucleo-L152RE was contributed by Mateusz Szafoni in NuttX-7.28.
+        Available configurations include NSH, ADC, and PWM.
+        
        
+      
        • 
+
      +

      + STATUS. + Initial support for the STM32L-Discovery was released in NuttX-6.28. + Addition (architecture-only) support for the STM32L152xC family was added in NuttX-7.21. + Support for the Nucleo-L152RE was added in NuttX-7.28. +

      +

      + That initial STM32L-Discovery support included a configuration using the NuttShell (NSH) that might be the basis for an application development. + A driver for the on-board segment LCD is included as well as an option to drive the segment LCD from an NSH "built-in" command. + Refer to the STM32L-Discovery board README file for further information. +

      +

      + Memory Usage. +

      + REVISIT: These numbers are out of date. Current NuttX sizing might be somewhat larger. +
      + For a full-featured RTOS such as NuttX, providing support in a usable and meaningful way within the tiny memories of the STM32L152RBT6 demonstrates the scalability of NuttX. The STM32L152RBT6 comes in a 64-pin package and has 128KB FLASH and 16KB of SRAM. +

      +

      + Static memory usage can be shown with size command: +

      + 
         $ size nuttx
    text    data     bss     dec     hex filename
   39664     132    1124   40920    9fd8 nuttx
      -

      - NuttX, the NSH application, and GCC libraries use 38.7KB of FLASH leaving 89.3B of FLASH (70%) free from additional application development. - Static SRAM usage is about 1.2KB (<4%) and leaves 14.8KB (86%) available for heap at runtime. -

      - SRAM usage at run-time can be shown with the NSH free command: - 
        +    
        
+      NuttX, the NSH application, and GCC libraries use 38.7KB of FLASH leaving 89.3B of FLASH (70%) free from additional application development.
+      Static SRAM usage is about 1.2KB (<4%) and leaves 14.8KB (86%) available for heap at runtime.
+    
        
+      SRAM usage at run-time can be shown with the NSH free command:
+    
           NuttShell (NSH) NuttX-6.27
 nsh> free
              total       used       free    largest
@@ -3084,7 +3177,7 @@ nsh>
     
          
       STMicro STM32F0xx (STM32 F0, ARM Cortex-M0).
       Support for the STM32 F0 family was contributed by Alan Carvalho de Assis in NuttX-7.21.
-      There are ports to three different boards in this respository:
+      There are ports to three different boards in this repository:
     
          
     
            
       
          • 
@@ -3103,11 +3196,47 @@ nsh>
         Contributed by Juha Niskanen in NuttX-7.21.
       
            • 
     
          
-    
          STATUS:
-    In this initial release, the level of support for the STM32 F0 family is minimal.
-    Certainly enough is in place to support a robust NSH configuration.
-    There are also unverified I2C and USB device drivers available in NuttX-7.21.
+    
          
+      STATUS:
     
          
+    
            
+      
          • 
+        NuttX-7.21.
+        In this initial release, the level of support for the STM32 F0 family is minimal.
+        Certainly enough is in place to support a robust NSH configuration.
+        There are also unverified I2C and USB device drivers available in
+        NuttX-7.21.
+      
            • 
+      
          • 
+        NuttX-7.28
+        Add support for GPIO EXTI.  From Mateusz Sfafoni.
+      
            • 
+    
            
+  
+
+
+
+  
            
+  
            
+
+
+  
            
+  
+    
            
+      STMicro STM32L0xx (STM32 F0, ARM Cortex-M0).
+      Support for the STM32 FL family was contributed by Mateusz Sfafoni in NuttX-7.28.
+      There are ports to two different STM32 L0 boards in the repository:
+    
            
+    
              
+      
            • 
+        B-L072Z-LRWAN1
+        Contributed byMateusz Sfafoni in NuttX-7.28.
+      
              • 
+      
            • 
+        Nucleo-L073RZ
+        Contributed byMateusz Sfafoni in NuttX-7.28.
+      
              • 
+    
            
   
 
 
@@ -3248,6 +3377,13 @@ nsh>
             Contributed by David Sidrane.
          
            
       
+      
          • 
+         
            
+            Nucleo-STM32F103RB.
+            This port uses the STM32F103RBT6.
+            It was contributed by Mateusz Szafoni in NuttX-7.28,
+         
            
+      
            • 
     
     
            
       These ports uses a GNU arm-nuttx-elf toolchain* under either Linux or Cygwin (with native Windows GNU tools or Cygwin-based GNU tools).
@@ -3299,6 +3435,13 @@ nsh>
             Configurations are included for the NuttShell (NSH), a tiny version of the NuttShell, USB composite CDC/ACM + MSC, CAN support, and two tiny, small-footprint NSH configurations.
           
            
         
+        
          • 
+          
            
+            Nucleo-STM32F103RB.
+            Contributed by Mateusz Szafoni and introduced with NuttX 7.28.
+            Configurations are included for the NuttShell (NSH), ADC, and PWM.
+          
            
+        
            • 
       
          
      
        
      
        
@@ -3442,6 +3585,10 @@ nsh>
         
      • 
           Martin Lederhilger contributed support for the Olimex STM32 P207 board using the STM32F207ZE MCU.
         
        • 
+        
      • 
+          Board support for the Nucleo-L152RE was contributed by Mateusz Szafoni in NuttX-7.28.
+          Available configurations include NSH, ADC, and PWM.
+        
        •

        @@ -3761,9 +3908,47 @@ nsh> This port is intended to test LC823450 features including SMP. Supported peripherals include UART, TIMER, RTC, GPIO, DMA, I2C, SPI, LCD, eMMC, and USB device. ADC, Watchdog, IPC2, and I2S support was added by Masayuki Ishakawa in NuttX-7.23. Bluetooth, SPI, and PROTECTED build support were added by Masayuki Ishakawa in NuttX-7.26. + Support for for SPI flash boot was added in NuttX-7.28.

        + +
        +
        + + +
        + +

        + Maxim Integrated MAX36600. + Architectural upport for the MAX32660 was added (along with partial support for other members of the MAX326xx family) in NuttX 7.28. +

        +

        + MAX32660-EVSYS. + Basic support for the Maxim Integrated MAC3X660 + EVSYS was included in the NuttX-7.28 release. + A basic NSH configuration is available and is fully functional. + Includes unverified support for an SPI0-based SD card. +

        +

        + STATUS: +

        +
          +

          + NuttX-7.29. + The initial release included: Clock configuration, timer, GPIO pin configuration, ICC, and UART. + Additional untested drivers are complete and ready for testing: DMA, GPIO interrupts, SPI0 Master, TC, WDT. + The following drivers are not yet implemented: I2C and I2S. +

          +

          + README File. + Refer to the MAX32660-EVSYS README file for further information. +

          +
        + + + +
      • (ARM Cortex-M3)
        • @@ -4928,6 +5113,35 @@ nsh>
      + + +
      +
      + + +
      + +

      + TI/SimpleLink CC13x2. + Basic, unverified architectural support for the CC13x2 was added in NuttX-7.28. + Fragmentary support for very similar CC26x2 family is included. + This is a work in progress and, with any luck, a fully verified port will be available in NuttX-7.29. + It is currently code complete (minus some ROM DriverLib hooks) but untested. +

      +

      + TI LaunchXL-CC1312R1. + Basic board support for the TI LaunchXL-CC1312R1 board is in place. + Board bring-up, however, cannot be done until the the basic CC13x2 architecture support is complete, hopefully in NuttX-7.29. +

      +
        +

        + STATUS: + As of this writing, the basic port is nearly code complete but unverified. + Refer to the NuttX board README file for further information. +

        +
      + +
      @@ -5489,6 +5703,12 @@ Mem: 29232 5920 23312 23312

      NuttX-7.27. NuttX-7.27 added LPI2C (from Ivan Ucherdzhiev) and SD card support via USDHC (from Dave Marples).

      +
    • +

      NuttX-7.28. + GPIO Support Input daisy selection was added in NuttX-7.28 by David Sidrane +

      +
      • +

    @@ -6737,13 +6957,16 @@ if [ -x "$WINELOADER" ]; then exec "$WINELOADER" "$appname" "$@"; fi
    • NuttX is a registered trademark of Gregory Nutt.
    • ARM, ARM7 ARM7TDMI, ARM9, ARM920T, ARM926EJS, Cortex-M3 are trademarks of Advanced RISC Machines, Limited.
      • +
    • Beaglebone is a trademark of GHI.
    • Cygwin is a trademark of Red Hat, Incorporated.
    • Linux is a registered trademark of Linus Torvalds.
    • Eagle-100 is a trademark of Micromint USA, LLC.
    • EnergyLite is a trademark of STMicroelectronics.
    • EFM32 is a trademark of Silicon Laboratories, Inc.
    • LPC2148 is a trademark of NXP Semiconductors.
      • +
    • Sitara is a trademark of Texas Instruments Incorporated.
    • TI is a tradename of Texas Instruments Incorporated.
      • +
    • Tiva is a trademark of Texas Instruments Incorporated.
    • UNIX is a registered trademark of The Open Group.
    • VxWorks is a registered trademark of Wind River Systems, Incorporated.
    • ZDS, ZNEO, Z16F, Z80, and Zilog are a registered trademark of Zilog, Inc.
      • diff --git a/ReleaseNotes b/ReleaseNotes index aeb4297a85..163739a5b4 100644 --- a/ReleaseNotes +++ b/ReleaseNotes @@ -20946,9 +20946,8 @@ Additional new features and extended functionality: - Configuration: Simplify ARM core selection logic From Mateusz Szafoni - Configuration: USB Host is an option. From David Sidrane - - STM32 L0: Brings in initial WIP support for the STM23 L0. This - initial commit is unverified and, hence it it marked "EXPERIMENTAL." - From Mateusz Szafoni + - STM32 L0: Brings in initial support for the STM23 L0. From Mateusz + Szafoni * STMicro STM32 Drivers: diff --git a/configs/launchxl-cc1312r1/README.txt b/configs/launchxl-cc1312r1/README.txt index ea927539cc..63d59a9900 100644 --- a/configs/launchxl-cc1312r1/README.txt +++ b/configs/launchxl-cc1312r1/README.txt @@ -1,7 +1,7 @@ README ====== - This directory holds NuttX board support for the TI LAUNCHL-CC1312R1. + This directory holds NuttX board support for the TI LaunchXL-CC1312R1. Contents ========