OpenOCD
Data Structures | Macros | Functions | Variables
atsamv.c File Reference
Include dependency graph for atsamv.c:

Go to the source code of this file.

Data Structures

struct  samv_flash_bank
 

Macros

#define OFFSET_EFC_FCR   4
 
#define OFFSET_EFC_FMR   0
 
#define OFFSET_EFC_FRR   12
 
#define OFFSET_EFC_FSR   8
 
#define REG_NAME_WIDTH   (12)
 
#define SAMV_CHIPID_CIDR   (0x400E0940)
 
#define SAMV_CONTROLLER_ADDR   (0x400e0c00)
 
#define SAMV_EFC_FCMD_CFB   (0xC) /* (EFC) Clear Fuse Bit */
 
#define SAMV_EFC_FCMD_CLB   (0x9) /* (EFC) Clear Lock Bit */
 
#define SAMV_EFC_FCMD_EA   (0x5) /* (EFC) Erase All */
 
#define SAMV_EFC_FCMD_EPA   (0x7) /* (EFC) Erase pages */
 
#define SAMV_EFC_FCMD_EWP   (0x3) /* (EFC) Erase Page and Write Page */
 
#define SAMV_EFC_FCMD_EWPL   (0x4) /* (EFC) Erase Page, Write Page then Lock*/
 
#define SAMV_EFC_FCMD_GETD   (0x0) /* (EFC) Get Flash Descriptor */
 
#define SAMV_EFC_FCMD_GFB   (0xD) /* (EFC) Get Fuse Bit */
 
#define SAMV_EFC_FCMD_GLB   (0xA) /* (EFC) Get Lock Bit */
 
#define SAMV_EFC_FCMD_SFB   (0xB) /* (EFC) Set Fuse Bit */
 
#define SAMV_EFC_FCMD_SLB   (0x8) /* (EFC) Set Lock Bit */
 
#define SAMV_EFC_FCMD_WP   (0x1) /* (EFC) Write Page */
 
#define SAMV_EFC_FCMD_WPL   (0x2) /* (EFC) Write Page and Lock */
 
#define SAMV_FLASH_BASE   0x00400000
 
#define SAMV_NUM_GPNVM_BITS   9
 
#define SAMV_PAGE_SIZE   512
 
#define SAMV_SECTOR_SIZE   16384
 

Functions

 COMMAND_HANDLER (samv_handle_gpnvm_command)
 
 FLASH_BANK_COMMAND_HANDLER (samv_flash_bank_command)
 
static int samv_auto_probe (struct flash_bank *bank)
 
static int samv_clear_gpnvm (struct target *target, unsigned gpnvm)
 
static int samv_efc_get_result (struct target *target, uint32_t *v)
 
static int samv_efc_get_status (struct target *target, uint32_t *v)
 
static int samv_efc_perform_command (struct target *target, unsigned command, unsigned argument, uint32_t *status)
 
static int samv_efc_start_command (struct target *target, unsigned command, unsigned argument)
 
static int samv_erase (struct flash_bank *bank, unsigned int first, unsigned int last)
 
static int samv_erase_pages (struct target *target, int first_page, int num_pages, uint32_t *status)
 
static int samv_flash_lock (struct target *target, unsigned start_sector, unsigned end_sector)
 
static int samv_flash_unlock (struct target *target, unsigned start_sector, unsigned end_sector)
 
static int samv_get_device_id (struct flash_bank *bank, uint32_t *device_id)
 
static int samv_get_gpnvm (struct target *target, unsigned gpnvm, unsigned *out)
 
static int samv_get_info (struct flash_bank *bank, struct command_invocation *cmd)
 
static int samv_page_read (struct target *target, unsigned page_num, uint8_t *buf)
 
static int samv_page_write (struct target *target, unsigned pagenum, const uint8_t *buf)
 
static int samv_probe (struct flash_bank *bank)
 
static int samv_protect (struct flash_bank *bank, int set, unsigned int first, unsigned int last)
 
static int samv_protect_check (struct flash_bank *bank)
 
static int samv_set_gpnvm (struct target *target, unsigned gpnvm)
 
static int samv_write (struct flash_bank *bank, const uint8_t *buffer, uint32_t offset, uint32_t count)
 

