git.sur5r.net Git - freertos/blob - FreeRTOS/Demo/CORTEX_M7_SAMV71_Xplained_IAR_Keil/libboard_samv7-ek/include/at25_spi.h

   1 /* ----------------------------------------------------------------------------\r
   2  *         ATMEL Microcontroller Software Support\r
   3  * ----------------------------------------------------------------------------\r
   4  * Copyright (c) 2010, Atmel Corporation\r
   5  *\r
   6  * All rights reserved.\r
   7  *\r
   8  * Redistribution and use in source and binary forms, with or without\r
   9  * modification, are permitted provided that the following conditions are met:\r
  10  *\r
  11  * - Redistributions of source code must retain the above copyright notice,\r
  12  * this list of conditions and the disclaimer below.\r
  13  *\r
  14  * Atmel's name may not be used to endorse or promote products derived from\r
  15  * this software without specific prior written permission.\r
  16  *\r
  17  * DISCLAIMER: THIS SOFTWARE IS PROVIDED BY ATMEL "AS IS" AND ANY EXPRESS OR\r
  18  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF\r
  19  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT ARE\r
  20  * DISCLAIMED. IN NO EVENT SHALL ATMEL BE LIABLE FOR ANY DIRECT, INDIRECT,\r
  21  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT\r
  22  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,\r
  23  * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF\r
  24  * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING\r
  25  * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,\r
  26  * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\r
  27  * ----------------------------------------------------------------------------\r
  28  */\r
  29 \r
  30 /**\r
  31  * \file\r
  32  *\r
  33  * Interface for the AT25 SPI driver.\r
  34  *\r
  35  */\r
  36 \r
  37 #ifndef AT25_SPI_H\r
  38 #define AT25_SPI_H\r
  39 \r
  40 /*----------------------------------------------------------------------------\r
  41  *        Headers\r
  42  *----------------------------------------------------------------------------*/\r
  43 #include <board.h>\r
  44 \r
  45 /*----------------------------------------------------------------------------\r
  46  *        Macros\r
  47  *----------------------------------------------------------------------------*/\r
  48 \r
  49 #define AT25_Size(pAt25)            ((pAt25)->pDesc->size)\r
  50 #define AT25_PageSize(pAt25)        ((pAt25)->pDesc->pageSize)\r
  51 #define AT25_BlockSize(pAt25)       ((pAt25)->pDesc->blockSize)\r
  52 #define AT25_Name(pAt25)            ((pAt25)->pDesc->name)\r
  53 #define AT25_ManId(pAt25)           (((pAt25)->pDesc->jedecId) & 0xFF)\r
  54 #define AT25_PageNumber(pAt25)      (AT25_Size(pAt25) / AT25_PageSize(pAt25))\r
  55 #define AT25_BlockNumber(pAt25)     (AT25_Size(pAt25) / AT25_BlockSize(pAt25))\r
  56 #define AT25_PagePerBlock(pAt25)    (AT25_BlockSize(pAt25) / AT25_PageSize(pAt25))\r
  57 #define AT25_BlockEraseCmd(pAt25)   ((pAt25)->pDesc->blockEraseCmd)\r
  58 \r
  59 /*----------------------------------------------------------------------------\r
  60  *        Local definitions\r
  61  *----------------------------------------------------------------------------*/\r
  62 \r
  63 /** Device is protected, operation cannot be carried out. */\r
  64 #define AT25_ERROR_PROTECTED        1\r
  65 /** Device is busy executing a command. */\r
  66 #define AT25_ERROR_BUSY             2\r
  67 /** There was a problem while trying to program page data. */\r
  68 #define AT25_ERROR_PROGRAM          3\r
  69 /** There was an SPI communication error. */\r
  70 #define AT25_ERROR_SPI              4\r
  71 \r
  72 /** Device ready/busy status bit. */\r
  73 #define AT25_STATUS_RDYBSY          (1 << 0)\r
  74 /** Device is ready. */\r
  75 #define AT25_STATUS_RDYBSY_READY    (0 << 0)\r
  76 /** Device is busy with internal operations. */\r
  77 #define AT25_STATUS_RDYBSY_BUSY     (1 << 0)\r
  78 /** Write enable latch status bit. */\r
  79 #define AT25_STATUS_WEL             (1 << 1)\r
  80 /** Device is not write enabled. */\r
  81 #define AT25_STATUS_WEL_DISABLED    (0 << 1)\r
  82 /** Device is write enabled. */\r
  83 #define AT25_STATUS_WEL_ENABLED     (1 << 1)\r
  84 /** Software protection status bitfield. */\r
  85 #define AT25_STATUS_SWP             (3 << 2)\r
  86 /** All sectors are software protected. */\r
  87 #define AT25_STATUS_SWP_PROTALL     (3 << 2)\r
  88 /** Some sectors are software protected. */\r
  89 #define AT25_STATUS_SWP_PROTSOME    (1 << 2)\r
  90 /** No sector is software protected. */\r
  91 #define AT25_STATUS_SWP_PROTNONE    (0 << 2)\r
  92 /** Write protect pin status bit. */\r
  93 #define AT25_STATUS_WPP             (1 << 4)\r
  94 /** Write protect signal is not asserted. */\r
  95 #define AT25_STATUS_WPP_NOTASSERTED (0 << 4)\r
  96 /** Write protect signal is asserted. */\r
  97 #define AT25_STATUS_WPP_ASSERTED    (1 << 4)\r
  98 /** Erase/program error bit. */\r
  99 #define AT25_STATUS_EPE             (1 << 5)\r
 100 /** Erase or program operation was successful. */\r
 101 #define AT25_STATUS_EPE_SUCCESS     (0 << 5)\r
 102 /** Erase or program error detected. */\r
 103 #define AT25_STATUS_EPE_ERROR       (1 << 5)\r
 104 /** Sector protection registers locked bit. */\r
 105 #define AT25_STATUS_SPRL            (1 << 7)\r
 106 /** Sector protection registers are unlocked. */\r
 107 #define AT25_STATUS_SPRL_UNLOCKED   (0 << 7)\r
 108 /** Sector protection registers are locked. */\r
 109 #define AT25_STATUS_SPRL_LOCKED     (1 << 7)\r
 110 \r
 111 /** Read array command code. */\r
 112 #define AT25_READ_ARRAY             0x0B\r
 113 /** Read array (low frequency) command code. */\r
 114 #define AT25_READ_ARRAY_LF          0x03\r
 115 /** Block erase command code (4K block). */\r
 116 #define AT25_BLOCK_ERASE_4K         0x20\r
 117 /** Block erase command code (32K block). */\r
 118 #define AT25_BLOCK_ERASE_32K        0x52\r
 119 /** Block erase command code (64K block). */\r
 120 #define AT25_BLOCK_ERASE_64K        0xD8\r
 121 /** Chip erase command code 1. */\r
 122 #define AT25_CHIP_ERASE_1           0x60\r
 123 /** Chip erase command code 2. */\r
 124 #define AT25_CHIP_ERASE_2           0xC7\r
 125 /** Byte/page program command code. */\r
 126 #define AT25_BYTE_PAGE_PROGRAM      0x02\r
 127 /** Sequential program mode command code 1. */\r
 128 #define AT25_SEQUENTIAL_PROGRAM_1   0xAD\r
 129 /** Sequential program mode command code 2. */\r
 130 #define AT25_SEQUENTIAL_PROGRAM_2   0xAF\r
 131 /** Write enable command code. */\r
 132 #define AT25_WRITE_ENABLE           0x06\r
 133 /** Write disable command code. */\r
 134 #define AT25_WRITE_DISABLE          0x04\r
 135 /** Protect sector command code. */\r
 136 #define AT25_PROTECT_SECTOR         0x36\r
 137 /** Unprotect sector command code. */\r
 138 #define AT25_UNPROTECT_SECTOR       0x39\r
 139 /** Read sector protection registers command code. */\r
 140 #define AT25_READ_SECTOR_PROT       0x3C\r
 141 /** Read status register command code. */\r
 142 #define AT25_READ_STATUS            0x05\r
 143 /** Write status register command code. */\r
 144 #define AT25_WRITE_STATUS           0x01\r
 145 /** Read manufacturer and device ID command code. */\r
 146 #define AT25_READ_JEDEC_ID          0x9F\r
 147 /** Deep power-down command code. */\r
 148 #define AT25_DEEP_PDOWN             0xB9\r
 149 /** Resume from deep power-down command code. */\r
 150 #define AT25_RES_DEEP_PDOWN         0xAB\r
 151 \r
 152 \r
 153 /** SPI Flash Manufacturer JEDEC ID */\r
 154 #define ATMEL_SPI_FLASH             0x1F\r
 155 #define ST_SPI_FLASH                0x20\r
 156 #define WINBOND_SPI_FLASH           0xEF\r
 157 #define MACRONIX_SPI_FLASH          0xC2\r
 158 #define SST_SPI_FLASH               0xBF\r
 159 \r
 160 /*----------------------------------------------------------------------------\r
 161  *        Types\r
 162  *----------------------------------------------------------------------------*/\r
 163 \r
 164 /** Describes a serial firmware flash device parameters. */\r
 165 typedef struct _At25Desc {\r
 166 \r
 167     /** Device string name. */\r
 168     const char *name;\r
 169     /** JEDEC ID of device. */\r
 170     unsigned int jedecId;\r
 171     /** Size of device in bytes. */\r
 172     unsigned int size;\r
 173     /** Size of one page in bytes. */\r
 174     unsigned int pageSize;\r
 175     /** Block erase size in bytes. */\r
 176     unsigned int blockSize;\r
 177     /** Block erase command. */\r
 178     unsigned int blockEraseCmd;\r
 179 \r
 180 } At25Desc;\r
 181 \r
 182 /**\r
 183  * Serial flash driver structure. Holds the current state of the driver,\r
 184  * including the current command and the descriptor for the underlying device.\r
 185  */\r
 186 typedef struct _At25 {\r
 187 \r
 188     /** Pointer to the underlying SPI driver. */\r
 189     Spid *pSpid;\r
 190     /** Current SPI command sent to the SPI driver. */\r
 191     SpidCmd command;\r
 192     /** Pointer to a descriptor for the serial firmware flash device. */\r
 193     const At25Desc *pDesc;\r
 194     /** Command buffer. */\r
 195     unsigned int pCmdBuffer[2];\r
 196 \r
 197 } At25;\r
 198 \r
 199 /*----------------------------------------------------------------------------\r
 200  *        Exported functions\r
 201  *----------------------------------------------------------------------------*/\r
 202 \r
 203 extern void AT25_Configure(At25 *pAt25, Spid *pSpid, unsigned char cs);\r
 204 \r
 205 extern unsigned char AT25_SendCommand(\r
 206     At25 *pAt25,\r
 207     unsigned char cmd,\r
 208     unsigned char cmdSize,\r
 209     unsigned char *pData,\r
 210     unsigned int dataSize,\r
 211     unsigned int address,\r
 212     SpidCallback callback,\r
 213     void *pArgument);\r
 214 \r
 215 extern unsigned char AT25_IsBusy(At25 *pAt25);\r
 216 \r
 217 extern const At25Desc * AT25_FindDevice(\r
 218     At25 *pAt25,\r
 219     unsigned int jedecId);\r
 220 \r
 221 #endif /*#ifndef AT25_SPI_H */\r
 222 \r