MSP Downstream Support For Zephyr

This repository contains early Zephyr Support for MSP-class devices

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 downstream repository of TI Zephyr is based on the current upstream and advance features concerning specific MSP MCUs.

This release contains support for the MSPM0G3507, MSPM0L2228, and MSPM0G3519 devices.

Devices

Supported:

• MSPM0G3507
• MSPM0L2228
• MSPM0G3519

Boards

Supported:

• lp_mspm0g3507
• lp_mspm0l2228
• lp_mspm0g3519

Getting Started

For getting started, please refer to the Zephyr Getting Started Guide and SimpleLink Academy Trainings, 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/msp-zephyr 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

Tools support

Currently the XDS110 debugger supplied with TI Launchpads is not natively supported in the west Zephyr tool using OpenOCD. Note that it is also possible to build an application in Zephyr, flash using west, and use Code Composer Studio to 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 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.

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 MSP E2E forum

  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!