Add missing doxygen group terminator to the new CompilerSpecific.h header file.
[pub/USBasp.git] / Demos / Host / LowLevel / AudioOutputHost / AudioOutputHost.c
1 /*
2 LUFA Library
3 Copyright (C) Dean Camera, 2011.
4
5 dean [at] fourwalledcubicle [dot] com
6 www.lufa-lib.org
7 */
8
9 /*
10 Copyright 2011 Dean Camera (dean [at] fourwalledcubicle [dot] com)
11
12 Permission to use, copy, modify, distribute, and sell this
13 software and its documentation for any purpose is hereby granted
14 without fee, provided that the above copyright notice appear in
15 all copies and that both that the copyright notice and this
16 permission notice and warranty disclaimer appear in supporting
17 documentation, and that the name of the author not be used in
18 advertising or publicity pertaining to distribution of the
19 software without specific, written prior permission.
20
21 The author disclaim all warranties with regard to this
22 software, including all implied warranties of merchantability
23 and fitness. In no event shall the author be liable for any
24 special, indirect or consequential damages or any damages
25 whatsoever resulting from loss of use, data or profits, whether
26 in an action of contract, negligence or other tortious action,
27 arising out of or in connection with the use or performance of
28 this software.
29 */
30
31 /** \file
32 *
33 * Main source file for the AudioOutputHost demo. This file contains the main tasks of
34 * the demo and is responsible for the initial application hardware configuration.
35 */
36
37 #include "AudioOutputHost.h"
38
39 /** Main program entry point. This routine configures the hardware required by the application, then
40 * enters a loop to run the application tasks in sequence.
41 */
42 int main(void)
43 {
44 SetupHardware();
45
46 puts_P(PSTR(ESC_FG_CYAN "Audio Output Host Demo running.\r\n" ESC_FG_WHITE));
47
48 LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);
49 sei();
50
51 for (;;)
52 {
53 Audio_Task();
54 USB_USBTask();
55 }
56 }
57
58 /** Configures the board hardware and chip peripherals for the demo's functionality. */
59 void SetupHardware(void)
60 {
61 /* Disable watchdog if enabled by bootloader/fuses */
62 MCUSR &= ~(1 << WDRF);
63 wdt_disable();
64
65 /* Disable clock division */
66 clock_prescale_set(clock_div_1);
67
68 /* Hardware Initialization */
69 Serial_Init(9600, false);
70 Buttons_Init();
71 ADC_Init(ADC_FREE_RUNNING | ADC_PRESCALE_32);
72 ADC_SetupChannel(MIC_IN_ADC_CHANNEL);
73 LEDs_Init();
74 USB_Init();
75
76 /* Create a stdio stream for the serial port for stdin and stdout */
77 Serial_CreateStream(NULL);
78 }
79
80 /** Event handler for the USB_DeviceAttached event. This indicates that a device has been attached to the host, and
81 * starts the library USB task to begin the enumeration and USB management process.
82 */
83 void EVENT_USB_Host_DeviceAttached(void)
84 {
85 puts_P(PSTR(ESC_FG_GREEN "Device Attached.\r\n" ESC_FG_WHITE));
86 LEDs_SetAllLEDs(LEDMASK_USB_ENUMERATING);
87 }
88
89 /** Event handler for the USB_DeviceUnattached event. This indicates that a device has been removed from the host, and
90 * stops the library USB task management process.
91 */
92 void EVENT_USB_Host_DeviceUnattached(void)
93 {
94 puts_P(PSTR(ESC_FG_GREEN "Device Unattached.\r\n" ESC_FG_WHITE));
95 LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);
96 }
97
98 /** Event handler for the USB_DeviceEnumerationComplete event. This indicates that a device has been successfully
99 * enumerated by the host and is now ready to be used by the application.
100 */
101 void EVENT_USB_Host_DeviceEnumerationComplete(void)
102 {
103 LEDs_SetAllLEDs(LEDMASK_USB_READY);
104 }
105
106 /** Event handler for the USB_HostError event. This indicates that a hardware error occurred while in host mode. */
107 void EVENT_USB_Host_HostError(const uint8_t ErrorCode)
108 {
109 USB_Disable();
110
111 printf_P(PSTR(ESC_FG_RED "Host Mode Error\r\n"
112 " -- Error Code %d\r\n" ESC_FG_WHITE), ErrorCode);
113
114 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
115 for(;;);
116 }
117
118 /** Event handler for the USB_DeviceEnumerationFailed event. This indicates that a problem occurred while
119 * enumerating an attached USB device.
120 */
121 void EVENT_USB_Host_DeviceEnumerationFailed(const uint8_t ErrorCode,
122 const uint8_t SubErrorCode)
123 {
124 printf_P(PSTR(ESC_FG_RED "Dev Enum Error\r\n"
125 " -- Error Code %d\r\n"
126 " -- Sub Error Code %d\r\n"
127 " -- In State %d\r\n" ESC_FG_WHITE), ErrorCode, SubErrorCode, USB_HostState);
128
129 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
130 }
131
132 void Audio_Task(void)
133 {
134 uint8_t ErrorCode;
135
136 switch (USB_HostState)
137 {
138 case HOST_STATE_Addressed:
139 puts_P(PSTR("Getting Config Data.\r\n"));
140
141 /* Get and process the configuration descriptor data */
142 if ((ErrorCode = ProcessConfigurationDescriptor()) != SuccessfulConfigRead)
143 {
144 if (ErrorCode == ControlError)
145 puts_P(PSTR(ESC_FG_RED "Control Error (Get Configuration).\r\n"));
146 else
147 puts_P(PSTR(ESC_FG_RED "Invalid Device.\r\n"));
148
149 printf_P(PSTR(" -- Error Code: %d\r\n" ESC_FG_WHITE), ErrorCode);
150
151 /* Indicate error status */
152 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
153
154 /* Wait until USB device disconnected */
155 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
156 break;
157 }
158
159 /* Set the device configuration to the first configuration (rarely do devices use multiple configurations) */
160 if ((ErrorCode = USB_Host_SetDeviceConfiguration(1)) != HOST_SENDCONTROL_Successful)
161 {
162 printf_P(PSTR(ESC_FG_RED "Control Error (Set Configuration).\r\n"
163 " -- Error Code: %d\r\n" ESC_FG_WHITE), ErrorCode);
164
165 /* Indicate error status */
166 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
167
168 /* Wait until USB device disconnected */
169 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
170 break;
171 }
172
173 if ((ErrorCode = USB_Host_SetInterfaceAltSetting(StreamingInterfaceIndex,
174 StreamingInterfaceAltSetting)) != HOST_SENDCONTROL_Successful)
175 {
176 printf_P(PSTR(ESC_FG_RED "Could not set alternative streaming interface setting.\r\n"
177 " -- Error Code: %d\r\n" ESC_FG_WHITE), ErrorCode);
178
179 /* Indicate error status */
180 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
181
182 /* Wait until USB device disconnected */
183 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
184 break;
185 }
186
187 USB_ControlRequest = (USB_Request_Header_t)
188 {
189 .bmRequestType = (REQDIR_HOSTTODEVICE | REQTYPE_CLASS | REQREC_ENDPOINT),
190 .bRequest = AUDIO_REQ_SetCurrent,
191 .wValue = (AUDIO_EPCONTROL_SamplingFreq << 8),
192 .wIndex = StreamingEndpointAddress,
193 .wLength = sizeof(USB_Audio_SampleFreq_t),
194 };
195
196 USB_Audio_SampleFreq_t SampleRate = AUDIO_SAMPLE_FREQ(48000);
197
198 /* Select the control pipe for the request transfer */
199 Pipe_SelectPipe(PIPE_CONTROLPIPE);
200
201 /* Set the sample rate on the streaming interface endpoint */
202 if ((ErrorCode = USB_Host_SendControlRequest(&SampleRate)) != HOST_SENDCONTROL_Successful)
203 {
204 /* Indicate error status */
205 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
206
207 /* Wait until USB device disconnected */
208 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
209 break;
210 }
211
212 /* Sample reload timer initialization */
213 TIMSK0 = (1 << OCIE0A);
214 OCR0A = ((F_CPU / 8 / 48000) - 1);
215 TCCR0A = (1 << WGM01); // CTC mode
216 TCCR0B = (1 << CS01); // Fcpu/8 speed
217
218 puts_P(PSTR("Speaker Enumerated.\r\n"));
219
220 USB_HostState = HOST_STATE_Configured;
221 break;
222 case HOST_STATE_Configured:
223 /* Do nothing - audio stream is handled by the timer interrupt routine */
224 break;
225 }
226 }
227
228 /** ISR to handle the reloading of the endpoint with the next sample. */
229 ISR(TIMER0_COMPA_vect, ISR_BLOCK)
230 {
231 uint8_t PrevPipe = Pipe_GetCurrentPipe();
232
233 Pipe_SelectPipe(AUDIO_DATA_OUT_PIPE);
234 Pipe_Unfreeze();
235
236 /* Check if the current pipe can be written to (device ready for more data) */
237 if (Pipe_IsOUTReady())
238 {
239 int16_t AudioSample;
240
241 #if defined(USE_TEST_TONE)
242 static uint8_t SquareWaveSampleCount;
243 static int16_t CurrentWaveValue;
244
245 /* In test tone mode, generate a square wave at 1/256 of the sample rate */
246 if (SquareWaveSampleCount++ == 0xFF)
247 CurrentWaveValue ^= 0x8000;
248
249 /* Only generate audio if the board button is being pressed */
250 AudioSample = (Buttons_GetStatus() & BUTTONS_BUTTON1) ? CurrentWaveValue : 0;
251 #else
252 /* Audio sample is ADC value scaled to fit the entire range */
253 AudioSample = ((SAMPLE_MAX_RANGE / ADC_MAX_RANGE) * ADC_GetResult());
254
255 #if defined(MICROPHONE_BIASED_TO_HALF_RAIL)
256 /* Microphone is biased to half rail voltage, subtract the bias from the sample value */
257 AudioSample -= (SAMPLE_MAX_RANGE / 2);
258 #endif
259 #endif
260
261 Pipe_Write_16_LE(AudioSample);
262 Pipe_Write_16_LE(AudioSample);
263
264 if (!(Pipe_IsReadWriteAllowed()))
265 Pipe_ClearOUT();
266 }
267
268 Pipe_Freeze();
269 Pipe_SelectPipe(PrevPipe);
270 }