You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@nuttx.apache.org by GitBox <gi...@apache.org> on 2021/04/25 01:25:10 UTC

[GitHub] [incubator-nuttx] btashton opened a new pull request #3604: docs: Add initial board docs for Tiva arch

btashton opened a new pull request #3604:
URL: https://github.com/apache/incubator-nuttx/pull/3604


   ## Summary
   Initial stab at updating the Tiva arch docs.
   
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [incubator-nuttx] btashton commented on a change in pull request #3604: docs: Add initial board docs for Tiva arch

Posted by GitBox <gi...@apache.org>.
btashton commented on a change in pull request #3604:
URL: https://github.com/apache/incubator-nuttx/pull/3604#discussion_r619842369



##########
File path: Documentation/platforms/arm/tiva/index.rst
##########
@@ -0,0 +1,74 @@
+===================================================
+Texas Instruments Tiva C / Luminary Micro Stellaris
+===================================================
+
+The Tiva architecture is a combination of the Luminary Micro Stellaris chips
+and the TI Tiva variants.  There are both M3 and M4 Arm cores in this family.
+
+Supported MCUs
+=============
+
+The following list includes MCUs from Tiva C series supported in NuttX
+
+=============   ==============  ======= =================
+MCU             Core            Radio    Frequency
+=============   ==============  ======= =================
+LM3S6918        Cortex-M3       No      50 MHz
+LM3S9B92        Cortex-M3       No      50 MHz
+LM3S9B96        Cortex-M3       No      50 MHz
+LM3S6432        Cortex-M3       No      50 MHz
+LM3S6965        Cortex-M3       No      50 MHz
+LM3S8962        Cortex-M3       No      50 MHz
+LM4F120         Cortex-M4       No      80 MHz
+TM4C123AH6PM    Cortex-M4       No      120 MHz
+TM4C123GH6ZRB   Cortex-M4       No      120 MHz
+TM4C123GH6PM    Cortex-M4       No      120 MHz
+TM4C123GH6PZ    Cortex-M4       No      120 MHz
+TM4C123GH6PGE   Cortex-M4       No      120 MHz
+TM4C1294NCPDT   Cortex-M4       No      120 MHz
+TM4C129ENCPDT   Cortex-M4       No      120 MHz
+TM4C129ENCZAD   Cortex-M4       No      120 MHz
+TM4C129XNCZAD   Cortex-M4       No      120 MHz
+CC1310          Cortex-M3       Yes     24 MHz
+CC1312R1        Cortex-M4       Yes     48 MHz
+CC1352R1        Cortex-M4       Yes     48 MHz
+=============   ==============  ======= =================
+
+Peripheral Support
+==================
+
+The following list indicates peripherals supported in NuttX:
+
+==========
+Peripheral
+==========
+GPIO
+ADC
+EEPROM
+FLASH
+HCIUART
+I2C
+MPU
+PWM
+QENCODER
+SERIAL
+SSI
+TIMER
+ETHERNET
+WDT
+I2S
+USB
+==========
+
+GPIO
+-----------

Review comment:
       Place holder, I just don't know what to write since I know very little about this arch.




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [incubator-nuttx] hartmannathan commented on a change in pull request #3604: docs: Add initial board docs for Tiva arch

Posted by GitBox <gi...@apache.org>.
hartmannathan commented on a change in pull request #3604:
URL: https://github.com/apache/incubator-nuttx/pull/3604#discussion_r754571570



##########
File path: Documentation/platforms/arm/tiva/index.rst
##########
@@ -0,0 +1,74 @@
+===================================================
+Texas Instruments Tiva C / Luminary Micro Stellaris
+===================================================
+
+The Tiva architecture is a combination of the Luminary Micro Stellaris chips
+and the TI Tiva variants.  There are both M3 and M4 Arm cores in this family.
+
+Supported MCUs
+=============
+
+The following list includes MCUs from Tiva C series supported in NuttX
+
+=============   ==============  ======= =================
+MCU             Core            Radio    Frequency
+=============   ==============  ======= =================
+LM3S6918        Cortex-M3       No      50 MHz
+LM3S9B92        Cortex-M3       No      50 MHz
+LM3S9B96        Cortex-M3       No      50 MHz
+LM3S6432        Cortex-M3       No      50 MHz
+LM3S6965        Cortex-M3       No      50 MHz
+LM3S8962        Cortex-M3       No      50 MHz
+LM4F120         Cortex-M4       No      80 MHz
+TM4C123AH6PM    Cortex-M4       No      120 MHz
+TM4C123GH6ZRB   Cortex-M4       No      120 MHz
+TM4C123GH6PM    Cortex-M4       No      120 MHz
+TM4C123GH6PZ    Cortex-M4       No      120 MHz
+TM4C123GH6PGE   Cortex-M4       No      120 MHz
+TM4C1294NCPDT   Cortex-M4       No      120 MHz
+TM4C129ENCPDT   Cortex-M4       No      120 MHz
+TM4C129ENCZAD   Cortex-M4       No      120 MHz
+TM4C129XNCZAD   Cortex-M4       No      120 MHz
+CC1310          Cortex-M3       Yes     24 MHz
+CC1312R1        Cortex-M4       Yes     48 MHz
+CC1352R1        Cortex-M4       Yes     48 MHz
+=============   ==============  ======= =================
+
+Peripheral Support
+==================
+
+The following list indicates peripherals supported in NuttX:
+
+==========
+Peripheral
+==========
+GPIO
+ADC
+EEPROM
+FLASH
+HCIUART
+I2C
+MPU
+PWM
+QENCODER
+SERIAL
+SSI
+TIMER
+ETHERNET
+WDT
+I2S
+USB
+==========

Review comment:
       I can update the peripheral support columns later




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@nuttx.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [incubator-nuttx] btashton commented on pull request #3604: docs: Add initial board docs for Tiva arch

Posted by GitBox <gi...@apache.org>.
btashton commented on pull request #3604:
URL: https://github.com/apache/incubator-nuttx/pull/3604#issuecomment-826192021


   @v01d  I would like your thoughts here, the dk-tm4c129x has a lot of great information, but it seems like it is 20% about the board 40% about the architecture and 40% about NuttX.  Seems like we should maybe pull most of this out into its own documentation sections? Especially around the networking and sensor stuff.
   
   https://github.com/apache/incubator-nuttx/blob/73c13318bd535885ea2ce32bc8bbf85ecf09c513/Documentation/platforms/arm/tiva/dk-tm4c129x/index.rst


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [incubator-nuttx] hartmannathan commented on pull request #3604: docs: Add initial board docs for Tiva arch

