Bootloaders/CDC/BootloaderCDC.h

   1 /*
   2              LUFA Library
   3      Copyright (C) Dean Camera, 2013.
   4
   5   dean [at] fourwalledcubicle [dot] com
   6            www.lufa-lib.org
   7 */
   8
   9 /*
  10   Copyright 2013  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  *  Header file for BootloaderCDC.c.
  34  */
  35
  36 #ifndef _CDC_H_
  37 #define _CDC_H_
  38
  39         /* Includes: */
  40                 #include <avr/io.h>
  41                 #include <avr/wdt.h>
  42                 #include <avr/boot.h>
  43                 #include <avr/eeprom.h>
  44                 #include <avr/power.h>
  45                 #include <avr/interrupt.h>
  46                 #include <stdbool.h>
  47
  48                 #include "Descriptors.h"
  49                 #include "BootloaderAPI.h"
  50                 #include "Config/AppConfig.h"
  51
  52                 #include <LUFA/Drivers/USB/USB.h>
  53                 #include <LUFA/Drivers/Board/LEDs.h>
  54
  55         /* Preprocessor Checks: */
  56                 #if !defined(__OPTIMIZE_SIZE__)
  57                         #error This bootloader requires that it be optimize for size, not speed, to fit into the target device. Change optimization settings and try again.
  58                 #endif
  59
  60         /* Macros: */
  61                 /** Version major of the CDC bootloader. */
  62                 #define BOOTLOADER_VERSION_MAJOR     0x01
  63
  64                 /** Version minor of the CDC bootloader. */
  65                 #define BOOTLOADER_VERSION_MINOR     0x00
  66
  67                 /** Hardware version major of the CDC bootloader. */
  68                 #define BOOTLOADER_HWVERSION_MAJOR   0x01
  69
  70                 /** Hardware version minor of the CDC bootloader. */
  71                 #define BOOTLOADER_HWVERSION_MINOR   0x00
  72
  73                 /** Eight character bootloader firmware identifier reported to the host when requested. */
  74                 #define SOFTWARE_IDENTIFIER          "LUFACDC"
  75
  76                 /** Magic bootloader key to unlock forced application start mode. */
  77                 #define MAGIC_BOOT_KEY               0xDC42
  78
  79         /* Enums: */
  80                 /** Possible memory types that can be addressed via the bootloader. */
  81                 enum AVR109_Memories
  82                 {
  83                         MEMORY_TYPE_FLASH  = 'F',
  84                         MEMORY_TYPE_EEPROM = 'E',
  85                 };
  86
  87                 /** Possible commands that can be issued to the bootloader. */
  88                 enum AVR109_Commands
  89                 {
  90                         AVR109_COMMAND_Sync                     = 27,
  91                         AVR109_COMMAND_ReadEEPROM               = 'd',
  92                         AVR109_COMMAND_WriteEEPROM              = 'D',
  93                         AVR109_COMMAND_ReadFLASHWord            = 'R',
  94                         AVR109_COMMAND_WriteFlashPage           = 'm',
  95                         AVR109_COMMAND_FillFlashPageWordLow     = 'c',
  96                         AVR109_COMMAND_FillFlashPageWordHigh    = 'C',
  97                         AVR109_COMMAND_GetBlockWriteSupport     = 'b',
  98                         AVR109_COMMAND_BlockWrite               = 'B',
  99                         AVR109_COMMAND_BlockRead                = 'g',
 100                         AVR109_COMMAND_ReadExtendedFuses        = 'Q',
 101                         AVR109_COMMAND_ReadHighFuses            = 'N',
 102                         AVR109_COMMAND_ReadLowFuses             = 'F',
 103                         AVR109_COMMAND_ReadLockbits             = 'r',
 104                         AVR109_COMMAND_WriteLockbits            = 'l',
 105                         AVR109_COMMAND_EraseFLASH               = 'e',
 106                         AVR109_COMMAND_ReadSignature            = 's',
 107                         AVR109_COMMAND_ReadBootloaderSWVersion  = 'V',
 108                         AVR109_COMMAND_ReadBootloaderHWVersion  = 'v',
 109                         AVR109_COMMAND_ReadBootloaderIdentifier = 'S',
 110                         AVR109_COMMAND_ReadBootloaderInterface  = 'p',
 111                         AVR109_COMMAND_SetCurrentAddress        = 'A',
 112                         AVR109_COMMAND_ReadAutoAddressIncrement = 'a',
 113                         AVR109_COMMAND_ReadPartCode             = 't',
 114                         AVR109_COMMAND_EnterProgrammingMode     = 'P',
 115                         AVR109_COMMAND_LeaveProgrammingMode     = 'L',
 116                         AVR109_COMMAND_SelectDeviceType         = 'T',
 117                         AVR109_COMMAND_SetLED                   = 'x',
 118                         AVR109_COMMAND_ClearLED                 = 'y',
 119                         AVR109_COMMAND_ExitBootloader           = 'E',
 120                 };
 121
 122         /* Type Defines: */
 123                 /** Type define for a non-returning pointer to the start of the loaded application in flash memory. */
 124                 typedef void (*AppPtr_t)(void) ATTR_NO_RETURN;
 125
 126         /* Function Prototypes: */
 127                 static void CDC_Task(void);
 128                 static void SetupHardware(void);
 129
 130                 void Application_Jump_Check(void) ATTR_INIT_SECTION(3);
 131
 132                 void EVENT_USB_Device_ConfigurationChanged(void);
 133
 134                 #if defined(INCLUDE_FROM_BOOTLOADERCDC_C) || defined(__DOXYGEN__)
 135                         #if !defined(NO_BLOCK_SUPPORT)
 136                         static void    ReadWriteMemoryBlock(const uint8_t Command);
 137                         #endif
 138                         static uint8_t FetchNextCommandByte(void);
 139                         static void    WriteNextResponseByte(const uint8_t Response);
 140                 #endif
 141
 142 #endif
 143