Add missing doxygen group terminator to the new CompilerSpecific.h header file.
[pub/USBasp.git] / Demos / Host / ClassDriver / StillImageHost / StillImageHost.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 StillImageHost demo. This file contains the main tasks of
34 * the demo and is responsible for the initial application hardware configuration.
35 */
36
37 #include "StillImageHost.h"
38
39 /** LUFA Still Image Class driver interface configuration and state information. This structure is
40 * passed to all Still Image 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_SI_Host_t DigitalCamera_SI_Interface =
44 {
45 .Config =
46 {
47 .DataINPipeNumber = 1,
48 .DataINPipeDoubleBank = false,
49
50 .DataOUTPipeNumber = 2,
51 .DataOUTPipeDoubleBank = false,
52
53 .EventsPipeNumber = 3,
54 .EventsPipeDoubleBank = false,
55 },
56 };
57
58
59 /** Main program entry point. This routine configures the hardware required by the application, then
60 * enters a loop to run the application tasks in sequence.
61 */
62 int main(void)
63 {
64 SetupHardware();
65
66 puts_P(PSTR(ESC_FG_CYAN "Still Image Host Demo running.\r\n" ESC_FG_WHITE));
67
68 LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);
69 sei();
70
71 for (;;)
72 {
73 switch (USB_HostState)
74 {
75 case HOST_STATE_Addressed:
76 LEDs_SetAllLEDs(LEDMASK_USB_ENUMERATING);
77
78 uint16_t ConfigDescriptorSize;
79 uint8_t ConfigDescriptorData[512];
80
81 if (USB_Host_GetDeviceConfigDescriptor(1, &ConfigDescriptorSize, ConfigDescriptorData,
82 sizeof(ConfigDescriptorData)) != HOST_GETCONFIG_Successful)
83 {
84 puts_P(PSTR("Error Retrieving Configuration Descriptor.\r\n"));
85 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
86 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
87 break;
88 }
89
90 if (SI_Host_ConfigurePipes(&DigitalCamera_SI_Interface,
91 ConfigDescriptorSize, ConfigDescriptorData) != SI_ENUMERROR_NoError)
92 {
93 puts_P(PSTR("Attached Device Not a Valid Still Image Class Device.\r\n"));
94 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
95 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
96 break;
97 }
98
99 if (USB_Host_SetDeviceConfiguration(1) != HOST_SENDCONTROL_Successful)
100 {
101 puts_P(PSTR("Error Setting Device Configuration.\r\n"));
102 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
103 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
104 break;
105 }
106
107 puts_P(PSTR("Still Image Device Enumerated.\r\n"));
108 LEDs_SetAllLEDs(LEDMASK_USB_READY);
109 USB_HostState = HOST_STATE_Configured;
110 break;
111 case HOST_STATE_Configured:
112 puts_P(PSTR("Opening Session...\r\n"));
113
114 if (SI_Host_OpenSession(&DigitalCamera_SI_Interface) != PIPE_RWSTREAM_NoError)
115 {
116 puts_P(PSTR("Could not open PIMA session.\r\n"));
117 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
118 break;
119 }
120
121 puts_P(PSTR("Turning off Device...\r\n"));
122
123 SI_Host_SendCommand(&DigitalCamera_SI_Interface, 0x1013, 0, NULL);
124 if (SI_Host_ReceiveResponse(&DigitalCamera_SI_Interface))
125 {
126 puts_P(PSTR("Could not turn off device.\r\n"));
127 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
128 break;
129 }
130
131 puts_P(PSTR("Device Off.\r\n"));
132
133 puts_P(PSTR("Closing Session...\r\n"));
134
135 if (SI_Host_CloseSession(&DigitalCamera_SI_Interface) != PIPE_RWSTREAM_NoError)
136 {
137 puts_P(PSTR("Could not close PIMA session.\r\n"));
138 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
139 break;
140 }
141
142 LEDs_SetAllLEDs(LEDMASK_USB_READY);
143 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
144 break;
145 }
146
147 SI_Host_USBTask(&DigitalCamera_SI_Interface);
148 USB_USBTask();
149 }
150 }
151
152 /** Configures the board hardware and chip peripherals for the demo's functionality. */
153 void SetupHardware(void)
154 {
155 /* Disable watchdog if enabled by bootloader/fuses */
156 MCUSR &= ~(1 << WDRF);
157 wdt_disable();
158
159 /* Disable clock division */
160 clock_prescale_set(clock_div_1);
161
162 /* Hardware Initialization */
163 Serial_Init(9600, false);
164 LEDs_Init();
165 USB_Init();
166
167 /* Create a stdio stream for the serial port for stdin and stdout */
168 Serial_CreateStream(NULL);
169 }
170
171 /** Event handler for the USB_DeviceAttached event. This indicates that a device has been attached to the host, and
172 * starts the library USB task to begin the enumeration and USB management process.
173 */
174 void EVENT_USB_Host_DeviceAttached(void)
175 {
176 puts_P(PSTR("Device Attached.\r\n"));
177 LEDs_SetAllLEDs(LEDMASK_USB_ENUMERATING);
178 }
179
180 /** Event handler for the USB_DeviceUnattached event. This indicates that a device has been removed from the host, and
181 * stops the library USB task management process.
182 */
183 void EVENT_USB_Host_DeviceUnattached(void)
184 {
185 puts_P(PSTR("\r\nDevice Unattached.\r\n"));
186 LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);
187 }
188
189 /** Event handler for the USB_DeviceEnumerationComplete event. This indicates that a device has been successfully
190 * enumerated by the host and is now ready to be used by the application.
191 */
192 void EVENT_USB_Host_DeviceEnumerationComplete(void)
193 {
194 LEDs_SetAllLEDs(LEDMASK_USB_READY);
195 }
196
197 /** Event handler for the USB_HostError event. This indicates that a hardware error occurred while in host mode. */
198 void EVENT_USB_Host_HostError(const uint8_t ErrorCode)
199 {
200 USB_Disable();
201
202 printf_P(PSTR(ESC_FG_RED "Host Mode Error\r\n"
203 " -- Error Code %d\r\n" ESC_FG_WHITE), ErrorCode);
204
205 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
206 for(;;);
207 }
208
209 /** Event handler for the USB_DeviceEnumerationFailed event. This indicates that a problem occurred while
210 * enumerating an attached USB device.
211 */
212 void EVENT_USB_Host_DeviceEnumerationFailed(const uint8_t ErrorCode,
213 const uint8_t SubErrorCode)
214 {
215 printf_P(PSTR(ESC_FG_RED "Dev Enum Error\r\n"
216 " -- Error Code %d\r\n"
217 " -- Sub Error Code %d\r\n"
218 " -- In State %d\r\n" ESC_FG_WHITE), ErrorCode, SubErrorCode, USB_HostState);
219
220 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
221 }
222