1// SPDX-License-Identifier: GPL-2.0+
2/*
3 * (C) Copyright 2001 Sysgo Real-Time Solutions, GmbH <www.elinos.com>
4 * Andreas Heppel <aheppel@sysgo.de>
5 *
6 * (C) Copyright 2002
7 * Wolfgang Denk, DENX Software Engineering, wd@denx.de.
8 * Wolfgang Grandegger, DENX Software Engineering, wg@denx.de.
9 */
10
11/*
12 * PCI routines
13 */
14
15#include <common.h>
16#include <bootretry.h>
17#include <cli.h>
18#include <command.h>
19#include <console.h>
20#include <dm.h>
21#include <init.h>
22#include <asm/processor.h>
23#include <asm/io.h>
24#include <pci.h>
25
26struct pci_reg_info {
27	const char *name;
28	enum pci_size_t size;
29	u8 offset;
30};
31
32static int pci_byte_size(enum pci_size_t size)
33{
34	switch (size) {
35	case PCI_SIZE_8:
36		return 1;
37	case PCI_SIZE_16:
38		return 2;
39	case PCI_SIZE_32:
40	default:
41		return 4;
42	}
43}
44
45static int pci_field_width(enum pci_size_t size)
46{
47	return pci_byte_size(size) * 2;
48}
49
50static void pci_show_regs(struct udevice *dev, struct pci_reg_info *regs)
51{
52	for (; regs->name; regs++) {
53		unsigned long val;
54
55		dm_pci_read_config(dev, regs->offset, &val, regs->size);
56		printf("  %s =%*s%#.*lx\n", regs->name,
57		       (int)(28 - strlen(regs->name)), "",
58		       pci_field_width(regs->size), val);
59	}
60}
61
62static int pci_bar_show(struct udevice *dev)
63{
64	u8 header_type;
65	int bar_cnt, bar_id, mem_type;
66	bool is_64, is_io;
67	u32 base_low, base_high;
68	u32 size_low, size_high;
69	u64 base, size;
70	u32 reg_addr;
71	int prefetchable;
72
73	dm_pci_read_config8(dev, PCI_HEADER_TYPE, &header_type);
74	header_type &= 0x7f;
75
76	if (header_type == PCI_HEADER_TYPE_CARDBUS) {
77		printf("CardBus doesn't support BARs\n");
78		return -ENOSYS;
79	} else if (header_type != PCI_HEADER_TYPE_NORMAL &&
80		   header_type != PCI_HEADER_TYPE_BRIDGE) {
81		printf("unknown header type\n");
82		return -ENOSYS;
83	}
84
85	bar_cnt = (header_type == PCI_HEADER_TYPE_NORMAL) ? 6 : 2;
86
87	printf("ID   Base                Size                Width  Type\n");
88	printf("----------------------------------------------------------\n");
89
90	bar_id = 0;
91	reg_addr = PCI_BASE_ADDRESS_0;
92	while (bar_cnt) {
93		dm_pci_read_config32(dev, reg_addr, &base_low);
94		dm_pci_write_config32(dev, reg_addr, 0xffffffff);
95		dm_pci_read_config32(dev, reg_addr, &size_low);
96		dm_pci_write_config32(dev, reg_addr, base_low);
97		reg_addr += 4;
98
99		base = base_low & ~0xf;
100		size = size_low & ~0xf;
101		base_high = 0x0;
102		size_high = 0xffffffff;
103		is_64 = 0;
104		prefetchable = base_low & PCI_BASE_ADDRESS_MEM_PREFETCH;
105		is_io = base_low & PCI_BASE_ADDRESS_SPACE_IO;
106		mem_type = base_low & PCI_BASE_ADDRESS_MEM_TYPE_MASK;
107
108		if (mem_type == PCI_BASE_ADDRESS_MEM_TYPE_64) {
109			dm_pci_read_config32(dev, reg_addr, &base_high);
110			dm_pci_write_config32(dev, reg_addr, 0xffffffff);
111			dm_pci_read_config32(dev, reg_addr, &size_high);
112			dm_pci_write_config32(dev, reg_addr, base_high);
113			bar_cnt--;
114			reg_addr += 4;
115			is_64 = 1;
116		}
117
118		base = base | ((u64)base_high << 32);
119		size = size | ((u64)size_high << 32);
120
121		if ((!is_64 && size_low) || (is_64 && size)) {
122			size = ~size + 1;
123			printf(" %d   %#018llx  %#018llx  %d     %s   %s\n",
124			       bar_id, (unsigned long long)base,
125			       (unsigned long long)size, is_64 ? 64 : 32,
126			       is_io ? "I/O" : "MEM",
127			       prefetchable ? "Prefetchable" : "");
128		}
129
130		bar_id++;
131		bar_cnt--;
132	}
133
134	return 0;
135}
136
137static struct pci_reg_info regs_start[] = {
138	{ "vendor ID", PCI_SIZE_16, PCI_VENDOR_ID },
139	{ "device ID", PCI_SIZE_16, PCI_DEVICE_ID },
140	{ "command register ID", PCI_SIZE_16, PCI_COMMAND },
141	{ "status register", PCI_SIZE_16, PCI_STATUS },
142	{ "revision ID", PCI_SIZE_8, PCI_REVISION_ID },
143	{},
144};
145
146static struct pci_reg_info regs_rest[] = {
147	{ "sub class code", PCI_SIZE_8, PCI_CLASS_SUB_CODE },
148	{ "programming interface", PCI_SIZE_8, PCI_CLASS_PROG },
149	{ "cache line", PCI_SIZE_8, PCI_CACHE_LINE_SIZE },
150	{ "latency time", PCI_SIZE_8, PCI_LATENCY_TIMER },
151	{ "header type", PCI_SIZE_8, PCI_HEADER_TYPE },
152	{ "BIST", PCI_SIZE_8, PCI_BIST },
153	{ "base address 0", PCI_SIZE_32, PCI_BASE_ADDRESS_0 },
154	{},
155};
156
157static struct pci_reg_info regs_normal[] = {
158	{ "base address 1", PCI_SIZE_32, PCI_BASE_ADDRESS_1 },
159	{ "base address 2", PCI_SIZE_32, PCI_BASE_ADDRESS_2 },
160	{ "base address 3", PCI_SIZE_32, PCI_BASE_ADDRESS_3 },
161	{ "base address 4", PCI_SIZE_32, PCI_BASE_ADDRESS_4 },
162	{ "base address 5", PCI_SIZE_32, PCI_BASE_ADDRESS_5 },
163	{ "cardBus CIS pointer", PCI_SIZE_32, PCI_CARDBUS_CIS },
164	{ "sub system vendor ID", PCI_SIZE_16, PCI_SUBSYSTEM_VENDOR_ID },
165	{ "sub system ID", PCI_SIZE_16, PCI_SUBSYSTEM_ID },
166	{ "expansion ROM base address", PCI_SIZE_32, PCI_ROM_ADDRESS },
167	{ "interrupt line", PCI_SIZE_8, PCI_INTERRUPT_LINE },
168	{ "interrupt pin", PCI_SIZE_8, PCI_INTERRUPT_PIN },
169	{ "min Grant", PCI_SIZE_8, PCI_MIN_GNT },
170	{ "max Latency", PCI_SIZE_8, PCI_MAX_LAT },
171	{},
172};
173
174static struct pci_reg_info regs_bridge[] = {
175	{ "base address 1", PCI_SIZE_32, PCI_BASE_ADDRESS_1 },
176	{ "primary bus number", PCI_SIZE_8, PCI_PRIMARY_BUS },
177	{ "secondary bus number", PCI_SIZE_8, PCI_SECONDARY_BUS },
178	{ "subordinate bus number", PCI_SIZE_8, PCI_SUBORDINATE_BUS },
179	{ "secondary latency timer", PCI_SIZE_8, PCI_SEC_LATENCY_TIMER },
180	{ "IO base", PCI_SIZE_8, PCI_IO_BASE },
181	{ "IO limit", PCI_SIZE_8, PCI_IO_LIMIT },
182	{ "secondary status", PCI_SIZE_16, PCI_SEC_STATUS },
183	{ "memory base", PCI_SIZE_16, PCI_MEMORY_BASE },
184	{ "memory limit", PCI_SIZE_16, PCI_MEMORY_LIMIT },
185	{ "prefetch memory base", PCI_SIZE_16, PCI_PREF_MEMORY_BASE },
186	{ "prefetch memory limit", PCI_SIZE_16, PCI_PREF_MEMORY_LIMIT },
187	{ "prefetch memory base upper", PCI_SIZE_32, PCI_PREF_BASE_UPPER32 },
188	{ "prefetch memory limit upper", PCI_SIZE_32, PCI_PREF_LIMIT_UPPER32 },
189	{ "IO base upper 16 bits", PCI_SIZE_16, PCI_IO_BASE_UPPER16 },
190	{ "IO limit upper 16 bits", PCI_SIZE_16, PCI_IO_LIMIT_UPPER16 },
191	{ "expansion ROM base address", PCI_SIZE_32, PCI_ROM_ADDRESS1 },
192	{ "interrupt line", PCI_SIZE_8, PCI_INTERRUPT_LINE },
193	{ "interrupt pin", PCI_SIZE_8, PCI_INTERRUPT_PIN },
194	{ "bridge control", PCI_SIZE_16, PCI_BRIDGE_CONTROL },
195	{},
196};
197
198static struct pci_reg_info regs_cardbus[] = {
199	{ "capabilities", PCI_SIZE_8, PCI_CB_CAPABILITY_LIST },
200	{ "secondary status", PCI_SIZE_16, PCI_CB_SEC_STATUS },
201	{ "primary bus number", PCI_SIZE_8, PCI_CB_PRIMARY_BUS },
202	{ "CardBus number", PCI_SIZE_8, PCI_CB_CARD_BUS },
203	{ "subordinate bus number", PCI_SIZE_8, PCI_CB_SUBORDINATE_BUS },
204	{ "CardBus latency timer", PCI_SIZE_8, PCI_CB_LATENCY_TIMER },
205	{ "CardBus memory base 0", PCI_SIZE_32, PCI_CB_MEMORY_BASE_0 },
206	{ "CardBus memory limit 0", PCI_SIZE_32, PCI_CB_MEMORY_LIMIT_0 },
207	{ "CardBus memory base 1", PCI_SIZE_32, PCI_CB_MEMORY_BASE_1 },
208	{ "CardBus memory limit 1", PCI_SIZE_32, PCI_CB_MEMORY_LIMIT_1 },
209	{ "CardBus IO base 0", PCI_SIZE_16, PCI_CB_IO_BASE_0 },
210	{ "CardBus IO base high 0", PCI_SIZE_16, PCI_CB_IO_BASE_0_HI },
211	{ "CardBus IO limit 0", PCI_SIZE_16, PCI_CB_IO_LIMIT_0 },
212	{ "CardBus IO limit high 0", PCI_SIZE_16, PCI_CB_IO_LIMIT_0_HI },
213	{ "CardBus IO base 1", PCI_SIZE_16, PCI_CB_IO_BASE_1 },
214	{ "CardBus IO base high 1", PCI_SIZE_16, PCI_CB_IO_BASE_1_HI },
215	{ "CardBus IO limit 1", PCI_SIZE_16, PCI_CB_IO_LIMIT_1 },
216	{ "CardBus IO limit high 1", PCI_SIZE_16, PCI_CB_IO_LIMIT_1_HI },
217	{ "interrupt line", PCI_SIZE_8, PCI_INTERRUPT_LINE },
218	{ "interrupt pin", PCI_SIZE_8, PCI_INTERRUPT_PIN },
219	{ "bridge control", PCI_SIZE_16, PCI_CB_BRIDGE_CONTROL },
220	{ "subvendor ID", PCI_SIZE_16, PCI_CB_SUBSYSTEM_VENDOR_ID },
221	{ "subdevice ID", PCI_SIZE_16, PCI_CB_SUBSYSTEM_ID },
222	{ "PC Card 16bit base address", PCI_SIZE_32, PCI_CB_LEGACY_MODE_BASE },
223	{},
224};
225
226/**
227 * pci_header_show() - Show the header of the specified PCI device.
228 *
229 * @dev: Bus+Device+Function number
230 */
231static void pci_header_show(struct udevice *dev)
232{
233	unsigned long class, header_type;
234
235	dm_pci_read_config(dev, PCI_CLASS_CODE, &class, PCI_SIZE_8);
236	dm_pci_read_config(dev, PCI_HEADER_TYPE, &header_type, PCI_SIZE_8);
237	pci_show_regs(dev, regs_start);
238	printf("  class code =                  0x%.2x (%s)\n", (int)class,
239	       pci_class_str(class));
240	pci_show_regs(dev, regs_rest);
241
242	switch (header_type & 0x7f) {
243	case PCI_HEADER_TYPE_NORMAL:	/* "normal" PCI device */
244		pci_show_regs(dev, regs_normal);
245		break;
246	case PCI_HEADER_TYPE_BRIDGE:	/* PCI-to-PCI bridge */
247		pci_show_regs(dev, regs_bridge);
248		break;
249	case PCI_HEADER_TYPE_CARDBUS:	/* PCI-to-CardBus bridge */
250		pci_show_regs(dev, regs_cardbus);
251		break;
252
253	default:
254		printf("unknown header\n");
255		break;
256    }
257}
258
259static void pciinfo_header(bool short_listing)
260{
261	if (short_listing) {
262		printf("BusDevFun  VendorId   DeviceId   Device Class       Sub-Class\n");
263		printf("_____________________________________________________________\n");
264	}
265}
266
267/**
268 * pci_header_show_brief() - Show the short-form PCI device header
269 *
270 * Reads and prints the header of the specified PCI device in short form.
271 *
272 * @dev: PCI device to show
273 */
274static void pci_header_show_brief(struct udevice *dev)
275{
276	ulong vendor, device;
277	ulong class, subclass;
278
279	dm_pci_read_config(dev, PCI_VENDOR_ID, &vendor, PCI_SIZE_16);
280	dm_pci_read_config(dev, PCI_DEVICE_ID, &device, PCI_SIZE_16);
281	dm_pci_read_config(dev, PCI_CLASS_CODE, &class, PCI_SIZE_8);
282	dm_pci_read_config(dev, PCI_CLASS_SUB_CODE, &subclass, PCI_SIZE_8);
283
284	printf("0x%.4lx     0x%.4lx     %-23s 0x%.2lx\n",
285	       vendor, device,
286	       pci_class_str(class), subclass);
287}
288
289static void pciinfo(struct udevice *bus, bool short_listing, bool multi)
290{
291	struct udevice *dev;
292
293	if (!multi)
294		printf("Scanning PCI devices on bus %d\n", dev_seq(bus));
295
296	if (!multi || dev_seq(bus) == 0)
297		pciinfo_header(short_listing);
298
299	for (device_find_first_child(bus, &dev);
300	     dev;
301	     device_find_next_child(&dev)) {
302		struct pci_child_plat *pplat;
303
304		pplat = dev_get_parent_plat(dev);
305		if (short_listing) {
306			printf("%02x.%02x.%02x   ", dev_seq(bus),
307			       PCI_DEV(pplat->devfn), PCI_FUNC(pplat->devfn));
308			pci_header_show_brief(dev);
309		} else {
310			printf("\nFound PCI device %02x.%02x.%02x:\n",
311			       dev_seq(bus),
312			       PCI_DEV(pplat->devfn), PCI_FUNC(pplat->devfn));
313			pci_header_show(dev);
314		}
315	}
316}
317
318/**
319 * get_pci_dev() - Convert the "bus.device.function" identifier into a number
320 *
321 * @name: Device string in the form "bus.device.function" where each is in hex
322 * Return: encoded pci_dev_t or -1 if the string was invalid
323 */
324static pci_dev_t get_pci_dev(char *name)
325{
326	char cnum[12];
327	int len, i, iold, n;
328	int bdfs[3] = {0,0,0};
329
330	len = strlen(name);
331	if (len > 8)
332		return -1;
333	for (i = 0, iold = 0, n = 0; i < len; i++) {
334		if (name[i] == '.') {
335			memcpy(cnum, &name[iold], i - iold);
336			cnum[i - iold] = '\0';
337			bdfs[n++] = hextoul(cnum, NULL);
338			iold = i + 1;
339		}
340	}
341	strcpy(cnum, &name[iold]);
342	if (n == 0)
343		n = 1;
344	bdfs[n] = hextoul(cnum, NULL);
345
346	return PCI_BDF(bdfs[0], bdfs[1], bdfs[2]);
347}
348
349static int pci_cfg_display(struct udevice *dev, ulong addr,
350			   enum pci_size_t size, ulong length)
351{
352#define DISP_LINE_LEN	16
353	ulong i, nbytes, linebytes;
354	int byte_size;
355	int rc = 0;
356
357	byte_size = pci_byte_size(size);
358	if (length == 0)
359		length = 0x40 / byte_size; /* Standard PCI config space */
360
361	if (addr >= 4096)
362		return 1;
363
364	/* Print the lines.
365	 * once, and all accesses are with the specified bus width.
366	 */
367	nbytes = length * byte_size;
368	do {
369		printf("%08lx:", addr);
370		linebytes = (nbytes > DISP_LINE_LEN) ? DISP_LINE_LEN : nbytes;
371		for (i = 0; i < linebytes; i += byte_size) {
372			unsigned long val;
373
374			dm_pci_read_config(dev, addr, &val, size);
375			printf(" %0*lx", pci_field_width(size), val);
376			addr += byte_size;
377		}
378		printf("\n");
379		nbytes -= linebytes;
380		if (ctrlc()) {
381			rc = 1;
382			break;
383		}
384	} while (nbytes > 0 && addr < 4096);
385
386	if (rc == 0 && nbytes > 0)
387		return 1;
388
389	return (rc);
390}
391
392static int pci_cfg_modify(struct udevice *dev, ulong addr, ulong size,
393			  ulong value, int incrflag)
394{
395	ulong	i;
396	int	nbytes;
397	ulong val;
398
399	if (addr >= 4096)
400		return 1;
401
402	/* Print the address, followed by value.  Then accept input for
403	 * the next value.  A non-converted value exits.
404	 */
405	do {
406		printf("%08lx:", addr);
407		dm_pci_read_config(dev, addr, &val, size);
408		printf(" %0*lx", pci_field_width(size), val);
409
410		nbytes = cli_readline(" ? ");
411		if (nbytes == 0 || (nbytes == 1 && console_buffer[0] == '-')) {
412			/* <CR> pressed as only input, don't modify current
413			 * location and move to next. "-" pressed will go back.
414			 */
415			if (incrflag)
416				addr += nbytes ? -size : size;
417			nbytes = 1;
418			/* good enough to not time out */
419			bootretry_reset_cmd_timeout();
420		}
421#ifdef CONFIG_BOOT_RETRY_TIME
422		else if (nbytes == -2) {
423			break;	/* timed out, exit the command	*/
424		}
425#endif
426		else {
427			char *endp;
428			i = hextoul(console_buffer, &endp);
429			nbytes = endp - console_buffer;
430			if (nbytes) {
431				/* good enough to not time out
432				 */
433				bootretry_reset_cmd_timeout();
434				dm_pci_write_config(dev, addr, i, size);
435				if (incrflag)
436					addr += size;
437			}
438		}
439	} while (nbytes && addr < 4096);
440
441	if (nbytes)
442		return 1;
443
444	return 0;
445}
446
447static const struct pci_flag_info {
448	uint flag;
449	const char *name;
450} pci_flag_info[] = {
451	{ PCI_REGION_IO, "io" },
452	{ PCI_REGION_PREFETCH, "prefetch" },
453	{ PCI_REGION_SYS_MEMORY, "sysmem" },
454	{ PCI_REGION_RO, "readonly" },
455};
456
457static void pci_show_regions(struct udevice *bus)
458{
459	struct pci_controller *hose = dev_get_uclass_priv(pci_get_controller(bus));
460	const struct pci_region *reg;
461	int i, j;
462
463	if (!hose) {
464		printf("Bus '%s' is not a PCI controller\n", bus->name);
465		return;
466	}
467
468	printf("Buses %02x-%02x\n", hose->first_busno, hose->last_busno);
469	printf("#   %-18s %-18s %-18s  %s\n", "Bus start", "Phys start", "Size",
470	       "Flags");
471	for (i = 0, reg = hose->regions; i < hose->region_count; i++, reg++) {
472		printf("%d   %#018llx %#018llx %#018llx  ", i,
473		       (unsigned long long)reg->bus_start,
474		       (unsigned long long)reg->phys_start,
475		       (unsigned long long)reg->size);
476		if (!(reg->flags & PCI_REGION_TYPE))
477			printf("mem ");
478		for (j = 0; j < ARRAY_SIZE(pci_flag_info); j++) {
479			if (reg->flags & pci_flag_info[j].flag)
480				printf("%s ", pci_flag_info[j].name);
481		}
482		printf("\n");
483	}
484}
485
486/* PCI Configuration Space access commands
487 *
488 * Syntax:
489 *	pci display[.b, .w, .l] bus.device.function} [addr] [len]
490 *	pci next[.b, .w, .l] bus.device.function [addr]
491 *      pci modify[.b, .w, .l] bus.device.function [addr]
492 *      pci write[.b, .w, .l] bus.device.function addr value
493 */
494static int do_pci(struct cmd_tbl *cmdtp, int flag, int argc, char *const argv[])
495{
496	ulong addr = 0, value = 0, cmd_size = 0;
497	enum pci_size_t size = PCI_SIZE_32;
498	struct udevice *dev, *bus;
499	int busnum = -1;
500	pci_dev_t bdf = 0;
501	char cmd = 's';
502	int ret = 0;
503	char *endp;
504
505	if (argc > 1)
506		cmd = argv[1][0];
507
508	switch (cmd) {
509	case 'd':		/* display */
510	case 'n':		/* next */
511	case 'm':		/* modify */
512	case 'w':		/* write */
513		/* Check for a size specification. */
514		cmd_size = cmd_get_data_size(argv[1], 4);
515		size = (cmd_size == 4) ? PCI_SIZE_32 : cmd_size - 1;
516		if (argc > 3)
517			addr = hextoul(argv[3], NULL);
518		if (argc > 4)
519			value = hextoul(argv[4], NULL);
520		fallthrough;
521	case 'h':		/* header */
522	case 'b':		/* bars */
523		if (argc < 3)
524			goto usage;
525		if ((bdf = get_pci_dev(argv[2])) == -1)
526			return 1;
527		break;
528	case 'e':
529		pci_init();
530		return 0;
531	case 'r': /* no break */
532	default:		/* scan bus */
533		value = 1; /* short listing */
534		if (argc > 1) {
535			if (cmd != 'r' && argv[argc-1][0] == 'l') {
536				value = 0;
537				argc--;
538			}
539			if (argc > 2 || (argc > 1 && cmd != 'r' && argv[1][0] != 's')) {
540				if (argv[argc - 1][0] != '*') {
541					busnum = hextoul(argv[argc - 1], &endp);
542					if (*endp)
543						goto usage;
544				}
545				argc--;
546			}
547			if (cmd == 'r' && argc > 2)
548				goto usage;
549			else if (cmd != 'r' && (argc > 2 || (argc == 2 && argv[1][0] != 's')))
550				goto usage;
551		}
552		if (busnum == -1) {
553			if (cmd != 'r') {
554				for (busnum = 0;
555				     uclass_get_device_by_seq(UCLASS_PCI, busnum, &bus) == 0;
556				     busnum++)
557					pciinfo(bus, value, true);
558			} else {
559				for (busnum = 0;
560				     uclass_get_device_by_seq(UCLASS_PCI, busnum, &bus) == 0;
561				     busnum++) {
562					/* Regions are controller specific so skip non-root buses */
563					if (device_is_on_pci_bus(bus))
564						continue;
565					pci_show_regions(bus);
566				}
567			}
568			return 0;
569		}
570		ret = uclass_get_device_by_seq(UCLASS_PCI, busnum, &bus);
571		if (ret) {
572			printf("No such bus\n");
573			return CMD_RET_FAILURE;
574		}
575		if (cmd == 'r')
576			pci_show_regions(bus);
577		else
578			pciinfo(bus, value, false);
579		return 0;
580	}
581
582	ret = dm_pci_bus_find_bdf(bdf, &dev);
583	if (ret) {
584		printf("No such device\n");
585		return CMD_RET_FAILURE;
586	}
587
588	switch (argv[1][0]) {
589	case 'h':		/* header */
590		pci_header_show(dev);
591		break;
592	case 'd':		/* display */
593		return pci_cfg_display(dev, addr, size, value);
594	case 'n':		/* next */
595		if (argc < 4)
596			goto usage;
597		ret = pci_cfg_modify(dev, addr, size, value, 0);
598		break;
599	case 'm':		/* modify */
600		if (argc < 4)
601			goto usage;
602		ret = pci_cfg_modify(dev, addr, size, value, 1);
603		break;
604	case 'w':		/* write */
605		if (argc < 5)
606			goto usage;
607		ret = dm_pci_write_config(dev, addr, value, size);
608		break;
609	case 'b':		/* bars */
610		return pci_bar_show(dev);
611	default:
612		ret = CMD_RET_USAGE;
613		break;
614	}
615
616	return ret;
617 usage:
618	return CMD_RET_USAGE;
619}
620
621/***************************************************/
622
623U_BOOT_LONGHELP(pci,
624	"[bus|*] [long]\n"
625	"    - short or long list of PCI devices on bus 'bus'\n"
626	"pci enum\n"
627	"    - Enumerate PCI buses\n"
628	"pci header b.d.f\n"
629	"    - show header of PCI device 'bus.device.function'\n"
630	"pci bar b.d.f\n"
631	"    - show BARs base and size for device b.d.f'\n"
632	"pci regions [bus|*]\n"
633	"    - show PCI regions\n"
634	"pci display[.b, .w, .l] b.d.f [address] [# of objects]\n"
635	"    - display PCI configuration space (CFG)\n"
636	"pci next[.b, .w, .l] b.d.f address\n"
637	"    - modify, read and keep CFG address\n"
638	"pci modify[.b, .w, .l] b.d.f address\n"
639	"    -  modify, auto increment CFG address\n"
640	"pci write[.b, .w, .l] b.d.f address value\n"
641	"    - write to CFG address");
642
643U_BOOT_CMD(
644	pci,	5,	1,	do_pci,
645	"list and access PCI Configuration Space", pci_help_text
646);
647