Variables

static const struct command_registration atsamv_command_handlers []
 
static const struct command_registration atsamv_exec_command_handlers []
 
const struct flash_driver atsamv_flash
 

Macro Definition Documentation

◆ OFFSET_EFC_FCR

#define OFFSET_EFC_FCR   4

Definition at line 45 of file atsamv.c.

◆ OFFSET_EFC_FMR

#define OFFSET_EFC_FMR   0

Definition at line 44 of file atsamv.c.

◆ OFFSET_EFC_FRR

#define OFFSET_EFC_FRR   12

Definition at line 47 of file atsamv.c.

◆ OFFSET_EFC_FSR

#define OFFSET_EFC_FSR   8

Definition at line 46 of file atsamv.c.

◆ REG_NAME_WIDTH

#define REG_NAME_WIDTH   (12)

Definition at line 28 of file atsamv.c.

◆ SAMV_CHIPID_CIDR

#define SAMV_CHIPID_CIDR   (0x400E0940)

Definition at line 49 of file atsamv.c.

◆ SAMV_CONTROLLER_ADDR

#define SAMV_CONTROLLER_ADDR   (0x400e0c00)

Definition at line 51 of file atsamv.c.

◆ SAMV_EFC_FCMD_CFB

#define SAMV_EFC_FCMD_CFB   (0xC) /* (EFC) Clear Fuse Bit */

Definition at line 41 of file atsamv.c.

◆ SAMV_EFC_FCMD_CLB

#define SAMV_EFC_FCMD_CLB   (0x9) /* (EFC) Clear Lock Bit */

Definition at line 38 of file atsamv.c.

◆ SAMV_EFC_FCMD_EA

#define SAMV_EFC_FCMD_EA   (0x5) /* (EFC) Erase All */

Definition at line 35 of file atsamv.c.

◆ SAMV_EFC_FCMD_EPA

#define SAMV_EFC_FCMD_EPA   (0x7) /* (EFC) Erase pages */

Definition at line 36 of file atsamv.c.

◆ SAMV_EFC_FCMD_EWP

#define SAMV_EFC_FCMD_EWP   (0x3) /* (EFC) Erase Page and Write Page */

Definition at line 33 of file atsamv.c.

◆ SAMV_EFC_FCMD_EWPL

#define SAMV_EFC_FCMD_EWPL   (0x4) /* (EFC) Erase Page, Write Page then Lock*/

Definition at line 34 of file atsamv.c.

◆ SAMV_EFC_FCMD_GETD

#define SAMV_EFC_FCMD_GETD   (0x0) /* (EFC) Get Flash Descriptor */

Definition at line 30 of file atsamv.c.

◆ SAMV_EFC_FCMD_GFB

#define SAMV_EFC_FCMD_GFB   (0xD) /* (EFC) Get Fuse Bit */

Definition at line 42 of file atsamv.c.

◆ SAMV_EFC_FCMD_GLB

#define SAMV_EFC_FCMD_GLB   (0xA) /* (EFC) Get Lock Bit */

Definition at line 39 of file atsamv.c.

◆ SAMV_EFC_FCMD_SFB

#define SAMV_EFC_FCMD_SFB   (0xB) /* (EFC) Set Fuse Bit */

Definition at line 40 of file atsamv.c.

◆ SAMV_EFC_FCMD_SLB

#define SAMV_EFC_FCMD_SLB   (0x8) /* (EFC) Set Lock Bit */

Definition at line 37 of file atsamv.c.

◆ SAMV_EFC_FCMD_WP

#define SAMV_EFC_FCMD_WP   (0x1) /* (EFC) Write Page */

Definition at line 31 of file atsamv.c.

◆ SAMV_EFC_FCMD_WPL

#define SAMV_EFC_FCMD_WPL   (0x2) /* (EFC) Write Page and Lock */

Definition at line 32 of file atsamv.c.

◆ SAMV_FLASH_BASE

#define SAMV_FLASH_BASE   0x00400000

Definition at line 54 of file atsamv.c.

◆ SAMV_NUM_GPNVM_BITS

#define SAMV_NUM_GPNVM_BITS   9