Posted by GitBox <gi...@apache.org>.
hartmannathan commented on pull request #3604:
URL: https://github.com/apache/incubator-nuttx/pull/3604#issuecomment-975608968


   Hi @btashton @Ouss4  @protobits, are there any objections to merging this PR? (I would like to apply the few suggested changes first.) Thanks!


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@nuttx.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [incubator-nuttx] Ouss4 commented on a change in pull request #3604: docs: Add initial board docs for Tiva arch

Posted by GitBox <gi...@apache.org>.
Ouss4 commented on a change in pull request #3604:
URL: https://github.com/apache/incubator-nuttx/pull/3604#discussion_r619882495



##########
File path: Documentation/platforms/arm/tiva/launchxl-cc1312r1/index.rst
##########
@@ -0,0 +1,138 @@
+====================
+TI LaunchXL-CC1312R1
+====================
+
+SimpleLink Sub-1 GHz CC1312R Wireless Microcontroller (MCU) LaunchPad Development Kit
+
+`LaunchXL-CC1312R1 <https://www.ti.com/tool/LAUNCHXL-CC1312R1>`_
+
+
+Serial Console
+==============
+
+The on-board XDS110 Debugger provide a USB virtual serial console using

Review comment:
       ```suggestion
   The on-board XDS110 Debugger provides a USB virtual serial console using
   ```

##########
File path: Documentation/platforms/arm/tiva/launchxl-cc1310/index.rst
##########
@@ -0,0 +1,94 @@
+====================
+TI LaunchXL-CC1310
+====================
+
+SimpleLink Sub-1 GHz CC1310 wireless MCU LaunchPad development kit
+
+`TI LaunchXL-CC1310 <https://www.ti.com/tool/LAUNCHXL-CC1310>`_
+
+
+Serial Console
+==============
+
+The on-board XDS110 Debugger provide a USB virtual serial console using

Review comment:
       ```suggestion
   The on-board XDS110 Debugger provides a USB virtual serial console using
   ```

##########
File path: Documentation/platforms/arm/tiva/launchxl-cc1312r1/index.rst
##########
@@ -0,0 +1,138 @@
+====================
+TI LaunchXL-CC1312R1
+====================
+
+SimpleLink Sub-1 GHz CC1312R Wireless Microcontroller (MCU) LaunchPad Development Kit
+
+`LaunchXL-CC1312R1 <https://www.ti.com/tool/LAUNCHXL-CC1312R1>`_
+
+
+Serial Console
+==============
+
+The on-board XDS110 Debugger provide a USB virtual serial console using
+UART0 (DIO2_RXD and DIO3_TXD).
+
+A J-Link debugger is used (see below), then the RXD/TXD jumper pins can
+be used to support a serial console through these same pins via an
+appropriate TTL level adapter (RS-232 or USB serial).
+
+LEDs and Buttons
+================
+
+LEDs
+----
+
+The LaunchXL-cc1312R1 has two LEDs controlled by software:  DIO7_GLED (CR1)
+and DIO6_RLED (CR2).  A high output value illuminates an LED.
+
+=========  ==== ========================
+DIO7_GLED  CR1  High output illuminates
+DIO6_RLED  CR2  High output illuminates
+=========  ==== ========================
+
+If CONFIG_ARCH_LEDS is not defined, then the user can control the LEDs in
+any way.  The definitions provided in the board.h header file can be used
+to access individual LEDs.
+
+These 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/cc1312_autoleds.c. The LEDs are used to encode
+OS-related events as follows:
+
+================== ======================== ====== ======
+SYMBOL              Meaning                 G-LED   R-LED
+================== ======================== ====== ======
+LED_STARTED        NuttX has been started   OFF    OFF
+LED_HEAPALLOCATE   Heap has been allocated  OFF    ON
+LED_IRQSENABLED    Interrupts enabled       OFF    ON
+LED_STACKCREATED   Idle stack created       ON     OFF
+LED_INIRQ          In an interrupt          N/C    GLOW
+LED_SIGNAL         In a signal handler      N/C    GLOW
+LED_ASSERTION      An assertion failed      N/C    GLOW
+LED_PANIC          The system has crashed   OFF    Blinking
+LED_IDLE           MCU is is sleep mode     N/A    N/A
+================== ======================== ====== ======
+
+Thus if GLED is statically on, NuttX has successfully booted and is,
+apparently, running normally.  A soft glow of the RLED means that the
+board is taking interrupts.   If GLED is off and GLED is flashing at
+approximately 2Hz, then a fatal error has been detected and the system
+has halted.
+
+Buttons
+-------
+
+The LaunchXL-CC1312R1 has two push-puttons:
+
+=========== ==== ===============================
+DIO13_BTN1  SW1  Low input sensed when depressed
+DIO14_BTN2  SW2  Low input sensed when depressed
+=========== ==== ===============================
+
+Version 1 or 2?
+===============
+
+Two versions of the CC1312R1 are supported selected by CONFIG_ARCH_CHIP_CC13XX_V1
+or CONFIG_ARCH_CHIP_CC13XX_V2.  It is not clear how to identify the chip version
+from markings on it.
+
+What you can do is enable CONFIG_DEBUG_ASSERTIONS.  The firmware can
+determine which version you have by looking at register contents.  The
+firmware will assert if you select the wrong version.  If that occurs,
+switch to the other version and the assertion should go away.
+
+Running from SRAM
+=================
+
+The LaunchXL-CC1312R1 port supports execution from RAM.  Execution from
+SRAM as a "safe" way to bring up a new board port without concern about
+borking the board because of a bad FLASH image.

Review comment:
       ```suggestion
   breaking the board because of a bad FLASH image.
   ```
   ```suggestion
   bricking the board because of a bad FLASH image.
   ```
   ?




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [incubator-nuttx] btashton commented on a change in pull request #3604: docs: Add initial board docs for Tiva arch

Posted by GitBox <gi...@apache.org>.
btashton commented on a change in pull request #3604:
URL: https://github.com/apache/incubator-nuttx/pull/3604#discussion_r619842279



