git.gag.com Git - fw/openocd/blob - src/flash/nor/imp.h

   1 /***************************************************************************
   2  *   Copyright (C) 2009 Zachary T Welch <zw@superlucidity.net>             *
   3  *                                                                         *
   4  *   This program is free software; you can redistribute it and/or modify  *
   5  *   it under the terms of the GNU General Public License as published by  *
   6  *   the Free Software Foundation; either version 2 of the License, or     *
   7  *   (at your option) any later version.                                   *
   8  *                                                                         *
   9  *   This program is distributed in the hope that it will be useful,       *
  10  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
  11  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
  12  *   GNU General Public License for more details.                          *
  13  *                                                                         *
  14  *   You should have received a copy of the GNU General Public License     *
  15  *   along with this program.  If not, see <http://www.gnu.org/licenses/>. *
  16  ***************************************************************************/
  17
  18 #ifndef OPENOCD_FLASH_NOR_IMP_H
  19 #define OPENOCD_FLASH_NOR_IMP_H
  20
  21 #include <stdbool.h>
  22
  23 /* this is an internal header */
  24 #include "core.h"
  25 #include "driver.h"
  26 /* almost all drivers will need this file */
  27 #include <target/target.h>
  28
  29 /**
  30  * Adds a new NOR bank to the global list of banks.
  31  * @param bank The bank that should be added.
  32  */
  33 void flash_bank_add(struct flash_bank *bank);
  34
  35 /**
  36  * @return The first bank in the global list.
  37  */
  38 struct flash_bank *flash_bank_list(void);
  39
  40 int flash_driver_erase(struct flash_bank *bank, unsigned int first,
  41                 unsigned int last);
  42 int flash_driver_protect(struct flash_bank *bank, int set, unsigned int first,
  43                 unsigned int last);
  44 int flash_driver_write(struct flash_bank *bank,
  45                 uint8_t *buffer, uint32_t offset, uint32_t count);
  46 int flash_driver_read(struct flash_bank *bank,
  47                 uint8_t *buffer, uint32_t offset, uint32_t count);
  48
  49 /* write (optional verify) an image to flash memory of the given target */
  50 int flash_write_unlock(struct target *target, struct image *image,
  51                 uint32_t *written, bool erase, bool unlock);
  52
  53 #endif /* OPENOCD_FLASH_NOR_IMP_H */