Definition at line 50 of file atsamv.c.

◆ SAMV_PAGE_SIZE

#define SAMV_PAGE_SIZE   512

Definition at line 53 of file atsamv.c.

◆ SAMV_SECTOR_SIZE

#define SAMV_SECTOR_SIZE   16384

Definition at line 52 of file atsamv.c.

Function Documentation

◆ COMMAND_HANDLER()

COMMAND_HANDLER ( samv_handle_gpnvm_command  )

Definition at line 582 of file atsamv.c.

◆ FLASH_BANK_COMMAND_HANDLER()

FLASH_BANK_COMMAND_HANDLER ( samv_flash_bank_command  )

Definition at line 295 of file atsamv.c.

References bank, ERROR_OK, and LOG_INFO.

◆ samv_auto_probe()

static int samv_auto_probe ( struct flash_bank *  bank)
static

Definition at line 360 of file atsamv.c.

References bank, ERROR_OK, samv_flash_bank::probed, and samv_probe().

Referenced by samv_erase().

◆ samv_clear_gpnvm()

static int samv_clear_gpnvm ( struct target *  target,
unsigned  gpnvm 
)
static

Definition at line 195 of file atsamv.c.

References ERROR_FAIL, ERROR_OK, LOG_DEBUG, LOG_ERROR, NULL, SAMV_EFC_FCMD_CFB, samv_efc_perform_command(), samv_get_gpnvm(), and SAMV_NUM_GPNVM_BITS.

◆ samv_efc_get_result()

static int samv_efc_get_result ( struct target *  target,
uint32_t *  v 
)
static

Definition at line 77 of file atsamv.c.

References OFFSET_EFC_FRR, SAMV_CONTROLLER_ADDR, and target_read_u32().

Referenced by samv_get_gpnvm(), and samv_protect_check().

◆ samv_efc_get_status()

static int samv_efc_get_status ( struct target *  target,
uint32_t *  v 
)
static

Definition at line 71 of file atsamv.c.

References OFFSET_EFC_FSR, SAMV_CONTROLLER_ADDR, and target_read_u32().

Referenced by samv_efc_perform_command(), and samv_efc_start_command().

◆ samv_efc_perform_command()

static int samv_efc_perform_command ( struct target *  target,
unsigned  command,
unsigned  argument,
uint32_t *  status 
)
static

Definition at line 104 of file atsamv.c.

References ERROR_FAIL, ERROR_OK, LOG_ERROR, samv_efc_get_status(), samv_efc_start_command(), status, and timeval_ms().

Referenced by samv_clear_gpnvm(), samv_erase(), samv_erase_pages(), samv_flash_lock(), samv_flash_unlock(), samv_get_gpnvm(), samv_page_write(), samv_protect_check(), and samv_set_gpnvm().

◆ samv_efc_start_command()

static int samv_efc_start_command ( struct target *  target,
unsigned  command,
unsigned  argument 
)
static

Definition at line 86 of file atsamv.c.

References ERROR_FAIL, ERROR_OK, LOG_DEBUG, LOG_ERROR, OFFSET_EFC_FCR, SAMV_CONTROLLER_ADDR, samv_efc_get_status(), and target_write_u32().

Referenced by samv_efc_perform_command().

◆ samv_erase()

static int samv_erase ( struct flash_bank *  bank,
unsigned int  first,
unsigned int  last 
)
static

Definition at line 368 of file atsamv.c.

References bank, ERROR_FAIL, ERROR_OK, ERROR_TARGET_NOT_HALTED, LOG_ERROR, LOG_INFO, NULL, samv_auto_probe(), SAMV_EFC_FCMD_EA, samv_efc_perform_command(), samv_erase_pages(), status, and TARGET_HALTED.

◆ samv_erase_pages()

static int samv_erase_pages ( struct target *  target,
int  first_page,
int  num_pages,
uint32_t *  status 
)
static

Definition at line 138 of file atsamv.c.

References SAMV_EFC_FCMD_EPA, samv_efc_perform_command(), and status.

Referenced by samv_erase().

◆ samv_flash_lock()

static int samv_flash_lock ( struct target *  target,
unsigned  start_sector,
unsigned  end_sector 
)
static