##########
File path: Documentation/platforms/arm/tiva/index.rst
##########
@@ -0,0 +1,74 @@
+===================================================
+Texas Instruments Tiva C / Luminary Micro Stellaris
+===================================================
+
+The Tiva architecture is a combination of the Luminary Micro Stellaris chips
+and the TI Tiva variants.  There are both M3 and M4 Arm cores in this family.
+
+Supported MCUs
+=============
+
+The following list includes MCUs from Tiva C series supported in NuttX
+
+=============   ==============  ======= =================
+MCU             Core            Radio    Frequency
+=============   ==============  ======= =================
+LM3S6918        Cortex-M3       No      50 MHz
+LM3S9B92        Cortex-M3       No      50 MHz
+LM3S9B96        Cortex-M3       No      50 MHz
+LM3S6432        Cortex-M3       No      50 MHz
+LM3S6965        Cortex-M3       No      50 MHz
+LM3S8962        Cortex-M3       No      50 MHz
+LM4F120         Cortex-M4       No      80 MHz
+TM4C123AH6PM    Cortex-M4       No      120 MHz
+TM4C123GH6ZRB   Cortex-M4       No      120 MHz
+TM4C123GH6PM    Cortex-M4       No      120 MHz
+TM4C123GH6PZ    Cortex-M4       No      120 MHz
+TM4C123GH6PGE   Cortex-M4       No      120 MHz
+TM4C1294NCPDT   Cortex-M4       No      120 MHz
+TM4C129ENCPDT   Cortex-M4       No      120 MHz
+TM4C129ENCZAD   Cortex-M4       No      120 MHz
+TM4C129XNCZAD   Cortex-M4       No      120 MHz
+CC1310          Cortex-M3       Yes     24 MHz
+CC1312R1        Cortex-M4       Yes     48 MHz
+CC1352R1        Cortex-M4       Yes     48 MHz
+=============   ==============  ======= =================
+
+Peripheral Support
+==================
+
+The following list indicates peripherals supported in NuttX:
+
+==========
+Peripheral
+==========
+GPIO
+ADC
+EEPROM
+FLASH
+HCIUART
+I2C
+MPU
+PWM
+QENCODER
+SERIAL
+SSI
+TIMER
+ETHERNET
+WDT
+I2S
+USB
+==========

Review comment:
       I have no idea really what all is all supported. I think we need to make some progress getting all of these moved over though because right now it looks like 5 boards or so are supported total.

##########
File path: Documentation/platforms/arm/tiva/index.rst
##########
@@ -0,0 +1,74 @@
+===================================================
+Texas Instruments Tiva C / Luminary Micro Stellaris
+===================================================
+
+The Tiva architecture is a combination of the Luminary Micro Stellaris chips
+and the TI Tiva variants.  There are both M3 and M4 Arm cores in this family.
+
+Supported MCUs
+=============
+
+The following list includes MCUs from Tiva C series supported in NuttX
+
+=============   ==============  ======= =================
+MCU             Core            Radio    Frequency
+=============   ==============  ======= =================
+LM3S6918        Cortex-M3       No      50 MHz
+LM3S9B92        Cortex-M3       No      50 MHz
+LM3S9B96        Cortex-M3       No      50 MHz
+LM3S6432        Cortex-M3       No      50 MHz
+LM3S6965        Cortex-M3       No      50 MHz
+LM3S8962        Cortex-M3       No      50 MHz
+LM4F120         Cortex-M4       No      80 MHz
+TM4C123AH6PM    Cortex-M4       No      120 MHz
+TM4C123GH6ZRB   Cortex-M4       No      120 MHz
+TM4C123GH6PM    Cortex-M4       No      120 MHz
+TM4C123GH6PZ    Cortex-M4       No      120 MHz
+TM4C123GH6PGE   Cortex-M4       No      120 MHz
+TM4C1294NCPDT   Cortex-M4       No      120 MHz
+TM4C129ENCPDT   Cortex-M4       No      120 MHz
+TM4C129ENCZAD   Cortex-M4       No      120 MHz
+TM4C129XNCZAD   Cortex-M4       No      120 MHz
+CC1310          Cortex-M3       Yes     24 MHz
+CC1312R1        Cortex-M4       Yes     48 MHz
+CC1352R1        Cortex-M4       Yes     48 MHz
+=============   ==============  ======= =================
+
+Peripheral Support
+==================
+
+The following list indicates peripherals supported in NuttX:
+
+==========
+Peripheral
+==========
+GPIO
+ADC
+EEPROM
+FLASH
+HCIUART
+I2C
+MPU
+PWM
+QENCODER
+SERIAL
+SSI
+TIMER
+ETHERNET
+WDT
+I2S
+USB
+==========
+
+GPIO
+-----------

Review comment:
       Place holder, I just don't know what to write since I know very little about this arch.




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [incubator-nuttx] v01d commented on a change in pull request #3604: docs: Add initial board docs for Tiva arch

Posted by GitBox <gi...@apache.org>.
v01d commented on a change in pull request #3604:
URL: https://github.com/apache/incubator-nuttx/pull/3604#discussion_r619826394



##########
File path: Documentation/platforms/arm/tiva/index.rst
##########
@@ -0,0 +1,74 @@
+===================================================
+Texas Instruments Tiva C / Luminary Micro Stellaris
+===================================================
+
+The Tiva architecture is a combination of the Luminary Micro Stellaris chips
+and the TI Tiva variants.  There are both M3 and M4 Arm cores in this family.
+
+Supported MCUs
+=============
+
+The following list includes MCUs from Tiva C series supported in NuttX
+
+=============   ==============  ======= =================
+MCU             Core            Radio    Frequency
+=============   ==============  ======= =================
+LM3S6918        Cortex-M3       No      50 MHz
+LM3S9B92        Cortex-M3       No      50 MHz
+LM3S9B96        Cortex-M3       No      50 MHz
+LM3S6432        Cortex-M3       No      50 MHz
+LM3S6965        Cortex-M3       No      50 MHz
+LM3S8962        Cortex-M3       No      50 MHz
+LM4F120         Cortex-M4       No      80 MHz
+TM4C123AH6PM    Cortex-M4       No      120 MHz
+TM4C123GH6ZRB   Cortex-M4       No      120 MHz
+TM4C123GH6PM    Cortex-M4       No      120 MHz
+TM4C123GH6PZ    Cortex-M4       No      120 MHz
+TM4C123GH6PGE   Cortex-M4       No      120 MHz
+TM4C1294NCPDT   Cortex-M4       No      120 MHz
+TM4C129ENCPDT   Cortex-M4       No      120 MHz
+TM4C129ENCZAD   Cortex-M4       No      120 MHz
+TM4C129XNCZAD   Cortex-M4       No      120 MHz
+CC1310          Cortex-M3       Yes     24 MHz
+CC1312R1        Cortex-M4       Yes     48 MHz
+CC1352R1        Cortex-M4       Yes     48 MHz
+=============   ==============  ======= =================
+
+Peripheral Support
+==================
+
+The following list indicates peripherals supported in NuttX:
+
+==========
+Peripheral
+==========
+GPIO
+ADC
+EEPROM
+FLASH
+HCIUART
+I2C
+MPU
+PWM
+QENCODER
+SERIAL
+SSI
+TIMER
+ETHERNET
+WDT
+I2S
+USB
+==========

Review comment:
       For other platforms this is a table with two more columns indicating support and any notes. It is better if we maintain format across documents, even if in this case everything is supported.

