```{toctree}
:glob:
:maxdepth: 1
:hidden:

matter-migration-guide/matter_cc2674_migration.md
matter-syscfg/getting-started.md
matter-syscfg/sysconfig-board.md
matter-users-guide/ti_openthread_library_usage.md
matter-users-guide/ti_factory_data_user_guide.md
matter-users-guide/enabling_icd_on_ti_devices.md
```

# Texas Instruments platform overview

The Texas Instruments Matter platform is based on the TI SimpleLink™ SDK.

The following diagram is a simplified representation of a Matter application
which is built on the TI Platform.

<div style="text-align: center;">
  <img src="../images/matter_ti_overview_simplified.png" width=30%>
</div>

## Texas Instruments SimpleLink SDK

This Matter GitHub repository contains the software development components and
tools that enable engineers to develop Matter based products. This repository is
the starting point for Matter development on all SimpleLink Thread and Wi-Fi
wireless microcontrollers (MCUs).

The SimpleLink MCU portfolio offers a single development environment that
delivers flexible hardware, software, and tool options for customers developing
wired and wireless applications. With 100 percent code reuse across host MCUs,
Wi-Fi™, Bluetooth Low Energy, 2.4GHz, Sub-1GHz devices and more, choose the MCU
or connectivity standard that fits your design. A one-time investment with the
SimpleLink software development kit allows you to reuse often, opening the door
to create unlimited applications. For more information, visit
www.ti.com/simplelink.

<hr>

## Bluetooth LE and Thread stacks

In the TI example applications the Bluetooth Low Energy protocol is used to
provision the Thread protocol to enable Matter communication. Then Thread is
used for IP communication with other Matter devices.

The TI applications leverage the Bluetooth Low Energy stack on the CC13XX and
CC26XX families. This Bluetooth LE software is distributed in binary form within
the TI SimpleLink SDK. The Bluetooth LE stack leverages code that is present in
the device ROM for certain common Bluetooth LE operations.

These applications leverage the OpenThread stack available within the Matter
repository for Thread communication. Platform support source is built from the
SimpleLink SDK.

These connection protocols can be run concurrently by using the Texas
Instruments Dynamic Multi-protocol Manager.

<hr>

## LwIP stack

The Lightweight IP stack interfaces with the OpenThread stack to offer standard
IP connectivity protocols that OpenThread does not natively support. This offers
a standard socket based interface to the Matter platform.

<hr>

## MbedTLS

The MbedTLS library is used by OpenThread and Matter for a wide variety of
protocols. This ranges from basic AES and SHA to cryptographic protocols like
ECDSA and ECDH.

The MbedTLS library is hardware accelerated using the TI SimpleLink SDK drivers.
This is achieved through the usage of `_ALT` defines in the MbedTLS
configuration file.

<hr>

## Matter Stack to TI Platform Interface

Matter Stack interacts with LwIP, OpenThread, and the TI-BLE stack to achieve
the protocol and application functionality. A Bluetooth LE profile is registered
with the TI-BLE stack to enable provisioning and configuration. Once the device
is provisioned Matter will configure the OpenThread interface to connect to an
existing Thread network or to start its own network. From there the Matter IP
messages are sent to the LwIP stack to be routed to the OpenThread stack for
transmission. Matter Impl (Implementation) layer acts as an interface between
Matter stack and the TI platform components such as BLE stack, OpenThread,
FreeRTOS. It also supports components such as connectivity manager that provides
the implementation for functionality required by Matter stack. Overall,
applications generally only need to interface with the Cluster Library from
Matter. The transport of messages and configuration of the device is all handled
by the platform implementation files.

<hr>

## Matter Development Resources

Below are several resources available for Matter development:

-   [Matter Protocol Overview](https://handbook.buildwithmatter.com/howitworks/roles/)
-   [Matter Build Guide](../../guides/BUILDING.md)
-   [Matter over Thread Getting Started](https://dev.ti.com/tirex/explore/node?node=A__AciOYyNq9gli.nsvJzBtQg__com.ti.SIMPLELINK_ACADEMY_CC13XX_CC26XX_SDK__AfkT0vQ__LATEST)
-   [TI Matter over Wi-Fi Getting Started](https://e2e.ti.com/support/wireless-connectivity/wi-fi-group/wifi/f/wi-fi-forum/1122413/faq-cc3235sf-matter----getting-started-guide)
-   [TI Matter Application Development](https://dev.ti.com/tirex/explore/node?node=A__AXNOPYikmtBCHJ-L6eRivA__com.ti.SIMPLELINK_ACADEMY_CC13XX_CC26XX_SDK__AfkT0vQ__LATEST)
-   [TI Matter OTA Guide](https://dev.ti.com/tirex/explore/node?node=A__AYTiKtu5heqgH4KPFa.6RQ__com.ti.SIMPLELINK_ACADEMY_CC13XX_CC26XX_SDK__AfkT0vQ__LATEST)

<hr>

## Matter Example Applications

Sample Matter applications are provided for the TI platform. These can be used
as reference for your own application.

-   [lock-app](../../../examples/lock-app/cc13x4_26x4/README.md)
-   [pump-app](../../../examples/pump-app/cc13x4_26x4/README.md)
-   [pump-controller-app](../../../examples/pump-controller-app/cc13x4_26x4/README.md)
-   [lighting-app](../../../examples/lighting-app/cc13x4_26x4/README.md)
    <hr>

### Build system

The TI platform uses GN to generate ninja build scripts. Build files have
already been written to build and link the TI specific code within the
SimpleLink SDK.

<hr>

## CC2674 Migration

For instructions on how to migrate the CC1354P10-6 examples to either the
CC2674P10 or the CC2674R10, please refer to the guide linked below.

-   [TI CC2674 Migration Guide](./matter-migration-guide/matter_cc2674_migration.md)

<hr>

## Factory Data Programming Tool

For instructions on how to program custom factory data on TI devices, please
refer to the guide linked below.

-   [TI Factory Data User Guide](./matter-users-guide/ti_factory_data_user_guide.md)

<hr>

## Intermittently Connected Devices

For instructions on how to use the Matter ICD feature on TI devices, please
refer to the guide linked below.

-   [Enabling ICD On TI Devices](./matter-users-guide/enabling_icd_on_ti_devices.md)

<hr>

## Matter OpenThread Library Configuration

For instructions on how to configure the OpenThread build configuration for a
Matter application, please refer to the guide linked below.

-   [OpenThread Library Configuration](./matter-users-guide/ti_openthread_library_usage.md)

### TI Support

For technical support, please consider creating a post on TI's [E2E forum][e2e].
Additionally, we welcome any feedback.

[e2e]: https://e2e.ti.com/support/wireless-connectivity/zigbee-and-thread
[matter_gh]: https://github.com/project-chip/connectedhomeip