Definition at line 255 of file atsamv.c.

References ERROR_OK, SAMV_EFC_FCMD_SLB, samv_efc_perform_command(), SAMV_PAGE_SIZE, SAMV_SECTOR_SIZE, and status.

Referenced by samv_protect().

◆ samv_flash_unlock()

static int samv_flash_unlock ( struct target *  target,
unsigned  start_sector,
unsigned  end_sector 
)
static

Definition at line 235 of file atsamv.c.

References ERROR_OK, SAMV_EFC_FCMD_CLB, samv_efc_perform_command(), SAMV_PAGE_SIZE, SAMV_SECTOR_SIZE, and status.

Referenced by samv_protect().

◆ samv_get_device_id()

static int samv_get_device_id ( struct flash_bank *  bank,
uint32_t *  device_id 
)
static

Definition at line 304 of file atsamv.c.

References bank, SAMV_CHIPID_CIDR, and target_read_u32().

Referenced by samv_probe().

◆ samv_get_gpnvm()

static int samv_get_gpnvm ( struct target *  target,
unsigned  gpnvm,
unsigned *  out 
)
static

Definition at line 171 of file atsamv.c.

References ERROR_FAIL, ERROR_OK, LOG_ERROR, NULL, SAMV_EFC_FCMD_GFB, samv_efc_get_result(), samv_efc_perform_command(), and SAMV_NUM_GPNVM_BITS.

Referenced by samv_clear_gpnvm(), and samv_set_gpnvm().

◆ samv_get_info()

static int samv_get_info ( struct flash_bank *  bank,
struct command_invocation *  cmd 
)
static

Definition at line 569 of file atsamv.c.

References bank, cmd, command_print_sameline(), ERROR_OK, samv_flash_bank::probed, and samv_probe().

◆ samv_page_read()

static int samv_page_read ( struct target *  target,
unsigned  page_num,
uint8_t *  buf 
)
static

Definition at line 423 of file atsamv.c.

References addr, ERROR_OK, LOG_ERROR, SAMV_FLASH_BASE, SAMV_PAGE_SIZE, and target_read_memory().

Referenced by samv_write().

◆ samv_page_write()

static int samv_page_write ( struct target *  target,
unsigned  pagenum,
const uint8_t *  buf 
)
static

Definition at line 434 of file atsamv.c.

References addr, ERROR_FAIL, ERROR_OK, LOG_DEBUG, LOG_ERROR, SAMV_EFC_FCMD_WP, samv_efc_perform_command(), SAMV_FLASH_BASE, SAMV_PAGE_SIZE, status, and target_write_memory().

Referenced by samv_write().

◆ samv_probe()

static int samv_probe ( struct flash_bank *  bank)
static

Definition at line 309 of file atsamv.c.

References bank, eproc, ERROR_FAIL, ERROR_OK, LOG_ERROR, LOG_INFO, samv_flash_bank::probed, SAMV_FLASH_BASE, samv_get_device_id(), samv_protect_check(), SAMV_SECTOR_SIZE, and samv_flash_bank::size_bytes.

Referenced by samv_auto_probe(), and samv_get_info().

◆ samv_protect()

static int samv_protect ( struct flash_bank *  bank,
int  set,
unsigned int  first,
unsigned int  last 
)
static

Definition at line 406 of file atsamv.c.

References bank, ERROR_TARGET_NOT_HALTED, LOG_ERROR, samv_flash_lock(), samv_flash_unlock(), and TARGET_HALTED.

◆ samv_protect_check()

static int samv_protect_check ( struct flash_bank *  bank)
static

Definition at line 275 of file atsamv.c.

References bank, ERROR_OK, NULL, SAMV_EFC_FCMD_GLB, samv_efc_get_result(), and samv_efc_perform_command().

Referenced by samv_probe().

◆ samv_set_gpnvm()

static int samv_set_gpnvm ( struct target *  target,
unsigned  gpnvm 
)
static

Definition at line 214 of file atsamv.c.

References ERROR_FAIL, ERROR_OK, LOG_ERROR, NULL, SAMV_EFC_FCMD_SFB, samv_efc_perform_command(), samv_get_gpnvm(), and SAMV_NUM_GPNVM_BITS.

