8c13241ddd9b198827cc1431a68e5d8579920afc
[openocd.git] / src / flash / nor / tcl.c
1 /***************************************************************************
2 * Copyright (C) 2005 by Dominic Rath <Dominic.Rath@gmx.de> *
3 * Copyright (C) 2007,2008 √ėyvind Harboe <oyvind.harboe@zylin.com> *
4 * Copyright (C) 2008 by Spencer Oliver <spen@spen-soft.co.uk> *
5 * Copyright (C) 2009 Zachary T Welch <zw@superlucidity.net> *
6 * *
7 * This program is free software; you can redistribute it and/or modify *
8 * it under the terms of the GNU General Public License as published by *
9 * the Free Software Foundation; either version 2 of the License, or *
10 * (at your option) any later version. *
11 * *
12 * This program is distributed in the hope that it will be useful, *
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
15 * GNU General Public License for more details. *
16 * *
17 * You should have received a copy of the GNU General Public License *
18 * along with this program; if not, write to the *
19 * Free Software Foundation, Inc., *
20 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. *
21 ***************************************************************************/
22 #ifdef HAVE_CONFIG_H
23 #include "config.h"
24 #endif
25 #include "imp.h"
26
27 COMMAND_HANDLER(handle_flash_bank_command)
28 {
29 if (CMD_ARGC < 7)
30 {
31 LOG_ERROR("usage: flash bank <name> <driver> "
32 "<base> <size> <chip_width> <bus_width>");
33 return ERROR_COMMAND_SYNTAX_ERROR;
34 }
35 // save bank name and advance arguments for compatibility
36 const char *bank_name = *CMD_ARGV++;
37 CMD_ARGC--;
38
39 struct target *target;
40 if ((target = get_target(CMD_ARGV[5])) == NULL)
41 {
42 LOG_ERROR("target '%s' not defined", CMD_ARGV[5]);
43 return ERROR_FAIL;
44 }
45
46 const char *driver_name = CMD_ARGV[0];
47 for (unsigned i = 0; flash_drivers[i]; i++)
48 {
49 if (strcmp(driver_name, flash_drivers[i]->name) != 0)
50 continue;
51
52 /* register flash specific commands */
53 if (NULL != flash_drivers[i]->commands)
54 {
55 int retval = register_commands(CMD_CTX, NULL,
56 flash_drivers[i]->commands);
57 if (ERROR_OK != retval)
58 {
59 LOG_ERROR("couldn't register '%s' commands",
60 driver_name);
61 return ERROR_FAIL;
62 }
63 }
64
65 struct flash_bank *p, *c;
66 c = malloc(sizeof(struct flash_bank));
67 c->name = strdup(bank_name);
68 c->target = target;
69 c->driver = flash_drivers[i];
70 c->driver_priv = NULL;
71 COMMAND_PARSE_NUMBER(u32, CMD_ARGV[1], c->base);
72 COMMAND_PARSE_NUMBER(u32, CMD_ARGV[2], c->size);
73 COMMAND_PARSE_NUMBER(int, CMD_ARGV[3], c->chip_width);
74 COMMAND_PARSE_NUMBER(int, CMD_ARGV[4], c->bus_width);
75 c->num_sectors = 0;
76 c->sectors = NULL;
77 c->next = NULL;
78
79 int retval;
80 retval = CALL_COMMAND_HANDLER(flash_drivers[i]->flash_bank_command, c);
81 if (ERROR_OK != retval)
82 {
83 LOG_ERROR("'%s' driver rejected flash bank at 0x%8.8" PRIx32,
84 driver_name, c->base);
85 free(c);
86 return retval;
87 }
88
89 /* put flash bank in linked list */
90 if (flash_banks)
91 {
92 int bank_num = 0;
93 /* find last flash bank */
94 for (p = flash_banks; p && p->next; p = p->next) bank_num++;
95 if (p)
96 p->next = c;
97 c->bank_number = bank_num + 1;
98 }
99 else
100 {
101 flash_banks = c;
102 c->bank_number = 0;
103 }
104
105 return ERROR_OK;
106 }
107
108 /* no matching flash driver found */
109 LOG_ERROR("flash driver '%s' not found", driver_name);
110 return ERROR_FAIL;
111 }
112
113
114 static int jim_flash_banks(Jim_Interp *interp, int argc, Jim_Obj *const *argv)
115 {
116 struct flash_bank *p;
117
118 if (argc != 1) {
119 Jim_WrongNumArgs(interp, 1, argv, "no arguments to flash_banks command");
120 return JIM_ERR;
121 }
122
123 Jim_Obj *list = Jim_NewListObj(interp, NULL, 0);
124 for (p = flash_banks; p; p = p->next)
125 {
126 Jim_Obj *elem = Jim_NewListObj(interp, NULL, 0);
127
128 Jim_ListAppendElement(interp, elem, Jim_NewStringObj(interp, "name", -1));
129 Jim_ListAppendElement(interp, elem, Jim_NewStringObj(interp, p->driver->name, -1));
130 Jim_ListAppendElement(interp, elem, Jim_NewStringObj(interp, "base", -1));
131 Jim_ListAppendElement(interp, elem, Jim_NewIntObj(interp, p->base));
132 Jim_ListAppendElement(interp, elem, Jim_NewStringObj(interp, "size", -1));
133 Jim_ListAppendElement(interp, elem, Jim_NewIntObj(interp, p->size));
134 Jim_ListAppendElement(interp, elem, Jim_NewStringObj(interp, "bus_width", -1));
135 Jim_ListAppendElement(interp, elem, Jim_NewIntObj(interp, p->bus_width));
136 Jim_ListAppendElement(interp, elem, Jim_NewStringObj(interp, "chip_width", -1));
137 Jim_ListAppendElement(interp, elem, Jim_NewIntObj(interp, p->chip_width));
138
139 Jim_ListAppendElement(interp, list, elem);
140 }
141
142 Jim_SetResult(interp, list);
143
144 return JIM_OK;
145 }
146
147
148 COMMAND_HANDLER(handle_flash_init_command)
149 {
150 if (CMD_ARGC != 0)
151 return ERROR_COMMAND_SYNTAX_ERROR;
152
153 static bool flash_initialized = false;
154 if (flash_initialized)
155 {
156 LOG_INFO("'flash init' has already been called");
157 return ERROR_OK;
158 }
159 flash_initialized = true;
160
161 LOG_DEBUG("Initializing flash devices...");
162 return flash_init_drivers(CMD_CTX);
163 }
164
165 static const struct command_registration flash_config_command_handlers[] = {
166 {
167 .name = "bank",
168 .handler = &handle_flash_bank_command,
169 .mode = COMMAND_CONFIG,
170 .usage = "<name> <driver> <base> <size> "
171 "<chip_width> <bus_width> <target> "
172 "[driver_options ...]",
173 .help = "Define a new bank with the given name, "
174 "using the specified NOR flash driver.",
175 },
176 {
177 .name = "init",
178 .mode = COMMAND_CONFIG,
179 .handler = &handle_flash_init_command,
180 .help = "initialize flash devices",
181 },
182 {
183 .name = "banks",
184 .mode = COMMAND_ANY,
185 .jim_handler = &jim_flash_banks,
186 .help = "return information about the flash banks",
187 },
188 COMMAND_REGISTRATION_DONE
189 };
190 static const struct command_registration flash_command_handlers[] = {
191 {
192 .name = "flash",
193 .mode = COMMAND_ANY,
194 .help = "NOR flash command group",
195 .chain = flash_config_command_handlers,
196 },
197 COMMAND_REGISTRATION_DONE
198 };
199
200 int flash_register_commands(struct command_context *cmd_ctx)
201 {
202 return register_commands(cmd_ctx, NULL, flash_command_handlers);
203 }

