Skip to content

Commit ea816e6

Browse files
committed
simplelink: ti: Add support for Demo II
This release of TI Zephyr is based on v3.7.0 and includes support and maintenance for the following Texas Instruments boards and devices. Devices - [CC2340R5](https://www.ti.com/product/CC2340R5) Boards - [lp_em_cc2340r5](https://www.ti.com/tool/LP-EM-CC2340R5) Supported Zephyr Examples - hci_uart - broadcaster - observer - scan_adv - extended_adv/advertiser - peripheral - central - peripheral_dis - peripheral_gatt_write - central_gatt_write Supported Drivers: - UART - Watchdog - GPIO - SPI - Crypto - ADC - I2C - PWM Signed-off-by: Masha Heller <masha.heller@ti.com> Signed-off-by: Lars Thalian Morstad <l-morstad@ti.com>
1 parent 36940db commit ea816e6

File tree

165 files changed

+16013
-4789
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

165 files changed

+16013
-4789
lines changed

README.md

Lines changed: 157 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,157 @@
1+
# Texas Instruments Support for Zephyr
2+
3+
<p align="center">
4+
<img src="doc/images/ti_logo.png" />
5+
</p>
6+
7+
The Texas Instruments Zephyr GitHub repository is the starting point for Zephyr
8+
development on supported Texas Instruments devices. TI's Zephyr solution is
9+
based on the Zephyr project and utilizes the same familiar environment, tools,
10+
and dependencies.
11+
12+
## What is Zephyr?
13+
14+
The Zephyr Project is a scalable real-time operating system (RTOS) supporting
15+
multiple hardware architectures, optimized for resource constrained devices,
16+
and built with security in mind.
17+
18+
The Zephyr OS is based on a small-footprint kernel designed for use on
19+
resource-constrained systems: from simple embedded environmental sensors and
20+
LED wearables to sophisticated smart watches and IoT wireless gateways.
21+
22+
This release in the downstream repository of TI Zephyr is based on a tagged
23+
release from the Zephyr upstream. TI has built on top of that Zephyr version
24+
to add support for specific SimpleLink Wireless MCUs. Please see the
25+
[Release Notes](#releases) for information about which upstream Zephyr release
26+
this TI release is based on. Other dependency info is included there as well.
27+
28+
This release only contains
29+
support for the `CC2340R5` device. The `CC32xx` and `CC13xx_CC26xx` devices are
30+
not supported in this release. However, the Zephyr community continues to
31+
support them in the upstream repositories.
32+
33+
### Devices
34+
35+
Supported by this release:
36+
37+
- [CC2340R52](https://www.ti.com/product/CC2340R5)
38+
39+
Beta support:
40+
41+
Limited testing was also performed on the `CC2340R53`, a variant of the CC2340R5
42+
with 64kB of SRAM. Please note that some examples that require more RAM should
43+
be run on the CC2340R53. Please see the release notes for more details.
44+
45+
To use this device, change [`cc2340r5.dtsi`](dts/arm/ti/cc2340r5.dtsi)
46+
as follows:
47+
48+
```dts
49+
sram0: memory@20000000 {
50+
reg = <0x20000000 DT_SIZE_K(64)>;
51+
};
52+
```
53+
54+
Supported by the Zephyr community:
55+
56+
- CC1352R
57+
- CC2652P
58+
- CC2652R
59+
- CC1352P7
60+
- CC1352R7
61+
- CC2652P7
62+
- CC2652R7
63+
- CC3220SF
64+
- CC3235SF
65+
66+
### Boards
67+
68+
Supported by this release:
69+
70+
- [lp_em_cc2340r5](https://www.ti.com/tool/LP-EM-CC2340R5)
71+
72+
Supported by the Zephyr community:
73+
74+
- cc1352p1_launchxl
75+
- cc1352p7_launchpad
76+
- cc1352r1_launchxl
77+
- cc26x2r1_launchxl
78+
- cc3220sf_launchxl
79+
- cc3235sf_launchxl
80+
81+
## Getting Started
82+
83+
For getting started, please refer to the
84+
[Upstream Zephyr Readme](https://github.com/zephyrproject-rtos/zephyr/blob/main/README.rst)
85+
for the Zephyr project and follow the same getting-started guide for setting up
86+
the environment and building your first application.
87+
88+
> **_NOTE:_** When running `west init` in the getting-started guide it's
89+
> important to instead run `west init -m https://github.com/TexasInstruments/simplelink-zephyr --mr {tag-name} zephyrproject`
90+
> in order to use the TI Zephyr repository.
91+
> The `{tag-name}` changes with each release from TI.
92+
>
93+
> You can look up the latest tag from the following link:
94+
> https://github.com/TexasInstruments/simplelink-zephyr/tags
95+
96+
97+
## Tools support
98+
99+
Currently the XDS110 debugger supplied with TI Launchpads is not natively
100+
supported in the `west` Zephyr tool for all devices. In order to flash/debug the
101+
`CC2340R5` device with `west`, only [JLink](https://www.segger.com/downloads/jlink/)
102+
is available. The recommended version to use is V7.94f which has been used for
103+
validation. Note that it is also possible to build an application in Zephyr
104+
targeting `CC2340R5`, and to use [Code Composer Studio](https://www.ti.com/tool/CCSTUDIO)
105+
to both flash and debug the application using the XDS110 debugger.
106+
107+
## Versioning
108+
109+
TI will tag each release with the following format: {upstream-tag}-ti-M.mm.pp(\_optional-qualifier)
110+
111+
This tag can be broken down into 4 components:
112+
113+
- upstream-tag: This is the tag or commit of the [Zephyr](https://github.com/zephyrproject-rtos/zephyr)
114+
repo that the TI release is based on
115+
- -ti-: Separator
116+
- TI release version: This is TI's version on top of the upstream Zephyr
117+
version. The version scheme is explained below.
118+
- Qualifier. The qualifier keyword is described below.
119+
120+
### TI Versioning Scheme
121+
122+
The TI version follows a version format, M.mm.pp, where:
123+
124+
- M is a 1 digit major number,
125+
- mm is a 2 digit minor number,
126+
- pp is a 2 digit patch number.
127+
128+
M.mm will follow TI's SimpleLink SDK version and is an indicator that the TI
129+
added content is based on the SimpleLink SDK with matching M.mm.
130+
131+
### Qualifier
132+
133+
Tags that are appended with \_ea are for demo only and are beta quality, while
134+
tags without the \_ea keyword should be treated as production worthy releases.
135+
136+
## Releases
137+
138+
All releases will be tagged using the version format above. Release notes are
139+
provided in the form of GitHub's release notices. Read the release notes for
140+
your selected version here:
141+
142+
https://github.com/TexasInstruments/simplelink-zephyr/releases/
143+
144+
### Disclaimer
145+
146+
This release is provided as-is and should be considered Beta quality. This
147+
product is meant for demonstration purposes only. Please refer to the Release Notes for
148+
details on specific limitations and known issues.
149+
150+
## Need help?
151+
152+
- For technical support with TI Zephyr, including bugs and feature requests -
153+
submit a ticket to [TI's Wireless Connectivity E2E forum](https://e2e.ti.com/support/wireless-connectivity/)
154+
> **_NOTE:_** Please do not use the Github issue tracker for this project.
155+
156+
Additionally, we welcome any feedback that you can give to improve the
157+
documentation!

README.rst

Lines changed: 0 additions & 112 deletions
This file was deleted.

boards/arm/lp_em_cc2340r5/board.cmake

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
# Copyright (c) 2024 Texas Instruments Incorporated
2+
# Copyright (c) 2024 BayLibre, SAS
3+
#
4+
# SPDX-License-Identifier: Apache-2.0
5+
6+
board_runner_args(jlink "--device=CC2340R5")
7+
include(${ZEPHYR_BASE}/boards/common/jlink.board.cmake)
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
if BOARD_LP_EM_CC2340R5
2+
3+
4+
if BT
5+
6+
config ZEPHYR
7+
bool "Bluetooth TI Controller on ZEPHYR"
8+
9+
help
10+
Bluetooth TI Controller on ZEPHYR OS.
11+
default y
12+
13+
config BT_LL_HEAP_SIZE
14+
hex "LL Heap memory pool size (in bytes)"
15+
default 0x1800
16+
17+
endif # BT
18+
19+
endif # BOARD_LP_EM_CC2340R5
Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
# Copyright (c) 2024 Texas Instruments Incorporated
2+
# Copyright (c) 2024 BayLibre, SAS
3+
#
4+
# SPDX-License-Identifier: Apache-2.0
5+
6+
config BOARD_LP_EM_CC2340R5
7+
select SOC_CC2340R5
8+
9+
config BOARD_USE_LF_XOSC
10+
bool "Use external low-frequency crystal"
11+
default y

boards/ti/lp_em_cc2340r5/board.cmake

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
# Copyright (c) 2024 Texas Instruments Incorporated
2+
# Copyright (c) 2024 BayLibre, SAS
3+
#
4+
# SPDX-License-Identifier: Apache-2.0
5+
6+
board_runner_args(jlink "--device=CC2340R5")
7+
include(${ZEPHYR_BASE}/boards/common/jlink.board.cmake)

boards/ti/lp_em_cc2340r5/board.yml

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
board:
2+
name: lp_em_cc2340r5
3+
vendor: ti
4+
socs:
5+
- name: cc2340r5
Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
/*
2+
* Copyright (c) 2024 Texas Instruments Incorporated
3+
* Copyright (c) 2024 BayLibre, SAS
4+
*
5+
* SPDX-License-Identifier: Apache-2.0
6+
*/
7+
8+
/ {
9+
boosterpack_header: connector {
10+
compatible = "ti,boosterpack-header";
11+
#gpio-cells = <2>;
12+
gpio-map = <3 0 &gpio0 22 0>,
13+
<4 0 &gpio0 20 0>,
14+
<7 0 &gpio0 18 0>,
15+
<8 0 &gpio0 3 0>,
16+
<9 0 &gpio0 24 0>,
17+
<10 0 &gpio0 0 0>,
18+
19+
<12 0 &gpio0 9 0>,
20+
<13 0 &gpio0 10 0>,
21+
<14 0 &gpio0 12 0>,
22+
<15 0 &gpio0 13 0>,
23+
<17 0 &gpio0 19 0>,
24+
<18 0 &gpio0 11 0>,
25+
26+
<23 0 &gpio0 23 0>,
27+
<24 0 &gpio0 25 0>,
28+
<25 0 &gpio0 1 0>,
29+
<26 0 &gpio0 2 0>,
30+
<27 0 &gpio0 5 0>,
31+
<28 0 &gpio0 7 0>,
32+
33+
<36 0 &gpio0 8 0>,
34+
<37 0 &gpio0 21 0>,
35+
<38 0 &gpio0 6 0>,
36+
<39 0 &gpio0 14 0>,
37+
<40 0 &gpio0 15 0>;
38+
};
39+
};
Loading

0 commit comments

Comments
 (0)