◆ samv_write()

static int samv_write ( struct flash_bank *  bank,
const uint8_t *  buffer,
uint32_t  offset,
uint32_t  count 
)
static

Definition at line 462 of file atsamv.c.

References bank, buffer, count, ERROR_FAIL, ERROR_OK, ERROR_TARGET_NOT_HALTED, LOG_DEBUG, LOG_ERROR, offset, samv_page_read(), SAMV_PAGE_SIZE, samv_page_write(), and TARGET_HALTED.

Variable Documentation

◆ atsamv_command_handlers

const struct command_registration atsamv_command_handlers[]
static
Initial value:
= {
{
.name = "atsamv",
.mode = COMMAND_ANY,
.help = "atsamv flash command group",
.usage = "",
.chain = atsamv_exec_command_handlers,
},
COMMAND_REGISTRATION_DONE
}
atsamv_exec_command_handlers
static const struct command_registration atsamv_exec_command_handlers[]
Definition: atsamv.c:665
COMMAND_REGISTRATION_DONE
#define COMMAND_REGISTRATION_DONE
Use this as the last entry in an array of command_registration records.
Definition: command.h:247
COMMAND_ANY
@ COMMAND_ANY
Definition: command.h:42

Definition at line 582 of file atsamv.c.

◆ atsamv_exec_command_handlers

const struct command_registration atsamv_exec_command_handlers[]
static
Initial value:
= {
{
.name = "gpnvm",
.handler = samv_handle_gpnvm_command,
.mode = COMMAND_EXEC,
.usage = "[('clr'|'set'|'show') bitnum]",
.help = "Without arguments, shows all bits in the gpnvm "
"register. Otherwise, clears, sets, or shows one "
"General Purpose Non-Volatile Memory (gpnvm) bit.",
},
COMMAND_REGISTRATION_DONE
}
COMMAND_EXEC
@ COMMAND_EXEC
Definition: command.h:40

Definition at line 582 of file atsamv.c.

◆ atsamv_flash

const struct flash_driver atsamv_flash
Initial value:
= {
.name = "atsamv",
.commands = atsamv_command_handlers,
.flash_bank_command = samv_flash_bank_command,
.erase = samv_erase,
.protect = samv_protect,
.write = samv_write,
.read = default_flash_read,
.probe = samv_probe,
.auto_probe = samv_auto_probe,
.erase_check = default_flash_blank_check,
.protect_check = samv_protect_check,
.info = samv_get_info,
.free_driver_priv = default_flash_free_driver_priv,
}
samv_protect_check
static int samv_protect_check(struct flash_bank *bank)
Definition: atsamv.c:275
samv_auto_probe
static int samv_auto_probe(struct flash_bank *bank)
Definition: atsamv.c:360
atsamv_command_handlers
static const struct command_registration atsamv_command_handlers[]
Definition: atsamv.c:678
samv_get_info
static int samv_get_info(struct flash_bank *bank, struct command_invocation *cmd)
Definition: atsamv.c:569
samv_protect
static int samv_protect(struct flash_bank *bank, int set, unsigned int first, unsigned int last)
Definition: atsamv.c:406
samv_write
static int samv_write(struct flash_bank *bank, const uint8_t *buffer, uint32_t offset, uint32_t count)
Definition: atsamv.c:462
samv_erase
static int samv_erase(struct flash_bank *bank, unsigned int first, unsigned int last)
Definition: atsamv.c:368
samv_probe
static int samv_probe(struct flash_bank *bank)
Definition: atsamv.c:309
default_flash_blank_check
int default_flash_blank_check(struct flash_bank *bank)
Provides default erased-bank check handling.
Definition: flash/nor/core.c:380
default_flash_read
int default_flash_read(struct flash_bank *bank, uint8_t *buffer, uint32_t offset, uint32_t count)
Provides default read implementation for flash memory.
Definition: flash/nor/core.c:121
default_flash_free_driver_priv
void default_flash_free_driver_priv(struct flash_bank *bank)
Deallocates bank->driver_priv.
Definition: flash/nor/core.c:210

Definition at line 582 of file atsamv.c.