AudioOutput.txt 3.21 KB
Newer Older
1
2
3
4
5
6
7
/** \file
 *
 *  This file contains special DoxyGen information for the generation of the main page and other special
 *  documentation pages. It is not a project source file.
 */
 
/** \mainpage Audio Output Device Demo
8
9
10
11
12
13
14
15
16
17
 *
 *  \section SSec_Compat Demo Compatibility:
 *
 *  The following table indicates what microcontrollers are compatible with this demo.
 *
 *  - AT90USB1287
 *  - AT90USB1286
 *  - AT90USB647
 *  - AT90USB646
 *  - ATMEGA32U6
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
 *
 *  \section SSec_Info USB Information:
 *
 *  The following table gives a rundown of the USB utilization of this demo.
 *
 *  <table>
 *   <tr>
 *    <td><b>USB Mode:</b></td>
 *    <td>Device</td>
 *   </tr>
 *   <tr>
 *    <td><b>USB Class:</b></td>
 *    <td>Audio Class</td>
 *   </tr>
 *   <tr> 
 *    <td><b>USB Subclass:</b></td>
 *    <td>Standard Audio Device</td>
 *   </tr>
 *   <tr>
 *    <td><b>Relevant Standards:</b></td>
 *    <td>USBIF Audio Class Specification</td>
 *    <td>USBIF Audio Class Terminal Types Specification</td>
 *    <td>USBIF Audio Data Formats Specification</td>
 *   </tr>
 *   <tr>
 *    <td><b>Usable Speeds:</b></td>
 *    <td>Full Speed Mode</td>
 *   </tr>
 *  </table>
 *
 *  \section SSec_Description Project Description: 
 *
50
51
52
53
54
 *  Audio demonstration application. This gives a simple reference
 *  application for implementing a USB Audio Output device using the
 *  basic USB Audio drivers in all modern OSes (i.e. no special drivers
 *  required).
 *  
55
 *  On start-up the system will automatically enumerate and function
56
57
58
59
60
 *  as a USB speaker. Outgoing audio will output in 8-bit PWM onto
 *  the timer 3 output compare channel A for AUDIO_OUT_MONO mode, on
 *  timer 3 channels A and B for AUDIO_OUT_STEREO and on PORTC as a signed
 *  mono sample for AUDIO_OUT_PORTC. Audio output will also be indicated on
 *  the board LEDs in all modes. Decouple audio outputs with a capacitor and
61
62
63
64
 *  attach to a speaker to hear the audio.
 *  
 *  Under Windows, if a driver request dialogue pops up, select the option
 *  to automatically install the appropriate drivers.
65
66
67
68
 *
 *  \section SSec_Options Project Options
 *
 *  The following defines can be found in this demo, which can control the demo behaviour when defined, or changed in value.
69
70
71
 *
 *  <table>
 *   <tr>
72
73
74
 *    <td><b>Define Name:</b></td>
 *    <td><b>Location:</b></td>
 *    <td><b>Description:</b></td>
75
76
 *   </tr>
 *   <tr>
77
78
79
 *    <td>AUDIO_OUT_STEREO</td>
 *    <td>Makefile CDEFS</td>
 *    <td>When defined, this outputs the audio samples in stereo to the timer output pins of the microcontroller.</td>
80
 *   </tr>
81
82
83
84
 *   <tr>
 *    <td>AUDIO_OUT_MONO</td>
 *    <td>Makefile CDEFS</td>
 *    <td>When defined, this outputs the audio samples in mono to the timer output pin of the microcontroller.</td>
85
86
 *   </tr>
 *   <tr>
87
88
89
90
 *    <td>AUDIO_OUT_PORTC</td>
 *    <td>Makefile CDEFS</td>
 *    <td>When defined, this outputs the audio samples in mono to port C of the microcontroller, for connection to an
 *        external DAC.</td>
91
 *   </tr>
92
93
94
95
96
 *   <tr>
 *    <td>AUDIO_SAMPLE_FREQUENCY</td>
 *    <td>Descriptors.h</td>
 *    <td>Gives the audio sample rate per channel for the audio stream, in Hz.</td>
 *   </tr>
97
 *  </table>
98
 */