Pull request #13: Feature/version1

Merge in MCU16CE/matlab-dspic33a-curiosity-i2cexample-mpu9250 from ~I67977/matlab-dspic33a-curiosity-i2cexample-mpu9250-codex:feature/version1 to develop

* commit '014f43b4cdb1de0416ef45c984de662c25c2e24c':
  chnagelog and json files modified
  copied the project with commit (a9213d71000a999c726bbcf2cb93b900b8591e2f) on December 3, 2025 3:58:02 PM

Author: i67977

.main-meta/main.json

@@ -4,13 +4,13 @@
    "content":{
       "metaDataVersion":"1.0.0",
       "name":"com.microchip.matlab.project.matlab-dspic33a-curiosity-i2cexample-mpu9250",
-      "version":"2.0.1",
+      "version":"3.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 Example: Roll and Pitch Angles Esitimation using Curiosity Platform Development Board, dsPIC33AK128MC106 Curiosity GP DIM and MPU9250",
+      "shortDescription":"MATLAB/Simulink Model for I2C Peripheral Example: Roll, Pitch and Yaw Angles Esitimation using Curiosity Platform Development Board, dsPIC33AK128MC106 Curiosity GP DIM and MPU9250",
       "simulationTool":{
          "name":"MATLAB/Simulink",
-         "semverRange":">=2024"
+         "semverRange":">=2025"
       },
 	  "addonPackages":[
 				"MATLAB add on packages",

README.md

@@ -4,35 +4,36 @@
     <img alt="Microchip Logo." src="images/microchip_logo_black_red.png">
 </picture> 
 
-# MATLAB/Simulink Model for I2C Peripheral Example: Roll and Pitch Angles Estimation using Curiosity Platform Development Board, dsPIC33AK128MC106 Curiosity GP DIM and MPU9250
+# MATLAB/Simulink Model for I2C Peripheral Example: Roll, Pitch and Yaw Angles Estimation 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 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.
+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). This example uses all the three sensors to estimate the roll, pitch and yaw 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-examples/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-solutions/matlab-dspic33a-curiosity-i2cexample-mpu9250)).
 
 ### 2.2 Software Tools Used for Testing the MATLAB/Simulink Model
 
 - MPLAB® X IDE **v6.25** 
 - MPLAB® XC-DSC Compiler **v3.21**
--	MATLAB R2024b
+-	MATLAB R2025b
 -	Required MATLAB add-on packages
-    -	Simulink (v24.2)
-    -	Simulink Coder (v24.2)
-    -	MATLAB Coder (v24.2)
-    -	Embedded Coder (v24.2)
+    -	Simulink (v25.2)
+    -	Simulink Coder (v25.2)
+    -	MATLAB Coder (v25.2)
+    -	Embedded Coder (v25.2)
     -	MPLAB Device blocks for Simulink (v3.62)
-    - Motor Control Blockset (v24.2)    
+    - Motor Control Blockset (v25.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.
 
@@ -52,12 +53,12 @@ This section describes the hardware setup required for the demonstration.
      <p align="left" >
      <img  src="images/dimconnected.png"width="500"></p>
 
-2. Insert the **MPU 9DOF CLICK** into the **mikro BUS A** interface **connector J13** on the development board. Make sure the click board is inserted correctly before going ahead.
+2. Insert the **MPU 9DOF click** into the **mikro BUS A** interface **connector J13** on the development board. Make sure the click board is inserted correctly before going ahead.
 
      <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-C® 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-USB cable between the Host PC and **connector J24** on the development board.
 
     The development board is also powered by this USB itself.
 
@@ -74,14 +75,14 @@ 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_pitch_roll.slx**. This opens the Simulink model as shown below.
+3.	Double click on the I2C example Simulink model - **curiosity_i2c_pitch_roll_yaw.slx**. This opens the Simulink model as shown below.
 
     <p align="left">
       <img  src="images/dem3.png"width="500"></p>
     </p>
 
     > **Note:** </br>
-    >This example demonstrates only the code generation to demonstrate the I2C communication. The simulation is not possible in this case.
+    >This example demonstrates only the code generation to demostrate the I2C communication. The simulation is not possible in this case.
 
 4.	<p style='text-align: justify;'>From this Simulink model an MPLAB X project can be generated, and it can be used to run the I2C Communication using development board. <p style='text-align: justify;'>To generate the code from the Simulink model, go to the <b>"MICROCHIP"</b> tab, and enable the tabs shown in the figure below. 
 
@@ -96,45 +97,44 @@ This section describes the hardware setup required for the demonstration.
     </p>
 
     > **Note:** </br>
-    >The PKOB4 based USB-UART Channel is used in this example for USB-UART communication. The development board has a 2-port USB hub.
+    >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).
 
 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 compiling the code and programming the device, External Mode will be activated on the dsPIC DSC.
+7.	<p style='text-align: justify;'> After compilation and programming the device. The external mode will be running on the dsPIC.
 
     <p align="left">
       <img  src="images/dem7.png"width="500"></p>
 
-8. </p><p style='text-align: justify;'> The <b>General Purpose LEDs</b> will be blinking.
+    </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>
 
-9. <p style='text-align: justify;'>	The <b> RGB LED</b> will be glowing in different colors. To increase the brightness of the RGB LED, vary the <b>Potentiometer</b> on the development board.
+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.
 
     <p align="left">
       <img  src="images/led_rgb.png"width="500"></p>
     </p>
 
-10. <p style='text-align: justify;'>	To visualize the estimated roll and pitch 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.
+9. <p style='text-align: justify;'>	To view the estimated roll, ptch and yaw angles from the <b>accelerometer, gyroscope and magnetometer 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, pitch and yaw angles.
 
     <p align="left">
       <img  src="images/dem9.png"width="500"></p>
     </p>
 
-11. <p style='text-align: justify;'>Click on the <b>Stop</b> button to stop the I2C communication and external mode.
+10. <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.
-
+>Ensure that at startup, the **development board** and **MPU9250** remain static and level for about 2 seconds for calibration. 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,10 @@
+# matlab-dspic33a-curiosity-i2cexample-mpu9250 v3.0.0
+### Release Highlights
+This is the fourth version of MATLAB Simulink model for I2C Communication Demonstration on hardware platform Curiosity Platform Development Board, dsPIC33AK128MC106 Curiosity GP DIM, and MPU9250 for theEstimation of Roll, Pitch and Yaw Angles by integrating the Magnetometer. 
+
+## Features Added\Updated
+Yaw Angles are Estimated from Gyroscope and Magnetometer data.
+
 # matlab-dspic33a-curiosity-i2cexample-mpu9250 v2.0.1
 ### Release Highlights
 This is the third version, which includes minor but necessary modifications to the readme file for the MATLAB/Simulink model for demonstrating I2C communication on the hardware platform consisting of the Curiosity Platform Development Board, dsPIC33AK128MC106 Curiosity GP DIM, and MPU9250, used for the estimation of roll and pitch angles.