OpenOCD
at91samd.c
Go to the documentation of this file.
1 // SPDX-License-Identifier: GPL-2.0-or-later
2 
3 /***************************************************************************
4  * Copyright (C) 2013 by Andrey Yurovsky *
5  * Andrey Yurovsky <yurovsky@gmail.com> *
6  ***************************************************************************/
7 
8 #ifdef HAVE_CONFIG_H
9 #include "config.h"
10 #endif
11 
12 #include "imp.h"
13 #include "helper/binarybuffer.h"
14 
15 #include <helper/time_support.h>
16 #include <jtag/jtag.h>
17 #include <target/cortex_m.h>
18 
19 #define SAMD_NUM_PROT_BLOCKS 16
20 #define SAMD_PAGE_SIZE_MAX 1024
21 
22 #define SAMD_FLASH ((uint32_t)0x00000000) /* physical Flash memory */
23 #define SAMD_USER_ROW ((uint32_t)0x00804000) /* User Row of Flash */
24 #define SAMD_PAC1 0x41000000 /* Peripheral Access Control 1 */
25 #define SAMD_DSU 0x41002000 /* Device Service Unit */
26 #define SAMD_NVMCTRL 0x41004000 /* Non-volatile memory controller */
27 
28 #define SAMD_DSU_STATUSA 1 /* DSU status register */
29 #define SAMD_DSU_DID 0x18 /* Device ID register */
30 #define SAMD_DSU_CTRL_EXT 0x100 /* CTRL register, external access */
31 
32 #define SAMD_NVMCTRL_CTRLA 0x00 /* NVM control A register */
33 #define SAMD_NVMCTRL_CTRLB 0x04 /* NVM control B register */
34 #define SAMD_NVMCTRL_PARAM 0x08 /* NVM parameters register */
35 #define SAMD_NVMCTRL_INTFLAG 0x14 /* NVM Interrupt Flag Status & Clear */
36 #define SAMD_NVMCTRL_STATUS 0x18 /* NVM status register */
37 #define SAMD_NVMCTRL_ADDR 0x1C /* NVM address register */
38 #define SAMD_NVMCTRL_LOCK 0x20 /* NVM Lock section register */
39 
40 #define SAMD_CMDEX_KEY 0xA5UL
41 #define SAMD_NVM_CMD(n) ((SAMD_CMDEX_KEY << 8) | (n & 0x7F))
42 
43 /* NVMCTRL commands. See Table 20-4 in 42129F–SAM–10/2013 */
44 #define SAMD_NVM_CMD_ER 0x02 /* Erase Row */
45 #define SAMD_NVM_CMD_WP 0x04 /* Write Page */
46 #define SAMD_NVM_CMD_EAR 0x05 /* Erase Auxiliary Row */
47 #define SAMD_NVM_CMD_WAP 0x06 /* Write Auxiliary Page */
48 #define SAMD_NVM_CMD_LR 0x40 /* Lock Region */
49 #define SAMD_NVM_CMD_UR 0x41 /* Unlock Region */
50 #define SAMD_NVM_CMD_SPRM 0x42 /* Set Power Reduction Mode */
51 #define SAMD_NVM_CMD_CPRM 0x43 /* Clear Power Reduction Mode */
52 #define SAMD_NVM_CMD_PBC 0x44 /* Page Buffer Clear */
53 #define SAMD_NVM_CMD_SSB 0x45 /* Set Security Bit */
54 #define SAMD_NVM_CMD_INVALL 0x46 /* Invalidate all caches */
55 
56 /* NVMCTRL bits */
57 #define SAMD_NVM_CTRLB_MANW 0x80
58 
59 /* NVMCTRL_INTFLAG bits */
60 #define SAMD_NVM_INTFLAG_READY 0x01
61 
62 /* Known identifiers */
63 #define SAMD_PROCESSOR_M0 0x01
64 #define SAMD_FAMILY_D 0x00
65 #define SAMD_FAMILY_L 0x01
66 #define SAMD_FAMILY_C 0x02
67 #define SAMD_SERIES_20 0x00
68 #define SAMD_SERIES_21 0x01
69 #define SAMD_SERIES_22 0x02
70 #define SAMD_SERIES_10 0x02
71 #define SAMD_SERIES_11 0x03
72 #define SAMD_SERIES_09 0x04
73 
74 /* Device ID macros */
75 #define SAMD_GET_PROCESSOR(id) (id >> 28)
76 #define SAMD_GET_FAMILY(id) (((id >> 23) & 0x1F))
77 #define SAMD_GET_SERIES(id) (((id >> 16) & 0x3F))
78 #define SAMD_GET_DEVSEL(id) (id & 0xFF)
79 
80 /* Bits to mask out lockbits in user row */
81 #define NVMUSERROW_LOCKBIT_MASK ((uint64_t)0x0000FFFFFFFFFFFF)
82 
83 struct samd_part {
84  uint8_t id;
85  const char *name;
86  uint32_t flash_kb;
87  uint32_t ram_kb;
88 };
89 
90 /* Known SAMD09 parts. DID reset values missing in RM, see
91  * https://github.com/avrxml/asf/blob/master/sam0/utils/cmsis/samd09/include/ */
92 static const struct samd_part samd09_parts[] = {
93  { 0x0, "SAMD09D14A", 16, 4 },
94  { 0x7, "SAMD09C13A", 8, 4 },
95 };
96 
97 /* Known SAMD10 parts */
98 static const struct samd_part samd10_parts[] = {
99  { 0x0, "SAMD10D14AMU", 16, 4 },
100  { 0x1, "SAMD10D13AMU", 8, 4 },
101  { 0x2, "SAMD10D12AMU", 4, 4 },
102  { 0x3, "SAMD10D14ASU", 16, 4 },
103  { 0x4, "SAMD10D13ASU", 8, 4 },
104  { 0x5, "SAMD10D12ASU", 4, 4 },
105  { 0x6, "SAMD10C14A", 16, 4 },
106  { 0x7, "SAMD10C13A", 8, 4 },
107  { 0x8, "SAMD10C12A", 4, 4 },
108 };
109 
110 /* Known SAMD11 parts */
111 static const struct samd_part samd11_parts[] = {
112  { 0x0, "SAMD11D14AM", 16, 4 },
113  { 0x1, "SAMD11D13AMU", 8, 4 },
114  { 0x2, "SAMD11D12AMU", 4, 4 },
115  { 0x3, "SAMD11D14ASS", 16, 4 },
116  { 0x4, "SAMD11D13ASU", 8, 4 },
117  { 0x5, "SAMD11D12ASU", 4, 4 },
118  { 0x6, "SAMD11C14A", 16, 4 },
119  { 0x7, "SAMD11C13A", 8, 4 },
120  { 0x8, "SAMD11C12A", 4, 4 },
121  { 0x9, "SAMD11D14AU", 16, 4 },
122 };
123 
124 /* Known SAMD20 parts. See Table 12-8 in 42129F–SAM–10/2013 */
125 static const struct samd_part samd20_parts[] = {
126  { 0x0, "SAMD20J18A", 256, 32 },
127  { 0x1, "SAMD20J17A", 128, 16 },
128  { 0x2, "SAMD20J16A", 64, 8 },
129  { 0x3, "SAMD20J15A", 32, 4 },
130  { 0x4, "SAMD20J14A", 16, 2 },
131  { 0x5, "SAMD20G18A", 256, 32 },
132  { 0x6, "SAMD20G17A", 128, 16 },
133  { 0x7, "SAMD20G16A", 64, 8 },
134  { 0x8, "SAMD20G15A", 32, 4 },
135  { 0x9, "SAMD20G14A", 16, 2 },
136  { 0xA, "SAMD20E18A", 256, 32 },
137  { 0xB, "SAMD20E17A", 128, 16 },
138  { 0xC, "SAMD20E16A", 64, 8 },
139  { 0xD, "SAMD20E15A", 32, 4 },
140  { 0xE, "SAMD20E14A", 16, 2 },
141 };
142 
143 /* Known SAMD21 parts. */
144 static const struct samd_part samd21_parts[] = {
145  { 0x0, "SAMD21J18A", 256, 32 },
146  { 0x1, "SAMD21J17A", 128, 16 },
147  { 0x2, "SAMD21J16A", 64, 8 },
148  { 0x3, "SAMD21J15A", 32, 4 },
149  { 0x4, "SAMD21J14A", 16, 2 },
150  { 0x5, "SAMD21G18A", 256, 32 },
151  { 0x6, "SAMD21G17A", 128, 16 },
152  { 0x7, "SAMD21G16A", 64, 8 },
153  { 0x8, "SAMD21G15A", 32, 4 },
154  { 0x9, "SAMD21G14A", 16, 2 },
155  { 0xA, "SAMD21E18A", 256, 32 },
156  { 0xB, "SAMD21E17A", 128, 16 },
157  { 0xC, "SAMD21E16A", 64, 8 },
158  { 0xD, "SAMD21E15A", 32, 4 },
159  { 0xE, "SAMD21E14A", 16, 2 },
160 
161  /* SAMR21 parts have integrated SAMD21 with a radio */
162  { 0x18, "SAMR21G19A", 256, 32 }, /* with 512k of serial flash */
163  { 0x19, "SAMR21G18A", 256, 32 },
164  { 0x1A, "SAMR21G17A", 128, 32 },
165  { 0x1B, "SAMR21G16A", 64, 16 },
166  { 0x1C, "SAMR21E18A", 256, 32 },
167  { 0x1D, "SAMR21E17A", 128, 32 },
168  { 0x1E, "SAMR21E16A", 64, 16 },
169 
170  /* SAMD21 B Variants (Table 3-7 from rev I of datasheet) */
171  { 0x20, "SAMD21J16B", 64, 8 },
172  { 0x21, "SAMD21J15B", 32, 4 },
173  { 0x23, "SAMD21G16B", 64, 8 },
174  { 0x24, "SAMD21G15B", 32, 4 },
175  { 0x26, "SAMD21E16B", 64, 8 },
176  { 0x27, "SAMD21E15B", 32, 4 },
177 
178  /* SAMD21 D and L Variants (from Errata)
179  http://ww1.microchip.com/downloads/en/DeviceDoc/
180  SAM-D21-Family-Silicon-Errata-and-DataSheet-Clarification-DS80000760D.pdf */
181  { 0x55, "SAMD21E16BU", 64, 8 },
182  { 0x56, "SAMD21E15BU", 32, 4 },
183  { 0x57, "SAMD21G16L", 64, 8 },
184  { 0x3E, "SAMD21E16L", 64, 8 },
185  { 0x3F, "SAMD21E15L", 32, 4 },
186  { 0x62, "SAMD21E16CU", 64, 8 },
187  { 0x63, "SAMD21E15CU", 32, 4 },
188  { 0x92, "SAMD21J17D", 128, 16 },
189  { 0x93, "SAMD21G17D", 128, 16 },
190  { 0x94, "SAMD21E17D", 128, 16 },
191  { 0x95, "SAMD21E17DU", 128, 16 },
192  { 0x96, "SAMD21G17L", 128, 16 },
193  { 0x97, "SAMD21E17L", 128, 16 },
194 
195  /* Known SAMDA1 parts.
196  SAMD-A1 series uses the same series identifier like the SAMD21
197  taken from http://ww1.microchip.com/downloads/en/DeviceDoc/40001895A.pdf (pages 14-17) */
198  { 0x29, "SAMDA1J16A", 64, 8 },
199  { 0x2A, "SAMDA1J15A", 32, 4 },
200  { 0x2B, "SAMDA1J14A", 16, 4 },
201  { 0x2C, "SAMDA1G16A", 64, 8 },
202  { 0x2D, "SAMDA1G15A", 32, 4 },
203  { 0x2E, "SAMDA1G14A", 16, 4 },
204  { 0x2F, "SAMDA1E16A", 64, 8 },
205  { 0x30, "SAMDA1E15A", 32, 4 },
206  { 0x31, "SAMDA1E14A", 16, 4 },
207  { 0x64, "SAMDA1J16B", 64, 8 },
208  { 0x65, "SAMDA1J15B", 32, 4 },
209  { 0x66, "SAMDA1J14B", 16, 4 },
210  { 0x67, "SAMDA1G16B", 64, 8 },
211  { 0x68, "SAMDA1G15B", 32, 4 },
212  { 0x69, "SAMDA1G14B", 16, 4 },
213  { 0x6A, "SAMDA1E16B", 64, 8 },
214  { 0x6B, "SAMDA1E15B", 32, 4 },
215  { 0x6C, "SAMDA1E14B", 16, 4 },
216 };
217 
218 /* Known SAML21 parts. */
219 static const struct samd_part saml21_parts[] = {
220  { 0x00, "SAML21J18A", 256, 32 },
221  { 0x01, "SAML21J17A", 128, 16 },
222  { 0x02, "SAML21J16A", 64, 8 },
223  { 0x05, "SAML21G18A", 256, 32 },
224  { 0x06, "SAML21G17A", 128, 16 },
225  { 0x07, "SAML21G16A", 64, 8 },
226  { 0x0A, "SAML21E18A", 256, 32 },
227  { 0x0B, "SAML21E17A", 128, 16 },
228  { 0x0C, "SAML21E16A", 64, 8 },
229  { 0x0D, "SAML21E15A", 32, 4 },
230  { 0x0F, "SAML21J18B", 256, 32 },
231  { 0x10, "SAML21J17B", 128, 16 },
232  { 0x11, "SAML21J16B", 64, 8 },
233  { 0x14, "SAML21G18B", 256, 32 },
234  { 0x15, "SAML21G17B", 128, 16 },
235  { 0x16, "SAML21G16B", 64, 8 },
236  { 0x19, "SAML21E18B", 256, 32 },
237  { 0x1A, "SAML21E17B", 128, 16 },
238  { 0x1B, "SAML21E16B", 64, 8 },
239  { 0x1C, "SAML21E15B", 32, 4 },
240 
241  /* SAMR30 parts have integrated SAML21 with a radio */
242  { 0x1E, "SAMR30G18A", 256, 32 },
243  { 0x1F, "SAMR30E18A", 256, 32 },
244 
245  /* SAMR34/R35 parts have integrated SAML21 with a lora radio */
246  { 0x28, "SAMR34J18", 256, 32 },
247  { 0x2B, "SAMR35J18", 256, 32 },
248 };
249 
250 /* Known SAML22 parts. */
251 static const struct samd_part saml22_parts[] = {
252  { 0x00, "SAML22N18A", 256, 32 },
253  { 0x01, "SAML22N17A", 128, 16 },
254  { 0x02, "SAML22N16A", 64, 8 },
255  { 0x05, "SAML22J18A", 256, 32 },
256  { 0x06, "SAML22J17A", 128, 16 },
257  { 0x07, "SAML22J16A", 64, 8 },
258  { 0x0A, "SAML22G18A", 256, 32 },
259  { 0x0B, "SAML22G17A", 128, 16 },
260  { 0x0C, "SAML22G16A", 64, 8 },
261 };
262 
263 /* Known SAMC20 parts. */
264 static const struct samd_part samc20_parts[] = {
265  { 0x00, "SAMC20J18A", 256, 32 },
266  { 0x01, "SAMC20J17A", 128, 16 },
267  { 0x02, "SAMC20J16A", 64, 8 },
268  { 0x03, "SAMC20J15A", 32, 4 },
269  { 0x05, "SAMC20G18A", 256, 32 },
270  { 0x06, "SAMC20G17A", 128, 16 },
271  { 0x07, "SAMC20G16A", 64, 8 },
272  { 0x08, "SAMC20G15A", 32, 4 },
273  { 0x0A, "SAMC20E18A", 256, 32 },
274  { 0x0B, "SAMC20E17A", 128, 16 },
275  { 0x0C, "SAMC20E16A", 64, 8 },
276  { 0x0D, "SAMC20E15A", 32, 4 },
277  { 0x20, "SAMC20N18A", 256, 32 },
278  { 0x21, "SAMC20N17A", 128, 16 },
279 };
280 
281 /* Known SAMC21 parts. */
282 static const struct samd_part samc21_parts[] = {
283  { 0x00, "SAMC21J18A", 256, 32 },
284  { 0x01, "SAMC21J17A", 128, 16 },
285  { 0x02, "SAMC21J16A", 64, 8 },
286  { 0x03, "SAMC21J15A", 32, 4 },
287  { 0x05, "SAMC21G18A", 256, 32 },
288  { 0x06, "SAMC21G17A", 128, 16 },
289  { 0x07, "SAMC21G16A", 64, 8 },
290  { 0x08, "SAMC21G15A", 32, 4 },
291  { 0x0A, "SAMC21E18A", 256, 32 },
292  { 0x0B, "SAMC21E17A", 128, 16 },
293  { 0x0C, "SAMC21E16A", 64, 8 },
294  { 0x0D, "SAMC21E15A", 32, 4 },
295  { 0x20, "SAMC21N18A", 256, 32 },
296  { 0x21, "SAMC21N17A", 128, 16 },
297 };
298 
299 /* Each family of parts contains a parts table in the DEVSEL field of DID. The
300  * processor ID, family ID, and series ID are used to determine which exact
301  * family this is and then we can use the corresponding table. */
302 struct samd_family {
303  uint8_t processor;
304  uint8_t family;
305  uint8_t series;
306  const struct samd_part *parts;
307  size_t num_parts;
308  uint64_t nvm_userrow_res_mask; /* protect bits which are reserved, 0 -> protect */
309 };
310 
311 /* Known SAMD families */
312 static const struct samd_family samd_families[] = {
315  (uint64_t)0xFFFF01FFFE01FF77 },
318  (uint64_t)0xFFFF01FFFE01FF77 },
321  (uint64_t)0xFFFF01FFFE01FF77 },
324  (uint64_t)0xFFFF01FFFE01FF77 },
327  (uint64_t)0xFFFF01FFFE01FF77 },
330  (uint64_t)0xFFFF03FFFC01FF77 },
333  (uint64_t)0xFFFF03FFFC01FF77 },
336  (uint64_t)0xFFFF03FFFC01FF77 },
339  (uint64_t)0xFFFF03FFFC01FF77 },
340 };
341 
342 struct samd_info {
343  uint32_t page_size;
347 
348  bool probed;
349  struct target *target;
350 };
351 
352 
358 static const struct samd_family *samd_find_family(uint32_t id)
359 {
360  uint8_t processor = SAMD_GET_PROCESSOR(id);
361  uint8_t family = SAMD_GET_FAMILY(id);
362  uint8_t series = SAMD_GET_SERIES(id);
363 
364  for (unsigned i = 0; i < ARRAY_SIZE(samd_families); i++) {
365  if (samd_families[i].processor == processor &&
366  samd_families[i].series == series &&
368  return &samd_families[i];
369  }
370 
371  return NULL;
372 }
373 
379 static const struct samd_part *samd_find_part(uint32_t id)
380 {
381  uint8_t devsel = SAMD_GET_DEVSEL(id);
382  const struct samd_family *family = samd_find_family(id);
383  if (!family)
384  return NULL;
385 
386  for (unsigned i = 0; i < family->num_parts; i++) {
387  if (family->parts[i].id == devsel)
388  return &family->parts[i];
389  }
390 
391  return NULL;
392 }
393 
394 static int samd_protect_check(struct flash_bank *bank)
395 {
396  int res;
397  uint16_t lock;
398 
399  res = target_read_u16(bank->target,
401  if (res != ERROR_OK)
402  return res;
403 
404  /* Lock bits are active-low */
405  for (unsigned int prot_block = 0; prot_block < bank->num_prot_blocks; prot_block++)
406  bank->prot_blocks[prot_block].is_protected = !(lock & (1u<<prot_block));
407 
408  return ERROR_OK;
409 }
410 
412  uint32_t *sizep, int *nump)
413 {
414  int res;
415  uint32_t param;
416 
418  if (res == ERROR_OK) {
419  /* The PSZ field (bits 18:16) indicate the page size bytes as 2^(3+n)
420  * so 0 is 8KB and 7 is 1024KB. */
421  if (sizep)
422  *sizep = (8 << ((param >> 16) & 0x7));
423  /* The NVMP field (bits 15:0) indicates the total number of pages */
424  if (nump)
425  *nump = param & 0xFFFF;
426  } else {
427  LOG_ERROR("Couldn't read NVM Parameters register");
428  }
429 
430  return res;
431 }
432 
433 static int samd_probe(struct flash_bank *bank)
434 {
435  uint32_t id;
436  int res;
437  struct samd_info *chip = (struct samd_info *)bank->driver_priv;
438  const struct samd_part *part;
439 
440  if (chip->probed)
441  return ERROR_OK;
442 
443  res = target_read_u32(bank->target, SAMD_DSU + SAMD_DSU_DID, &id);
444  if (res != ERROR_OK) {
445  LOG_ERROR("Couldn't read Device ID register");
446  return res;
447  }
448 
449  part = samd_find_part(id);
450  if (!part) {
451  LOG_ERROR("Couldn't find part corresponding to DID %08" PRIx32, id);
452  return ERROR_FAIL;
453  }
454 
455  bank->size = part->flash_kb * 1024;
456 
457  res = samd_get_flash_page_info(bank->target, &chip->page_size,
458  &chip->num_pages);
459  if (res != ERROR_OK) {
460  LOG_ERROR("Couldn't determine Flash page size");
461  return res;
462  }
463 
464  /* Sanity check: the total flash size in the DSU should match the page size
465  * multiplied by the number of pages. */
466  if (bank->size != chip->num_pages * chip->page_size) {
467  LOG_WARNING("SAMD: bank size doesn't match NVM parameters. "
468  "Identified %" PRIu32 "KB Flash but NVMCTRL reports %u %" PRIu32 "B pages",
469  part->flash_kb, chip->num_pages, chip->page_size);
470  }
471 
472  /* Erase granularity = 1 row = 4 pages */
473  chip->sector_size = chip->page_size * 4;
474 
475  /* Allocate the sector table */
476  bank->num_sectors = chip->num_pages / 4;
477  bank->sectors = alloc_block_array(0, chip->sector_size, bank->num_sectors);
478  if (!bank->sectors)
479  return ERROR_FAIL;
480 
481  /* 16 protection blocks per device */
482  chip->prot_block_size = bank->size / SAMD_NUM_PROT_BLOCKS;
483 
484  /* Allocate the table of protection blocks */
485  bank->num_prot_blocks = SAMD_NUM_PROT_BLOCKS;
486  bank->prot_blocks = alloc_block_array(0, chip->prot_block_size, bank->num_prot_blocks);
487  if (!bank->prot_blocks)
488  return ERROR_FAIL;
489 
491 
492  /* Done */
493  chip->probed = true;
494 
495  LOG_INFO("SAMD MCU: %s (%" PRIu32 "KB Flash, %" PRIu32 "KB RAM)", part->name,
496  part->flash_kb, part->ram_kb);
497 
498  return ERROR_OK;
499 }
500 
501 static int samd_check_error(struct target *target)
502 {
503  int ret, ret2;
504  uint8_t intflag;
505  uint16_t status;
506  int timeout_ms = 1000;
507  int64_t ts_start = timeval_ms();
508 
509  do {
510  ret = target_read_u8(target,
511  SAMD_NVMCTRL + SAMD_NVMCTRL_INTFLAG, &intflag);
512  if (ret != ERROR_OK) {
513  LOG_ERROR("Can't read NVM intflag");
514  return ret;
515  }
516  if (intflag & SAMD_NVM_INTFLAG_READY)
517  break;
518  keep_alive();
519  } while (timeval_ms() - ts_start < timeout_ms);
520 
521  if (!(intflag & SAMD_NVM_INTFLAG_READY)) {
522  LOG_ERROR("SAMD: NVM programming timed out");
524  }
525 
526  ret = target_read_u16(target,
528  if (ret != ERROR_OK) {
529  LOG_ERROR("Can't read NVM status");
530  return ret;
531  }
532 
533  if ((status & 0x001C) == 0)
534  return ERROR_OK;
535 
536  if (status & (1 << 4)) { /* NVME */
537  LOG_ERROR("SAMD: NVM Error");
539  }
540 
541  if (status & (1 << 3)) { /* LOCKE */
542  LOG_ERROR("SAMD: NVM lock error");
543  ret = ERROR_FLASH_PROTECTED;
544  }
545 
546  if (status & (1 << 2)) { /* PROGE */
547  LOG_ERROR("SAMD: NVM programming error");
549  }
550 
551  /* Clear the error conditions by writing a one to them */
552  ret2 = target_write_u16(target,
554  if (ret2 != ERROR_OK)
555  LOG_ERROR("Can't clear NVM error conditions");
556 
557  return ret;
558 }
559 
560 static int samd_issue_nvmctrl_command(struct target *target, uint16_t cmd)
561 {
562  int res;
563 
564  if (target->state != TARGET_HALTED) {
565  LOG_ERROR("Target not halted");
567  }
568 
569  /* Issue the NVM command */
570  /* 32-bit write is used to ensure atomic operation on ST-Link */
571  res = target_write_u32(target,
573  if (res != ERROR_OK)
574  return res;
575 
576  /* Check to see if the NVM command resulted in an error condition. */
577  return samd_check_error(target);
578 }
579 
586 static int samd_erase_row(struct target *target, uint32_t address)
587 {
588  int res;
589 
590  /* Set an address contained in the row to be erased */
591  res = target_write_u32(target,
592  SAMD_NVMCTRL + SAMD_NVMCTRL_ADDR, address >> 1);
593 
594  /* Issue the Erase Row command to erase that row. */
595  if (res == ERROR_OK)
598 
599  if (res != ERROR_OK) {
600  LOG_ERROR("Failed to erase row containing %08" PRIx32, address);
601  return ERROR_FAIL;
602  }
603 
604  return ERROR_OK;
605 }
606 
613 static int samd_get_reservedmask(struct target *target, uint64_t *mask)
614 {
615  int res;
616  /* Get the devicetype */
617  uint32_t id;
619  if (res != ERROR_OK) {
620  LOG_ERROR("Couldn't read Device ID register");
621  return res;
622  }
623  const struct samd_family *family;
624  family = samd_find_family(id);
625  if (!family) {
626  LOG_ERROR("Couldn't determine device family");
627  return ERROR_FAIL;
628  }
629  *mask = family->nvm_userrow_res_mask;
630  return ERROR_OK;
631 }
632 
633 static int read_userrow(struct target *target, uint64_t *userrow)
634 {
635  int res;
636  uint8_t buffer[8];
637 
639  if (res != ERROR_OK)
640  return res;
641 
642  *userrow = target_buffer_get_u64(target, buffer);
643  return ERROR_OK;
644 }
645 
657  uint64_t value_input, uint64_t value_mask)
658 {
659  int res;
660  uint32_t nvm_ctrlb;
661  bool manual_wp = true;
662 
663  /* Retrieve the MCU's page size, in bytes. This is also the size of the
664  * entire User Row. */
665  uint32_t page_size;
666  res = samd_get_flash_page_info(target, &page_size, NULL);
667  if (res != ERROR_OK) {
668  LOG_ERROR("Couldn't determine Flash page size");
669  return res;
670  }
671 
672  /* Make sure the size is sane. */
673  assert(page_size <= SAMD_PAGE_SIZE_MAX &&
674  page_size >= sizeof(value_input));
675 
676  uint8_t buf[SAMD_PAGE_SIZE_MAX];
677  /* Read the user row (comprising one page) by words. */
678  res = target_read_memory(target, SAMD_USER_ROW, 4, page_size / 4, buf);
679  if (res != ERROR_OK)
680  return res;
681 
682  uint64_t value_device;
683  res = read_userrow(target, &value_device);
684  if (res != ERROR_OK)
685  return res;
686  uint64_t value_new = (value_input & value_mask) | (value_device & ~value_mask);
687 
688  /* We will need to erase before writing if the new value needs a '1' in any
689  * position for which the current value had a '0'. Otherwise we can avoid
690  * erasing. */
691  if ((~value_device) & value_new) {
693  if (res != ERROR_OK) {
694  LOG_ERROR("Couldn't erase user row");
695  return res;
696  }
697  }
698 
699  /* Modify */
700  target_buffer_set_u64(target, buf, value_new);
701 
702  /* Write the page buffer back out to the target. */
703  res = target_write_memory(target, SAMD_USER_ROW, 4, page_size / 4, buf);
704  if (res != ERROR_OK)
705  return res;
706 
707  /* Check if we need to do manual page write commands */
709  if (res == ERROR_OK)
710  manual_wp = (nvm_ctrlb & SAMD_NVM_CTRLB_MANW) != 0;
711  else {
712  LOG_ERROR("Read of NVM register CTRKB failed.");
713  return ERROR_FAIL;
714  }
715  if (manual_wp) {
716  /* Trigger flash write */
718  } else {
719  res = samd_check_error(target);
720  }
721 
722  return res;
723 }
724 
733 static int samd_modify_user_row(struct target *target, uint64_t value,
734  uint8_t startb, uint8_t endb)
735 {
736  uint64_t mask = 0;
737  int i;
738  for (i = startb ; i <= endb ; i++)
739  mask |= ((uint64_t)1) << i;
740 
741  return samd_modify_user_row_masked(target, value << startb, mask);
742 }
743 
744 static int samd_protect(struct flash_bank *bank, int set,
745  unsigned int first, unsigned int last)
746 {
747  int res = ERROR_OK;
748 
749  /* We can issue lock/unlock region commands with the target running but
750  * the settings won't persist unless we're able to modify the LOCK regions
751  * and that requires the target to be halted. */
752  if (bank->target->state != TARGET_HALTED) {
753  LOG_ERROR("Target not halted");
755  }
756 
757  for (unsigned int prot_block = first; prot_block <= last; prot_block++) {
758  if (set != bank->prot_blocks[prot_block].is_protected) {
759  /* Load an address that is within this protection block (we use offset 0) */
760  res = target_write_u32(bank->target,
762  bank->prot_blocks[prot_block].offset >> 1);
763  if (res != ERROR_OK)
764  goto exit;
765 
766  /* Tell the controller to lock that block */
767  res = samd_issue_nvmctrl_command(bank->target,
769  if (res != ERROR_OK)
770  goto exit;
771  }
772  }
773 
774  /* We've now applied our changes, however they will be undone by the next
775  * reset unless we also apply them to the LOCK bits in the User Page. The
776  * LOCK bits start at bit 48, corresponding to Sector 0 and end with bit 63,
777  * corresponding to Sector 15. A '1' means unlocked and a '0' means
778  * locked. See Table 9-3 in the SAMD20 datasheet for more details. */
779 
780  res = samd_modify_user_row(bank->target,
781  set ? (uint64_t)0 : (uint64_t)UINT64_MAX,
782  48 + first, 48 + last);
783  if (res != ERROR_OK)
784  LOG_WARNING("SAMD: protect settings were not made persistent!");
785 
786  res = ERROR_OK;
787 
788 exit:
790 
791  return res;
792 }
793 
794 static int samd_erase(struct flash_bank *bank, unsigned int first,
795  unsigned int last)
796 {
797  int res;
798  struct samd_info *chip = (struct samd_info *)bank->driver_priv;
799 
800  if (bank->target->state != TARGET_HALTED) {
801  LOG_ERROR("Target not halted");
802 
804  }
805 
806  if (!chip->probed) {
807  if (samd_probe(bank) != ERROR_OK)
809  }
810 
811  /* For each sector to be erased */
812  for (unsigned int s = first; s <= last; s++) {
813  res = samd_erase_row(bank->target, bank->sectors[s].offset);
814  if (res != ERROR_OK) {
815  LOG_ERROR("SAMD: failed to erase sector %d at 0x%08" PRIx32, s, bank->sectors[s].offset);
816  return res;
817  }
818  }
819 
820  return ERROR_OK;
821 }
822 
823 
824 static int samd_write(struct flash_bank *bank, const uint8_t *buffer,
825  uint32_t offset, uint32_t count)
826 {
827  int res;
828  uint32_t nvm_ctrlb;
829  uint32_t address;
830  uint32_t pg_offset;
831  uint32_t nb;
832  uint32_t nw;
833  struct samd_info *chip = (struct samd_info *)bank->driver_priv;
834  uint8_t *pb = NULL;
835  bool manual_wp;
836 
837  if (bank->target->state != TARGET_HALTED) {
838  LOG_ERROR("Target not halted");
840  }
841 
842  if (!chip->probed) {
843  if (samd_probe(bank) != ERROR_OK)
845  }
846 
847  /* Check if we need to do manual page write commands */
848  res = target_read_u32(bank->target, SAMD_NVMCTRL + SAMD_NVMCTRL_CTRLB, &nvm_ctrlb);
849 
850  if (res != ERROR_OK)
851  return res;
852 
853  if (nvm_ctrlb & SAMD_NVM_CTRLB_MANW)
854  manual_wp = true;
855  else
856  manual_wp = false;
857 
859  if (res != ERROR_OK) {
860  LOG_ERROR("%s: %d", __func__, __LINE__);
861  return res;
862  }
863 
864  while (count) {
865  nb = chip->page_size - offset % chip->page_size;
866  if (count < nb)
867  nb = count;
868 
869  address = bank->base + offset;
870  pg_offset = offset % chip->page_size;
871 
872  if (offset % 4 || (offset + nb) % 4) {
873  /* Either start or end of write is not word aligned */
874  if (!pb) {
875  pb = malloc(chip->page_size);
876  if (!pb)
877  return ERROR_FAIL;
878  }
879 
880  /* Set temporary page buffer to 0xff and overwrite the relevant part */
881  memset(pb, 0xff, chip->page_size);
882  memcpy(pb + pg_offset, buffer, nb);
883 
884  /* Align start address to a word boundary */
885  address -= offset % 4;
886  pg_offset -= offset % 4;
887  assert(pg_offset % 4 == 0);
888 
889  /* Extend length to whole words */
890  nw = (nb + offset % 4 + 3) / 4;
891  assert(pg_offset + 4 * nw <= chip->page_size);
892 
893  /* Now we have original data extended by 0xff bytes
894  * to the nearest word boundary on both start and end */
895  res = target_write_memory(bank->target, address, 4, nw, pb + pg_offset);
896  } else {
897  assert(nb % 4 == 0);
898  nw = nb / 4;
899  assert(pg_offset + 4 * nw <= chip->page_size);
900 
901  /* Word aligned data, use direct write from buffer */
902  res = target_write_memory(bank->target, address, 4, nw, buffer);
903  }
904  if (res != ERROR_OK) {
905  LOG_ERROR("%s: %d", __func__, __LINE__);
906  goto free_pb;
907  }
908 
909  /* Devices with errata 13134 have automatic page write enabled by default
910  * For other devices issue a write page CMD to the NVM
911  * If the page has not been written up to the last word
912  * then issue CMD_WP always */
913  if (manual_wp || pg_offset + 4 * nw < chip->page_size) {
915  } else {
916  /* Access through AHB is stalled while flash is being programmed */
917  usleep(200);
918 
919  res = samd_check_error(bank->target);
920  }
921 
922  if (res != ERROR_OK) {
923  LOG_ERROR("%s: write failed at address 0x%08" PRIx32, __func__, address);
924  goto free_pb;
925  }
926 
927  /* We're done with the page contents */
928  count -= nb;
929  offset += nb;
930  buffer += nb;
931  }
932 
933 free_pb:
934  free(pb);
935  return res;
936 }
937 
938 FLASH_BANK_COMMAND_HANDLER(samd_flash_bank_command)
939 {
940  if (bank->base != SAMD_FLASH) {
941  LOG_ERROR("Address " TARGET_ADDR_FMT
942  " invalid bank address (try 0x%08" PRIx32
943  "[at91samd series] )",
944  bank->base, SAMD_FLASH);
945  return ERROR_FAIL;
946  }
947 
948  struct samd_info *chip;
949  chip = calloc(1, sizeof(*chip));
950  if (!chip) {
951  LOG_ERROR("No memory for flash bank chip info");
952  return ERROR_FAIL;
953  }
954 
955  chip->target = bank->target;
956  chip->probed = false;
957 
958  bank->driver_priv = chip;
959 
960  return ERROR_OK;
961 }
962 
963 COMMAND_HANDLER(samd_handle_chip_erase_command)
964 {
966  int res = ERROR_FAIL;
967 
968  if (target) {
969  /* Enable access to the DSU by disabling the write protect bit */
971  /* intentionally without error checking - not accessible on secured chip */
972 
973  /* Tell the DSU to perform a full chip erase. It takes about 240ms to
974  * perform the erase. */
976  if (res == ERROR_OK)
977  command_print(CMD, "chip erase started");
978  else
979  command_print(CMD, "write to DSU CTRL failed");
980  }
981 
982  return res;
983 }
984 
985 COMMAND_HANDLER(samd_handle_set_security_command)
986 {
987  int res = ERROR_OK;
989 
990  if (CMD_ARGC < 1 || (CMD_ARGC >= 1 && (strcmp(CMD_ARGV[0], "enable")))) {
991  command_print(CMD, "supply the \"enable\" argument to proceed.");
993  }
994 
995  if (target) {
996  if (target->state != TARGET_HALTED) {
997  LOG_ERROR("Target not halted");
999  }
1000 
1002 
1003  /* Check (and clear) error conditions */
1004  if (res == ERROR_OK)
1005  command_print(CMD, "chip secured on next power-cycle");
1006  else
1007  command_print(CMD, "failed to secure chip");
1008  }
1009 
1010  return res;
1011 }
1012 
1013 COMMAND_HANDLER(samd_handle_eeprom_command)
1014 {
1015  int res = ERROR_OK;
1017 
1018  if (target) {
1019  if (target->state != TARGET_HALTED) {
1020  LOG_ERROR("Target not halted");
1021  return ERROR_TARGET_NOT_HALTED;
1022  }
1023 
1024  if (CMD_ARGC >= 1) {
1025  int val = atoi(CMD_ARGV[0]);
1026  uint32_t code;
1027 
1028  if (val == 0)
1029  code = 7;
1030  else {
1031  /* Try to match size in bytes with corresponding size code */
1032  for (code = 0; code <= 6; code++) {
1033  if (val == (2 << (13 - code)))
1034  break;
1035  }
1036 
1037  if (code > 6) {
1038  command_print(CMD, "Invalid EEPROM size. Please see "
1039  "datasheet for a list valid sizes.");
1041  }
1042  }
1043 
1044  res = samd_modify_user_row(target, code, 4, 6);
1045  } else {
1046  uint16_t val;
1047  res = target_read_u16(target, SAMD_USER_ROW, &val);
1048  if (res == ERROR_OK) {
1049  uint32_t size = ((val >> 4) & 0x7); /* grab size code */
1050 
1051  if (size == 0x7)
1052  command_print(CMD, "EEPROM is disabled");
1053  else {
1054  /* Otherwise, 6 is 256B, 0 is 16KB */
1055  command_print(CMD, "EEPROM size is %u bytes",
1056  (2 << (13 - size)));
1057  }
1058  }
1059  }
1060  }
1061 
1062  return res;
1063 }
1064 
1065 COMMAND_HANDLER(samd_handle_nvmuserrow_command)
1066 {
1067  int res = ERROR_OK;
1069 
1070  if (target) {
1071  if (CMD_ARGC > 2) {
1072  command_print(CMD, "Too much Arguments given.");
1074  }
1075 
1076  if (CMD_ARGC > 0) {
1077  if (target->state != TARGET_HALTED) {
1078  LOG_ERROR("Target not halted.");
1079  return ERROR_TARGET_NOT_HALTED;
1080  }
1081 
1082  uint64_t mask;
1084  if (res != ERROR_OK) {
1085  LOG_ERROR("Couldn't determine the mask for reserved bits.");
1086  return ERROR_FAIL;
1087  }
1089 
1090  uint64_t value;
1091  COMMAND_PARSE_NUMBER(u64, CMD_ARGV[0], value);
1092 
1093  if (CMD_ARGC == 2) {
1094  uint64_t mask_temp;
1095  COMMAND_PARSE_NUMBER(u64, CMD_ARGV[1], mask_temp);
1096 
1097  mask &= mask_temp;
1098  }
1099  res = samd_modify_user_row_masked(target, value, mask);
1100  if (res != ERROR_OK)
1101  return res;
1102  }
1103 
1104  /* read register */
1105  uint64_t value;
1106  res = read_userrow(target, &value);
1107  if (res == ERROR_OK)
1108  command_print(CMD, "NVMUSERROW: 0x%016"PRIX64, value);
1109  else
1110  LOG_ERROR("NVMUSERROW could not be read.");
1111  }
1112  return res;
1113 }
1114 
1115 COMMAND_HANDLER(samd_handle_bootloader_command)
1116 {
1117  int res = ERROR_OK;
1119 
1120  if (target) {
1121  if (target->state != TARGET_HALTED) {
1122  LOG_ERROR("Target not halted");
1123  return ERROR_TARGET_NOT_HALTED;
1124  }
1125 
1126  /* Retrieve the MCU's page size, in bytes. */
1127  uint32_t page_size;
1128  res = samd_get_flash_page_info(target, &page_size, NULL);
1129  if (res != ERROR_OK) {
1130  LOG_ERROR("Couldn't determine Flash page size");
1131  return res;
1132  }
1133 
1134  if (CMD_ARGC >= 1) {
1135  int val = atoi(CMD_ARGV[0]);
1136  uint32_t code;
1137 
1138  if (val == 0)
1139  code = 7;
1140  else {
1141  /* Try to match size in bytes with corresponding size code */
1142  for (code = 0; code <= 6; code++) {
1143  if ((unsigned int)val == (2UL << (8UL - code)) * page_size)
1144  break;
1145  }
1146 
1147  if (code > 6) {
1148  command_print(CMD, "Invalid bootloader size. Please "
1149  "see datasheet for a list valid sizes.");
1151  }
1152 
1153  }
1154 
1155  res = samd_modify_user_row(target, code, 0, 2);
1156  } else {
1157  uint16_t val;
1158  res = target_read_u16(target, SAMD_USER_ROW, &val);
1159  if (res == ERROR_OK) {
1160  uint32_t size = (val & 0x7); /* grab size code */
1161  uint32_t nb;
1162 
1163  if (size == 0x7)
1164  nb = 0;
1165  else
1166  nb = (2 << (8 - size)) * page_size;
1167 
1168  /* There are 4 pages per row */
1169  command_print(CMD, "Bootloader size is %" PRIu32 " bytes (%" PRIu32 " rows)",
1170  nb, (uint32_t)(nb / (page_size * 4)));
1171  }
1172  }
1173  }
1174 
1175  return res;
1176 }
1177 
1178 
1179 
1180 COMMAND_HANDLER(samd_handle_reset_deassert)
1181 {
1183  int retval = ERROR_OK;
1185 
1186  /* If the target has been unresponsive before, try to re-establish
1187  * communication now - CPU is held in reset by DSU, DAP is working */
1191 
1192  /* In case of sysresetreq, debug retains state set in cortex_m_assert_reset()
1193  * so we just release reset held by DSU
1194  *
1195  * n_RESET (srst) clears the DP, so reenable debug and set vector catch here
1196  *
1197  * After vectreset DSU release is not needed however makes no harm
1198  */
1201  if (retval == ERROR_OK)
1202  retval = target_write_u32(target, DCB_DEMCR,
1204  /* do not return on error here, releasing DSU reset is more important */
1205  }
1206 
1207  /* clear CPU Reset Phase Extension bit */
1208  int retval2 = target_write_u8(target, SAMD_DSU + SAMD_DSU_STATUSA, (1<<1));
1209  if (retval2 != ERROR_OK)
1210  return retval2;
1211 
1212  return retval;
1213 }
1214 
1215 static const struct command_registration at91samd_exec_command_handlers[] = {
1216  {
1217  .name = "dsu_reset_deassert",
1218  .handler = samd_handle_reset_deassert,
1219  .mode = COMMAND_EXEC,
1220  .help = "Deassert internal reset held by DSU.",
1221  .usage = "",
1222  },
1223  {
1224  .name = "chip-erase",
1225  .handler = samd_handle_chip_erase_command,
1226  .mode = COMMAND_EXEC,
1227  .help = "Erase the entire Flash by using the Chip-"
1228  "Erase feature in the Device Service Unit (DSU).",
1229  .usage = "",
1230  },
1231  {
1232  .name = "set-security",
1233  .handler = samd_handle_set_security_command,
1234  .mode = COMMAND_EXEC,
1235  .help = "Secure the chip's Flash by setting the Security Bit. "
1236  "This makes it impossible to read the Flash contents. "
1237  "The only way to undo this is to issue the chip-erase "
1238  "command.",
1239  .usage = "'enable'",
1240  },
1241  {
1242  .name = "eeprom",
1243  .usage = "[size_in_bytes]",
1244  .handler = samd_handle_eeprom_command,
1245  .mode = COMMAND_EXEC,
1246  .help = "Show or set the EEPROM size setting, stored in the User Row. "
1247  "Please see Table 20-3 of the SAMD20 datasheet for allowed values. "
1248  "Changes are stored immediately but take affect after the MCU is "
1249  "reset.",
1250  },
1251  {
1252  .name = "bootloader",
1253  .usage = "[size_in_bytes]",
1254  .handler = samd_handle_bootloader_command,
1255  .mode = COMMAND_EXEC,
1256  .help = "Show or set the bootloader size, stored in the User Row. "
1257  "Please see Table 20-2 of the SAMD20 datasheet for allowed values. "
1258  "Changes are stored immediately but take affect after the MCU is "
1259  "reset.",
1260  },
1261  {
1262  .name = "nvmuserrow",
1263  .usage = "[value] [mask]",
1264  .handler = samd_handle_nvmuserrow_command,
1265  .mode = COMMAND_EXEC,
1266  .help = "Show or set the nvmuserrow register. It is 64 bit wide "
1267  "and located at address 0x804000. Use the optional mask argument "
1268  "to prevent changes at positions where the bitvalue is zero. "
1269  "For security reasons the lock- and reserved-bits are masked out "
1270  "in background and therefore cannot be changed.",
1271  },
1273 };
1274 
1275 static const struct command_registration at91samd_command_handlers[] = {
1276  {
1277  .name = "at91samd",
1278  .mode = COMMAND_ANY,
1279  .help = "at91samd flash command group",
1280  .usage = "",
1282  },
1284 };
1285 
1286 const struct flash_driver at91samd_flash = {
1287  .name = "at91samd",
1288  .commands = at91samd_command_handlers,
1289  .flash_bank_command = samd_flash_bank_command,
1290  .erase = samd_erase,
1291  .protect = samd_protect,
1292  .write = samd_write,
1293  .read = default_flash_read,
1294  .probe = samd_probe,
1295  .auto_probe = samd_probe,
1296  .erase_check = default_flash_blank_check,
1297  .protect_check = samd_protect_check,
1298  .free_driver_priv = default_flash_free_driver_priv,
1299 };
static struct aice_port_param_s param
#define SAMD_DSU_STATUSA
Definition: at91samd.c:28
static const struct samd_part samd21_parts[]
Definition: at91samd.c:144
#define SAMD_NVMCTRL_CTRLB
Definition: at91samd.c:33
const struct flash_driver at91samd_flash
Definition: at91samd.c:1286
#define SAMD_GET_SERIES(id)
Definition: at91samd.c:77
#define NVMUSERROW_LOCKBIT_MASK
Definition: at91samd.c:81
#define SAMD_NVMCTRL_CTRLA
Definition: at91samd.c:32
static const struct samd_part samd20_parts[]
Definition: at91samd.c:125
#define SAMD_NVM_CMD_PBC
Definition: at91samd.c:52
static int samd_get_flash_page_info(struct target *target, uint32_t *sizep, int *nump)
Definition: at91samd.c:411
#define SAMD_NVM_CMD_WAP
Definition: at91samd.c:47
#define SAMD_FAMILY_D
Definition: at91samd.c:64
static const struct samd_family * samd_find_family(uint32_t id)
Gives the family structure to specific device id.
Definition: at91samd.c:358
#define SAMD_NVM_CMD_WP
Definition: at91samd.c:45
#define SAMD_NUM_PROT_BLOCKS
Definition: at91samd.c:19
COMMAND_HANDLER(samd_handle_chip_erase_command)
Definition: at91samd.c:963
static int samd_probe(struct flash_bank *bank)
Definition: at91samd.c:433
FLASH_BANK_COMMAND_HANDLER(samd_flash_bank_command)
Definition: at91samd.c:938
#define SAMD_GET_DEVSEL(id)
Definition: at91samd.c:78
#define SAMD_GET_FAMILY(id)
Definition: at91samd.c:76
static int samd_protect_check(struct flash_bank *bank)
Definition: at91samd.c:394
static int samd_modify_user_row_masked(struct target *target, uint64_t value_input, uint64_t value_mask)
Modify the contents of the User Row in Flash.
Definition: at91samd.c:656
#define SAMD_NVMCTRL_LOCK
Definition: at91samd.c:38
#define SAMD_NVM_CMD_ER
Definition: at91samd.c:44
#define SAMD_NVM_CMD_LR
Definition: at91samd.c:48
#define SAMD_PAC1
Definition: at91samd.c:24
#define SAMD_NVM_CMD_SSB
Definition: at91samd.c:53
#define SAMD_NVM_CMD_UR
Definition: at91samd.c:49
#define SAMD_GET_PROCESSOR(id)
Definition: at91samd.c:75
#define SAMD_SERIES_09
Definition: at91samd.c:72
static int samd_check_error(struct target *target)
Definition: at91samd.c:501
static const struct command_registration at91samd_exec_command_handlers[]
Definition: at91samd.c:1215
#define SAMD_NVM_INTFLAG_READY
Definition: at91samd.c:60
#define SAMD_PROCESSOR_M0
Definition: at91samd.c:63
#define SAMD_DSU_CTRL_EXT
Definition: at91samd.c:30
static const struct command_registration at91samd_command_handlers[]
Definition: at91samd.c:1275
static int samd_protect(struct flash_bank *bank, int set, unsigned int first, unsigned int last)
Definition: at91samd.c:744
static const struct samd_part samd11_parts[]
Definition: at91samd.c:111
#define SAMD_DSU
Definition: at91samd.c:25
#define SAMD_NVMCTRL_PARAM
Definition: at91samd.c:34
#define SAMD_FLASH
Definition: at91samd.c:22
#define SAMD_NVMCTRL_STATUS
Definition: at91samd.c:36
#define SAMD_PAGE_SIZE_MAX
Definition: at91samd.c:20
#define SAMD_DSU_DID
Definition: at91samd.c:29
static const struct samd_part samd09_parts[]
Definition: at91samd.c:92
static const struct samd_part saml22_parts[]
Definition: at91samd.c:251
#define SAMD_SERIES_11
Definition: at91samd.c:71
static int samd_issue_nvmctrl_command(struct target *target, uint16_t cmd)
Definition: at91samd.c:560
static int samd_modify_user_row(struct target *target, uint64_t value, uint8_t startb, uint8_t endb)
Modifies the user row register to the given value.
Definition: at91samd.c:733
#define SAMD_NVMCTRL
Definition: at91samd.c:26
#define SAMD_NVM_CMD(n)
Definition: at91samd.c:41
static int read_userrow(struct target *target, uint64_t *userrow)
Definition: at91samd.c:633
#define SAMD_NVMCTRL_INTFLAG
Definition: at91samd.c:35
#define SAMD_SERIES_22
Definition: at91samd.c:69
#define SAMD_USER_ROW
Definition: at91samd.c:23
static const struct samd_part samd10_parts[]
Definition: at91samd.c:98
static int samd_erase(struct flash_bank *bank, unsigned int first, unsigned int last)
Definition: at91samd.c:794
#define SAMD_NVM_CMD_EAR
Definition: at91samd.c:46
#define SAMD_NVMCTRL_ADDR
Definition: at91samd.c:37
#define SAMD_SERIES_20
Definition: at91samd.c:67
#define SAMD_SERIES_10
Definition: at91samd.c:70
static int samd_write(struct flash_bank *bank, const uint8_t *buffer, uint32_t offset, uint32_t count)
Definition: at91samd.c:824
static const struct samd_part * samd_find_part(uint32_t id)
Gives the part structure to specific device id.
Definition: at91samd.c:379
static const struct samd_family samd_families[]
Definition: at91samd.c:312
#define SAMD_FAMILY_C
Definition: at91samd.c:66
static const struct samd_part saml21_parts[]
Definition: at91samd.c:219
#define SAMD_NVM_CTRLB_MANW
Definition: at91samd.c:57
static const struct samd_part samc20_parts[]
Definition: at91samd.c:264
static const struct samd_part samc21_parts[]
Definition: at91samd.c:282
static int samd_erase_row(struct target *target, uint32_t address)
Erases a flash-row at the given address.
Definition: at91samd.c:586
#define SAMD_SERIES_21
Definition: at91samd.c:68
#define SAMD_FAMILY_L
Definition: at91samd.c:65
static int samd_get_reservedmask(struct target *target, uint64_t *mask)
Returns the bitmask of reserved bits in register.
Definition: at91samd.c:613
Support functions to access arbitrary bits in a byte array.
void command_print(struct command_invocation *cmd, const char *format,...)
Definition: command.c:473
#define CMD
Use this macro to access the command being handled, rather than accessing the variable directly.
Definition: command.h:140
#define CMD_ARGV
Use this macro to access the arguments for the command being handled, rather than accessing the varia...
Definition: command.h:155
#define ERROR_COMMAND_SYNTAX_ERROR
Definition: command.h:385
#define CMD_ARGC
Use this macro to access the number of arguments for the command being handled, rather than accessing...
Definition: command.h:150
#define COMMAND_PARSE_NUMBER(type, in, out)
parses the string in into out as a type, or prints a command error and passes the error code to the c...
Definition: command.h:425
#define CMD_CTX
Use this macro to access the context of the command being handled, rather than accessing the variable...
Definition: command.h:145
#define COMMAND_REGISTRATION_DONE
Use this as the last entry in an array of command_registration records.
Definition: command.h:247
@ COMMAND_ANY
Definition: command.h:42
@ COMMAND_EXEC
Definition: command.h:40
#define DBGKEY
Definition: cortex_m.h:114
#define C_HALT
Definition: cortex_m.h:116
#define VC_BUSERR
Definition: cortex_m.h:130
#define VC_CORERESET
Definition: cortex_m.h:135
#define DCB_DEMCR
Definition: cortex_m.h:68
#define C_DEBUGEN
Definition: cortex_m.h:115
#define DCB_DHCSR
Definition: cortex_m.h:65
#define TRCENA
Definition: cortex_m.h:127
#define VC_HARDERR
Definition: cortex_m.h:128
uint8_t bank
Definition: esirisc.c:135
int mask
Definition: esirisc.c:1698
#define ERROR_FLASH_OPER_UNSUPPORTED
Definition: flash/common.h:36
#define ERROR_FLASH_PROTECTED
Definition: flash/common.h:37
#define ERROR_FLASH_BANK_NOT_PROBED
Definition: flash/common.h:35
#define ERROR_FLASH_OPERATION_FAILED
Definition: flash/common.h:30
struct flash_sector * alloc_block_array(uint32_t offset, uint32_t size, unsigned int num_blocks)
Allocate and fill an array of sectors or protection blocks.
int default_flash_blank_check(struct flash_bank *bank)
Provides default erased-bank check handling.
int default_flash_read(struct flash_bank *bank, uint8_t *buffer, uint32_t offset, uint32_t count)
Provides default read implementation for flash memory.
void default_flash_free_driver_priv(struct flash_bank *bank)
Deallocates bank->driver_priv.
static enum reset_types jtag_reset_config
Definition: jtag/core.c:87
enum reset_types jtag_get_reset_config(void)
Definition: jtag/core.c:1734
The JTAG interface can be implemented with a software or hardware fifo.
reset_types
Definition: jtag.h:212
@ RESET_HAS_SRST
Definition: jtag.h:215
void keep_alive(void)
Definition: log.c:419
#define LOG_WARNING(expr ...)
Definition: log.h:120
#define ERROR_FAIL
Definition: log.h:161
#define LOG_ERROR(expr ...)
Definition: log.h:123
#define LOG_INFO(expr ...)
Definition: log.h:117
#define ERROR_OK
Definition: log.h:155
size_t size
Size of the control block search area.
Definition: rtt/rtt.c:30
char id[RTT_CB_MAX_ID_LENGTH]
Control block identifier.
Definition: rtt/rtt.c:32
const char * name
Definition: command.h:229
Provides details of a flash bank, available either on-chip or through a major interface.
Definition: nor/core.h:75
Provides the implementation-independent structure that defines all of the callbacks required by OpenO...
Definition: nor/driver.h:39
const char * name
Gives a human-readable name of this flash driver, This field is used to select and initialize the dri...
Definition: nor/driver.h:44
const struct samd_part * parts
Definition: at91samd.c:306
uint8_t processor
Definition: at91samd.c:303
size_t num_parts
Definition: at91samd.c:307
uint64_t nvm_userrow_res_mask
Definition: at91samd.c:308
uint8_t series
Definition: at91samd.c:305
uint8_t family
Definition: at91samd.c:304
bool probed
Definition: at91samd.c:348
struct target * target
Definition: at91samd.c:349
int prot_block_size
Definition: at91samd.c:346
uint32_t page_size
Definition: at91samd.c:343
int sector_size
Definition: at91samd.c:345
int num_pages
Definition: at91samd.c:344
const char * name
Definition: at91samd.c:85
uint32_t flash_kb
Definition: at91samd.c:86
uint32_t ram_kb
Definition: at91samd.c:87
uint8_t id
Definition: at91samd.c:84
Definition: target.h:120
enum target_state state
Definition: target.h:162
bool reset_halt
Definition: target.h:149
uint64_t target_buffer_get_u64(struct target *target, const uint8_t *buffer)
Definition: target.c:366
int target_write_u8(struct target *target, target_addr_t address, uint8_t value)
Definition: target.c:2749
int target_write_u16(struct target *target, target_addr_t address, uint16_t value)
Definition: target.c:2728
int target_read_u8(struct target *target, target_addr_t address, uint8_t *value)
Definition: target.c:2664
int target_write_memory(struct target *target, target_addr_t address, uint32_t size, uint32_t count, const uint8_t *buffer)
Write count items of size bytes to the memory of target at the address given.
Definition: target.c:1334
int target_write_u32(struct target *target, target_addr_t address, uint32_t value)
Definition: target.c:2707
int target_examine_one(struct target *target)
Examine the specified target, letting it perform any Initialisation that requires JTAG access.
Definition: target.c:750
int target_poll(struct target *target)
Definition: target.c:555
int target_read_u16(struct target *target, target_addr_t address, uint16_t *value)
Definition: target.c:2640
void target_buffer_set_u64(struct target *target, uint8_t *buffer, uint64_t value)
Definition: target.c:402
int target_read_u32(struct target *target, target_addr_t address, uint32_t *value)
Definition: target.c:2616
int target_read_memory(struct target *target, target_addr_t address, uint32_t size, uint32_t count, uint8_t *buffer)
Read count items of size bytes from the memory of target at the address given.
Definition: target.c:1306
struct target * get_current_target(struct command_context *cmd_ctx)
Definition: target.c:536
#define ERROR_TARGET_NOT_HALTED
Definition: target.h:792
@ TARGET_HALTED
Definition: target.h:55
static bool target_was_examined(struct target *target)
Definition: target.h:438
int64_t timeval_ms(void)
#define TARGET_ADDR_FMT
Definition: types.h:342
#define ARRAY_SIZE(x)
Compute the number of elements of a variable length array.
Definition: types.h:57
#define NULL
Definition: usb.h:16
uint8_t status[4]
Definition: vdebug.c:17
uint8_t cmd
Definition: vdebug.c:1
uint8_t offset[4]
Definition: vdebug.c:9
uint8_t count[4]
Definition: vdebug.c:22