PaulStoffregen
před 10 roky
2 změnil soubory, kde provedl 187 přidání a 1 odebrání
+ 1
- 0
gui/index.html
Zobrazit soubor
| @@ -37,6 +37,7 @@ tr.odd {background-color:#F0F0F0} | |||
| tr.even {background-color:#E0E0E0} | |||
| p.func {padding-bottom:0; margin:0px} | |||
| p.desc {padding-left:2em; margin:0px; padding-top:0.2em; padding-bottom:0.8em; font-size:0.75em} | |||
| p.exam {padding-left:2em; text-indent:-1.2em; margin:0px; padding-top:0; padding-bottom:0.5em; font-size:0.75em; font-weight:bold} | |||
| pre.desc {padding-left:3em; margin:0px; padding-top:0em; padding-bottom:0.8em; font-size:0.75em; | |||
| background-color:#FFFFFF; border:0px; line-height:100%; | |||
| } | |||
+ 186
- 1
gui/list.html
Zobrazit soubor
| @@ -44,6 +44,25 @@ | |||
| <p>Audio from | |||
| master mode I2S may be used in the same project as ADC, DAC and | |||
| PWM signals, because all remain in sync to Teensy's timing</p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > HardwareTesting > PassThroughStereo | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Recorder | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Analysis > PeakMeterStereo | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Analysis > FFT | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Analysis > SpectrumAnalyzerBasic | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Effects > Chorus | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Effects > Flange | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Effects > Filter | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Effects > Filter_FIR | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>Normally, this object is used with the Audio Shield, which | |||
| is controlled separately by the "sgtl5000" object.</p> | |||
| @@ -92,6 +111,9 @@ | |||
| <tr class=odd><td align=center>13</td><td>RX</td><td>Input</td></tr> | |||
| <tr class=odd><td align=center>23</td><td>LRCLK</td><td>Input</td></tr> | |||
| </table> | |||
| <!--<h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > | |||
| </p>--> | |||
| <h3>Notes</h3> | |||
| <p>Slave mode I2S <b>should not used in the same project as ADC, DAC and | |||
| PWM</b> signals. Differences in timing between the I2S device and | |||
| @@ -136,6 +158,13 @@ | |||
| <p>Pin A2 is used for audio input. This circuitry is recommended.</p> | |||
| <p align=center><img src="adccircuit.png"></p> | |||
| <p>Signal range is 0 to 1.2V</p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > HardwareTesting > PassThroughMono | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Analysis > PeakMeterMono | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Analysis > DialTone_7segment | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>Algorithm for automatic DC bias tracking</p> | |||
| <p>Noise due to high source impedance</p> | |||
| @@ -191,6 +220,20 @@ | |||
| <p>Audio from | |||
| master mode I2S may be used in the same project as ADC, DAC and | |||
| PWM signals, because all remain in sync to Teensy's timing</p> | |||
| <h3>Examples</h3> | |||
| <p>Nearly all the examples use this object. Here are some of the highlights:</p> | |||
| <p class=exam>File > Examples > Audio > HardwareTesting > PassThroughStereo | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > SamplePlayer | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Recorder | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > WavFilePlayer | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Effects > Chorus | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Synthesis > PlaySynthMusic | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>Normally, this object is used with the Audio Shield, which | |||
| is controlled separately by the "sgtl5000" object.</p> | |||
| @@ -238,6 +281,9 @@ | |||
| <tr class=odd><td align=center>22</td><td>TX</td><td>Output</td></tr> | |||
| <tr class=odd><td align=center>23</td><td>LRCLK</td><td>Input</td></tr> | |||
| </table> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > HardwareTesting > WM8731MikroSine | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>Slave mode I2S <b>should not used in the same project as ADC, DAC and | |||
| PWM</b> signals. Differences in timing between the I2S device and | |||
| @@ -284,6 +330,11 @@ | |||
| <p>Signal range is 0 to 1.2V</p> | |||
| <p>Most applications require at least a 10µF DC-blocking capacitor.</p> | |||
| <p>TODO: photo of Teensy 3.1 with 10µF capacitor and 3.5mm jack.</p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > HardwareTesting > PassThroughMono | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > SamplePlayer | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>The output rate is 44.1 kHz (no oversampling). Ultrasonic noise present if | |||
| not filtered. This may not | |||
| @@ -332,6 +383,9 @@ | |||
| <p>A plastic film (Polypropylene, Polyethylene, Polyester, etc) or | |||
| C0G/NPO ceramic capacitor should be used for filtering. Low | |||
| quality ceramic (X7R, Y5V, Z5U, etc) can cause signal distortion.</p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > HardwareTesting > PassThroughMono | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>This object only works properly when Tools > CPU_Speed is set to | |||
| 48 or 96 MHz. Other speeds aren't supported and will likely fail | |||
| @@ -385,6 +439,17 @@ | |||
| off completely. Between 0 to 1.0 attenuates the signal, and above | |||
| 1.0 amplifies it. All 4 channels have separate settings. | |||
| </p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > SamplePlayer | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Synthesis > PlaySynthMusic | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Analysis > SpectrumAnalyzerBasic | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Analysis > DialTone_Serial | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > MemoryAndCpuUsage | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>Signal clipping can occur when any channel has gain greater than 1.0, | |||
| or when multiple signals add together to greater than 1.0.</p> | |||
| @@ -446,6 +511,9 @@ | |||
| in milliseconds. When not playing, the return from this function | |||
| is undefined. | |||
| </p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > SamplePlayer | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>TODO: supported sample rates: 11.025, 22.05, 44.1</p> | |||
| <p>TODO: ulaw vs uncompressed encoding</p> | |||
| @@ -502,6 +570,9 @@ | |||
| in milliseconds. When not playing, the return from this function | |||
| is undefined. | |||
| </p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > WavFilePlayer | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>Only 16 bit PCM, 44100 Hz WAV files are supported. When mono | |||
| files are played, both output ports transmit a copy of the | |||
| @@ -573,6 +644,9 @@ | |||
| in milliseconds. When not playing, the return from this function | |||
| is undefined. | |||
| </p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > Recorder | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>The data file must be RAW 16 bit signed integers in LSB-first format. | |||
| </p> | |||
| @@ -631,6 +705,11 @@ | |||
| <p class=func><span class=keyword>playBuffer</span>();</p> | |||
| <p class=desc>Transmit the buffer previously obtained from getBuffer(). | |||
| </p> | |||
| <h3>Examples</h3> | |||
| <p><a href="http://community.arm.com/groups/embedded/blog/2014/05/23/led-video-panel-at-maker-faire-2014" target="_blank">4320 LED Video+Sound Project</a> | |||
| </p> | |||
| <!--<p class=exam>File > Examples > Audio > | |||
| </p>--> | |||
| <h3>Notes</h3> | |||
| <p>TODO: many caveats....</p> | |||
| <p> | |||
| @@ -691,6 +770,9 @@ | |||
| <p class=desc>Stop capturing incoming audio into the queue. Data already | |||
| captured remains in the queue and may be read with readBuffer(). | |||
| </p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > Recorder | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p> | |||
| Up to 52 packets may be queued by this object, which allows approximately | |||
| @@ -747,6 +829,13 @@ The actual packets are taken | |||
| <a href="http://www.pjrc.com/teensy/td_libs_AudioProcessorUsage.html" target="_blank">AudioNoInterrupts()</a> | |||
| should be used to guarantee all new settings take effect together. | |||
| </p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > MemoryAndCpuUsage | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Analysis > DialTone_Serial | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Analysis > FFT | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p></p> | |||
| </script> | |||
| @@ -798,6 +887,9 @@ The actual packets are taken | |||
| <a href="http://www.pjrc.com/teensy/td_libs_AudioProcessorUsage.html" target="_blank">AudioNoInterrupts()</a> | |||
| should be used to guarantee all new settings take effect together. | |||
| </p> | |||
| <!--<h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > | |||
| </p>--> | |||
| <h3>Notes</h3> | |||
| <p></p> | |||
| </script> | |||
| @@ -860,6 +952,13 @@ The actual packets are taken | |||
| limit your waveform data. Someday, "maxFreq" will be used to | |||
| do this automatically. | |||
| </p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > Synthesis > PlaySynthMusic | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Synthesis > pulseWidth | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > HardwareTesting > WM8731MikroSine | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>Supported Waveforms:<br> | |||
| <ul> | |||
| @@ -907,6 +1006,9 @@ The actual packets are taken | |||
| <p class=func><span class=keyword>isPlaying</span>();</p> | |||
| <p class=desc>Returns true (non-zero) while the output is active. | |||
| </p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > HardwareTesting > ToneSweep | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>Uses excessive CPU time</p> | |||
| </script> | |||
| @@ -949,6 +1051,9 @@ The actual packets are taken | |||
| be specified, but periods longer than 1 second may be automatically | |||
| shortened for small level changes, due to numerical precision limits. | |||
| </p> | |||
| <!--<h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > | |||
| </p>--> | |||
| <h3>Notes</h3> | |||
| <p>Of course, the term "DC", for Direct Current, doesn't properly apply | |||
| to a pure digital stream of numerical values. But the term is widely | |||
| @@ -990,6 +1095,9 @@ The actual packets are taken | |||
| The default is off. Noise is generated only after setting | |||
| to a non-zero level. | |||
| </p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>Setting the amplitude to zero causes this object to stop using | |||
| CPU time to generate random numbers. | |||
| @@ -1032,6 +1140,9 @@ The actual packets are taken | |||
| The default is off. Noise is generated only after setting | |||
| to a non-zero level. | |||
| </p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > MemoryAndCpuUsage | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>Setting the amplitude to zero causes this object to stop using | |||
| CPU time. CPU usage is approx 3% on Teensy 3.1. | |||
| @@ -1080,6 +1191,9 @@ The actual packets are taken | |||
| <p class=desc>Begin decreasing the audio level, to reach 0 (no output) | |||
| after "milliseconds" time. | |||
| </p> | |||
| <!--<h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > | |||
| </p>--> | |||
| <h3>Notes</h3> | |||
| <p>Cross fading can be built with 2 fade objects fed into a mixer. | |||
| When one fade object is off (fully faded out) and the other on | |||
| @@ -1148,6 +1262,9 @@ The actual packets are taken | |||
| <p class=func><span class=keyword>modify</span>(n_chorus);</p> | |||
| <p class=desc>Alters the number of voices in a running chorus (previously started with begin). | |||
| </p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > Effects > Chorus | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>The longer the length of the chorus, the more memory blocks are used.</p> | |||
| </script> | |||
| @@ -1203,6 +1320,9 @@ The actual packets are taken | |||
| <p class=desc>Alters the parameters in a running flanger (previously started with begin). | |||
| </p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > Effects > Flange | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>The longer the length of the delay buffer, the more memory blocks are used.</p> | |||
| <p>Try these settings:<br> | |||
| @@ -1281,6 +1401,13 @@ double s_freq = .0625;</p> | |||
| <p class=func><span class=keyword>release</span>(milliseconds);</p> | |||
| <p class=desc>Set the release time. The default is 30 millisecond. | |||
| </p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > Synthesis > PlaySynthMusic | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Synthesis > pulseWidth | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > MemoryAndCpuUsage | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>To achieve the more common ADSR shape, simply | |||
| set delay and hold to zero.</p> | |||
| @@ -1327,6 +1454,9 @@ double s_freq = .0625;</p> | |||
| This object simply multiplies the 2 signals to create | |||
| a continuous output | |||
| </p> | |||
| <!--<h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > | |||
| </p>--> | |||
| <h3>Notes</h3> | |||
| <p> | |||
| </p> | |||
| @@ -1382,6 +1512,9 @@ double s_freq = .0625;</p> | |||
| silent. If this channel is the longest delay, memory usage is | |||
| automatically reduced to accomodate only the remaining channels used. | |||
| </p> | |||
| <!--<h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > | |||
| </p>--> | |||
| <h3>Notes</h3> | |||
| <p>Memory for the delayed signal is take from the memory pool allocated by | |||
| <a href="http://www.pjrc.com/teensy/td_libs_AudioConnection.html" target="_blank">AudioMemory()</a>. | |||
| @@ -1450,6 +1583,9 @@ double s_freq = .0625;</p> | |||
| should be type double. Alternately, it may be type int, where 1.0 is | |||
| represented with 1073741824 (2<sup>30</sup>). | |||
| </p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > Effects > Filter | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>Filters can with gain must have their input signals attenuated, so the | |||
| signal does not exceed 1.0. | |||
| @@ -1506,6 +1642,9 @@ double s_freq = .0625;</p> | |||
| <p class=func><span class=keyword>end</span>();</p> | |||
| <p class=desc>Turn the filter off. | |||
| </p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > Effects > Filter_FIR | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>FIR filters requires more CPU time than Biquad (IIR), but they can | |||
| implement filters with better phase response. | |||
| @@ -1576,6 +1715,9 @@ double s_freq = .0625;</p> | |||
| shift the filter frequency up 2.5 octaves, and a full scale negative | |||
| signal will shift it down 2.5 octaves. | |||
| </p> | |||
| <!--<h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > | |||
| </p>--> | |||
| <h3>Notes</h3> | |||
| <p> | |||
| When controlled by a signal, the equation for the filter | |||
| @@ -1627,6 +1769,11 @@ double s_freq = .0625;</p> | |||
| <p class=desc>Read the highest peak value since the last read. | |||
| Return is from 0.0 to 1.0. | |||
| </p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > Analysis > PeakMeterMono | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Analysis > PeakMeterStereo | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p></p> | |||
| </script> | |||
| @@ -1684,6 +1831,9 @@ double s_freq = .0625;</p> | |||
| signals that are not exact integer division of the sample rate. | |||
| </p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > MemoryAndCpuUsage | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>The raw 16 bit output data bins may be access with myFFT.output[num], where | |||
| num is 0 to 127.</p> | |||
| @@ -1756,6 +1906,11 @@ double s_freq = .0625;</p> | |||
| should be used for all non-periodic (music) signals, and all periodic | |||
| signals that are not exact integer division of the sample rate. | |||
| </p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > Analysis > FFT | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Analysis > SpectrumAnalyzerBasic | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>The raw 16 bit output data bins may be access with myFFT.output[num], where | |||
| num is 0 to 511.</p> | |||
| @@ -1832,6 +1987,11 @@ double s_freq = .0625;</p> | |||
| <p class=desc>By testing the object as a boolean value, you can respond | |||
| to detection of a tone. | |||
| </p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > Analysis > DialTone_Serial | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > Analysis > DialTone_7segment | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>Low frequency detection has trouble with numerical precision. | |||
| Works really well for all 8 DTMF frequencies, but fails for | |||
| @@ -1885,6 +2045,9 @@ double s_freq = .0625;</p> | |||
| <p class=func><span class=keyword>length</span>(samples);</p> | |||
| <p class=desc>blah blah blah blah | |||
| </p> | |||
| <!--<h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > | |||
| </p>--> | |||
| <h3>Notes</h3> | |||
| <p>This object doesn't work very well and probably should not be used.</p> | |||
| </script> | |||
| @@ -1909,7 +2072,7 @@ double s_freq = .0625;</p> | |||
| </script> | |||
| <script type="text/x-red" data-help-name="AudioControlSGTL5000"> | |||
| <h3>Summary</h3> | |||
| <p>Control the SGTL5000 chip on the audio shield | |||
| <p>Control the SGTL5000 chip on the | |||
| <a href="http://www.pjrc.com/store/teensy3_audio.html" target="_blank">audio shield</a>. | |||
| SGTL5000 is always used in slave mode, where Teensy controls | |||
| all I2S timing. | |||
| @@ -2209,6 +2372,22 @@ value frequency | |||
| <p class=desc>Enables zero or more of the already enabled parametric filters. | |||
| </p> | |||
| <h3>Examples</h3> | |||
| <p>Nearly all of the library's examples use this object. These | |||
| examples demonstrate its special features. | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > HardwareTesting > PassThroughStereo | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > HardwareTesting > SGTL5000 > dap_bass_enhance | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > HardwareTesting > SGTL5000 > dap_avc_agc | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > HardwareTesting > SGTL5000 > balanceDAC | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > HardwareTesting > SGTL5000 > balanceHP | |||
| </p> | |||
| <p class=exam>File > Examples > Audio > HardwareTesting > SGTL5000 > CalcBiquadToneControlDAP | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p>TODO: add example with rock/classical/speech presets, where rock uses bass boost | |||
| and surround enhancement while speech uses bandpass filtering and auto volume control | |||
| @@ -2261,6 +2440,9 @@ value frequency | |||
| <p class=func><span class=keyword>inputSelect</span>(input);</p> | |||
| <p class=desc>not implemented | |||
| </p> | |||
| <!--<h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > | |||
| </p>--> | |||
| <h3>Notes</h3> | |||
| <p></p> | |||
| </script> | |||
| @@ -2308,6 +2490,9 @@ value frequency | |||
| <p class=func><span class=keyword>inputSelect</span>(input);</p> | |||
| <p class=desc>not implemented | |||
| </p> | |||
| <h3>Examples</h3> | |||
| <p class=exam>File > Examples > Audio > HardwareTesting > WM8731MikroSine | |||
| </p> | |||
| <h3>Notes</h3> | |||
| <p></p> | |||
| </script> | |||
Načítá se…