simplelink: ti: v3.7.0-ti-9.10.00_ea release

This release of TI Zephyr is based on v3.7.0 and includes support and
maintenance for the following Texas Instruments boards and devices.

- [CC2340R5](https://www.ti.com/product/CC2340R5)
- [CC2340R53](https://www.ti.com/product/CC2340R5)
- [CC2745R10_Q1](https://www.ti.com/product/CC2745R10-Q1)
- [CC2755R10](https://www.ti.com/product/CC2755R10)

Boards
- [lp_em_cc2340r5](https://www.ti.com/tool/LP-EM-CC2340R5)
- [lp_em_cc2340r53](https://www.ti.com/tool/LP-EM-CC2340R5)
- [lp_em_cc2745r10_q1](https://www.ti.com/product/CC2745R10-Q1)
- [lp_em_cc2755](https://www.ti.com/product/CC2755R10)

See Release Notes for content summary.

Signed-off-by: Lars Thalian Morstad <l-morstad@ti.com>
Signed-off-by: Vebjorn Myklebust <v.myklebust@ti.com>
Signed-off-by: Min Xu <m-xu@ti.com>
Signed-off-by: Masha Heller <masha.heller@ti.com>
Signed-off-by: Cameron Soviero <cam@ti.com>
Signed-off-by: Ging Gonzalez <g-gonzalez@ti.com>
Signed-off-by: Eirik Runshaug <e-runshaug@ti.com>
Signed-off-by: Santhosh George <s-george@ti.com>
Signed-off-by: Naama Rozental <naamaroz@ti.com>
Signed-off-by: Caleb Overbay <c-overbay@ti.com>
Signed-off-by: Stoyan Bogdanov <sbogdanov@baylibre.com>
Signed-off-by: Julien Panis <jpanis@baylibre.com>

Author: LarsMorstadTI

MAINTAINERS.yml

@@ -897,7 +897,6 @@ Documentation:
     - doc/releases/
     - doc/security/
     - doc/safety/
-    - README.rst
     - doc/substitutions.txt
     - doc/images/Zephyr-Kite-in-tree.png
     - doc/index-tex.rst
@@ -4624,6 +4623,14 @@ West:
   labels:
     - "platform: TI"
 
+"West project: simplelink-hal_ti":
+  status: maintained
+  maintainers:
+    - ti
+  files: []
+  labels:
+    - "platform: TI"
+
 "West project: hal_wurthelektronik":
   status: maintained
   maintainers:

README.md

@@ -0,0 +1,192 @@
+# Texas Instruments Support for Zephyr
+
+<p align="center">
+  <img src="doc/images/ti_logo.png" />
+</p>
+
+The Texas Instruments Zephyr GitHub repository is the starting point for Zephyr
+development on supported Texas Instruments devices. TI's Zephyr solution is
+based on the Zephyr project and utilizes the same familiar environment, tools,
+and dependencies.
+
+## What is Zephyr?
+
+The Zephyr Project is a scalable real-time operating system (RTOS) supporting
+multiple hardware architectures, optimized for resource constrained devices,
+and built with security in mind.
+
+The Zephyr OS is based on a small-footprint kernel designed for use on
+resource-constrained systems: from simple embedded environmental sensors and
+LED wearables to sophisticated smart watches and IoT wireless gateways.
+
+This release in the downstream repository of TI Zephyr is based on a tagged
+release from the Zephyr upstream. TI has built on top of that Zephyr version
+to add support for specific SimpleLink Wireless MCUs. Please see the
+[Release Notes](#releases) for information about which upstream Zephyr release
+this TI release is based on. Other dependency info is included there as well.
+
+This release contains
+support for the `CC2340R5`, `CC2340R53`, `CC2745R10_Q1`, and `CC2755R10` devices.
+The `CC32xx` and `CC13xx_CC26xx` devices are
+not supported in this release. However, the Zephyr community continues to
+support them in the upstream repositories.
+
+### Devices
+
+Supported by this release:
+
+- [CC2340R52](https://www.ti.com/product/CC2340R5)
+- [CC2340R53](https://www.ti.com/product/CC2340R5)
+- [CC2745R10_Q1](https://www.ti.com/product/CC2745R10-Q1)
+- [CC2755R10](https://www.ti.com/product/CC2755R10)
+
+Supported by the Zephyr community:
+
+- CC1352R
+- CC2652P
+- CC2652R
+- CC1352P7
+- CC1352R7
+- CC2652P7
+- CC2652R7
+- CC3220SF
+- CC3235SF
+
+### Boards
+
+Supported by this release:
+
+- [lp_em_cc2340r5](https://www.ti.com/tool/LP-EM-CC2340R5)
+- [lp_em_cc2340r53](https://www.ti.com/tool/LP-EM-CC2340R5)
+- [lp_em_cc2745r10_q1](https://www.ti.com/product/CC2745R10-Q1)
+- [lp_em_cc2755](https://www.ti.com/product/CC2755R10)
+
+Supported by the Zephyr community:
+
+- cc1352p1_launchxl
+- cc1352p7_launchpad
+- cc1352r1_launchxl
+- cc26x2r1_launchxl
+- cc3220sf_launchxl
+- cc3235sf_launchxl
+
+## Getting Started
+
+For getting started, please refer to the
+[SimpleLink Academy Trainings](https://dev.ti.com/tirex/explore/node?node=A__ABCS5JT7BlsTcu2NNH3HBg__SIMPLELINK-ACADEMY-CC23XX__gsUPh5j__LATEST),
+it has guidance for setting up the Zephyr environment and building your first application.
+
+> **_NOTE:_** When running `west init` in the getting-started guide it's
+> important to instead run `west init -m https://github.com/TexasInstruments/simplelink-zephyr --mr {tag-name} zephyrproject`
+> in order to use the TI Zephyr repository.
+> The `{tag-name}` changes with each release from TI.
+>
+> You can look up the latest tag from the following link:
+> https://github.com/TexasInstruments/simplelink-zephyr/tags
+
+
+## BLE FOTA
+
+TI supports BLE FOTA for Bluetooth Peripheral samples. To enable, add the following
+configurations to your project's `prj.conf`.
+
+```
+# Enable BLE DFU FOTA MCUMGR MCUBOOT
+CONFIG_BOOTLOADER_MCUBOOT=y
+CONFIG_TI_MCUMGR_BT_OTA_DFU=y
+```
+
+The following configurations should also be applied to your project's `prj.conf`
+to reduce flash and RAM consumption.
+
+```
+CONFIG_LOG=n
+CONFIG_BT_RECV_WORKQ_SYS=y
+CONFIG_MCUMGR_TRANSPORT_NETBUF_COUNT=3
+CONFIG_MCUMGR_TRANSPORT_WORKQUEUE_STACK_SIZE=1536
+CONFIG_BT_BUF_EVT_RX_SIZE=68
+CONFIG_BT_BUF_ACL_RX_SIZE=69
+CONFIG_BT_BUF_ACL_TX_SIZE=27
+CONFIG_BT_BUF_CMD_TX_SIZE=65
+```
+
+You can then build MCUboot and the Bluetooth Peripheral sample using the following
+commands
+
+```
+west build -p=always -b lp_em_cc2340r5 -d build_mcuboot_f3 bootloader/mcuboot/boot/zephyr
+west build -p=always -b lp_em_cc2340r5 -d build_peripheral_fota_f3 zephyr/samples/bluetooth/peripheral
+```
+
+By default, BLE FOTA uses the internal flash as the secondary slot for MCUboot.
+For applications that require more flash, the external flash on the `lp_em_cc2340r5x`
+can be used as the secondary slot instead. To enable this, TI provides Snippets
+that can be applied at build time to enable offchip BLE FOTA. Use the commands below
+as reference
+
+```
+west build -p=always -b lp_em_cc2340r5 -d build_mcuboot_offchip_f3 bootloader/mcuboot/boot/zephyr -S ti-spi-nor-secondary-bl
+west build -p=always -b lp_em_cc2340r5 -d build_peripheral_offchip_fota_f3 zephyr/samples/bluetooth/peripheral -S ti-spi-nor-secondary-app
+```
+
+## Tools support
+
+Currently the XDS110 debugger supplied with TI Launchpads is not natively
+supported in the `west` Zephyr tool for all devices. In order to flash/debug the
+`CC2340R5` device with `west`, only [JLink](https://www.segger.com/downloads/jlink/)
+is available. The recommended version to use is V7.94f which has been used for
+validation. Note that it is also possible to build an application in Zephyr
+targeting `CC2340R5`, and to use [Code Composer Studio](https://www.ti.com/tool/CCSTUDIO)
+to both flash and debug the application using the XDS110 debugger.
+
+## Versioning
+
+TI will tag each release with the following format: {upstream-tag}-ti-M.mm.pp(\_optional-qualifier)
+
+This tag can be broken down into 4 components:
+
+- upstream-tag: This is the tag or commit of the [Zephyr](https://github.com/zephyrproject-rtos/zephyr)
+  repo that the TI release is based on
+- -ti-: Separator
+- TI release version: This is TI's version on top of the upstream Zephyr
+  version. The version scheme is explained below.
+- Qualifier. The qualifier keyword is described below.
+
+### TI Versioning Scheme
+
+The TI version follows a version format, M.mm.pp, where:
+
+- M is a 1 digit major number,
+- mm is a 2 digit minor number,
+- pp is a 2 digit patch number.
+
+M.mm will follow TI's SimpleLink SDK version and is an indicator that the TI
+added content is based on the SimpleLink SDK with matching M.mm.
+
+### Qualifier
+
+Tags that are appended with \_ea are for demo only and are beta quality, while
+tags without the \_ea keyword should be treated as production worthy releases.
+
+## Releases
+
+All releases will be tagged using the version format above. Release notes are
+provided in the form of GitHub's release notices. Read the release notes for
+your selected version here:
+
+https://github.com/TexasInstruments/simplelink-zephyr/releases/
+
+### Disclaimer
+
+This release is provided as-is and should be considered Beta quality. This
+product is meant for demonstration purposes only. Please refer to the Release Notes for
+details on specific limitations and known issues.
+
+## Need help?
+
+- For technical support with TI Zephyr, including bugs and feature requests -
+  submit a ticket to [TI's Wireless Connectivity E2E forum](https://e2e.ti.com/support/wireless-connectivity/)
+  > **_NOTE:_** Please do not use the Github issue tracker for this project.
+
+Additionally, we welcome any feedback that you can give to improve the
+documentation!

README.rst

@@ -1,112 +1,8 @@
-.. raw:: html
-
-   <a href="https://www.zephyrproject.org">
-     <p align="center">
-       <picture>
-         <source media="(prefers-color-scheme: dark)" srcset="doc/_static/images/logo-readme-dark.svg">
-         <source media="(prefers-color-scheme: light)" srcset="doc/_static/images/logo-readme-light.svg">
-         <img src="doc/_static/images/logo-readme-light.svg">
-       </picture>
-     </p>
-   </a>
-
-   <a href="https://bestpractices.coreinfrastructure.org/projects/74"><img
-   src="https://bestpractices.coreinfrastructure.org/projects/74/badge"></a>
-   <a
-   href="https://github.com/zephyrproject-rtos/zephyr/actions/workflows/twister.yaml?query=branch%3Amain">
-   <img
-   src="https://github.com/zephyrproject-rtos/zephyr/actions/workflows/twister.yaml/badge.svg?event=push"></a>
-
-
-The Zephyr Project is a scalable real-time operating system (RTOS) supporting
-multiple hardware architectures, optimized for resource constrained devices,
-and built with security in mind.
-
-The Zephyr OS is based on a small-footprint kernel designed for use on
-resource-constrained systems: from simple embedded environmental sensors and
-LED wearables to sophisticated smart watches and IoT wireless gateways.
-
-The Zephyr kernel supports multiple architectures, including ARM (Cortex-A,
-Cortex-R, Cortex-M), Intel x86, ARC, Nios II, Tensilica Xtensa, and RISC-V,
-SPARC, MIPS, and a large number of `supported boards`_.
-
-.. below included in doc/introduction/introduction.rst
-
-
-Getting Started
-***************
-
-Welcome to Zephyr! See the `Introduction to Zephyr`_ for a high-level overview,
-and the documentation's `Getting Started Guide`_ to start developing.
-
 .. start_include_here
 
-Community Support
-*****************
-
-Community support is provided via mailing lists and Discord; see the Resources
-below for details.
-
 .. _project-resources:
 
 Resources
 *********
 
-Here's a quick summary of resources to help you find your way around:
-
-Getting Started
----------------
-
-  | 📖 `Zephyr Documentation`_
-  | 🚀 `Getting Started Guide`_
-  | 🙋🏽 `Tips when asking for help`_
-  | 💻 `Code samples`_
-
-Code and Development
---------------------
-
-  | 🌐 `Source Code Repository`_
-  | 📦 `Releases`_
-  | 🤝 `Contribution Guide`_
-
-Community and Support
----------------------
-
-  | 💬 `Discord Server`_ for real-time community discussions
-  | 📧 `User mailing list (users@lists.zephyrproject.org)`_
-  | 📧 `Developer mailing list (devel@lists.zephyrproject.org)`_
-  | 📬 `Other project mailing lists`_
-  | 📚 `Project Wiki`_
-
-Issue Tracking and Security
----------------------------
-
-  | 🐛 `GitHub Issues`_
-  | 🔒 `Security documentation`_
-  | 🛡️ `Security Advisories Repository`_
-  | ⚠️ Report security vulnerabilities at vulnerabilities@zephyrproject.org
-
-Additional Resources
---------------------
-  | 🌐 `Zephyr Project Website`_
-  | 📺 `Zephyr Tech Talks`_
-
-.. _Zephyr Project Website: https://www.zephyrproject.org
-.. _Discord Server: https://chat.zephyrproject.org
-.. _supported boards: https://docs.zephyrproject.org/latest/boards/index.html
-.. _Zephyr Documentation: https://docs.zephyrproject.org
-.. _Introduction to Zephyr: https://docs.zephyrproject.org/latest/introduction/index.html
-.. _Getting Started Guide: https://docs.zephyrproject.org/latest/develop/getting_started/index.html
-.. _Contribution Guide: https://docs.zephyrproject.org/latest/contribute/index.html
-.. _Source Code Repository: https://github.com/zephyrproject-rtos/zephyr
-.. _GitHub Issues: https://github.com/zephyrproject-rtos/zephyr/issues
-.. _Releases: https://github.com/zephyrproject-rtos/zephyr/releases
-.. _Project Wiki: https://github.com/zephyrproject-rtos/zephyr/wiki
-.. _User mailing list (users@lists.zephyrproject.org): https://lists.zephyrproject.org/g/users
-.. _Developer mailing list (devel@lists.zephyrproject.org): https://lists.zephyrproject.org/g/devel
-.. _Other project mailing lists: https://lists.zephyrproject.org/g/main/subgroups
-.. _Code samples: https://docs.zephyrproject.org/latest/samples/index.html
-.. _Security documentation: https://docs.zephyrproject.org/latest/security/index.html
-.. _Security Advisories Repository: https://github.com/zephyrproject-rtos/zephyr/security
-.. _Tips when asking for help: https://docs.zephyrproject.org/latest/develop/getting_started/index.html#asking-for-help
-.. _Zephyr Tech Talks: https://www.zephyrproject.org/tech-talks
+See README.md

boards/arm/lp_em_cc2340r5/board.cmake

@@ -0,0 +1,7 @@
+# Copyright (c) 2024 Texas Instruments Incorporated
+# Copyright (c) 2024 BayLibre, SAS
+#
+# SPDX-License-Identifier: Apache-2.0
+
+board_runner_args(jlink "--device=CC2340R5")
+include(${ZEPHYR_BASE}/boards/common/jlink.board.cmake)

boards/arm/lp_em_cc2745r10_q1/board.cmake

@@ -0,0 +1,7 @@
+# Copyright (c) 2025 Texas Instruments Incorporated
+# Copyright (c) 2024 BayLibre, SAS
+#
+# SPDX-License-Identifier: Apache-2.0
+
+board_runner_args(jlink "--device=CC2745R10-Q1")
+include(${ZEPHYR_BASE}/boards/common/jlink.board.cmake)

boards/ti/lp_em_cc2340r5/Kconfig

@@ -0,0 +1,5 @@
+# Copyright (c) 2024 Texas Instruments Incorporated
+#
+# SPDX-License-Identifier: Apache-2.0
+
+rsource "../lpf3_common/Kconfig"