Projects/AVRISP-MKII/Lib/XPROG/XMEGANVM.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 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  *  Header file for XMEGANVM.c.
  34  */
  35
  36 #ifndef _XMEGA_NVM_
  37 #define _XMEGA_NVM_
  38
  39         /* Includes: */
  40                 #include <avr/io.h>
  41                 #include <avr/interrupt.h>
  42                 #include <stdbool.h>
  43
  44                 #include <LUFA/Common/Common.h>
  45
  46                 #include "XPROGProtocol.h"
  47                 #include "XPROGTarget.h"
  48
  49         /* Preprocessor Checks: */
  50                 #if ((BOARD == BOARD_XPLAIN) || (BOARD == BOARD_XPLAIN_REV1))
  51                         #undef ENABLE_ISP_PROTOCOL
  52
  53                         #if !defined(ENABLE_XPROG_PROTOCOL)
  54                                 #define ENABLE_XPROG_PROTOCOL
  55                         #endif
  56                 #endif
  57
  58         /* Defines: */
  59                 #define XMEGA_CRC_LENGTH_BYTES               3
  60
  61                 #define XMEGA_NVM_REG_ADDR0                  0x00
  62                 #define XMEGA_NVM_REG_ADDR1                  0x01
  63                 #define XMEGA_NVM_REG_ADDR2                  0x02
  64                 #define XMEGA_NVM_REG_DAT0                   0x04
  65                 #define XMEGA_NVM_REG_DAT1                   0x05
  66                 #define XMEGA_NVM_REG_DAT2                   0x06
  67                 #define XMEGA_NVM_REG_CMD                    0x0A
  68                 #define XMEGA_NVM_REG_CTRLA                  0x0B
  69                 #define XMEGA_NVM_REG_CTRLB                  0x0C
  70                 #define XMEGA_NVM_REG_INTCTRL                0x0D
  71                 #define XMEGA_NVM_REG_STATUS                 0x0F
  72                 #define XMEGA_NVM_REG_LOCKBITS               0x10
  73
  74                 #define XMEGA_NVM_BIT_CTRLA_CMDEX            (1 << 0)
  75
  76                 #define XMEGA_NVM_CMD_NOOP                   0x00
  77                 #define XMEGA_NVM_CMD_CHIPERASE              0x40
  78                 #define XMEGA_NVM_CMD_READNVM                0x43
  79                 #define XMEGA_NVM_CMD_LOADFLASHPAGEBUFF      0x23
  80                 #define XMEGA_NVM_CMD_ERASEFLASHPAGEBUFF     0x26
  81                 #define XMEGA_NVM_CMD_ERASEFLASHPAGE         0x2B
  82                 #define XMEGA_NVM_CMD_WRITEFLASHPAGE         0x2E
  83                 #define XMEGA_NVM_CMD_ERASEWRITEFLASH        0x2F
  84                 #define XMEGA_NVM_CMD_FLASHCRC               0x78
  85                 #define XMEGA_NVM_CMD_ERASEAPPSEC            0x20
  86                 #define XMEGA_NVM_CMD_ERASEAPPSECPAGE        0x22
  87                 #define XMEGA_NVM_CMD_WRITEAPPSECPAGE        0x24
  88                 #define XMEGA_NVM_CMD_ERASEWRITEAPPSECPAGE   0x25
  89                 #define XMEGA_NVM_CMD_APPCRC                 0x38
  90                 #define XMEGA_NVM_CMD_ERASEBOOTSEC           0x68
  91                 #define XMEGA_NVM_CMD_ERASEBOOTSECPAGE       0x2A
  92                 #define XMEGA_NVM_CMD_WRITEBOOTSECPAGE       0x2C
  93                 #define XMEGA_NVM_CMD_ERASEWRITEBOOTSECPAGE  0x2D
  94                 #define XMEGA_NVM_CMD_BOOTCRC                0x39
  95                 #define XMEGA_NVM_CMD_READUSERSIG            0x03
  96                 #define XMEGA_NVM_CMD_ERASEUSERSIG           0x18
  97                 #define XMEGA_NVM_CMD_WRITEUSERSIG           0x1A
  98                 #define XMEGA_NVM_CMD_READCALIBRATION        0x02
  99                 #define XMEGA_NVM_CMD_READFUSE               0x07
 100                 #define XMEGA_NVM_CMD_WRITEFUSE              0x4C
 101                 #define XMEGA_NVM_CMD_WRITELOCK              0x08
 102                 #define XMEGA_NVM_CMD_LOADEEPROMPAGEBUFF     0x33
 103                 #define XMEGA_NVM_CMD_ERASEEEPROMPAGEBUFF    0x36
 104                 #define XMEGA_NVM_CMD_ERASEEEPROM            0x30
 105                 #define XMEGA_NVM_CMD_ERASEEEPROMPAGE        0x32
 106                 #define XMEGA_NVM_CMD_WRITEEEPROMPAGE        0x34
 107                 #define XMEGA_NVM_CMD_ERASEWRITEEEPROMPAGE   0x35
 108                 #define XMEGA_NVM_CMD_READEEPROM             0x06
 109
 110         /* Function Prototypes: */
 111                 bool XMEGANVM_WaitWhileNVMBusBusy(void);
 112                 bool XMEGANVM_WaitWhileNVMControllerBusy(void);
 113                 bool XMEGANVM_EnablePDI(void);
 114                 void XMEGANVM_DisablePDI(void);
 115                 bool XMEGANVM_GetMemoryCRC(const uint8_t CRCCommand, uint32_t* const CRCDest);
 116                 bool XMEGANVM_ReadMemory(const uint32_t ReadAddress, uint8_t* ReadBuffer, uint16_t ReadSize);
 117                 bool XMEGANVM_WriteByteMemory(const uint8_t WriteCommand, const uint32_t WriteAddress, const uint8_t Byte);
 118                 bool XMEGANVM_WritePageMemory(const uint8_t WriteBuffCommand, const uint8_t EraseBuffCommand,
 119                                               const uint8_t WritePageCommand, const uint8_t PageMode, const uint32_t WriteAddress,
 120                                               const uint8_t* WriteBuffer, uint16_t WriteSize);
 121                 bool XMEGANVM_EraseMemory(const uint8_t EraseCommand, const uint32_t Address);
 122
 123                 #if defined(INCLUDE_FROM_XMEGANVM_C)
 124                         static void XMEGANVM_SendNVMRegAddress(const uint8_t Register);
 125                         static void XMEGANVM_SendAddress(const uint32_t AbsoluteAddress);
 126                 #endif
 127
 128 #endif
 129