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 15354fc7c5f2b67a0a45ed31431ec48ea3607c84 Author: Erkan Vatan <[email protected]> AuthorDate: Wed Oct 22 17:26:52 2025 +0300 docs/boards: Add documentation for t3-gem-o1 board. Add documentation for the T3 Gemstone O1 (t3-gem-o1) development board, including board specifications, serial console, available configurations (nsh), and installation instructions via RemoteProc. Signed-off-by: Erkan Vatan <[email protected]> --- .../platforms/arm/am67/boards/t3-gem-o1/index.rst | 153 +++++++++++++++++++++ .../arm/am67/boards/t3-gem-o1/t3-gem-o1-back.png | Bin 0 -> 866610 bytes .../arm/am67/boards/t3-gem-o1/t3-gem-o1-front.png | Bin 0 -> 1012406 bytes Documentation/platforms/arm/am67/index.rst | 39 ++++++ 4 files changed, 192 insertions(+) diff --git a/Documentation/platforms/arm/am67/boards/t3-gem-o1/index.rst b/Documentation/platforms/arm/am67/boards/t3-gem-o1/index.rst new file mode 100644 index 00000000000..c660fa9bf4a --- /dev/null +++ b/Documentation/platforms/arm/am67/boards/t3-gem-o1/index.rst @@ -0,0 +1,153 @@ +============== +T3 Gemstone O1 +============== + +.. tags:: chip:am67, arch:arm, experimental + +.. list-table:: + :align: center + + * - .. figure:: t3-gem-o1-front.png + :align: center + + T3 Gemstone O1 board layout - front + + - .. figure:: t3-gem-o1-back.png + :align: center + + T3 Gemstone O1 board layout - back + +This page presents T3 Gemstone O1 – High-performance development board based on +Texas Instruments AM67A processor, which runs NuttX on main domain Cortex-R5F +core. + +- `Website <https://t3gemstone.org/en/>`__ +- `Board Specs <https://docs.t3gemstone.org/en/boards/o1/introduction/>`__ +- `Documentation <https://docs.t3gemstone.org/en/projects/nuttx/>`__ + +Features +======== + +- **Processor** (`TI AM67A <https://www.ti.com/product/AM67A/>`__) + - Quad-core 64-bit ARM Cortex-A53 @1.4 GHz for running high-level operating + systems such as Linux + - Dual single-core ARM Cortex-R5F @800 MHz for running real-time MCU + applications + - Dual 2 TOPS (4 TOPS total) deep learning accelerators for running vision + applications + - Advanced 50 GFLOPS GPU for high-performance graphics processing + - 4GB LPDDR4 RAM + +- **Sensors** + - InvenSense ICM-20948 IMU (accel, gyro, compass) + - Bosch BMP390 barometer + - TI HDC2010 humidity and temperature + +- **Storage** + + - **On-board** + - 32GB eMMC flash + - 512Kbit EEPROM + + - **Expandable** + - microSD card slot + - M.2 2280 SSD port + +- **Network Connections** + - 1x Gigabit ethernet + - 1x CAN bus + - Wi-Fi 4 (802.11n) + - Bluetooth 5.1, Bluetooth Low Energy (BLE) + +- **Power** + - USB Type-C power (5-9V / 3A) + - DC power connector (5-12V / 5A) + +- **Interfaces** + - UART, I2C and SPI for extensions + - S.Bus input + - 7x PWM servo outputs + - Green-red status leds + - Real-time clock + - Fan with PWM speed control + - 4x USB ports + - 2x 4-lane MIPI CSI/DSI + - 1x HDMI + +.. warning:: + + This board currently only supports a basic implementation of NuttX with + only UART console as a supported peripheral. Please see the contributing + documentation if you would like to help contribute to the support. + +Serial console +============== + +The serial console is provided on UART-MAIN1, which is available on the 40-pin +HAT: + +- **UART-MAIN1 TX:** GPIO-14 +- **UART-MAIN1 RX:** GPIO-15 + +Installation +============ + +The :code:`arm‑none‑eabi‑gcc` toolchain can compile NuttX for R5F cores. +You can obtain a compatible toolchain for your operating system directly from +the official ARM website. + +If you’re running a Debian‑based Linux distribution, you can also install the +toolchain via your package manager: + +.. code:: console + + $ sudo apt-get update + $ sudo apt-get -y install gcc-arm-none-eabi + +Flashing +======== + +The board does not provide flash storage for the R5F firmware, so NuttX must be +loaded onto the R5F cores through the RemoteProc framework from either U‑Boot or +Linux. While the A53 cores run Linux, the R5F cores execute the NuttX operating +system. + +To load code onto the R5F cores, place the compiled binaries in the +:code:`/lib/firmware` directory, using the filenames expected by RemoteProc. +During boot, RemoteProc will automatically detect these files and launch the +corresponding programs on the appropriate cores. + +Follow the steps below to start NuttX on the main‑domain R5F core via RemoteProc. + +#. Copy the :code:`nuttx` file resulting from the compilation to the + :code:`/lib/firmware` directory with the name :code:`j722s-main-r5f0_0-fw`. + +#. Reboot the board. + +#. You can access NuttShell by connecting a USB-to-TTL device to the + UART-MAIN1's TX (GPIO-14) and RX (GPIO-15) pins on the 40-pin HAT. + +.. code-block:: console + + $ picocom -b 115200 /dev/ttyACM0 + NuttShell (NSH) NuttX-12.11.0 + nsh> cat proc/version + NuttX version 12.11.0 8bdbb8c7d5-dirty Oct 22 2025 14:15:42 t3-gem-o1:nsh + nsh> + +Configurations +============== + +All of the configurations that can be used with :code:`t3-gem-o1` board name are +listed below. For example you can select :code:`nsh` configuration with the +following command: + +.. code:: console + + $ ./tools/configure.sh t3-gem-o1:nsh + +nsh +--- + +Configures the NuttShell (nsh) located at examples/nsh. +This configuration enables a serial console on UART-MAIN1. diff --git a/Documentation/platforms/arm/am67/boards/t3-gem-o1/t3-gem-o1-back.png b/Documentation/platforms/arm/am67/boards/t3-gem-o1/t3-gem-o1-back.png new file mode 100644 index 00000000000..c7cda530b34 Binary files /dev/null and b/Documentation/platforms/arm/am67/boards/t3-gem-o1/t3-gem-o1-back.png differ diff --git a/Documentation/platforms/arm/am67/boards/t3-gem-o1/t3-gem-o1-front.png b/Documentation/platforms/arm/am67/boards/t3-gem-o1/t3-gem-o1-front.png new file mode 100644 index 00000000000..9a1a87b8b31 Binary files /dev/null and b/Documentation/platforms/arm/am67/boards/t3-gem-o1/t3-gem-o1-front.png differ diff --git a/Documentation/platforms/arm/am67/index.rst b/Documentation/platforms/arm/am67/index.rst new file mode 100644 index 00000000000..9d8fd59c09d --- /dev/null +++ b/Documentation/platforms/arm/am67/index.rst @@ -0,0 +1,39 @@ +======= +TI AM67 +======= + +- **Processor** (`TI AM67A <https://www.ti.com/product/AM67A/>`__) + - Quad-core 64-bit ARM Cortex-A53 @1.4 GHz for running high-level operating + systems such as Linux + - Dual single-core ARM Cortex-R5F @800 MHz for running real-time MCU + applications + - Dual 2 TOPS (4 TOPS total) deep learning accelerators for running vision + applications + - Advanced 50 GFLOPS GPU for high-performance graphics processing + +The TI AM67 platform integrates a dual‑domain architecture comprising: + +- **High‑Performance Domain –** Four Cortex‑A53 cores run a real‑time Linux + operating system. These cores deliver the computational throughput required + for intensive workloads such as image‑processing pipelines, computer‑vision + algorithms, and other application‑level tasks. + +- **Safety‑Critical Domain –** Dedicated Cortex‑R5F cores execute NuttX, a + deterministic, low‑latency RTOS optimized for hard real‑time control. This + domain handles safety‑critical functions, including the autopilot control + loop. + +.. warning:: + + This chip currently only supports a basic implementation of NuttX with + only UART console as a supported peripheral. Please see the contributing + documentation if you would like to help contribute to the support. + +Supported Boards +================ + +.. toctree:: + :glob: + :maxdepth: 1 + + boards/*/*
