Minor documentation improvements.
[pub/USBasp.git] / Projects / AVRISP-MKII / AVRISP-MKII.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 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 AVRISP project. This file contains the main tasks of
34 * the project and is responsible for the initial application hardware configuration.
35 */
36
37 #include "AVRISP-MKII.h"
38
39 /** Main program entry point. This routine contains the overall program flow, including initial
40 * setup of all components and the main program loop.
41 */
42 int main(void)
43 {
44 SetupHardware();
45 V2Protocol_Init();
46
47 LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);
48 sei();
49
50 for (;;)
51 {
52 #if (BOARD == BOARD_USBTINYMKII)
53 /* On the USBTINY-MKII target, there is a secondary LED which indicates the current selected power
54 mode - either VBUS, or sourced from the VTARGET pin of the programming connectors */
55 LEDs_ChangeLEDs(LEDMASK_VBUSPOWER, (PIND & (1 << 0)) ? 0 : LEDMASK_VBUSPOWER);
56 #endif
57
58 AVRISP_Task();
59 USB_USBTask();
60 }
61 }
62
63 /** Configures the board hardware and chip peripherals for the demo's functionality. */
64 void SetupHardware(void)
65 {
66 /* Disable watchdog if enabled by bootloader/fuses */
67 MCUSR &= ~(1 << WDRF);
68 wdt_disable();
69
70 /* Disable clock division */
71 clock_prescale_set(clock_div_1);
72
73 /* Hardware Initialization */
74 LEDs_Init();
75 #if defined(RESET_TOGGLES_LIBUSB_COMPAT)
76 UpdateCurrentCompatibilityMode();
77 #endif
78
79 /* USB Stack Initialization */
80 USB_Init();
81 }
82
83 /** Event handler for the library USB Connection event. */
84 void EVENT_USB_Device_Connect(void)
85 {
86 LEDs_SetAllLEDs(LEDMASK_USB_ENUMERATING);
87 }
88
89 /** Event handler for the library USB Disconnection event. */
90 void EVENT_USB_Device_Disconnect(void)
91 {
92 LEDs_SetAllLEDs(LEDMASK_USB_NOTREADY);
93 }
94
95 /** Event handler for the library USB Configuration Changed event. */
96 void EVENT_USB_Device_ConfigurationChanged(void)
97 {
98 bool ConfigSuccess = true;
99
100 /* Setup AVRISP Data Endpoint(s) */
101 ConfigSuccess &= Endpoint_ConfigureEndpoint(AVRISP_DATA_OUT_EPADDR, EP_TYPE_BULK, AVRISP_DATA_EPSIZE, 1);
102
103 #if defined(LIBUSB_DRIVER_COMPAT)
104 ConfigSuccess &= Endpoint_ConfigureEndpoint(AVRISP_DATA_IN_EPADDR, EP_TYPE_BULK, AVRISP_DATA_EPSIZE, 1);
105 #endif
106
107 /* Indicate endpoint configuration success or failure */
108 LEDs_SetAllLEDs(ConfigSuccess ? LEDMASK_USB_READY : LEDMASK_USB_ERROR);
109 }
110
111 /** Processes incoming V2 Protocol commands from the host, returning a response when required. */
112 void AVRISP_Task(void)
113 {
114 /* Device must be connected and configured for the task to run */
115 if (USB_DeviceState != DEVICE_STATE_Configured)
116 return;
117
118 V2Params_UpdateParamValues();
119
120 Endpoint_SelectEndpoint(AVRISP_DATA_OUT_EPADDR);
121
122 /* Check to see if a V2 Protocol command has been received */
123 if (Endpoint_IsOUTReceived())
124 {
125 LEDs_SetAllLEDs(LEDMASK_BUSY);
126
127 /* Pass off processing of the V2 Protocol command to the V2 Protocol handler */
128 V2Protocol_ProcessCommand();
129
130 LEDs_SetAllLEDs(LEDMASK_USB_READY);
131 }
132 }
133