You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@nuttx.apache.org by je...@apache.org on 2026/04/07 12:51:18 UTC
(nuttx) 02/03: Documentation/platforms/arm/tiva: add lm3s6965-ek board documentation
This is an automated email from the ASF dual-hosted git repository.
jerpelea pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/nuttx.git
commit c272086ab5ff1505484c9dec3b8c8cae4c6e1c3d
Author: Xiang Xiao <xi...@xiaomi.com>
AuthorDate: Mon Mar 23 16:56:08 2026 +0800
Documentation/platforms/arm/tiva: add lm3s6965-ek board documentation
Add board documentation for the Stellaris LM3S6965 Evaluation Kit
including available configurations (nsh, qemu-flat, qemu-protected,
qemu-kostest, qemu-nxflat) and instructions for running and debugging
with QEMU.
Also add a Supported Boards toctree section to the Tiva platform
index to automatically include board documentation.
Signed-off-by: Xiang Xiao <xi...@xiaomi.com>
---
.../arm/tiva/boards/lm3s6965-ek/index.rst | 169 +++++++++++++++++++++
Documentation/platforms/arm/tiva/index.rst | 9 ++
2 files changed, 178 insertions(+)
diff --git a/Documentation/platforms/arm/tiva/boards/lm3s6965-ek/index.rst b/Documentation/platforms/arm/tiva/boards/lm3s6965-ek/index.rst
new file mode 100644
index 00000000000..3166c2059b1
--- /dev/null
+++ b/Documentation/platforms/arm/tiva/boards/lm3s6965-ek/index.rst
@@ -0,0 +1,169 @@
+===========
+lm3s6965-ek
+===========
+
+The `Stellaris LM3S6965 Evaluation Kit
+<https://www.ti.com/tool/EK-LM3S6965>`_ is an ARM Cortex-M3 based
+development board featuring the LM3S6965 microcontroller with an
+integrated 10/100 Ethernet controller. NuttX can run on this board
+both on real hardware and under QEMU emulation
+(``qemu-system-arm -M lm3s6965evb``).
+
+Features of the LM3S6965 Evaluation Kit:
+
+* LM3S6965 microcontroller (ARM Cortex-M3, 50 MHz)
+* 256 KB flash, 64 KB SRAM
+* Integrated 10/100 Ethernet MAC and PHY
+* OLED graphics display (128 x 96 pixel)
+* MicroSD card slot
+* USB interface for debugging and power supply
+* Standard ARM 20-pin JTAG debug connector
+
+Configurations
+==============
+
+Each configuration is maintained in a sub-directory and can be selected
+as follows::
+
+ $ ./tools/configure.sh lm3s6965-ek:<subdir>
+
+Where ``<subdir>`` is one of the following:
+
+discover
+--------
+
+A network discovery configuration::
+
+ $ ./tools/configure.sh -l lm3s6965-ek:discover
+ $ make
+
+nsh
+---
+
+Configures the NuttShell (NSH) with serial and telnet interfaces::
+
+ $ ./tools/configure.sh -l lm3s6965-ek:nsh
+ $ make
+
+nx
+--
+
+An NX graphics configuration::
+
+ $ ./tools/configure.sh -l lm3s6965-ek:nx
+ $ make
+
+qemu-flat
+---------
+
+A FLAT memory model configuration for running under QEMU::
+
+ $ ./tools/configure.sh -l lm3s6965-ek:qemu-flat
+ $ make
+
+qemu-protected
+--------------
+
+A PROTECTED memory model configuration for running under QEMU::
+
+ $ ./tools/configure.sh -l lm3s6965-ek:qemu-protected
+ $ make
+
+qemu-kostest
+-------------
+
+A PROTECTED memory model configuration with kernel ostest for running
+under QEMU::
+
+ $ ./tools/configure.sh -l lm3s6965-ek:qemu-kostest
+ $ make
+
+qemu-nxflat
+------------
+
+A FLAT memory model configuration with NXFLAT binary support for running
+under QEMU::
+
+ $ ./tools/configure.sh -l lm3s6965-ek:qemu-nxflat
+ $ make
+
+tcpecho
+-------
+
+A TCP echo server configuration::
+
+ $ ./tools/configure.sh -l lm3s6965-ek:tcpecho
+ $ make
+
+Running with QEMU
+=================
+
+FLAT build (qemu-flat)
+----------------------
+
+::
+
+ $ qemu-system-arm -M lm3s6965evb -nographic \
+ -kernel nuttx.bin
+
+PROTECTED build (qemu-protected, qemu-kostest)
+-----------------------------------------------
+
+The PROTECTED build produces separate kernel and user binaries.
+Use ``-device loader`` to load the user binary at its link address::
+
+ $ qemu-system-arm -M lm3s6965evb -nographic \
+ -kernel nuttx.bin \
+ -device loader,file=nuttx_user.bin,addr=0x20000
+
+With networking (qemu-flat)
+---------------------------
+
+The ``lm3s6965evb`` machine includes a built-in Stellaris Ethernet NIC
+(``stellaris_enet``). To enable user-mode networking with the host,
+add the ``-nic user`` option::
+
+ $ qemu-system-arm -M lm3s6965evb -nographic \
+ -kernel nuttx.bin -nic user
+
+With networking (qemu-protected)
+---------------------------------
+
+For the PROTECTED build, also load the user binary::
+
+ $ qemu-system-arm -M lm3s6965evb -nographic \
+ -kernel nuttx.bin \
+ -device loader,file=nuttx_user.bin,addr=0x20000 \
+ -nic user
+
+To exit QEMU, press ``Ctrl-A`` then ``X``.
+
+Debugging with QEMU
+====================
+
+1. To debug the NuttX ELF with symbols, ensure that the following
+ configuration option is enabled in your defconfig (it is already
+ set in the ``lm3s6965-ek:qemu-protected`` defconfig)::
+
+ CONFIG_DEBUG_SYMBOLS=y
+
+2. Run QEMU at shell terminal 1 with GDB server enabled::
+
+ $ qemu-system-arm -M lm3s6965evb -nographic \
+ -kernel nuttx.bin -S -s
+
+ For a PROTECTED build, also load the userspace binary::
+
+ $ qemu-system-arm -M lm3s6965evb -nographic \
+ -kernel nuttx.bin \
+ -device loader,file=nuttx_user.bin,addr=0x20000 -S -s
+
+3. Run GDB with TUI, connect to QEMU, load NuttX and continue
+ (at shell terminal 2)::
+
+ $ arm-none-eabi-gdb -tui --eval-command='target remote localhost:1234' nuttx
+ (gdb) c
+ Continuing.
+ ^C
+ Program received signal SIGINT, Interrupt.
+ (gdb)
diff --git a/Documentation/platforms/arm/tiva/index.rst b/Documentation/platforms/arm/tiva/index.rst
index 7b41b727890..d64bfb70070 100644
--- a/Documentation/platforms/arm/tiva/index.rst
+++ b/Documentation/platforms/arm/tiva/index.rst
@@ -188,3 +188,12 @@ Jose Pablo Carballo and I are doing this port.
- TI/Tiva TM4C129E
- TI/Tiva TM4C129X
- TI/SimpleLink CC13x2
+
+Supported Boards
+================
+
+.. toctree::
+ :glob:
+ :maxdepth: 1
+
+ boards/*/*