##########
File path: Documentation/platforms/arm/tiva/launchxl-cc1310/index.rst
##########
@@ -0,0 +1,94 @@
+====================
+TI LaunchXL-CC1310
+====================
+
+SimpleLink Sub-1 GHz CC1310 wireless MCU LaunchPad development kit
+
+`TI LaunchXL-CC1310 <https://www.ti.com/tool/LAUNCHXL-CC1310>`_
+
+
+Serial Console
+==============
+
+The on-board XDS110 Debugger provide a USB virtual serial console using
+UART0 (PA0/U0RX and PA1/U0TX).
+
+A J-Link debugger is used (see below), then the RXD/TXD jumper pins can
+be used to support a serial console through appropriate TTL level adapter
+(RS-232 or USB serial).
+
+LEDs and Buttons
+================
+
+LEDs
+----
+
+The LaunchXL-cc1312R1 has two LEDs controlled by software:  DIO7_GLED (CR1)
+and DIO6_RLED (CR2).  A high output value illuminates an LED.
+
+=========  ==== ========================
+DIO7_GLED  CR1  High output illuminates
+DIO6_RLED  CR2  High output illuminates
+=========  ==== ========================
+
+If CONFIG_ARCH_LEDS is not defined, then the user can control the LEDs in
+any way.  The definitions provided in the board.h header file can be used
+to access individual LEDs.
+
+These 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/cc1310_autoleds.c. The LEDs are used to encode
+OS-related events as follows:
+
+================== ======================== ====== ======
+SYMBOL              Meaning                 G-LED   R-LED
+================== ======================== ====== ======
+LED_STARTED        NuttX has been started   OFF    OFF
+LED_HEAPALLOCATE   Heap has been allocated  OFF    ON
+LED_IRQSENABLED    Interrupts enabled       OFF    ON
+LED_STACKCREATED   Idle stack created       ON     OFF
+LED_INIRQ          In an interrupt          N/C    GLOW
+LED_SIGNAL         In a signal handler      N/C    GLOW
+LED_ASSERTION      An assertion failed      N/C    GLOW
+LED_PANIC          The system has crashed   OFF    Blinking
+LED_IDLE           MCU is is sleep mode     N/A    N/A
+================== ======================== ====== ======
+
+Thus if GLED is statically on, NuttX has successfully booted and is,
+apparently, running normally.  A soft glow of the RLED means that the
+board is taking interrupts.   If GLED is off and GLED is flashing at
+approximately 2Hz, then a fatal error has been detected and the system
+has halted.
+
+Buttons
+-------
+
+The LaunchXL-CC1310 has two push-puttons:
+
+=========== ==== ===============================
+DIO13_BTN1  SW1  Low input sensed when depressed
+DIO14_BTN2  SW2  Low input sensed when depressed
+=========== ==== ===============================

Review comment:
       same as above

##########
File path: Documentation/platforms/arm/tiva/launchxl-cc1310/index.rst
##########
@@ -0,0 +1,94 @@
+====================
+TI LaunchXL-CC1310
+====================
+
+SimpleLink Sub-1 GHz CC1310 wireless MCU LaunchPad development kit
+
+`TI LaunchXL-CC1310 <https://www.ti.com/tool/LAUNCHXL-CC1310>`_
+
+
+Serial Console
+==============
+
+The on-board XDS110 Debugger provide a USB virtual serial console using
+UART0 (PA0/U0RX and PA1/U0TX).
+
+A J-Link debugger is used (see below), then the RXD/TXD jumper pins can
+be used to support a serial console through appropriate TTL level adapter
+(RS-232 or USB serial).
+
+LEDs and Buttons
+================
+
+LEDs
+----
+
+The LaunchXL-cc1312R1 has two LEDs controlled by software:  DIO7_GLED (CR1)
+and DIO6_RLED (CR2).  A high output value illuminates an LED.
+
+=========  ==== ========================
+DIO7_GLED  CR1  High output illuminates
+DIO6_RLED  CR2  High output illuminates
+=========  ==== ========================

Review comment:
       Add a header to indicate what the columns are?

##########
File path: Documentation/platforms/arm/tiva/index.rst
##########
@@ -0,0 +1,74 @@
+===================================================
+Texas Instruments Tiva C / Luminary Micro Stellaris
+===================================================
+
+The Tiva architecture is a combination of the Luminary Micro Stellaris chips
+and the TI Tiva variants.  There are both M3 and M4 Arm cores in this family.
+
+Supported MCUs
+=============

Review comment:
       ```suggestion
   ==============
   ```

##########
File path: Documentation/platforms/arm/tiva/launchxl-cc1310/index.rst
##########
@@ -0,0 +1,94 @@
+====================
+TI LaunchXL-CC1310
+====================
+
+SimpleLink Sub-1 GHz CC1310 wireless MCU LaunchPad development kit
+
+`TI LaunchXL-CC1310 <https://www.ti.com/tool/LAUNCHXL-CC1310>`_

Review comment:
       Integrate link in previous line. If you have a board picture, it would be good to add.

##########
File path: Documentation/platforms/arm/tiva/index.rst
##########
@@ -0,0 +1,74 @@
+===================================================
+Texas Instruments Tiva C / Luminary Micro Stellaris
+===================================================
+
+The Tiva architecture is a combination of the Luminary Micro Stellaris chips
+and the TI Tiva variants.  There are both M3 and M4 Arm cores in this family.
+
+Supported MCUs
+=============
+
+The following list includes MCUs from Tiva C series supported in NuttX
+
+=============   ==============  ======= =================
+MCU             Core            Radio    Frequency
+=============   ==============  ======= =================
+LM3S6918        Cortex-M3       No      50 MHz
+LM3S9B92        Cortex-M3       No      50 MHz
+LM3S9B96        Cortex-M3       No      50 MHz
+LM3S6432        Cortex-M3       No      50 MHz
+LM3S6965        Cortex-M3       No      50 MHz
+LM3S8962        Cortex-M3       No      50 MHz
+LM4F120         Cortex-M4       No      80 MHz
+TM4C123AH6PM    Cortex-M4       No      120 MHz
+TM4C123GH6ZRB   Cortex-M4       No      120 MHz
+TM4C123GH6PM    Cortex-M4       No      120 MHz
+TM4C123GH6PZ    Cortex-M4       No      120 MHz
+TM4C123GH6PGE   Cortex-M4       No      120 MHz
+TM4C1294NCPDT   Cortex-M4       No      120 MHz
+TM4C129ENCPDT   Cortex-M4       No      120 MHz
+TM4C129ENCZAD   Cortex-M4       No      120 MHz
+TM4C129XNCZAD   Cortex-M4       No      120 MHz
+CC1310          Cortex-M3       Yes     24 MHz
+CC1312R1        Cortex-M4       Yes     48 MHz
+CC1352R1        Cortex-M4       Yes     48 MHz
+=============   ==============  ======= =================
+
+Peripheral Support
+==================
+
+The following list indicates peripherals supported in NuttX:
+
+==========
+Peripheral
+==========
+GPIO
+ADC
+EEPROM
+FLASH
+HCIUART
+I2C
+MPU
+PWM
+QENCODER
+SERIAL
+SSI
+TIMER
+ETHERNET
+WDT
+I2S
+USB
+==========
+
+GPIO
+-----------

