Bootloaders/CDC/BootloaderCDC.h

   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  *  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         /* Macros: */
  56                 /** Version major of the CDC bootloader. */
  57                 #define BOOTLOADER_VERSION_MAJOR     0x01
  58
  59                 /** Version minor of the CDC bootloader. */
  60                 #define BOOTLOADER_VERSION_MINOR     0x00
  61
  62                 /** Hardware version major of the CDC bootloader. */
  63                 #define BOOTLOADER_HWVERSION_MAJOR   0x01
  64
  65                 /** Hardware version minor of the CDC bootloader. */
  66                 #define BOOTLOADER_HWVERSION_MINOR   0x00
  67
  68                 /** Eight character bootloader firmware identifier reported to the host when requested. */
  69                 #define SOFTWARE_IDENTIFIER          "LUFACDC"
  70
  71                 /** Magic bootloader key to unlock forced application start mode. */
  72                 #define MAGIC_BOOT_KEY               0xDC42
  73
  74         /* Enums: */
  75                 /** Possible memory types that can be addressed via the bootloader. */
  76                 enum AVR109_Memories
  77                 {
  78                         MEMORY_TYPE_FLASH  = 'F',
  79                         MEMORY_TYPE_EEPROM = 'E',
  80                 };
  81
  82                 /** Possible commands that can be issued to the bootloader. */
  83                 enum AVR109_Commands
  84                 {
  85                         AVR109_COMMAND_Sync                     = 27,
  86                         AVR109_COMMAND_ReadEEPROM               = 'd',
  87                         AVR109_COMMAND_WriteEEPROM              = 'D',
  88                         AVR109_COMMAND_ReadFLASHWord            = 'R',
  89                         AVR109_COMMAND_WriteFlashPage           = 'm',
  90                         AVR109_COMMAND_FillFlashPageWordLow     = 'c',
  91                         AVR109_COMMAND_FillFlashPageWordHigh    = 'C',
  92                         AVR109_COMMAND_GetBlockWriteSupport     = 'b',
  93                         AVR109_COMMAND_BlockWrite               = 'B',
  94                         AVR109_COMMAND_BlockRead                = 'g',
  95                         AVR109_COMMAND_ReadExtendedFuses        = 'Q',
  96                         AVR109_COMMAND_ReadHighFuses            = 'N',
  97                         AVR109_COMMAND_ReadLowFuses             = 'F',
  98                         AVR109_COMMAND_ReadLockbits             = 'r',
  99                         AVR109_COMMAND_WriteLockbits            = 'l',
 100                         AVR109_COMMAND_EraseFLASH               = 'e',
 101                         AVR109_COMMAND_ReadSignature            = 's',
 102                         AVR109_COMMAND_ReadBootloaderSWVersion  = 'V',
 103                         AVR109_COMMAND_ReadBootloaderHWVersion  = 'v',
 104                         AVR109_COMMAND_ReadBootloaderIdentifier = 'S',
 105                         AVR109_COMMAND_ReadBootloaderInterface  = 'p',
 106                         AVR109_COMMAND_SetCurrentAddress        = 'A',
 107                         AVR109_COMMAND_ReadAutoAddressIncrement = 'a',
 108                         AVR109_COMMAND_ReadPartCode             = 't',
 109                         AVR109_COMMAND_EnterProgrammingMode     = 'P',
 110                         AVR109_COMMAND_LeaveProgrammingMode     = 'L',
 111                         AVR109_COMMAND_SelectDeviceType         = 'T',
 112                         AVR109_COMMAND_SetLED                   = 'x',
 113                         AVR109_COMMAND_ClearLED                 = 'y',
 114                         AVR109_COMMAND_ExitBootloader           = 'E',
 115                 };
 116
 117         /* Type Defines: */
 118                 /** Type define for a non-returning pointer to the start of the loaded application in flash memory. */
 119                 typedef void (*AppPtr_t)(void) ATTR_NO_RETURN;
 120
 121         /* Function Prototypes: */
 122                 static void CDC_Task(void);
 123                 static void SetupHardware(void);
 124
 125                 void Application_Jump_Check(void) ATTR_INIT_SECTION(3);
 126
 127                 void EVENT_USB_Device_ConfigurationChanged(void);
 128
 129                 #if defined(INCLUDE_FROM_BOOTLOADERCDC_C) || defined(__DOXYGEN__)
 130                         #if !defined(NO_BLOCK_SUPPORT)
 131                         static void    ReadWriteMemoryBlock(const uint8_t Command);
 132                         #endif
 133                         static uint8_t FetchNextCommandByte(void);
 134                         static void    WriteNextResponseByte(const uint8_t Response);
 135                 #endif
 136
 137 #endif
 138