Linking to existing account procedure

If you already have an account and want to add another login method you MUST first sign in with your existing account and then change URL to read https://review.openocd.org/login/?link to get to this page again but this time it'll work for linking. Thank you.

SSH host keys fingerprints

1024 SHA256:YKx8b7u5ZWdcbp7/4AeXNaqElP49m6QrwfXaqQGJAOk gerrit-code-review@openocd.zylin.com (DSA)
384 SHA256:jHIbSQa4REvwCFG4cq5LBlBLxmxSqelQPem/EXIrxjk gerrit-code-review@openocd.org (ECDSA)
521 SHA256:UAOPYkU9Fjtcao0Ul/Rrlnj/OsQvt+pgdYSZ4jOYdgs gerrit-code-review@openocd.org (ECDSA)
256 SHA256:A13M5QlnozFOvTllybRZH6vm7iSt0XLxbA48yfc2yfY gerrit-code-review@openocd.org (ECDSA)
256 SHA256:spYMBqEYoAOtK7yZBrcwE8ZpYt6b68Cfh9yEVetvbXg gerrit-code-review@openocd.org (ED25519)
+--[ED25519 256]--+
|=..              |
|+o..   .         |
|*.o   . .        |
|+B . . .         |
|Bo. = o S        |
|Oo.+ + =         |
|oB=.* = . o      |
| =+=.+   + E     |
|. .=o   . o      |
+----[SHA256]-----+
2048 SHA256:0Onrb7/PHjpo6iVZ7xQX2riKN83FJ3KGU0TvI0TaFG4 gerrit-code-review@openocd.zylin.com (RSA)