Review comment:
       ?

##########
File path: Documentation/platforms/arm/tiva/launchxl-cc1310/index.rst
##########
@@ -0,0 +1,94 @@
+====================
+TI LaunchXL-CC1310
+====================
+
+SimpleLink Sub-1 GHz CC1310 wireless MCU LaunchPad development kit
+
+`TI LaunchXL-CC1310 <https://www.ti.com/tool/LAUNCHXL-CC1310>`_
+
+
+Serial Console
+==============
+
+The on-board XDS110 Debugger provide a USB virtual serial console using
+UART0 (PA0/U0RX and PA1/U0TX).
+
+A J-Link debugger is used (see below), then the RXD/TXD jumper pins can
+be used to support a serial console through appropriate TTL level adapter
+(RS-232 or USB serial).
+
+LEDs and Buttons
+================
+
+LEDs
+----
+
+The LaunchXL-cc1312R1 has two LEDs controlled by software:  DIO7_GLED (CR1)
+and DIO6_RLED (CR2).  A high output value illuminates an LED.
+
+=========  ==== ========================
+DIO7_GLED  CR1  High output illuminates
+DIO6_RLED  CR2  High output illuminates
+=========  ==== ========================
+
+If CONFIG_ARCH_LEDS is not defined, then the user can control the LEDs in

Review comment:
       use backticks for config terms and filenames.




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [incubator-nuttx] btashton commented on pull request #3604: docs: Add initial board docs for Tiva arch

Posted by GitBox <gi...@apache.org>.
btashton commented on pull request #3604:
URL: https://github.com/apache/incubator-nuttx/pull/3604#issuecomment-826192021


   @v01d  I would like your thoughts here, the dk-tm4c129x has a lot of great information, but it seems like it is 20% about the board 40% about the architecture and 40% about NuttX.  Seems like we should maybe pull most of this out into its own documentation sections? Especially around the networking and sensor stuff.
   
   https://github.com/apache/incubator-nuttx/blob/73c13318bd535885ea2ce32bc8bbf85ecf09c513/Documentation/platforms/arm/tiva/dk-tm4c129x/index.rst


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [incubator-nuttx] Ouss4 commented on pull request #3604: docs: Add initial board docs for Tiva arch

Posted by GitBox <gi...@apache.org>.
Ouss4 commented on pull request #3604:
URL: https://github.com/apache/incubator-nuttx/pull/3604#issuecomment-975617915


   @hartmannathan fine by me.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@nuttx.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [incubator-nuttx] v01d commented on a change in pull request #3604: docs: Add initial board docs for Tiva arch

Posted by GitBox <gi...@apache.org>.
v01d commented on a change in pull request #3604:
URL: https://github.com/apache/incubator-nuttx/pull/3604#discussion_r619826394



##########
File path: Documentation/platforms/arm/tiva/index.rst
##########
@@ -0,0 +1,74 @@
+===================================================
+Texas Instruments Tiva C / Luminary Micro Stellaris
+===================================================
+
+The Tiva architecture is a combination of the Luminary Micro Stellaris chips
+and the TI Tiva variants.  There are both M3 and M4 Arm cores in this family.
+
+Supported MCUs
+=============
+
+The following list includes MCUs from Tiva C series supported in NuttX
+
+=============   ==============  ======= =================
+MCU             Core            Radio    Frequency
+=============   ==============  ======= =================
+LM3S6918        Cortex-M3       No      50 MHz
+LM3S9B92        Cortex-M3       No      50 MHz
+LM3S9B96        Cortex-M3       No      50 MHz
+LM3S6432        Cortex-M3       No      50 MHz
+LM3S6965        Cortex-M3       No      50 MHz
+LM3S8962        Cortex-M3       No      50 MHz
+LM4F120         Cortex-M4       No      80 MHz
+TM4C123AH6PM    Cortex-M4       No      120 MHz
+TM4C123GH6ZRB   Cortex-M4       No      120 MHz
+TM4C123GH6PM    Cortex-M4       No      120 MHz
+TM4C123GH6PZ    Cortex-M4       No      120 MHz
+TM4C123GH6PGE   Cortex-M4       No      120 MHz
+TM4C1294NCPDT   Cortex-M4       No      120 MHz
+TM4C129ENCPDT   Cortex-M4       No      120 MHz
+TM4C129ENCZAD   Cortex-M4       No      120 MHz
+TM4C129XNCZAD   Cortex-M4       No      120 MHz
+CC1310          Cortex-M3       Yes     24 MHz
+CC1312R1        Cortex-M4       Yes     48 MHz
+CC1352R1        Cortex-M4       Yes     48 MHz
+=============   ==============  ======= =================
+
+Peripheral Support
+==================
+
+The following list indicates peripherals supported in NuttX:
+
+==========
+Peripheral
+==========
+GPIO
+ADC
+EEPROM
+FLASH
+HCIUART
+I2C
+MPU
+PWM
+QENCODER
+SERIAL
+SSI
+TIMER
+ETHERNET
+WDT
+I2S
+USB
+==========

Review comment:
       For other platforms this is a table with two more columns indicating support and any notes. It is better if we maintain format across documents, even if in this case everything is supported.

