Fix MIT license language to make its intent clearer.
[pub/USBasp.git] / Demos / Host / ClassDriver / StillImageHost / StillImageHost.c
1 /*
2 LUFA Library
3 Copyright (C) Dean Camera, 2009.
4
5 dean [at] fourwalledcubicle [dot] com
6 www.fourwalledcubicle.com
7 */
8
9 /*
10 Copyright 2009 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 /** Main program entry point. This routine configures the hardware required by the application, then
59 * enters a loop to run the application tasks in sequence.
60 */
61 int main(void)
62 {
63 SetupHardware();
64
65 puts_P(PSTR(ESC_FG_CYAN "Still Image Host Demo running.\r\n" ESC_FG_WHITE));
66
67 LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);
68
69 for (;;)
70 {
71 switch (USB_HostState)
72 {
73 case HOST_STATE_Addressed:
74 LEDs_SetAllLEDs(LEDMASK_USB_ENUMERATING);
75
76 uint16_t ConfigDescriptorSize;
77 uint8_t ConfigDescriptorData[512];
78
79 if (USB_Host_GetDeviceConfigDescriptor(1, &ConfigDescriptorSize, ConfigDescriptorData,
80 sizeof(ConfigDescriptorData)) != HOST_GETCONFIG_Successful)
81 {
82 printf("Error Retrieving Configuration Descriptor.\r\n");
83 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
84 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
85 break;
86 }
87
88 if (SImage_Host_ConfigurePipes(&DigitalCamera_SI_Interface,
89 ConfigDescriptorSize, ConfigDescriptorData) != SI_ENUMERROR_NoError)
90 {
91 printf("Attached Device Not a Valid CDC Class Device.\r\n");
92 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
93 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
94 break;
95 }
96
97 if (USB_Host_SetDeviceConfiguration(1) != HOST_SENDCONTROL_Successful)
98 {
99 printf("Error Setting Device Configuration.\r\n");
100 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
101 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
102 break;
103 }
104
105 printf("Still Image Device Enumerated.\r\n");
106 USB_HostState = HOST_STATE_Configured;
107 break;
108 case HOST_STATE_Configured:
109 printf("Opening Session...\r\n");
110
111 if (SImage_Host_OpenSession(&DigitalCamera_SI_Interface) != PIPE_RWSTREAM_NoError)
112 {
113 printf("Could not open PIMA session.\r\n");
114 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
115 break;
116 }
117
118 printf("Turning off Device...\r\n");
119
120 SImage_Host_SendCommand(&DigitalCamera_SI_Interface, 0x1013, 0, NULL);
121 if (SImage_Host_ReceiveResponse(&DigitalCamera_SI_Interface))
122 {
123 printf("Could not turn off device.\r\n");
124 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
125 break;
126 }
127
128 printf("Device Off.\r\n");
129
130 printf("Closing Session...\r\n");
131
132 if (SImage_Host_CloseSession(&DigitalCamera_SI_Interface) != PIPE_RWSTREAM_NoError)
133 {
134 printf("Could not close PIMA session.\r\n");
135 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
136 break;
137 }
138
139 LEDs_SetAllLEDs(LEDMASK_USB_READY);
140 USB_HostState = HOST_STATE_WaitForDeviceRemoval;
141 break;
142 }
143
144 SImage_Host_USBTask(&DigitalCamera_SI_Interface);
145 USB_USBTask();
146 }
147 }
148
149 /** Configures the board hardware and chip peripherals for the demo's functionality. */
150 void SetupHardware(void)
151 {
152 /* Disable watchdog if enabled by bootloader/fuses */
153 MCUSR &= ~(1 << WDRF);
154 wdt_disable();
155
156 /* Disable clock division */
157 clock_prescale_set(clock_div_1);
158
159 /* Hardware Initialization */
160 SerialStream_Init(9600, false);
161 LEDs_Init();
162 USB_Init();
163 }
164
165 /** Event handler for the USB_DeviceAttached event. This indicates that a device has been attached to the host, and
166 * starts the library USB task to begin the enumeration and USB management process.
167 */
168 void EVENT_USB_Host_DeviceAttached(void)
169 {
170 puts_P(PSTR("Device Attached.\r\n"));
171 LEDs_SetAllLEDs(LEDMASK_USB_ENUMERATING);
172 }
173
174 /** Event handler for the USB_DeviceUnattached event. This indicates that a device has been removed from the host, and
175 * stops the library USB task management process.
176 */
177 void EVENT_USB_Host_DeviceUnattached(void)
178 {
179 puts_P(PSTR("\r\nDevice Unattached.\r\n"));
180 LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);
181 }
182
183 /** Event handler for the USB_DeviceEnumerationComplete event. This indicates that a device has been successfully
184 * enumerated by the host and is now ready to be used by the application.
185 */
186 void EVENT_USB_Host_DeviceEnumerationComplete(void)
187 {
188 LEDs_SetAllLEDs(LEDMASK_USB_READY);
189 }
190
191 /** Event handler for the USB_HostError event. This indicates that a hardware error occurred while in host mode. */
192 void EVENT_USB_Host_HostError(const uint8_t ErrorCode)
193 {
194 USB_ShutDown();
195
196 printf_P(PSTR(ESC_FG_RED "Host Mode Error\r\n"
197 " -- Error Code %d\r\n" ESC_FG_WHITE), ErrorCode);
198
199 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
200 for(;;);
201 }
202
203 /** Event handler for the USB_DeviceEnumerationFailed event. This indicates that a problem occurred while
204 * enumerating an attached USB device.
205 */
206 void EVENT_USB_Host_DeviceEnumerationFailed(const uint8_t ErrorCode, const uint8_t SubErrorCode)
207 {
208 printf_P(PSTR(ESC_FG_RED "Dev Enum Error\r\n"
209 " -- Error Code %d\r\n"
210 " -- Sub Error Code %d\r\n"
211 " -- In State %d\r\n" ESC_FG_WHITE), ErrorCode, SubErrorCode, USB_HostState);
212
213 LEDs_SetAllLEDs(LEDMASK_USB_ERROR);
214 }