Minor documentation improvements.
[pub/USBasp.git] / Demos / Host / ClassDriver / AudioInputHost / AudioInputHost.c
1 /*
2 LUFA Library
3 Copyright (C) Dean Camera, 2012.
4
5 dean [at] fourwalledcubicle [dot] com
6 www.lufa-lib.org
7 */
8
9 /*
10 Copyright 2012 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 disclaims 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 AudioInputHost demo. This file contains the main tasks of
34 * the demo and is responsible for the initial application hardware configuration.
35 */
36
37 #include "AudioInputHost.h"
38
39 /** LUFA Audio Class driver interface configuration and state information. This structure is
40 * passed to all Audio Class driver functions, so that multiple instances of the same class
41 * within a device can be differentiated from one another.
42 */
43 USB_ClassInfo_Audio_Host_t Microphone_Audio_Interface =
44 {
45 .Config =
46 {
47 .DataINPipe =
48 {
49 .Address = (PIPE_DIR_IN | 1),
50 },
51 },
52 };
53
54
55 /** Main program entry point. This routine configures the hardware required by the application, then
56 * enters a loop to run the application tasks in sequence.
57 */
58 int main(void)
59 {
60 SetupHardware();
61
62 puts_P(PSTR(ESC_FG_CYAN "Audio Input Host Demo running.\r\n" ESC_FG_WHITE));
63
64 LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);
65 GlobalInterruptEnable();
66
67 for (;;)
68 {
69 Audio_Host_USBTask(&Microphone_Audio_Interface);
70 USB_USBTask();
71 }
72 }
73
74 /** ISR to handle the reloading of the PWM timer with the next sample. */
75 ISR(TIMER0_COMPA_vect, ISR_BLOCK)
76 {
77 uint8_t PrevPipe = Pipe_GetCurrentPipe();
78
79 /* Check that the USB bus is ready for the next sample to read */
80 if (Audio_Host_IsSampleReceived(&Microphone_Audio_Interface))
81 {
82 /* Retrieve the signed 16-bit audio sample, convert to 8-bit */
83 int8_t Sample_8Bit = (Audio_Host_ReadSample16(&Microphone_Audio_Interface) >> 8);
84
85 /* Load the sample into the PWM timer channel */
86 OCR3A = (Sample_8Bit ^ (1 << 7));
87
88 uint8_t LEDMask = LEDS_NO_LEDS;
89
90 /* Turn on LEDs as the sample amplitude increases */
91 if (Sample_8Bit > 16)
92 LEDMask = (LEDS_LED1 | LEDS_LED2 | LEDS_LED3 | LEDS_LED4);
93 else if (Sample_8Bit > 8)
94 LEDMask = (LEDS_LED1 | LEDS_LED2 | LEDS_LED3);
95 else if (Sample_8Bit > 4)
96 LEDMask = (LEDS_LED1 | LEDS_LED2);
97 else if (Sample_8Bit > 2)
98 LEDMask = (LEDS_LED1);
99
100 LEDs_SetAllLEDs(LEDMask);
101 }
102
103 Pipe_SelectPipe(PrevPipe);
104 }
105
106 /** Configures the board hardware and chip peripherals for the demo's functionality. */
107 void SetupHardware(void)
108 {
109 /* Disable watchdog if enabled by bootloader/fuses */
110 MCUSR &= ~(1 << WDRF);
111 wdt_disable();
112
113 /* Disable clock division */
114 clock_prescale_set(clock_div_1);
115
116 /* Hardware Initialization */
117 Serial_Init(9600, false);
118 LEDs_Init();
119 USB_Init();
120
121 /* Create a stdio stream for the serial port for stdin and stdout */
122 Serial_CreateStream(NULL);
123 }
124
125 /** Event handler for the USB_DeviceAttached event. This indicates that a device has been attached to the host, and
126 * starts the library USB task to begin the enumeration and USB management process.
127 */
128 void EVENT_USB_Host_DeviceAttached(void)
129 {
130 puts_P(PSTR("Device Attached.\r\n"));
131 LEDs_SetAllLEDs(LEDMASK_USB_ENUMERATING);
132 }
133
134 /** Event handler for the USB_DeviceUnattached event. This indicates that a device has been removed from the host, and
135 * stops the library USB task management process.
136 */
137 void EVENT_USB_Host_DeviceUnattached(void)
138 {
139 puts_P(PSTR("\r\nDevice Unattached.\r\n"));
140 LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);
141 }
142
143 /** Event handler for the USB_DeviceEnumerationComplete event. This indicates that a device has been successfully
144 * enumerated by the host and is now ready to be used by the application.
145 */
146 void EVENT_USB_Host_DeviceEnumerationComplete(void)
147 {
148 LEDs_SetAllLEDs(LEDMASK_USB_ENUMERATING);
149
150 uint16_t ConfigDescriptorSize;
151 uint8_t ConfigDescriptorData[512];
152
153 if (USB_Host_GetDeviceConfigDescriptor(1, &ConfigDescriptorSize, ConfigDescriptorData,
154 sizeof(ConfigDescriptorData)) != HOST_GETCONFIG_Successful)
155 {
156 puts_P(PSTR("Error Retrieving Configuration Descriptor.\r\n"));
157 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
158 return;
159 }
160
161 if (Audio_Host_ConfigurePipes(&Microphone_Audio_Interface,
162 ConfigDescriptorSize, ConfigDescriptorData) != AUDIO_ENUMERROR_NoError)
163 {
164 puts_P(PSTR("Attached Device Not a Valid Audio Input Device.\r\n"));
165 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
166 return;
167 }
168
169 if (USB_Host_SetDeviceConfiguration(1) != HOST_SENDCONTROL_Successful)
170 {
171 puts_P(PSTR("Error Setting Device Configuration.\r\n"));
172 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
173 return;
174 }
175
176 if (Audio_Host_StartStopStreaming(&Microphone_Audio_Interface, true) != HOST_SENDCONTROL_Successful)
177 {
178 puts_P(PSTR("Error Enabling Audio Stream.\r\n"));
179 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
180 USB_Host_SetDeviceConfiguration(0);
181 return;
182 }
183
184 USB_Audio_SampleFreq_t SampleRate = AUDIO_SAMPLE_FREQ(48000);
185 if (Audio_Host_GetSetEndpointProperty(&Microphone_Audio_Interface, Microphone_Audio_Interface.Config.DataINPipe.Address,
186 AUDIO_REQ_SetCurrent, AUDIO_EPCONTROL_SamplingFreq,
187 sizeof(SampleRate), &SampleRate) != HOST_SENDCONTROL_Successful)
188 {
189 puts_P(PSTR("Error Setting Audio Sampling Frequency.\r\n"));
190 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
191 USB_Host_SetDeviceConfiguration(0);
192 return;
193 }
194
195 /* Sample reload timer initialization */
196 TIMSK0 = (1 << OCIE0A);
197 OCR0A = ((F_CPU / 8 / 48000) - 1);
198 TCCR0A = (1 << WGM01); // CTC mode
199 TCCR0B = (1 << CS01); // Fcpu/8 speed
200
201 /* Set speaker as output */
202 DDRC |= (1 << 6);
203
204 /* PWM speaker timer initialization */
205 TCCR3A = ((1 << WGM30) | (1 << COM3A1) | (1 << COM3A0)); // Set on match, clear on TOP
206 TCCR3B = ((1 << WGM32) | (1 << CS30)); // Fast 8-Bit PWM, F_CPU speed
207
208 puts_P(PSTR("Audio Device Enumerated.\r\n"));
209 LEDs_SetAllLEDs(LEDMASK_USB_READY);
210 }
211
212 /** Event handler for the USB_HostError event. This indicates that a hardware error occurred while in host mode. */
213 void EVENT_USB_Host_HostError(const uint8_t ErrorCode)
214 {
215 USB_Disable();
216
217 printf_P(PSTR(ESC_FG_RED "Host Mode Error\r\n"
218 " -- Error Code %d\r\n" ESC_FG_WHITE), ErrorCode);
219
220 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
221 for(;;);
222 }
223
224 /** Event handler for the USB_DeviceEnumerationFailed event. This indicates that a problem occurred while
225 * enumerating an attached USB device.
226 */
227 void EVENT_USB_Host_DeviceEnumerationFailed(const uint8_t ErrorCode,
228 const uint8_t SubErrorCode)
229 {
230 printf_P(PSTR(ESC_FG_RED "Dev Enum Error\r\n"
231 " -- Error Code %d\r\n"
232 " -- Sub Error Code %d\r\n"
233 " -- In State %d\r\n" ESC_FG_WHITE), ErrorCode, SubErrorCode, USB_HostState);
234
235 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
236 }
237