##########
File path: Documentation/platforms/arm/tiva/launchxl-cc1310/index.rst
##########
@@ -0,0 +1,94 @@
+====================
+TI LaunchXL-CC1310
+====================
+
+SimpleLink Sub-1 GHz CC1310 wireless MCU LaunchPad development kit
+
+`TI LaunchXL-CC1310 <https://www.ti.com/tool/LAUNCHXL-CC1310>`_
+
+
+Serial Console
+==============
+
+The on-board XDS110 Debugger provide a USB virtual serial console using
+UART0 (PA0/U0RX and PA1/U0TX).
+
+A J-Link debugger is used (see below), then the RXD/TXD jumper pins can
+be used to support a serial console through appropriate TTL level adapter
+(RS-232 or USB serial).
+
+LEDs and Buttons
+================
+
+LEDs
+----
+
+The LaunchXL-cc1312R1 has two LEDs controlled by software:  DIO7_GLED (CR1)
+and DIO6_RLED (CR2).  A high output value illuminates an LED.
+
+=========  ==== ========================
+DIO7_GLED  CR1  High output illuminates
+DIO6_RLED  CR2  High output illuminates
+=========  ==== ========================
+
+If CONFIG_ARCH_LEDS is not defined, then the user can control the LEDs in
+any way.  The definitions provided in the board.h header file can be used
+to access individual LEDs.
+
+These 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/cc1310_autoleds.c. The LEDs are used to encode
+OS-related events as follows:
+
+================== ======================== ====== ======
+SYMBOL              Meaning                 G-LED   R-LED
+================== ======================== ====== ======
+LED_STARTED        NuttX has been started   OFF    OFF
+LED_HEAPALLOCATE   Heap has been allocated  OFF    ON
+LED_IRQSENABLED    Interrupts enabled       OFF    ON
+LED_STACKCREATED   Idle stack created       ON     OFF
+LED_INIRQ          In an interrupt          N/C    GLOW
+LED_SIGNAL         In a signal handler      N/C    GLOW
+LED_ASSERTION      An assertion failed      N/C    GLOW
+LED_PANIC          The system has crashed   OFF    Blinking
+LED_IDLE           MCU is is sleep mode     N/A    N/A
+================== ======================== ====== ======
+
+Thus if GLED is statically on, NuttX has successfully booted and is,
+apparently, running normally.  A soft glow of the RLED means that the
+board is taking interrupts.   If GLED is off and GLED is flashing at
+approximately 2Hz, then a fatal error has been detected and the system
+has halted.
+
+Buttons
+-------
+
+The LaunchXL-CC1310 has two push-puttons:
+
+=========== ==== ===============================
+DIO13_BTN1  SW1  Low input sensed when depressed
+DIO14_BTN2  SW2  Low input sensed when depressed
+=========== ==== ===============================

Review comment:
       same as above

##########
File path: Documentation/platforms/arm/tiva/launchxl-cc1310/index.rst
##########
@@ -0,0 +1,94 @@
+====================
+TI LaunchXL-CC1310
+====================
+
+SimpleLink Sub-1 GHz CC1310 wireless MCU LaunchPad development kit
+
+`TI LaunchXL-CC1310 <https://www.ti.com/tool/LAUNCHXL-CC1310>`_
+
+
+Serial Console
+==============
+
+The on-board XDS110 Debugger provide a USB virtual serial console using
+UART0 (PA0/U0RX and PA1/U0TX).
+
+A J-Link debugger is used (see below), then the RXD/TXD jumper pins can
+be used to support a serial console through appropriate TTL level adapter
+(RS-232 or USB serial).
+
+LEDs and Buttons
+================
+
+LEDs
+----
+
+The LaunchXL-cc1312R1 has two LEDs controlled by software:  DIO7_GLED (CR1)
+and DIO6_RLED (CR2).  A high output value illuminates an LED.
+
+=========  ==== ========================
+DIO7_GLED  CR1  High output illuminates
+DIO6_RLED  CR2  High output illuminates
+=========  ==== ========================

Review comment:
       Add a header to indicate what the columns are?

##########
File path: Documentation/platforms/arm/tiva/index.rst
##########
@@ -0,0 +1,74 @@
+===================================================
+Texas Instruments Tiva C / Luminary Micro Stellaris
+===================================================
+
+The Tiva architecture is a combination of the Luminary Micro Stellaris chips
+and the TI Tiva variants.  There are both M3 and M4 Arm cores in this family.
+
+Supported MCUs
+=============

Review comment:
       ```suggestion
   ==============
   ```

##########
File path: Documentation/platforms/arm/tiva/launchxl-cc1310/index.rst
##########
@@ -0,0 +1,94 @@
+====================
+TI LaunchXL-CC1310
+====================
+
+SimpleLink Sub-1 GHz CC1310 wireless MCU LaunchPad development kit
+
+`TI LaunchXL-CC1310 <https://www.ti.com/tool/LAUNCHXL-CC1310>`_

Review comment:
       Integrate link in previous line. If you have a board picture, it would be good to add.

##########
File path: Documentation/platforms/arm/tiva/index.rst
##########
@@ -0,0 +1,74 @@
+===================================================
+Texas Instruments Tiva C / Luminary Micro Stellaris
+===================================================
+
+The Tiva architecture is a combination of the Luminary Micro Stellaris chips
+and the TI Tiva variants.  There are both M3 and M4 Arm cores in this family.
+
+Supported MCUs
+=============
+
+The following list includes MCUs from Tiva C series supported in NuttX
+
+=============   ==============  ======= =================
+MCU             Core            Radio    Frequency
+=============   ==============  ======= =================
+LM3S6918        Cortex-M3       No      50 MHz
+LM3S9B92        Cortex-M3       No      50 MHz
+LM3S9B96        Cortex-M3       No      50 MHz
+LM3S6432        Cortex-M3       No      50 MHz
+LM3S6965        Cortex-M3       No      50 MHz
+LM3S8962        Cortex-M3       No      50 MHz
+LM4F120         Cortex-M4       No      80 MHz
+TM4C123AH6PM    Cortex-M4       No      120 MHz
+TM4C123GH6ZRB   Cortex-M4       No      120 MHz
+TM4C123GH6PM    Cortex-M4       No      120 MHz
+TM4C123GH6PZ    Cortex-M4       No      120 MHz
+TM4C123GH6PGE   Cortex-M4       No      120 MHz
+TM4C1294NCPDT   Cortex-M4       No      120 MHz
+TM4C129ENCPDT   Cortex-M4       No      120 MHz
+TM4C129ENCZAD   Cortex-M4       No      120 MHz
+TM4C129XNCZAD   Cortex-M4       No      120 MHz
+CC1310          Cortex-M3       Yes     24 MHz
+CC1312R1        Cortex-M4       Yes     48 MHz
+CC1352R1        Cortex-M4       Yes     48 MHz
+=============   ==============  ======= =================
+
+Peripheral Support
+==================
+
+The following list indicates peripherals supported in NuttX:
+
+==========
+Peripheral
+==========
+GPIO
+ADC
+EEPROM
+FLASH
+HCIUART
+I2C
+MPU
+PWM
+QENCODER
+SERIAL
+SSI
+TIMER
+ETHERNET
+WDT
+I2S
+USB
+==========
+
+GPIO
+-----------

Review comment:
       ?

##########
File path: Documentation/platforms/arm/tiva/launchxl-cc1310/index.rst
##########
@@ -0,0 +1,94 @@
+====================
+TI LaunchXL-CC1310
+====================
+
+SimpleLink Sub-1 GHz CC1310 wireless MCU LaunchPad development kit
+
+`TI LaunchXL-CC1310 <https://www.ti.com/tool/LAUNCHXL-CC1310>`_
+
+
+Serial Console
+==============
+
+The on-board XDS110 Debugger provide a USB virtual serial console using
+UART0 (PA0/U0RX and PA1/U0TX).
+
+A J-Link debugger is used (see below), then the RXD/TXD jumper pins can
+be used to support a serial console through appropriate TTL level adapter
+(RS-232 or USB serial).
+
+LEDs and Buttons
+================
+
+LEDs
+----
+
+The LaunchXL-cc1312R1 has two LEDs controlled by software:  DIO7_GLED (CR1)
+and DIO6_RLED (CR2).  A high output value illuminates an LED.
+
+=========  ==== ========================
+DIO7_GLED  CR1  High output illuminates
+DIO6_RLED  CR2  High output illuminates
+=========  ==== ========================
+
+If CONFIG_ARCH_LEDS is not defined, then the user can control the LEDs in

