Merge pull request zephyrproject-rtos#13 from TexasInstruments/mspm33_documentation

Add README.md and boards index.rst file for MSPM33

Author: padmaraghunathan90

README.md

@@ -7,8 +7,8 @@
 
 <div align="left">
 
-# MSP Downstream Support For Zephyr 
-This repository contains early Zephyr Support for MSP-class devices
+# MSPM33 Downstream Support For Zephyr
+This repository contains early Zephyr Support for MSPM33-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
@@ -25,49 +25,42 @@ 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 downstream repository of TI Zephyr is based on the current upstream and
+advance features concerning specific MSPM33 MCUs.
 
-This release contains
-support for the `MSPM0G3507`, `MSPM0L2228`, and `MSPM0G3519` devices.
+This release contains support for the `MSPM33C321A` device.
+
+## Release Information
+
+| Version | v4.2.0-ti-1.00.00.00_EA (pre-APL) |
+|---------|--------------------------|
+| Zephyr RTOS | <br>• Zephyr Base Device Support<br>• Board Configuration, DTS, Interrupts, Timers, Clock (Fix Clocked), Pinmux, GPIO<br>• HS-ADC (Basic)<br>• Blinky Example |
 
 ### Devices
 
 Supported:
 
-- [MSPM0G3507](https://www.ti.com/product/MSPM0G3507)
-- [MSPM0L2228](https://www.ti.com/product/MSPM0L2228)
-- [MSPM0G3519](https://www.ti.com/product/MSPM0G3519)
+- [MSPM33C321A]
 
 ### Boards
 
 Supported:
 
-- [lp_mspm0g3507](https://www.ti.com/tool/LP-MSPM0G3507)
-- [lp_mspm0l2228](https://www.ti.com/tool/LP-MSPM0L2228)
-- [lp_mspm0g3519](https://www.ti.com/tool/LP-MSPM0G3519)
+- [lp_mspm33c321a]
 
 ## Getting Started
 
-For getting started, please refer to the [Zephyr Getting Started Guide](https://docs.zephyrproject.org/latest/develop/getting_started/index.html) and
-[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.
+For getting started, please refer to the [Zephyr Getting Started Guide](https://docs.zephyrproject.org/latest/develop/getting_started/index.html).
+
+For detailed board-specific information, building instructions, flashing procedures, and required development tools, please refer to the board documentation in `boards/ti/lp_mspm33c321a/doc/index.rst`.
 
 > **_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`
+> important to instead run `west init -m https://github.com/TexasInstruments/msp-zephyr --mr v4.2.0-ti-1.00.00.00_ea zephyrproject`
 > in order to use the TI Zephyr repository.
-> The `{tag-name}` changes with each release from TI.
+> Replace `zephyrproject` with your desired project directory name.
+> The `v4.2.0-ti-1.00.00.00_ea` tag changes with each release from TI and zephyr .
 >
-> 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](https://www.ti.com/tool/CCSTUDIO) to debug the 
-application using the XDS110 debugger.
 
 ## Versioning
 
@@ -82,24 +75,12 @@ This tag can be broken down into 4 components:
   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:
+provided in the form of GitHub's release notices.
 
-https://github.com/TexasInstruments/simplelink-zephyr/releases/
 
 ### Disclaimer
 

boards/ti/lp_mspm33c321a/doc/index.rst

@@ -0,0 +1,100 @@
+.. zephyr:board:: lp_mspm33c321a
+
+Overview
+********
+
+MSPM33C321A microcontrollers (MCUs) are part of the MSP highly integrated, ultra-low-power 32-bit MCU
+family based on the Arm® Cortex®-M33 32-bit core platform operating at up to 160-MHz frequency.
+These MCUs offer high-performance analog peripheral integration, support extended temperature
+ranges, and operate with supply voltages ranging from 1.62 V to 3.6 V.
+
+The MSPM33C321A devices provide 1MB embedded flash program memory with built-in error correction
+code (ECC) and 256KB SRAM with hardware parity option. These MCUs also incorporate a
+memory protection unit, DMA, and a variety of peripherals including GPIO, ADC, timers, and
+communication interfaces.
+
+Hardware
+********
+
+Zephyr uses the ``lp_mspm33c321a`` board for building LP_MSPM33C321A
+
+Supported Features
+=================
+
+.. zephyr:board-supported-hw::
+
+
+Development Environment
+======================
+
+The following development environment was used while developing and testing:
+
+* TI Code Composer Studio (CCS) version 20.3.0 (`Download Link <https://www.ti.com/tool/download/CCSTUDIO/20.3.0>`_)
+* Zephyr SDK version 0.17.4
+* Zephyr version v4.2.0 (v4.2.0-4346-g212edd9ebef)
+
+
+Release Information
+******************
+
+.. list-table::
+   :header-rows: 1
+
+   * - Version
+     - v4.2.0-ti-1.00.00.00_EA (pre-APL)
+   * - Zephyr RTOS
+     - | • Zephyr Base Device Support
+       | • Board Configuration, DTS, Interrupts, Timers, Clock (Fix Clocked), Pinmux, GPIO
+       | • HS-ADC (Basic)
+       | • Blinky Example
+
+
+Building and Flashing
+*********************
+
+Building
+========
+
+Follow the :ref:`getting_started` instructions for Zephyr application development.
+
+For example, to build the basic/blinky application for the MSPM33C321A LaunchPad:
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/basic/blinky
+   :board: lp_mspm33c321a
+   :goals: build
+
+The resulting ``zephyr.elf`` binary in the build directory can be loaded onto
+MSPM33C321A LaunchPad using the steps mentioned below.
+
+Flashing
+========
+
+Currently, the MSPM33C321A board does not support the west flashing tool or OpenOCD support currently.
+Instead, we use SRAM-based loading where we build the samples and load the zephyr.elf file
+from the build directory to the TI Code Composer Studio (CCS) IDE in debugger mode.
+
+To flash the board:
+
+1. Build your Zephyr application as described above
+2. Open TI Code Composer Studio IDE
+3. Create a new project or import an existing CCS project for the MSPM33C321A
+4. Start project less debug using MSPM33 target configuration(CCXML) file
+5. Connect to the MSPM33 core
+6. In the debugger, select "Run" > "Load" > "Load Program..."
+7. Browse to your Zephyr build directory and select the ``zephyr.elf`` file
+8. The program will be loaded into the SRAM of the device
+9. Click "Resume" to start the program execution
+
+Future updates to the Zephyr support for this board will include flash-based programming.
+
+Debugging
+=========
+
+You can debug an application using TI Code Composer Studio IDE as described in the flashing
+section above. The debugger provides full visibility into the device state, registers,
+memory, and supports common debugging features like breakpoints, watchpoints, and step-by-step
+execution.
+
+References
+**********