Skip to content

Commit d4597ba

Browse files
committed
* Updated README file fixing data sheet links, toolchain versions and copyright dates
1 parent 886303a commit d4597ba

File tree

1 file changed

+30
-20
lines changed

1 file changed

+30
-20
lines changed

README.md

+30-20
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@
33
<p><a target="_blank" href="https://www.microchip.com" rel="nofollow"><img src="images/microchip.png" alt="MCHP" width="200";"></a></p>
44

55
# dsPIC33C High-Resolution PWM Configuration: Lab 4
6+
67
**Phase-Shifted PWM Waveform Generation**
78

89
<p><center><a href="https://www.microchip.com/MA330048" rel="nofollow">
@@ -11,46 +12,54 @@
1112
- - -
1213

1314
## Summary
15+
1416
Learning how to use the High Resolution PWM Module of dsPIC33C MP devices, Lab 4:
1517
Code example for dsPIC33CK and dsPIC33CH devices showing a basic configuration of the high-resolution PWM module using two PWM generator channels generating a Phase-Shifted PWM waveforms
1618

1719
- - -
1820

1921
## Related Documentation
20-
- [dsPIC33CK256MP508 Family Data Sheet](https://ww1.microchip.com/downloads/en/DeviceDoc/dsPIC33CK256MP508-Family-Data-Sheet-DS70005349G.pdf)
21-
- [dsPIC33CK256MP508 Family Silicon Errata and Data Sheet Clarification](https://ww1.microchip.com/downloads/en/DeviceDoc/dsPIC33CK256MP508-Family-Silicon-Errata-and-Data-Sheet-Clarification-DS80000796G.pdf)
22-
- [dsPIC33CH512MP508 Family Data Sheet](http://ww1.microchip.com/downloads/en/DeviceDoc/dsPIC33CH512MP508-Family-Data-Sheet-DS70005371D.pdf)
23-
- [dsPIC33CH512MP508 Family Silicon Errata and Data Sheet Clarification](http://ww1.microchip.com/downloads/en/DeviceDoc/dsPIC33CH512MP508-Family-Silicon-Errata-and-Data-Sheet-Clarification-DS80000805F.pdf)
22+
23+
- [dsPIC33CK256MP508 Family Data Sheet](https://www.microchip.com/70005349)
24+
- [dsPIC33CK256MP508 Family Silicon Errata and Data Sheet Clarification](https://www.microchip.com/80000796)
25+
- [dsPIC33CH512MP508 Family Data Sheet](http://www.microchip.com/70005371)
26+
- [dsPIC33CH512MP508 Family Silicon Errata and Data Sheet Clarification](http://www.microchip.com/80000805)
2427

2528
**Please always check for the latest data sheets on the respective product websites:**
29+
2630
- [dsPIC33CK256MP508 Family](https://www.microchip.com/dsPIC33CK256MP508)
2731
- [dsPIC33CH512MP508 Family](https://www.microchip.com/dsPIC33CH512MP508)
2832

2933
## Software Used
30-
- [MPLAB® X IDE v5.40](https://www.microchip.com/mplabx-ide-windows-installer)
31-
- [MPLAB® XC16 Compiler v1.50](https://www.microchip.com/mplabxc16windows)
32-
- [MPLAB® Code Configurator v4.01](https://www.microchip.com/mplab/mplab-code-configurator)
34+
35+
- [MPLAB® X IDE v6.05](https://www.microchip.com/mplabx)
36+
- [MPLAB® XC16 Compiler v2.00](https://www.microchip.com/xc16)
37+
- [MPLAB® Code Configurator v4.85](https://www.microchip.com/mcc)
3338

3439
## Hardware Used
40+
3541
- Digital Power Development Board, Part-No. [DM330029](https://www.microchip.com/DM330029)
3642
- dsPIC33CK Digital Power Plug-In Module (DP PIM), Part-No. [MA330048](https://www.microchip.com/MA330048)
3743
- Alternatively: dsPIC33CH Digital Power Plug-In Module (DP PIM), Part-No. [MA330049](https://www.microchip.com/MA330049)
3844

3945
## Supported Target Devices
46+
4047
- [dsPIC33CK256MP506](https://www.microchip.com/dsPIC33CK256MP506)
4148
- [dsPIC33CH512MP506](https://www.microchip.com/dsPIC33CH512MP506)
4249
- Code compatible with all Single and Dual Core dsPIC33C MP families of devices
4350

4451
- - -
4552

4653
## Setup
54+
4755
- Plug-In the dsPIC33CK or dsPIC33CH Digital Power Plug In Module into the Digital Power Development Board PIM socket J1
4856
- Open and compile the firmware and program the DSC
4957

5058
<br><center><img src="images/dm330029.jpg" width="400"></center><br>
5159

5260
## Operation
53-
After the device has been programmed and the MCU starts up, a 90 degrees phase shift between the two synchronized PWM Generators is generated see below screen capture. Both PWM Generator #1 and #3 are configured in complementary mode with 200 kHz frequency and 50% duty cycle waveform outputs. PWM Generator 1 output is available at PWM1H/L pins while PWM Generator 3 output is available at PWM3H/L pins.
61+
62+
After the device has been programmed and the MCU starts up, a 90 degrees phase shift between the two synchronized PWM Generators is generated see below screen capture. Both PWM Generator #1 and #3 are configured in complementary mode with 200 kHz frequency and 50% duty cycle waveform outputs. PWM Generator 1 output is available at PWM1H/L pins while PWM Generator 3 output is available at PWM3H/L pins.
5463

5564
<br><center><img src="images/pwm90phaseshift.png" width="400"></center><br>
5665
<br><center>*CH1(blue):PWM1H CH2(green):PWM1L CH3(red):PWM3H CH4(purple):PWM3L*</center><br>
@@ -60,41 +69,42 @@ By pressing the on-board push button *USER* on the Digital Power Development Boa
6069
<br><center><img src="images/pwm180phaseshift.png" width="400"></center><br>
6170
<br><center>*CH1(blue):PWM1H CH2(green):PWM1L CH3(red):PWM3H CH4(purple):PWM3L*</center><br>
6271

63-
6472
Please refer to section *FIRMWARE QUICK-START GUIDE* below for more information on the initialization process and code structure.
6573

6674
<br><center><img src="images/dm330029-pinmap.png" width="600"></center><br>
67-
75+
6876
- - -
6977

7078
## FIRMWARE QUICK-START GUIDE
7179

72-
This code example builds on previous code examples showing how to use Microchip Code Configurator (MCC) to set up device clock domains.
73-
Although MCC also supports configuration tools for the High Resolution PWM module, PWM configuration in this example builds on generic peripheral drivers to help users better understand the peripheral architecture and key aspects of specific configurations and operating modes.
80+
This code example builds on previous code examples showing how to use Microchip Code Configurator (MCC) to set up device clock domains.
81+
Although MCC also supports configuration tools for the High Resolution PWM module, PWM configuration in this example builds on generic peripheral drivers to help users better understand the peripheral architecture and key aspects of specific configurations and operating modes.
7482
In each PWM example code project the PWM configuration procedure is located in the user file pwm.c, where each register bit required to achieve/enable the specific function or mode of interest is set and its function described with comments.
7583
Once users are familiar with the architecture, features and capabilities, both configuration options (generic peripheral library or MCC) may be used.
7684

7785
#### a) Project Directory Structure <br/>
86+
7887
The project contains four sub-directories
88+
7989
1. config: location of all hardware abstraction header files
80-
2. common: location of generic peripheral drivers
90+
2. common: location of generic peripheral drivers
8191
3. MCC Generated Files: all device configuration files auto-generated by MCC
8292
4. root: application user code
8393

84-
On the hard drive, main.c/h are located in the MPLAB X project directory.
85-
All other user files, incl. peripheral drivers, are located in the sub-directory *sources*.
86-
Files generated by MCC are always located in their own sub-directory *mcc_generated-files*
94+
On the hard drive, main.c/h are located in the MPLAB X project directory.
95+
All other user files, incl. peripheral drivers, are located in the sub-directory *sources*.
96+
Files generated by MCC are always located in their own sub-directory *mcc_generated-files*
8797

8898
#### b) Using the generic PWM peripheral driver <br/>
89-
The PWM peripheral driver files p33c_pwm.c/h provide data structures representing the Special Function Register (SFR) sets of PWM generators and the PWM base module. These 'virtual' PWM objects are used to load, read and modify PWM generator configurations without the need for hard-coded instructions, which would make the code hard to migrate from one peripheral to another or even across devices.To simplify PWM configurations, in these examples, each register is reset to a known default state before the user configuration of interest is set. Thus, only the register setting which really matters for a certain features/function are shown.
99+
100+
The PWM peripheral driver files p33c_pwm.c/h provide data structures representing the Special Function Register (SFR) sets of PWM generators and the PWM base module. These 'virtual' PWM objects are used to load, read and modify PWM generator configurations without the need for hard-coded instructions, which would make the code hard to migrate from one peripheral to another or even across devices. To simplify PWM configurations, in these examples, each register is reset to a known default state before the user configuration of interest is set. Thus, only the register setting which really matters for a certain features/function are shown.
90101

91102
To learn more about the generic PWM driver, its supported features and intended use cases, please read the comments inside p33c_pwm.c.
92103

93104
#### c) Executing the Code Example <br/>
94-
This code has been written to automatically start up and perform the function of interest. Please read the demo instructions on top of file main.c to learn more about the code example, test points, expected signals and demo mode operation.
95-
96105

106+
This code has been written to automatically start up and perform the function of interest. Please read the demo instructions on top of file main.c to learn more about the code example, test points, expected signals and demo mode operation.
97107

98108
- - -
99109

100-
© 2020, Microchip Technology Inc.
110+
&copy; 2023, Microchip Technology Inc.

0 commit comments

Comments
 (0)