Review comment:
       use backticks for config terms and filenames.




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [incubator-nuttx] v01d commented on pull request #3604: docs: Add initial board docs for Tiva arch

Posted by GitBox <gi...@apache.org>.
v01d commented on pull request #3604:
URL: https://github.com/apache/incubator-nuttx/pull/3604#issuecomment-826336345


   > @v01d I would like your thoughts here, the dk-tm4c129x has a lot of great information, but it seems like it is 20% about the board 40% about the architecture and 40% about NuttX. Seems like we should maybe pull most of this out into its own documentation sections? Especially around the networking and sensor stuff.
   > 
   > https://github.com/apache/incubator-nuttx/blob/73c13318bd535885ea2ce32bc8bbf85ecf09c513/Documentation/platforms/arm/tiva/dk-tm4c129x/index.rst
   
   Yes, I would split it as you suggest. Feel free to redistribute the content as you see fit (you can see other boards/soc docs to see what kind of content is placed in each case).


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [incubator-nuttx] v01d commented on pull request #3604: docs: Add initial board docs for Tiva arch

Posted by GitBox <gi...@apache.org>.
v01d commented on pull request #3604:
URL: https://github.com/apache/incubator-nuttx/pull/3604#issuecomment-826336345


   > @v01d I would like your thoughts here, the dk-tm4c129x has a lot of great information, but it seems like it is 20% about the board 40% about the architecture and 40% about NuttX. Seems like we should maybe pull most of this out into its own documentation sections? Especially around the networking and sensor stuff.
   > 
   > https://github.com/apache/incubator-nuttx/blob/73c13318bd535885ea2ce32bc8bbf85ecf09c513/Documentation/platforms/arm/tiva/dk-tm4c129x/index.rst
   
   Yes, I would split it as you suggest. Feel free to redistribute the content as you see fit (you can see other boards/soc docs to see what kind of content is placed in each case).


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [incubator-nuttx] Ouss4 commented on a change in pull request #3604: docs: Add initial board docs for Tiva arch

Posted by GitBox <gi...@apache.org>.
Ouss4 commented on a change in pull request #3604:
URL: https://github.com/apache/incubator-nuttx/pull/3604#discussion_r619882495



##########
File path: Documentation/platforms/arm/tiva/launchxl-cc1312r1/index.rst
##########
@@ -0,0 +1,138 @@
+====================
+TI LaunchXL-CC1312R1
+====================
+
+SimpleLink Sub-1 GHz CC1312R Wireless Microcontroller (MCU) LaunchPad Development Kit
+
+`LaunchXL-CC1312R1 <https://www.ti.com/tool/LAUNCHXL-CC1312R1>`_
+
+
+Serial Console
+==============
+
+The on-board XDS110 Debugger provide a USB virtual serial console using

Review comment:
       ```suggestion
   The on-board XDS110 Debugger provides a USB virtual serial console using
   ```

##########
File path: Documentation/platforms/arm/tiva/launchxl-cc1310/index.rst
##########
@@ -0,0 +1,94 @@
+====================
+TI LaunchXL-CC1310
+====================
+
+SimpleLink Sub-1 GHz CC1310 wireless MCU LaunchPad development kit
+
+`TI LaunchXL-CC1310 <https://www.ti.com/tool/LAUNCHXL-CC1310>`_
+
+
+Serial Console
+==============
+
+The on-board XDS110 Debugger provide a USB virtual serial console using

Review comment:
       ```suggestion
   The on-board XDS110 Debugger provides a USB virtual serial console using
   ```

##########
File path: Documentation/platforms/arm/tiva/launchxl-cc1312r1/index.rst
##########
@@ -0,0 +1,138 @@
+====================
+TI LaunchXL-CC1312R1
+====================
+
+SimpleLink Sub-1 GHz CC1312R Wireless Microcontroller (MCU) LaunchPad Development Kit
+
+`LaunchXL-CC1312R1 <https://www.ti.com/tool/LAUNCHXL-CC1312R1>`_
+
+
+Serial Console
+==============
+
+The on-board XDS110 Debugger provide a USB virtual serial console using
+UART0 (DIO2_RXD and DIO3_TXD).
+
+A J-Link debugger is used (see below), then the RXD/TXD jumper pins can
+be used to support a serial console through these same pins via an
+appropriate TTL level adapter (RS-232 or USB serial).
+
+LEDs and Buttons
+================
+
+LEDs
+----
+
+The LaunchXL-cc1312R1 has two LEDs controlled by software:  DIO7_GLED (CR1)
+and DIO6_RLED (CR2).  A high output value illuminates an LED.
+
+=========  ==== ========================
+DIO7_GLED  CR1  High output illuminates
+DIO6_RLED  CR2  High output illuminates
+=========  ==== ========================
+
+If CONFIG_ARCH_LEDS is not defined, then the user can control the LEDs in
+any way.  The definitions provided in the board.h header file can be used
+to access individual LEDs.
+
+These 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/cc1312_autoleds.c. The LEDs are used to encode
+OS-related events as follows:
+
+================== ======================== ====== ======
+SYMBOL              Meaning                 G-LED   R-LED
+================== ======================== ====== ======
+LED_STARTED        NuttX has been started   OFF    OFF
+LED_HEAPALLOCATE   Heap has been allocated  OFF    ON
+LED_IRQSENABLED    Interrupts enabled       OFF    ON
+LED_STACKCREATED   Idle stack created       ON     OFF
+LED_INIRQ          In an interrupt          N/C    GLOW
+LED_SIGNAL         In a signal handler      N/C    GLOW
+LED_ASSERTION      An assertion failed      N/C    GLOW
+LED_PANIC          The system has crashed   OFF    Blinking
+LED_IDLE           MCU is is sleep mode     N/A    N/A
+================== ======================== ====== ======
+
+Thus if GLED is statically on, NuttX has successfully booted and is,
+apparently, running normally.  A soft glow of the RLED means that the
+board is taking interrupts.   If GLED is off and GLED is flashing at
+approximately 2Hz, then a fatal error has been detected and the system
+has halted.
+
+Buttons
+-------
+
+The LaunchXL-CC1312R1 has two push-puttons:
+
+=========== ==== ===============================
+DIO13_BTN1  SW1  Low input sensed when depressed
+DIO14_BTN2  SW2  Low input sensed when depressed
+=========== ==== ===============================
+
+Version 1 or 2?
+===============
+
+Two versions of the CC1312R1 are supported selected by CONFIG_ARCH_CHIP_CC13XX_V1
+or CONFIG_ARCH_CHIP_CC13XX_V2.  It is not clear how to identify the chip version
+from markings on it.
+
+What you can do is enable CONFIG_DEBUG_ASSERTIONS.  The firmware can
+determine which version you have by looking at register contents.  The
+firmware will assert if you select the wrong version.  If that occurs,
+switch to the other version and the assertion should go away.
+
+Running from SRAM
+=================
+
+The LaunchXL-CC1312R1 port supports execution from RAM.  Execution from
+SRAM as a "safe" way to bring up a new board port without concern about
+borking the board because of a bad FLASH image.

