xref: /btstack/port/stm32-f4discovery-cc256x/pdm/Release_Notes.html (revision 4e871e86c3a5e24c4737dcf1f3dcd5f357230051)
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns="http://www.w3.org/TR/REC-html40"><head>
3
4
5
6
7
8
9
10
11
12
13
14  <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
15
16
17  <link rel="File-List" href="Library_files/filelist.xml">
18
19
20  <link rel="Edit-Time-Data" href="Library_files/editdata.mso"><!--[if !mso]> <style> v\:* {behavior:url(#default#VML);} o\:* {behavior:url(#default#VML);} w\:* {behavior:url(#default#VML);} .shape {behavior:url(#default#VML);} </style> <![endif]--><title>Release Notes for PDM audio software decoding Library</title><!--[if gte mso 9]><xml> <o:DocumentProperties> <o:Author>STMicroelectronics</o:Author> <o:LastAuthor>STMicroelectronics</o:LastAuthor> <o:Revision>37</o:Revision> <o:TotalTime>136</o:TotalTime> <o:Created>2009-02-27T19:26:00Z</o:Created> <o:LastSaved>2009-03-01T17:56:00Z</o:LastSaved> <o:Pages>1</o:Pages> <o:Words>522</o:Words> <o:Characters>2977</o:Characters> <o:Company>STMicroelectronics</o:Company> <o:Lines>24</o:Lines> <o:Paragraphs>6</o:Paragraphs> <o:CharactersWithSpaces>3493</o:CharactersWithSpaces> <o:Version>11.6568</o:Version> </o:DocumentProperties> </xml><![endif]--><!--[if gte mso 9]><xml> <w:WordDocument> <w:Zoom>110</w:Zoom> <w:ValidateAgainstSchemas/> <w:SaveIfXMLInvalid>false</w:SaveIfXMLInvalid> <w:IgnoreMixedContent>false</w:IgnoreMixedContent> <w:AlwaysShowPlaceholderText>false</w:AlwaysShowPlaceholderText> <w:BrowserLevel>MicrosoftInternetExplorer4</w:BrowserLevel> </w:WordDocument> </xml><![endif]--><!--[if gte mso 9]><xml> <w:LatentStyles DefLockedState="false" LatentStyleCount="156"> </w:LatentStyles> </xml><![endif]-->
21
22
23
24
25
26
27
28  <style>
29<!--
30/* Style Definitions */
31p.MsoNormal, li.MsoNormal, div.MsoNormal
32{mso-style-parent:"";
33margin:0in;
34margin-bottom:.0001pt;
35mso-pagination:widow-orphan;
36font-size:12.0pt;
37font-family:"Times New Roman";
38mso-fareast-font-family:"Times New Roman";}
39h2
40{mso-style-next:Normal;
41margin-top:12.0pt;
42margin-right:0in;
43margin-bottom:3.0pt;
44margin-left:0in;
45mso-pagination:widow-orphan;
46page-break-after:avoid;
47mso-outline-level:2;
48font-size:14.0pt;
49font-family:Arial;
50font-weight:bold;
51font-style:italic;}
52a:link, span.MsoHyperlink
53{color:blue;
54text-decoration:underline;
55text-underline:single;}
56a:visited, span.MsoHyperlinkFollowed
57{color:blue;
58text-decoration:underline;
59text-underline:single;}
60p
61{mso-margin-top-alt:auto;
62margin-right:0in;
63mso-margin-bottom-alt:auto;
64margin-left:0in;
65mso-pagination:widow-orphan;
66font-size:12.0pt;
67font-family:"Times New Roman";
68mso-fareast-font-family:"Times New Roman";}
69@page Section1
70{size:8.5in 11.0in;
71margin:1.0in 1.25in 1.0in 1.25in;
72mso-header-margin:.5in;
73mso-footer-margin:.5in;
74mso-paper-source:0;}
75div.Section1
76{page:Section1;}
77-->
78  </style><!--[if gte mso 10]> <style> /* Style Definitions */ table.MsoNormalTable {mso-style-name:"Table Normal"; mso-tstyle-rowband-size:0; mso-tstyle-colband-size:0; mso-style-noshow:yes; mso-style-parent:""; mso-padding-alt:0in 5.4pt 0in 5.4pt; mso-para-margin:0in; mso-para-margin-bottom:.0001pt; mso-pagination:widow-orphan; font-size:10.0pt; font-family:"Times New Roman"; mso-ansi-language:#0400; mso-fareast-language:#0400; mso-bidi-language:#0400;} </style> <![endif]--><!--[if gte mso 9]><xml> <o:shapedefaults v:ext="edit" spidmax="5122"/> </xml><![endif]--><!--[if gte mso 9]><xml> <o:shapelayout v:ext="edit"> <o:idmap v:ext="edit" data="1"/> </o:shapelayout></xml><![endif]-->
79  <meta content="MCD Application Team" name="author"></head><body link="blue" vlink="blue">
80<div class="Section1">
81<p class="MsoNormal"><span style="font-family: Arial;"><o:p><br>
82</o:p></span></p>
83<div align="center">
84<table class="MsoNormalTable" style="width: 675pt;" border="0" cellpadding="0" cellspacing="0" width="900">
85  <tbody>
86    <tr>
87      <td style="padding: 0cm;" valign="top">
88      <table class="MsoNormalTable" style="width: 675pt;" border="0" cellpadding="0" cellspacing="0" width="900">
89        <tbody>
90          <tr>
91            <td style="vertical-align: top;">
92
93            <br>
94</td>
95          </tr>
96          <tr style="">
97            <td style="padding: 1.5pt;">
98            <h1 style="margin-bottom: 18pt; text-align: center;" align="center"><span style="font-size: 20pt; font-family: Verdana; color: rgb(51, 102, 255);">Release
99Notes for PDM audio software decoding Library</span><span style="font-size: 20pt; font-family: Verdana;"><o:p></o:p></span></h1>
100            <p class="MsoNormal" style="text-align: center;" align="center"><span style="font-size: 10pt; font-family: Arial; color: black;">Copyright
1012015 STMicroelectronics</span><span style="color: black;"><u1:p></u1:p><o:p></o:p></span></p>
102            <p class="MsoNormal" style="text-align: center;" align="center"><span style="font-size: 10pt; font-family: Arial; color: black;"><img alt="" id="_x0000_i1025" src="_htmresc/st_logo.png" style="border: 0px solid ; width: 171px; height: 126px;"></span><span style="font-size: 10pt;"><o:p></o:p></span></p>
103            </td>
104          </tr>
105        </tbody>
106      </table>
107      <p class="MsoNormal"><span style="font-family: Arial; display: none;"><o:p>&nbsp;</o:p></span></p>
108      <table class="MsoNormalTable" style="width: 675pt;" border="0" cellpadding="0" width="900">
109        <tbody>
110          <tr style="">
111            <td style="padding: 0cm;" valign="top"><br>
112            <div style="margin-left: 40px;"><span style="font-size: 10pt; font-family: Verdana;">The <span style="font-weight: bold; font-style: italic;">PDM audio software decoding Library</span>
113is an optimized software implementation for PDM signal decoding and
114audio signal reconstruction when connecting an <span style="font-weight: bold; font-style: italic;">ST MEMS
115microphone</span> (</span><span style="font-size: 10pt; font-family: Verdana;">MP45Dxxx, MP34Dxxx)</span><span style="font-size: 10pt; font-family: Verdana;"> with an <span style="font-weight: bold; font-style: italic;">STM32 microcontroller</span>.
116It can directly take the Pulse Density Modulated (PDM) data output from
117the microphone and convert it to 16-bit pulse-code modulation (PCM)
118format.</span><br>
119            <span style="font-size: 10pt; font-family: Verdana;">
120            </span><br>
121            <span style="font-size: 10pt; font-family: Verdana;">
122            </span><span style="font-size: 10pt; font-family: Verdana;">This Library includes one header file <span style="font-style: italic;">pdm_filter.h</span> and binary/object codes running on all STM32 devices. The naming format is <span style="font-weight: bold;">libPDMFilter_<span style="font-style: italic;">CMx</span>_<span style="font-style: italic;">C</span>.a/.lib</span>, where:</span><br>
123            <span style="font-size: 10pt; font-family: Verdana;"></span></div>
124            <ul style="margin-top: 0cm; margin-left: 80px;" type="square">
125<li class="MsoNormal" style="color: black; margin-top: 4.5pt; margin-bottom: 4.5pt;"><span style="font-size: 10pt; font-family: Verdana;">CMx: CortexMx core class (CM0, </span><span style="font-size: 10pt; font-family: Verdana;"></span><span style="font-size: 10pt; font-family: Verdana;">CM3, CM4</span><span style="font-size: 10pt; font-family: Verdana;"> and CM7</span><span style="font-size: 10pt; font-family: Verdana;">)</span><span style="font-size: 10pt; font-family: Verdana;"></span></li><li class="MsoNormal" style="color: black; margin-top: 4.5pt; margin-bottom: 4.5pt;"><span style="font-size: 10pt; font-family: Verdana;">C: compiler (IAR, Keil and GCC)</span><span style="font-size: 10pt; font-family: Verdana;"></span><span style="font-size: 10pt; font-family: Verdana;"></span></li>
126            </ul>
127            <div style="margin-left: 40px;"><span style="font-size: 10pt; font-family: Verdana;">For more&nbsp;</span><span style="font-size: 10pt; font-family: Verdana;">information</span><span style="font-size: 10pt; font-family: Verdana;"> about this Library, please refer to the document <span style="font-weight: bold; font-style: italic;">"</span></span><span style="font-size: 10pt; font-family: Verdana; font-weight: bold; font-style: italic;">AN3998 </span><span style="font-size: 10pt; font-family: Verdana;"><span style="font-weight: bold; font-style: italic;">PDM audio software decoding on STM32 microcontrollers"</span> </span><span style="font-family: Verdana; font-size: 10pt;">available for download from&nbsp;STMicroelectronics website at <a href="http://www.st.com/internet/mcu/family/141.jsp" target="_blank">www.st.com</a>.</span></div>
128            <ol style="margin-top: 0cm;" start="1" type="1">
129
130
131            </ol>
132
133            <span style="font-family: &quot;Times New Roman&quot;;">
134            </span>
135            <h2 style="background: rgb(51, 102, 255) none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial;"><a name="History"></a><span style="font-size: 12pt; color: white;">Update History</span></h2>
136            <h3 style="background: rgb(51, 102, 255) none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial; margin-right: 500pt; width: 200px;"><span style="font-size: 10pt; font-family: Arial; color: white;">V2.1.0 / 31-March-2015<o:p></o:p></span></h3>
137
138
139
140
141            <p class="MsoNormal" style="margin: 4.5pt 0cm 4.5pt 18pt;"><b style=""><u><span style="font-size: 10pt; font-family: Verdana; color: black;">Main
142Changes<o:p></o:p></span></u></b></p>
143
144
145
146
147
148            <ul style="list-style-type: square;">
149              <li><span style="font-size: 10pt; font-family: Verdana;">Add Binaries for </span><span style="font-size: 10pt; font-family: Verdana;">CortexM7 (CM7) core<br>
150                </span></li>
151              <li><span style="font-size: 10pt; font-family: Verdana;"><span style="font-style: italic;">PDM_Filter_128_MSB()</span> and <span style="font-style: italic;">PDM_Filter_128_LSB()</span> functions: enhance volume setting, it was lower than expected</span></li>
152              <li><span style="font-size: 10pt; font-family: Verdana;"><span style="font-style: italic;">PDM_Filter_64_MSB()</span> function: fix issue when using more than 2 microphones<span style="font-style: italic;"><br>
153                </span></span></li>
154            </ul>
155
156            <h3 style="background: rgb(51, 102, 255) none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial; margin-right: 500pt; width: 200px;"><span style="font-size: 10pt; font-family: Arial; color: white;">V2.0.1 / 17-December-2013<o:p></o:p></span></h3>
157
158
159            <p class="MsoNormal" style="margin: 4.5pt 0cm 4.5pt 18pt;"><b style=""><u><span style="font-size: 10pt; font-family: Verdana; color: black;">Main
160Changes<o:p></o:p></span></u></b></p>
161
162
163
164            <ul style="margin-top: 0cm;" type="square">
165<li class="MsoNormal" style="color: black; margin-top: 4.5pt; margin-bottom: 4.5pt;"><span style="font-size: 10pt; font-family: Verdana;">In <span style="font-style: italic;">HTONS()</span> macro, change <span style="font-style: italic;">u16</span> type by <span style="font-style: italic;">uint16_t</span><br>
166</span></li>
167            </ul>
168
169            <h3 style="background: rgb(51, 102, 255) none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial; margin-right: 500pt; width: 200px;"><span style="font-size: 10pt; font-family: Arial; color: white;">V2.0.0 / 07-August-2013<o:p></o:p></span></h3>
170            <p class="MsoNormal" style="margin: 4.5pt 0cm 4.5pt 18pt;"><b style=""><u><span style="font-size: 10pt; font-family: Verdana; color: black;">Main
171Changes<o:p></o:p></span></u></b></p>
172
173            <ul style="margin-top: 0cm;" type="square">
174<li class="MsoNormal" style="color: black; margin-top: 4.5pt; margin-bottom: 4.5pt;"><span style="font-size: 10pt; font-family: Verdana;">Update Library binary name format</span></li>
175              <li class="MsoNormal" style="color: black; margin-top: 4.5pt; margin-bottom: 4.5pt;"><span style="font-size: 10pt; font-family: Verdana;">Add Library version optimized for </span><span style="font-size: 10pt; font-family: Verdana;">CM0, CM3 and CM4F cores<br>
176                </span></li>
177              <li class="MsoNormal" style="color: black; margin-top: 4.5pt; margin-bottom: 4.5pt;"><span style="font-size: 10pt; font-family: Verdana;">Add functions for decimation factor </span><span style="font-size: 10pt; font-family: Verdana;">128</span></li>
178            </ul>
179            <h3 style="background: rgb(51, 102, 255) none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial; margin-right: 500pt; width: 167px;"><span style="font-size: 10pt; font-family: Arial; color: white;">V1.1.2 / 17-April-2012<o:p></o:p></span></h3>
180<p class="MsoNormal" style="margin: 4.5pt 0cm 4.5pt 18pt;"><b style=""><u><span style="font-size: 10pt; font-family: Verdana; color: black;">Main
181Changes<o:p></o:p></span></u></b></p>
182<ul style="margin-top: 0cm;" type="square"><li class="MsoNormal" style="color: black; margin-top: 4.5pt; margin-bottom: 4.5pt;"><span style="font-size: 10pt; font-family: Verdana;">All source files:&nbsp;license disclaimer text update and add link to the License file on ST Internet.</span></li></ul><h3 style="background: rgb(51, 102, 255) none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial; margin-right: 500pt; width: 176px;"><span style="font-size: 10pt; font-family: Arial; color: white;">V1.1.1 / 30-December-2011<o:p></o:p></span></h3><p class="MsoNormal" style="margin: 4.5pt 0cm 4.5pt 18pt;"><b style=""><u><span style="font-size: 10pt; font-family: Verdana; color: black;">Main
183Changes<o:p></o:p></span></u></b></p>
184<ul style="margin-top: 0cm;" type="square"><li class="MsoNormal" style="color: black; margin-top: 4.5pt; margin-bottom: 4.5pt;"><span style="font-size: 10pt; font-family: Verdana;">PDM Library moved from <span style="font-style: italic;">Utilities\STM32F4-Discovery</span> to <span style="font-style: italic;">Utilities\STM32_Audio\Addons\PDM</span> folder</span></li><li class="MsoNormal" style="color: black; margin-top: 4.5pt; margin-bottom: 4.5pt;"><span style="font-size: 10pt; font-family: Verdana;">Add new&nbsp;license agreement <span style="font-style: italic;">"MCD-ST Image SW License Agreement V2.pdf"</span></span></li></ul><h3 style="background: rgb(51, 102, 255) none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial; margin-right: 500pt; width: 186px;"><span style="font-size: 10pt; font-family: Arial; color: white;">V1.1.0 / 28-October-2011</span></h3>
185            <p class="MsoNormal" style="margin: 4.5pt 0cm 4.5pt 18pt;"><b style=""><u><span style="font-size: 10pt; font-family: Verdana; color: black;">Main
186Changes<o:p></o:p></span></u></b></p>
187
188            <ul style="margin-top: 0cm;" type="square"><li class="MsoNormal"><span style="font-size: 10pt; font-family: Verdana;">Add&nbsp;<span style="font-weight: bold; font-style: italic;">PDM audio software decoding Library</span><span style="font-weight: bold;"></span> drivers, used to decode and reconstruct the audio signal produced by&nbsp;MP45DT02 MEMS microphone from </span><span style="font-size: 10pt; font-family: Arial; color: black;">STMicroelectronics.</span><span style="font-size: 10pt; font-family: Verdana;"><span style="font-weight: bold; font-style: italic;"> </span><span style="font-weight: bold;"></span>For more details about this Library, please refer to document<span style="font-weight: bold; font-style: italic;"> "PDM audio software decoding on STM32 microcontrollers (AN3998)".</span></span><span style="font-size: 10pt; font-family: Verdana;"></span></li><li class="MsoNormal"><span style="font-size: 10pt; font-family: Verdana;">stm32f4_discovery_audio_codec.c/.h: update to use DMA instead of Interrupt in I2S communication with the external codec.</span></li></ul><h3 style="background: rgb(51, 102, 255) none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial; margin-right: 500pt; width: 186px;"><span style="font-size: 10pt; font-family: Arial; color: white;">V1.0.0 / 19-September-2011</span></h3>
189            <p class="MsoNormal" style="margin: 4.5pt 0cm 4.5pt 18pt;"><b style=""><u><span style="font-size: 10pt; font-family: Verdana; color: black;">Main
190Changes<o:p></o:p></span></u></b></p>
191
192            <ul style="margin-top: 0cm;" type="square"><li class="MsoNormal"><span style="font-size: 10pt; font-family: Verdana;">First official version of the<span style="font-weight: bold; font-style: italic;"> STM32F4-Discovery Board&nbsp;Drivers</span></span></li></ul><span style="font-size: 10pt; font-family: Verdana;"><span style="font-weight: bold; font-style: italic;"></span></span><span style="font-size: 10pt; font-family: Verdana;"><span style="font-style: italic; font-weight: bold;"></span></span><span style="font-size: 10pt; font-family: Verdana;"><span style="font-style: italic; font-weight: bold;"></span></span><span style="font-size: 10pt; font-family: Verdana;"><span style="font-style: italic; font-weight: bold;"></span></span><span style="font-size: 10pt; font-family: Verdana;"><span style="font-style: italic; font-weight: bold;"></span></span><span style="font-size: 10pt; font-family: Verdana;"><span style="font-style: italic; font-weight: bold;"></span></span><span style="font-size: 10pt; font-family: Verdana;"></span><h2 style="background: rgb(51, 102, 255) none repeat scroll 0% 50%; -moz-background-clip: -moz-initial; -moz-background-origin: -moz-initial; -moz-background-inline-policy: -moz-initial;"><a name="License"></a><span style="font-size: 12pt; color: white;">License<o:p></o:p></span></h2><p class="MsoNormal"><span style="font-size: 10pt; font-family: &quot;Verdana&quot;,&quot;sans-serif&quot;; color: black;">Licensed under MCD-ST Image SW License Agreement V2, (the "License"); You may not use this&nbsp;</span><span style="font-size: 10pt; font-family: &quot;Verdana&quot;,&quot;sans-serif&quot;; color: black;">package</span><span style="font-size: 10pt; font-family: &quot;Verdana&quot;,&quot;sans-serif&quot;; color: black;"> except in compliance with the License. You may obtain a copy of the License at:<br><br></span></p><div style="text-align: center;"><span style="font-size: 10pt; font-family: &quot;Verdana&quot;,&quot;sans-serif&quot;; color: black;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <a target="_blank" href="http://www.st.com/software_license_agreement_image_v2"><span style="text-decoration: underline;">http://www.st.com/software_license_agreement_image_v2</span></a><a target="_blank" href="http://www.st.com/software_license_agreement_liberty_v2"></a></span><br><span style="font-size: 10pt; font-family: &quot;Verdana&quot;,&quot;sans-serif&quot;; color: black;"></span></div><span style="font-size: 10pt; font-family: &quot;Verdana&quot;,&quot;sans-serif&quot;; color: black;"><br>Unless
193required by applicable law or agreed to in writing, software
194distributed under the License is distributed on an "AS IS" BASIS, <br>WITHOUT
195WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See
196the License for the specific language governing permissions and
197limitations under the License.</span><b><span style="font-size: 10pt; font-family: Verdana; color: black;"></span></b>
198
199            <div class="MsoNormal" style="text-align: center;" align="center"><span style="color: black;">
200            <hr align="center" size="2" width="100%"></span></div>
201            <p class="MsoNormal" style="margin: 4.5pt 0cm 4.5pt 18pt; text-align: center;" align="center"><span style="font-size: 10pt; font-family: &quot;Verdana&quot;,&quot;sans-serif&quot;; color: black;">For
202    complete documentation on </span><span style="font-size: 10pt; font-family: &quot;Verdana&quot;,&quot;sans-serif&quot;;">STM32<span style="color: black;">
203    Microcontrollers visit </span><u><span style="color: blue;"><a href="http://www.st.com/internet/mcu/family/141.jsp" target="_blank">www.st.com/STM32</a></span></u></span><span style="font-size: 10pt; font-family: Verdana;"><a target="_blank" href="http://www.st.com/internet/mcu/family/141.jsp"><u><span style="color: blue;"></span></u></a></span><span style="font-size: 10pt; font-family: Verdana;"><u><span style="color: blue;"></span></u></span><span style="color: black;"><o:p></o:p></span></p>
204            </td>
205          </tr>
206        </tbody>
207      </table>
208      <p class="MsoNormal"><span style="font-size: 10pt;"><o:p></o:p></span></p>
209      </td>
210    </tr>
211  </tbody>
212</table>
213</div>
214<p class="MsoNormal"><o:p>&nbsp;</o:p></p>
215</div>
216
217</body></html>