Pull request #9: Develop

Merge in MCU16CE/matlab-dspic33a-curiosity-i2cexample-mpu9250 from develop to main

* commit '9355ba188142eebc50322f9f912e85ba48685930':
  readme modification
  changelog modified, radme modified, one image changed and readme pdf added
  Update the files- main.json and changelog.md and deleted curiosity_i2c
  (37955a0af338bf5b6457d580dd816208dafa7278) on Friday, November 7, 2025 4:01:34 PM

Author: i67977

.main-meta/main.json

@@ -4,10 +4,10 @@
    "content":{
       "metaDataVersion":"1.0.0",
       "name":"com.microchip.matlab.project.matlab-dspic33a-curiosity-i2cexample-mpu9250",
-      "version":"1.0.0",
+      "version":"2.0.0",
       "displayName":"MATLAB/Simulink Model for I2C Peripheral Demonstration on dsPIC33AK128MC106",
       "projectName":"matlab-dspic33a-curiosity-i2cexample-mpu9250",
-      "shortDescription":"MATLAB/Simulink Model for I2C Peripheral Demonstration on the hardware platform Curiosity Platform Development Board, dsPIC33AK128MC106 GP DIM and MPU9250 sensor on the MPU 9DOF Click Board",
+      "shortDescription":"MATLAB/Simulink Model for I2C Peripheral Example: Roll and Pitch Angles Esitimation using Curiosity Platform Development Board, dsPIC33AK128MC106 Curiosity GP DIM and MPU9250",
       "simulationTool":{
          "name":"MATLAB/Simulink",
          "semverRange":">=2024"
@@ -24,7 +24,7 @@
       },
       "dfp":{
          "name":"dsPIC33AK-MC_DFP",
-         "semverRange":">=1.1.109"
+         "semverRange":">=1.2.125"
       },
       "device":{
          "metaDataVersion":"1.0.0",

README.md

@@ -4,22 +4,22 @@
     <img alt="Microchip Logo." src="images/microchip_logo_black_red.png">
 </picture> 
 
-# MATLAB/Simulink Model for I2C Peripheral Example: Curiosity Platform Development Board, dsPIC33AK128MC106 Curiosity GP DIM and MPU9250
+# MATLAB/Simulink Model for I2C Peripheral Example: Roll and Pitch Angles Esitimation using Curiosity Platform Development Board, dsPIC33AK128MC106 Curiosity GP DIM and MPU9250
 
 ## 1. INTRODUCTION
 
 This document describes the setup requirements for demonstration of I2C communication on the hardware platform 
 [EV74H48A](https://www.microchip.com/en-us/development-tool/EV74H48A) "Curiosity Platform Development Board" and [EV02G02A](https://www.microchip.com/en-us/development-tool/EV02G02A) "dsPIC33AK128MC106 General Purpose Dual In-Line Module (DIM)" using MPU9250 sensor on the MPU 9DOF Click Board.</p>
 
-MPU-9250 is a multi-chip module (MCM) with 9-axis MotionTracking device that combines a 3-axis gyroscope, 3-axis accelerometer, 3-axis magnetometer and a Digital Motion Processor™ (DMP).
+MPU-9250 is a multi-chip module (MCM) with 9-axis Motion Tracking device that combines a 3-axis gyroscope, 3-axis accelerometer, 3-axis magnetometer and a Digital Motion Processor™ (DMP). This example exclusively uses 3-axis gyroscope, and the 3-axis accelerometer to estimate the roll and pitch angles.
 
 ## 2. SUGGESTED DEMONSTRATION REQUIREMENTS
 
 ### 2.1 MATLAB Model Required for the Demonstration
 
 To clone or download this MATLAB model on GitHub, 
 
-- MATLAB model can be cloned or downloaded as zip file from the Github repository ([link](https://github.com/microchip-pic-avr-solutions/matlab-dspic33a-curiosity-i2cexample-mpu9250)).
+- MATLAB model can be cloned or downloaded as zip file from the Github repository ([link](https://github.com/microchip-pic-avr-examples/matlab-dspic33a-curiosity-i2cexample-mpu9250)).
 
 ### 2.2 Software Tools Used for Testing the MATLAB/Simulink Model
 
@@ -31,8 +31,8 @@ To clone or download this MATLAB model on GitHub,
     -	Simulink Coder (v24.2)
     -	MATLAB Coder (v24.2)
     -	Embedded Coder (v24.2)
-    -	MPLAB Device blocks for Simulink (v3.59)
-    - Motor Control Blockset (v24.2)
+    -	MPLAB Device blocks for Simulink (v3.62)
+    - Motor Control Blockset (v24.2)    
 > **_NOTE:_**
 >The software tools used for testing the model during release is listed above. It is recommended to use the version listed above or later versions for building the model.
 
@@ -57,7 +57,7 @@ This section describes the hardware setup required for the demonstration.
      <p align="left" >
      <img  src="images/microbusA.png"width="500"></p>
 
-3. The development board has an onboard programmer **PICkit™ On Board (PKoBv4)** , which can be used for programming or debugging the microcontroller or dsPIC DSC on the DIM. To use the onboard programmer, connect a micro-USB cable between the Host PC and **connector J24** on the development board.
+3. The development board has an onboard programmer **PICkit™ On Board (PKoBv4)** , which can be used for programming or debugging the microcontroller or dsPIC DSC on the DIM. To use the onboard programmer, connect a Micro-C® cable between the Host PC and **connector J24** on the development board.
 
     The development board is also powered by this USB itself.
 
@@ -74,7 +74,7 @@ This section describes the hardware setup required for the demonstration.
     <p align="left" >
     <img  src="images/dem1.png"width="500"></p>
 
-3.	Double click on the I2C example Simulink model - **curiosity_i2c.slx**. This opens the Simulink model as shown below.
+3.	Double click on the I2C example Simulink model - **curiosity_i2c_pitch_roll.slx**. This opens the Simulink model as shown below.
 
     <p align="left">
       <img  src="images/dem3.png"width="500"></p>
@@ -96,42 +96,45 @@ This section describes the hardware setup required for the demonstration.
     </p>
 
     > **Note:** </br>
-    >Two COM ports are available on the development board. Select the second COM port number for the external mode (if COM2 and COM3 are available on the development board, select COM3).
+    >The PKOB4 based USB-UART Channel is used in this example for USB-UART communication. The development board has a 2-port USB hub.
 
 6.	<p style='text-align: justify;'>	To generate the code and run the I2C communication on hardware, click on <b>"Monitor & Tune" </b> option under the <b>Hardware</b> tab and ensure that <b>"Stop Time" </b> is set to <b>"inf"</b>. 
 
     <p align="left">
       <img  src="images/dem6.png"width="500"></p>
     </p>
-7.	<p style='text-align: justify;'> After compilation and programming the device. The external mode will be running on the dsPIC.
+7.	<p style='text-align: justify;'> After compiling the code and programming the device, External Mode will be activated on the dsPIC DSC.
 
     <p align="left">
       <img  src="images/dem7.png"width="500"></p>
 
-    </p><p style='text-align: justify;'> The <b>General Purpose LED's</b> will be blinking.
+8. </p><p style='text-align: justify;'> The <b>General Purpose LED's</b> will be blinking.
 
     <p align="left">
       <img  src="images/debug_led.png"width="500"></p>
     </p>
 
-8. <p style='text-align: justify;'>	The <b> RGB LEB</b> will be glowing in different colors. To increase the brightness of the RGB LED, vary the <b>Potentiometer</b> on the development board.
+9. <p style='text-align: justify;'>	The <b> RGB LEB</b> will be glowing in different colors. To increase the brightness of the RGB LED, vary the <b>Potentiometer</b> on the development board.
 
     <p align="left">
       <img  src="images/led_rgb.png"width="500"></p>
     </p>
 
-9. <p style='text-align: justify;'>	To view the I2C communication from <b>"MPU9250" </b> double click on the scope. This opens the scope view. Tilt or turn the development board by hand to view variations in the signal from the <b>accelerometer, gyroscope and magnetometer sensors of MPU9250</b>.
+10. <p style='text-align: justify;'>	To visualize the estimated roll and ptch angles from the <b>accelerometer, gyroscope sensors of MPU9250</b> double click on the scope. This opens the scope view. Tilt or turn the development board by hand to view variations in the roll and pitch angles.
 
     <p align="left">
       <img  src="images/dem9.png"width="500"></p>
     </p>
 
-10. <p style='text-align: justify;'>Click on the <b>Stop</b> button to stop the I2C communication and external mode.
+11. <p style='text-align: justify;'>Click on the <b>Stop</b> button to stop the I2C communication and external mode.
 
     <p align="left">
       <img  src="images/dem10.png"width="500"></p>
     </p>
 
+> **Note:** </br>
+>At each startup, the system calibrates the accelerometer and gyroscope of the **MPU 9DOF Click board**. During this 2-second calibration period, the **development board** and **MPU 9DOF Click board** must remain stationary (do not move/ shake). After calibration, the board can be tilted or rotated to observe angle variations.
+
 
 ## 	REFERENCES:
 For more information, refer to the following documents or links.

changelog.md

@@ -1,3 +1,11 @@
+# matlab-dspic33a-curiosity-i2cexample-mpu9250 v2.0.0
+### Release Highlights
+This is the second version of MATLAB Simulink model for I2C Communication Demonstration on hardware platform Curiosity Platform Development Board, dsPIC33AK128MC106 Curiosity GP DIM, and MPU9250 for the Estimation of Roll and Pitch Angles. 
+
+
+### Features Added\Updated
+Roll and Pitch Angles are Estimated from Gyroscope and Accelerometer data.
+
 # matlab-dspic33a-curiosity-i2cexample-mpu9250 v1.0.0
 ### Release Highlights
 This is the first version of MATLAB Simulink model for I2C Communication Demonstration on hardware platform Curiosity Platform Development Board, dsPIC33AK128MC106 Curiosity GP DIM and MPU9250.