Review comment:
       ```suggestion
   breaking the board because of a bad FLASH image.
   ```
   ```suggestion
   bricking the board because of a bad FLASH image.
   ```
   ?




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [incubator-nuttx] btashton commented on a change in pull request #3604: docs: Add initial board docs for Tiva arch

Posted by GitBox <gi...@apache.org>.
btashton commented on a change in pull request #3604:
URL: https://github.com/apache/incubator-nuttx/pull/3604#discussion_r619842279



##########
File path: Documentation/platforms/arm/tiva/index.rst
##########
@@ -0,0 +1,74 @@
+===================================================
+Texas Instruments Tiva C / Luminary Micro Stellaris
+===================================================
+
+The Tiva architecture is a combination of the Luminary Micro Stellaris chips
+and the TI Tiva variants.  There are both M3 and M4 Arm cores in this family.
+
+Supported MCUs
+=============
+
+The following list includes MCUs from Tiva C series supported in NuttX
+
+=============   ==============  ======= =================
+MCU             Core            Radio    Frequency
+=============   ==============  ======= =================
+LM3S6918        Cortex-M3       No      50 MHz
+LM3S9B92        Cortex-M3       No      50 MHz
+LM3S9B96        Cortex-M3       No      50 MHz
+LM3S6432        Cortex-M3       No      50 MHz
+LM3S6965        Cortex-M3       No      50 MHz
+LM3S8962        Cortex-M3       No      50 MHz
+LM4F120         Cortex-M4       No      80 MHz
+TM4C123AH6PM    Cortex-M4       No      120 MHz
+TM4C123GH6ZRB   Cortex-M4       No      120 MHz
+TM4C123GH6PM    Cortex-M4       No      120 MHz
+TM4C123GH6PZ    Cortex-M4       No      120 MHz
+TM4C123GH6PGE   Cortex-M4       No      120 MHz
+TM4C1294NCPDT   Cortex-M4       No      120 MHz
+TM4C129ENCPDT   Cortex-M4       No      120 MHz
+TM4C129ENCZAD   Cortex-M4       No      120 MHz
+TM4C129XNCZAD   Cortex-M4       No      120 MHz
+CC1310          Cortex-M3       Yes     24 MHz
+CC1312R1        Cortex-M4       Yes     48 MHz
+CC1352R1        Cortex-M4       Yes     48 MHz
+=============   ==============  ======= =================
+
+Peripheral Support
+==================
+
+The following list indicates peripherals supported in NuttX:
+
+==========
+Peripheral
+==========
+GPIO
+ADC
+EEPROM
+FLASH
+HCIUART
+I2C
+MPU
+PWM
+QENCODER
+SERIAL
+SSI
+TIMER
+ETHERNET
+WDT
+I2S
+USB
+==========

Review comment:
       I have no idea really what all is all supported. I think we need to make some progress getting all of these moved over though because right now it looks like 5 boards or so are supported total.




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [incubator-nuttx] hartmannathan commented on a change in pull request #3604: docs: Add initial board docs for Tiva arch

Posted by GitBox <gi...@apache.org>.
hartmannathan commented on a change in pull request #3604:
URL: https://github.com/apache/incubator-nuttx/pull/3604#discussion_r754571845



##########
File path: Documentation/platforms/arm/tiva/index.rst
##########
@@ -0,0 +1,74 @@
+===================================================
+Texas Instruments Tiva C / Luminary Micro Stellaris
+===================================================
+
+The Tiva architecture is a combination of the Luminary Micro Stellaris chips
+and the TI Tiva variants.  There are both M3 and M4 Arm cores in this family.
+
+Supported MCUs
+=============
+
+The following list includes MCUs from Tiva C series supported in NuttX
+
+=============   ==============  ======= =================
+MCU             Core            Radio    Frequency
+=============   ==============  ======= =================
+LM3S6918        Cortex-M3       No      50 MHz
+LM3S9B92        Cortex-M3       No      50 MHz
+LM3S9B96        Cortex-M3       No      50 MHz
+LM3S6432        Cortex-M3       No      50 MHz
+LM3S6965        Cortex-M3       No      50 MHz
+LM3S8962        Cortex-M3       No      50 MHz
+LM4F120         Cortex-M4       No      80 MHz
+TM4C123AH6PM    Cortex-M4       No      120 MHz
+TM4C123GH6ZRB   Cortex-M4       No      120 MHz
+TM4C123GH6PM    Cortex-M4       No      120 MHz
+TM4C123GH6PZ    Cortex-M4       No      120 MHz
+TM4C123GH6PGE   Cortex-M4       No      120 MHz
+TM4C1294NCPDT   Cortex-M4       No      120 MHz
+TM4C129ENCPDT   Cortex-M4       No      120 MHz
+TM4C129ENCZAD   Cortex-M4       No      120 MHz
+TM4C129XNCZAD   Cortex-M4       No      120 MHz
+CC1310          Cortex-M3       Yes     24 MHz
+CC1312R1        Cortex-M4       Yes     48 MHz
+CC1352R1        Cortex-M4       Yes     48 MHz
+=============   ==============  ======= =================
+
+Peripheral Support
+==================
+
+The following list indicates peripherals supported in NuttX:
+
+==========
+Peripheral
+==========
+GPIO
+ADC
+EEPROM
+FLASH
+HCIUART
+I2C
+MPU
+PWM
+QENCODER
+SERIAL
+SSI
+TIMER
+ETHERNET
+WDT
+I2S
+USB
+==========
+
+GPIO
+-----------

Review comment:
       Ditto




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@nuttx.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org



[GitHub] [incubator-nuttx] hartmannathan commented on pull request #3604: docs: Add initial board docs for Tiva arch

Posted by GitBox <gi...@apache.org>.
hartmannathan commented on pull request #3604:
URL: https://github.com/apache/incubator-nuttx/pull/3604#issuecomment-975848739


   Ok it just needs to be rebased and marked as not a draft...


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: commits-unsubscribe@nuttx.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org