git.gag.com Git - fw/stlink/blob - example/stm32f4/STM32_USB_Device_Library/Class/dfu/src/usbd_mem_if_template.c

   1 /**
   2   ******************************************************************************
   3   * @file    usbd_mem_if_template.c
   4   * @author  MCD Application Team
   5   * @version V1.0.0
   6   * @date    22-July-2011
   7   * @brief   Specific media access Layer for a template memory. This file is
   8              provided as template example showing how to implement a new memory
   9              interface based on pre-defined API.
  10   ******************************************************************************
  11   * @attention
  12   *
  13   * THE PRESENT FIRMWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS
  14   * WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE
  15   * TIME. AS A RESULT, STMICROELECTRONICS SHALL NOT BE HELD LIABLE FOR ANY
  16   * DIRECT, INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING
  17   * FROM THE CONTENT OF SUCH FIRMWARE AND/OR THE USE MADE BY CUSTOMERS OF THE
  18   * CODING INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS.
  19   *
  20   * <h2><center>&copy; COPYRIGHT 2011 STMicroelectronics</center></h2>
  21   ******************************************************************************
  22   */
  23
  24 /* Includes ------------------------------------------------------------------*/
  25 #include "usbd_mem_if_template.h"
  26 #include "usbd_dfu_mal.h"
  27
  28 /* Private typedef -----------------------------------------------------------*/
  29 /* Private define ------------------------------------------------------------*/
  30 /* Private macro -------------------------------------------------------------*/
  31
  32 /* Private function prototypes -----------------------------------------------*/
  33 uint16_t MEM_If_Init(void);
  34 uint16_t MEM_If_Erase (uint32_t Add);
  35 uint16_t MEM_If_Write (uint32_t Add, uint32_t Len);
  36 uint8_t *MEM_If_Read  (uint32_t Add, uint32_t Len);
  37 uint16_t MEM_If_DeInit(void);
  38 uint16_t MEM_If_CheckAdd(uint32_t Add);
  39
  40
  41 /* Private variables ---------------------------------------------------------*/
  42 DFU_MAL_Prop_TypeDef DFU_Mem_cb =
  43   {
  44     MEM_IF_STRING,
  45     MEM_If_Init,
  46     MEM_If_DeInit,
  47     MEM_If_Erase,
  48     MEM_If_Write,
  49     MEM_If_Read,
  50     MEM_If_CheckAdd,
  51     10, /* Erase Time in ms */
  52     10  /* Programming Time in ms */
  53   };
  54
  55 /* Private functions ---------------------------------------------------------*/
  56
  57 /**
  58   * @brief  MEM_If_Init
  59   *         Memory initialization routine.
  60   * @param  None
  61   * @retval MAL_OK if operation is successeful, MAL_FAIL else.
  62   */
  63 uint16_t MEM_If_Init(void)
  64 {
  65   return MAL_OK;
  66 }
  67
  68 /**
  69   * @brief  MEM_If_DeInit
  70   *         Memory deinitialization routine.
  71   * @param  None
  72   * @retval MAL_OK if operation is successeful, MAL_FAIL else.
  73   */
  74 uint16_t MEM_If_DeInit(void)
  75 {
  76   return MAL_OK;
  77 }
  78
  79 /**
  80   * @brief  MEM_If_Erase
  81   *         Erase sector.
  82   * @param  Add: Address of sector to be erased.
  83   * @retval MAL_OK if operation is successeful, MAL_FAIL else.
  84   */
  85 uint16_t MEM_If_Erase(uint32_t Add)
  86 {
  87   return MAL_OK;
  88 }
  89
  90 /**
  91   * @brief  MEM_If_Write
  92   *         Memory write routine.
  93   * @param  Add: Address to be written to.
  94   * @param  Len: Number of data to be written (in bytes).
  95   * @retval MAL_OK if operation is successeful, MAL_FAIL else.
  96   */
  97 uint16_t MEM_If_Write(uint32_t Add, uint32_t Len)
  98 {
  99   return MAL_OK;
 100 }
 101
 102 /**
 103   * @brief  MEM_If_Read
 104   *         Memory read routine.
 105   * @param  Add: Address to be read from.
 106   * @param  Len: Number of data to be read (in bytes).
 107   * @retval Pointer to the phyisical address where data should be read.
 108   */
 109 uint8_t *MEM_If_Read (uint32_t Add, uint32_t Len)
 110 {
 111   /* Return a valid address to avoid HardFault */
 112   return  (uint8_t*)(MAL_Buffer);
 113 }
 114
 115 /**
 116   * @brief  MEM_If_CheckAdd
 117   *         Check if the address is an allowed address for this memory.
 118   * @param  Add: Address to be checked.
 119   * @param  Len: Number of data to be read (in bytes).
 120   * @retval MAL_OK if the address is allowed, MAL_FAIL else.
 121   */
 122 uint16_t MEM_If_CheckAdd(uint32_t Add)
 123 {
 124   if ((Add >= MEM_START_ADD) && (Add < MEM_END_ADD))
 125   {
 126     return MAL_OK;
 127   }
 128   else
 129   {
 130     return MAL_FAIL;
 131   }
 132 }
 133 /******************* (C) COPYRIGHT 2011 STMicroelectronics *****END OF FILE****/