]> git.ipfire.org Git - people/ms/u-boot.git/blob - common/cmd_pci.c
projects / people / ms / u-boot.git / blob
? search:
summary | shortlog | log | commit | commitdiff | tree
blame | history | raw | HEAD
Convert cmd_usage() calls in common to use a return value
[people/ms/u-boot.git] / common / cmd_pci.c
1 /*
2 * (C) Copyright 2001 Sysgo Real-Time Solutions, GmbH <www.elinos.com>
3 * Andreas Heppel <aheppel@sysgo.de>
4 *
5 * (C) Copyright 2002
6 * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
7 * Wolfgang Grandegger, DENX Software Engineering, wg@denx.de.
8 *
9 * See file CREDITS for list of people who contributed to this
10 * project.
11 *
12 * This program is free software; you can redistribute it and/or
13 * modify it under the terms of the GNU General Public License as
14 * published by the Free Software Foundation; either version 2 of
15 * the License, or (at your option) any later version.
16 *
17 * This program is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU General Public License for more details.
21 *
22 * You should have received a copy of the GNU General Public License
23 * along with this program; if not, write to the Free Software
24 * Foundation, Inc., 59 Temple Place, Suite 330, Boston,
25 * MA 02111-1307 USA
26 */
27
28 /*
29 * PCI routines
30 */
31
32 #include <common.h>
33 #include <command.h>
34 #include <asm/processor.h>
35 #include <asm/io.h>
36 #include <pci.h>
37
38 unsigned char ShortPCIListing = 1;
39
40 /*
41 * Follows routines for the output of infos about devices on PCI bus.
42 */
43
44 void pci_header_show(pci_dev_t dev);
45 void pci_header_show_brief(pci_dev_t dev);
46
47 /*
48 * Subroutine: pciinfo
49 *
50 * Description: Show information about devices on PCI bus.
51 * Depending on the define CONFIG_SYS_SHORT_PCI_LISTING
52 * the output will be more or less exhaustive.
53 *
54 * Inputs: bus_no the number of the bus to be scanned.
55 *
56 * Return: None
57 *
58 */
59 void pciinfo(int BusNum, int ShortPCIListing)
60 {
61 int Device;
62 int Function;
63 unsigned char HeaderType;
64 unsigned short VendorID;
65 pci_dev_t dev;
66
67 printf("Scanning PCI devices on bus %d\n", BusNum);
68
69 if (ShortPCIListing) {
70 printf("BusDevFun VendorId DeviceId Device Class Sub-Class\n");
71 printf("_____________________________________________________________\n");
72 }
73
74 for (Device = 0; Device < PCI_MAX_PCI_DEVICES; Device++) {
75 HeaderType = 0;
76 VendorID = 0;
77 for (Function = 0; Function < PCI_MAX_PCI_FUNCTIONS; Function++) {
78 /*
79 * If this is not a multi-function device, we skip the rest.
80 */
81 if (Function && !(HeaderType & 0x80))
82 break;
83
84 dev = PCI_BDF(BusNum, Device, Function);
85
86 pci_read_config_word(dev, PCI_VENDOR_ID, &VendorID);
87 if ((VendorID == 0xFFFF) || (VendorID == 0x0000))
88 continue;
89
90 if (!Function) pci_read_config_byte(dev, PCI_HEADER_TYPE, &HeaderType);
91
92 if (ShortPCIListing)
93 {
94 printf("%02x.%02x.%02x ", BusNum, Device, Function);
95 pci_header_show_brief(dev);
96 }
97 else
98 {
99 printf("\nFound PCI device %02x.%02x.%02x:\n",
100 BusNum, Device, Function);
101 pci_header_show(dev);
102 }
103 }
104 }
105 }
106
107
108 /*
109 * Subroutine: pci_header_show_brief
110 *
111 * Description: Reads and prints the header of the
112 * specified PCI device in short form.
113 *
114 * Inputs: dev Bus+Device+Function number
115 *
116 * Return: None
117 *
118 */
119 void pci_header_show_brief(pci_dev_t dev)
120 {
121 u16 vendor, device;
122 u8 class, subclass;
123
124 pci_read_config_word(dev, PCI_VENDOR_ID, &vendor);
125 pci_read_config_word(dev, PCI_DEVICE_ID, &device);
126 pci_read_config_byte(dev, PCI_CLASS_CODE, &class);
127 pci_read_config_byte(dev, PCI_CLASS_SUB_CODE, &subclass);
128
129 printf("0x%.4x 0x%.4x %-23s 0x%.2x\n",
130 vendor, device,
131 pci_class_str(class), subclass);
132 }
133
134 /*
135 * Subroutine: PCI_Header_Show
136 *
137 * Description: Reads the header of the specified PCI device.
138 *
139 * Inputs: BusDevFunc Bus+Device+Function number
140 *
141 * Return: None
142 *
143 */
144 void pci_header_show(pci_dev_t dev)
145 {
146 u8 _byte, header_type;
147 u16 _word;
148 u32 _dword;
149
150 #define PRINT(msg, type, reg) \
151 pci_read_config_##type(dev, reg, &_##type); \
152 printf(msg, _##type)
153
154 #define PRINT2(msg, type, reg, func) \
155 pci_read_config_##type(dev, reg, &_##type); \
156 printf(msg, _##type, func(_##type))
157
158 pci_read_config_byte(dev, PCI_HEADER_TYPE, &header_type);
159
160 PRINT (" vendor ID = 0x%.4x\n", word, PCI_VENDOR_ID);
161 PRINT (" device ID = 0x%.4x\n", word, PCI_DEVICE_ID);
162 PRINT (" command register = 0x%.4x\n", word, PCI_COMMAND);
163 PRINT (" status register = 0x%.4x\n", word, PCI_STATUS);
164 PRINT (" revision ID = 0x%.2x\n", byte, PCI_REVISION_ID);
165 PRINT2(" class code = 0x%.2x (%s)\n", byte, PCI_CLASS_CODE,
166 pci_class_str);
167 PRINT (" sub class code = 0x%.2x\n", byte, PCI_CLASS_SUB_CODE);
168 PRINT (" programming interface = 0x%.2x\n", byte, PCI_CLASS_PROG);
169 PRINT (" cache line = 0x%.2x\n", byte, PCI_CACHE_LINE_SIZE);
170 PRINT (" latency time = 0x%.2x\n", byte, PCI_LATENCY_TIMER);
171 PRINT (" header type = 0x%.2x\n", byte, PCI_HEADER_TYPE);
172 PRINT (" BIST = 0x%.2x\n", byte, PCI_BIST);
173 PRINT (" base address 0 = 0x%.8x\n", dword, PCI_BASE_ADDRESS_0);
174
175 switch (header_type & 0x03) {
176 case PCI_HEADER_TYPE_NORMAL: /* "normal" PCI device */
177 PRINT (" base address 1 = 0x%.8x\n", dword, PCI_BASE_ADDRESS_1);
178 PRINT (" base address 2 = 0x%.8x\n", dword, PCI_BASE_ADDRESS_2);
179 PRINT (" base address 3 = 0x%.8x\n", dword, PCI_BASE_ADDRESS_3);
180 PRINT (" base address 4 = 0x%.8x\n", dword, PCI_BASE_ADDRESS_4);
181 PRINT (" base address 5 = 0x%.8x\n", dword, PCI_BASE_ADDRESS_5);
182 PRINT (" cardBus CIS pointer = 0x%.8x\n", dword, PCI_CARDBUS_CIS);
183 PRINT (" sub system vendor ID = 0x%.4x\n", word, PCI_SUBSYSTEM_VENDOR_ID);
184 PRINT (" sub system ID = 0x%.4x\n", word, PCI_SUBSYSTEM_ID);
185 PRINT (" expansion ROM base address = 0x%.8x\n", dword, PCI_ROM_ADDRESS);
186 PRINT (" interrupt line = 0x%.2x\n", byte, PCI_INTERRUPT_LINE);
187 PRINT (" interrupt pin = 0x%.2x\n", byte, PCI_INTERRUPT_PIN);
188 PRINT (" min Grant = 0x%.2x\n", byte, PCI_MIN_GNT);
189 PRINT (" max Latency = 0x%.2x\n", byte, PCI_MAX_LAT);
190 break;
191
192 case PCI_HEADER_TYPE_BRIDGE: /* PCI-to-PCI bridge */
193
194 PRINT (" base address 1 = 0x%.8x\n", dword, PCI_BASE_ADDRESS_1);
195 PRINT (" primary bus number = 0x%.2x\n", byte, PCI_PRIMARY_BUS);
196 PRINT (" secondary bus number = 0x%.2x\n", byte, PCI_SECONDARY_BUS);
197 PRINT (" subordinate bus number = 0x%.2x\n", byte, PCI_SUBORDINATE_BUS);
198 PRINT (" secondary latency timer = 0x%.2x\n", byte, PCI_SEC_LATENCY_TIMER);
199 PRINT (" IO base = 0x%.2x\n", byte, PCI_IO_BASE);
200 PRINT (" IO limit = 0x%.2x\n", byte, PCI_IO_LIMIT);
201 PRINT (" secondary status = 0x%.4x\n", word, PCI_SEC_STATUS);
202 PRINT (" memory base = 0x%.4x\n", word, PCI_MEMORY_BASE);
203 PRINT (" memory limit = 0x%.4x\n", word, PCI_MEMORY_LIMIT);
204 PRINT (" prefetch memory base = 0x%.4x\n", word, PCI_PREF_MEMORY_BASE);
205 PRINT (" prefetch memory limit = 0x%.4x\n", word, PCI_PREF_MEMORY_LIMIT);
206 PRINT (" prefetch memory base upper = 0x%.8x\n", dword, PCI_PREF_BASE_UPPER32);
207 PRINT (" prefetch memory limit upper = 0x%.8x\n", dword, PCI_PREF_LIMIT_UPPER32);
208 PRINT (" IO base upper 16 bits = 0x%.4x\n", word, PCI_IO_BASE_UPPER16);
209 PRINT (" IO limit upper 16 bits = 0x%.4x\n", word, PCI_IO_LIMIT_UPPER16);
210 PRINT (" expansion ROM base address = 0x%.8x\n", dword, PCI_ROM_ADDRESS1);
211 PRINT (" interrupt line = 0x%.2x\n", byte, PCI_INTERRUPT_LINE);
212 PRINT (" interrupt pin = 0x%.2x\n", byte, PCI_INTERRUPT_PIN);
213 PRINT (" bridge control = 0x%.4x\n", word, PCI_BRIDGE_CONTROL);
214 break;
215
216 case PCI_HEADER_TYPE_CARDBUS: /* PCI-to-CardBus bridge */
217
218 PRINT (" capabilities = 0x%.2x\n", byte, PCI_CB_CAPABILITY_LIST);
219 PRINT (" secondary status = 0x%.4x\n", word, PCI_CB_SEC_STATUS);
220 PRINT (" primary bus number = 0x%.2x\n", byte, PCI_CB_PRIMARY_BUS);
221 PRINT (" CardBus number = 0x%.2x\n", byte, PCI_CB_CARD_BUS);
222 PRINT (" subordinate bus number = 0x%.2x\n", byte, PCI_CB_SUBORDINATE_BUS);
223 PRINT (" CardBus latency timer = 0x%.2x\n", byte, PCI_CB_LATENCY_TIMER);
224 PRINT (" CardBus memory base 0 = 0x%.8x\n", dword, PCI_CB_MEMORY_BASE_0);
225 PRINT (" CardBus memory limit 0 = 0x%.8x\n", dword, PCI_CB_MEMORY_LIMIT_0);
226 PRINT (" CardBus memory base 1 = 0x%.8x\n", dword, PCI_CB_MEMORY_BASE_1);
227 PRINT (" CardBus memory limit 1 = 0x%.8x\n", dword, PCI_CB_MEMORY_LIMIT_1);
228 PRINT (" CardBus IO base 0 = 0x%.4x\n", word, PCI_CB_IO_BASE_0);
229 PRINT (" CardBus IO base high 0 = 0x%.4x\n", word, PCI_CB_IO_BASE_0_HI);
230 PRINT (" CardBus IO limit 0 = 0x%.4x\n", word, PCI_CB_IO_LIMIT_0);
231 PRINT (" CardBus IO limit high 0 = 0x%.4x\n", word, PCI_CB_IO_LIMIT_0_HI);
232 PRINT (" CardBus IO base 1 = 0x%.4x\n", word, PCI_CB_IO_BASE_1);
233 PRINT (" CardBus IO base high 1 = 0x%.4x\n", word, PCI_CB_IO_BASE_1_HI);
234 PRINT (" CardBus IO limit 1 = 0x%.4x\n", word, PCI_CB_IO_LIMIT_1);
235 PRINT (" CardBus IO limit high 1 = 0x%.4x\n", word, PCI_CB_IO_LIMIT_1_HI);
236 PRINT (" interrupt line = 0x%.2x\n", byte, PCI_INTERRUPT_LINE);
237 PRINT (" interrupt pin = 0x%.2x\n", byte, PCI_INTERRUPT_PIN);
238 PRINT (" bridge control = 0x%.4x\n", word, PCI_CB_BRIDGE_CONTROL);
239 PRINT (" subvendor ID = 0x%.4x\n", word, PCI_CB_SUBSYSTEM_VENDOR_ID);
240 PRINT (" subdevice ID = 0x%.4x\n", word, PCI_CB_SUBSYSTEM_ID);
241 PRINT (" PC Card 16bit base address = 0x%.8x\n", dword, PCI_CB_LEGACY_MODE_BASE);
242 break;
243
244 default:
245 printf("unknown header\n");
246 break;
247 }
248
249 #undef PRINT
250 #undef PRINT2
251 }
252
253 /* Convert the "bus.device.function" identifier into a number.
254 */
255 static pci_dev_t get_pci_dev(char* name)
256 {
257 char cnum[12];
258 int len, i, iold, n;
259 int bdfs[3] = {0,0,0};
260
261 len = strlen(name);
262 if (len > 8)
263 return -1;
264 for (i = 0, iold = 0, n = 0; i < len; i++) {
265 if (name[i] == '.') {
266 memcpy(cnum, &name[iold], i - iold);
267 cnum[i - iold] = '\0';
268 bdfs[n++] = simple_strtoul(cnum, NULL, 16);
269 iold = i + 1;
270 }
271 }
272 strcpy(cnum, &name[iold]);
273 if (n == 0)
274 n = 1;
275 bdfs[n] = simple_strtoul(cnum, NULL, 16);
276 return PCI_BDF(bdfs[0], bdfs[1], bdfs[2]);
277 }
278
279 static int pci_cfg_display(pci_dev_t bdf, ulong addr, ulong size, ulong length)
280 {
281 #define DISP_LINE_LEN 16
282 ulong i, nbytes, linebytes;
283 int rc = 0;
284
285 if (length == 0)
286 length = 0x40 / size; /* Standard PCI configuration space */
287
288 /* Print the lines.
289 * once, and all accesses are with the specified bus width.
290 */
291 nbytes = length * size;
292 do {
293 uint val4;
294 ushort val2;
295 u_char val1;
296
297 printf("%08lx:", addr);
298 linebytes = (nbytes>DISP_LINE_LEN)?DISP_LINE_LEN:nbytes;
299 for (i=0; i<linebytes; i+= size) {
300 if (size == 4) {
301 pci_read_config_dword(bdf, addr, &val4);
302 printf(" %08x", val4);
303 } else if (size == 2) {
304 pci_read_config_word(bdf, addr, &val2);
305 printf(" %04x", val2);
306 } else {
307 pci_read_config_byte(bdf, addr, &val1);
308 printf(" %02x", val1);
309 }
310 addr += size;
311 }
312 printf("\n");
313 nbytes -= linebytes;
314 if (ctrlc()) {
315 rc = 1;
316 break;
317 }
318 } while (nbytes > 0);
319
320 return (rc);
321 }
322
323 static int pci_cfg_write (pci_dev_t bdf, ulong addr, ulong size, ulong value)
324 {
325 if (size == 4) {
326 pci_write_config_dword(bdf, addr, value);
327 }
328 else if (size == 2) {
329 ushort val = value & 0xffff;
330 pci_write_config_word(bdf, addr, val);
331 }
332 else {
333 u_char val = value & 0xff;
334 pci_write_config_byte(bdf, addr, val);
335 }
336 return 0;
337 }
338
339 static int
340 pci_cfg_modify (pci_dev_t bdf, ulong addr, ulong size, ulong value, int incrflag)
341 {
342 ulong i;
343 int nbytes;
344 uint val4;
345 ushort val2;
346 u_char val1;
347
348 /* Print the address, followed by value. Then accept input for
349 * the next value. A non-converted value exits.
350 */
351 do {
352 printf("%08lx:", addr);
353 if (size == 4) {
354 pci_read_config_dword(bdf, addr, &val4);
355 printf(" %08x", val4);
356 }
357 else if (size == 2) {
358 pci_read_config_word(bdf, addr, &val2);
359 printf(" %04x", val2);
360 }
361 else {
362 pci_read_config_byte(bdf, addr, &val1);
363 printf(" %02x", val1);
364 }
365
366 nbytes = readline (" ? ");
367 if (nbytes == 0 || (nbytes == 1 && console_buffer[0] == '-')) {
368 /* <CR> pressed as only input, don't modify current
369 * location and move to next. "-" pressed will go back.
370 */
371 if (incrflag)
372 addr += nbytes ? -size : size;
373 nbytes = 1;
374 #ifdef CONFIG_BOOT_RETRY_TIME
375 reset_cmd_timeout(); /* good enough to not time out */
376 #endif
377 }
378 #ifdef CONFIG_BOOT_RETRY_TIME
379 else if (nbytes == -2) {
380 break; /* timed out, exit the command */
381 }
382 #endif
383 else {
384 char *endp;
385 i = simple_strtoul(console_buffer, &endp, 16);
386 nbytes = endp - console_buffer;
387 if (nbytes) {
388 #ifdef CONFIG_BOOT_RETRY_TIME
389 /* good enough to not time out
390 */
391 reset_cmd_timeout();
392 #endif
393 pci_cfg_write (bdf, addr, size, i);
394 if (incrflag)
395 addr += size;
396 }
397 }
398 } while (nbytes);
399
400 return 0;
401 }
402
403 /* PCI Configuration Space access commands
404 *
405 * Syntax:
406 * pci display[.b, .w, .l] bus.device.function} [addr] [len]
407 * pci next[.b, .w, .l] bus.device.function [addr]
408 * pci modify[.b, .w, .l] bus.device.function [addr]
409 * pci write[.b, .w, .l] bus.device.function addr value
410 */
411 int do_pci (cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[])
412 {
413 ulong addr = 0, value = 0, size = 0;
414 pci_dev_t bdf = 0;
415 char cmd = 's';
416
417 if (argc > 1)
418 cmd = argv[1][0];
419
420 switch (cmd) {
421 case 'd': /* display */
422 case 'n': /* next */
423 case 'm': /* modify */
424 case 'w': /* write */
425 /* Check for a size specification. */
426 size = cmd_get_data_size(argv[1], 4);
427 if (argc > 3)
428 addr = simple_strtoul(argv[3], NULL, 16);
429 if (argc > 4)
430 value = simple_strtoul(argv[4], NULL, 16);
431 case 'h': /* header */
432 if (argc < 3)
433 goto usage;
434 if ((bdf = get_pci_dev(argv[2])) == -1)
435 return 1;
436 break;
437 #ifdef CONFIG_CMD_PCI_ENUM
438 case 'e':
439 break;
440 #endif
441 default: /* scan bus */
442 value = 1; /* short listing */
443 bdf = 0; /* bus number */
444 if (argc > 1) {
445 if (argv[argc-1][0] == 'l') {
446 value = 0;
447 argc--;
448 }
449 if (argc > 1)
450 bdf = simple_strtoul(argv[1], NULL, 16);
451 }
452 pciinfo(bdf, value);
453 return 0;
454 }
455
456 switch (argv[1][0]) {
457 case 'h': /* header */
458 pci_header_show(bdf);
459 return 0;
460 case 'd': /* display */
461 return pci_cfg_display(bdf, addr, size, value);
462 #ifdef CONFIG_CMD_PCI_ENUM
463 case 'e':
464 pci_init();
465 return 0;
466 #endif
467 case 'n': /* next */
468 if (argc < 4)
469 goto usage;
470 return pci_cfg_modify(bdf, addr, size, value, 0);
471 case 'm': /* modify */
472 if (argc < 4)
473 goto usage;
474 return pci_cfg_modify(bdf, addr, size, value, 1);
475 case 'w': /* write */
476 if (argc < 5)
477 goto usage;
478 return pci_cfg_write(bdf, addr, size, value);
479 }
480
481 return 1;
482 usage:
483 return CMD_RET_USAGE;
484 }
485
486 /***************************************************/
487
488
489 U_BOOT_CMD(
490 pci, 5, 1, do_pci,
491 "list and access PCI Configuration Space",
492 "[bus] [long]\n"
493 " - short or long list of PCI devices on bus 'bus'\n"
494 #ifdef CONFIG_CMD_PCI_ENUM
495 "pci enum\n"
496 " - re-enumerate PCI buses\n"
497 #endif
498 "pci header b.d.f\n"
499 " - show header of PCI device 'bus.device.function'\n"
500 "pci display[.b, .w, .l] b.d.f [address] [# of objects]\n"
501 " - display PCI configuration space (CFG)\n"
502 "pci next[.b, .w, .l] b.d.f address\n"
503 " - modify, read and keep CFG address\n"
504 "pci modify[.b, .w, .l] b.d.f address\n"
505 " - modify, auto increment CFG address\n"
506 "pci write[.b, .w, .l] b.d.f address value\n"
507 " - write to CFG address"
508 );
"Das U-Boot" Source Tree