]>
git.ipfire.org Git - thirdparty/pciutils.git/blob - setpci.c
2 * The PCI Utilities -- Manipulate PCI Configuration Registers
4 * Copyright (c) 1998--2008 Martin Mares <mj@ucw.cz>
6 * Can be freely distributed and used under the terms of the GNU GPL.
16 #define PCIUTILS_SETPCI
19 static int force
; /* Don't complain if no devices match */
20 static int verbose
; /* Verbosity level */
21 static int demo_mode
; /* Only show */
23 const char program_name
[] = "setpci";
25 static struct pci_access
*pacc
;
34 struct pci_dev
**dev_vector
;
35 u16 cap_type
; /* PCI_CAP_xxx or 0 */
38 unsigned int width
; /* Byte width of the access */
39 unsigned int num_values
; /* Number of values to write; 0=read */
40 struct value values
[0];
43 static struct op
*first_op
, **last_op
= &first_op
;
44 static unsigned int max_values
[] = { 0, 0xff, 0xffff, 0, 0xffffffff };
46 static struct pci_dev
**
47 select_devices(struct pci_filter
*filt
)
49 struct pci_dev
*z
, **a
, **b
;
52 for (z
=pacc
->devices
; z
; z
=z
->next
)
53 if (pci_filter_match(filt
, z
))
55 a
= b
= xmalloc(sizeof(struct device
*) * cnt
);
56 for (z
=pacc
->devices
; z
; z
=z
->next
)
57 if (pci_filter_match(filt
, z
))
63 static void PCI_PRINTF(1,2)
64 trace(const char *fmt
, ...)
74 exec_op(struct op
*op
, struct pci_dev
*dev
)
76 const char * const formats
[] = { NULL
, " %02x", " %04x", NULL
, " %08x" };
77 const char * const mask_formats
[] = { NULL
, " %02x->(%02x:%02x)->%02x", " %04x->(%04x:%04x)->%04x", NULL
, " %08x->(%08x:%08x)->%08x" };
80 int width
= op
->width
;
83 sprintf(slot
, "%04x:%02x:%02x.%x", dev
->domain
, dev
->bus
, dev
->dev
, dev
->func
);
88 cap
= pci_find_cap(dev
, op
->cap_id
, op
->cap_type
);
92 die("%s: %s %04x not found", slot
, ((op
->cap_type
== PCI_CAP_NORMAL
) ? "Capability" : "Extended capability"), op
->cap_id
);
93 trace(((op
->cap_type
== PCI_CAP_NORMAL
) ? "(cap %02x @%02x) " : "(ecap %04x @%03x) "), op
->cap_id
, addr
);
98 /* We have already checked it when parsing, but addressing relative to capabilities can change the address. */
100 die("%s: Unaligned access of width %d to register %04x", slot
, width
, addr
);
101 if (addr
+ width
> 0x1000)
102 die("%s: Access of width %d to register %04x out of range", slot
, width
, addr
);
106 for (i
=0; i
<op
->num_values
; i
++)
108 if ((op
->values
[i
].mask
& max_values
[width
]) == max_values
[width
])
110 x
= op
->values
[i
].value
;
111 trace(formats
[width
], op
->values
[i
].value
);
118 y
= pci_read_byte(dev
, addr
);
121 y
= pci_read_word(dev
, addr
);
124 y
= pci_read_long(dev
, addr
);
127 x
= (y
& ~op
->values
[i
].mask
) | op
->values
[i
].value
;
128 trace(mask_formats
[width
], y
, op
->values
[i
].value
, op
->values
[i
].mask
, x
);
135 pci_write_byte(dev
, addr
, x
);
138 pci_write_word(dev
, addr
, x
);
141 pci_write_long(dev
, addr
, x
);
155 x
= pci_read_byte(dev
, addr
);
158 x
= pci_read_word(dev
, addr
);
161 x
= pci_read_long(dev
, addr
);
164 printf(formats
[width
]+1, x
);
170 execute(struct op
*op
)
172 struct pci_dev
**vec
= NULL
;
173 struct pci_dev
**pdev
, *dev
;
178 pdev
= vec
= op
->dev_vector
;
179 while (dev
= *pdev
++)
180 for (oops
=op
; oops
&& oops
->dev_vector
== vec
; oops
=oops
->next
)
182 while (op
&& op
->dev_vector
== vec
)
188 scan_ops(struct op
*op
)
207 static const struct reg_name pci_reg_names
[] = {
208 { 0, 0x00, 2, "VENDOR_ID" },
209 { 0, 0x02, 2, "DEVICE_ID" },
210 { 0, 0x04, 2, "COMMAND" },
211 { 0, 0x06, 2, "STATUS" },
212 { 0, 0x08, 1, "REVISION" },
213 { 0, 0x09, 1, "CLASS_PROG" },
214 { 0, 0x0a, 2, "CLASS_DEVICE" },
215 { 0, 0x0c, 1, "CACHE_LINE_SIZE" },
216 { 0, 0x0d, 1, "LATENCY_TIMER" },
217 { 0, 0x0e, 1, "HEADER_TYPE" },
218 { 0, 0x0f, 1, "BIST" },
219 { 0, 0x10, 4, "BASE_ADDRESS_0" },
220 { 0, 0x14, 4, "BASE_ADDRESS_1" },
221 { 0, 0x18, 4, "BASE_ADDRESS_2" },
222 { 0, 0x1c, 4, "BASE_ADDRESS_3" },
223 { 0, 0x20, 4, "BASE_ADDRESS_4" },
224 { 0, 0x24, 4, "BASE_ADDRESS_5" },
225 { 0, 0x28, 4, "CARDBUS_CIS" },
226 { 0, 0x2c, 4, "SUBSYSTEM_VENDOR_ID" },
227 { 0, 0x2e, 2, "SUBSYSTEM_ID" },
228 { 0, 0x30, 4, "ROM_ADDRESS" },
229 { 0, 0x3c, 1, "INTERRUPT_LINE" },
230 { 0, 0x3d, 1, "INTERRUPT_PIN" },
231 { 0, 0x3e, 1, "MIN_GNT" },
232 { 0, 0x3f, 1, "MAX_LAT" },
233 { 0, 0x18, 1, "PRIMARY_BUS" },
234 { 0, 0x19, 1, "SECONDARY_BUS" },
235 { 0, 0x1a, 1, "SUBORDINATE_BUS" },
236 { 0, 0x1b, 1, "SEC_LATENCY_TIMER" },
237 { 0, 0x1c, 1, "IO_BASE" },
238 { 0, 0x1d, 1, "IO_LIMIT" },
239 { 0, 0x1e, 2, "SEC_STATUS" },
240 { 0, 0x20, 2, "MEMORY_BASE" },
241 { 0, 0x22, 2, "MEMORY_LIMIT" },
242 { 0, 0x24, 2, "PREF_MEMORY_BASE" },
243 { 0, 0x26, 2, "PREF_MEMORY_LIMIT" },
244 { 0, 0x28, 4, "PREF_BASE_UPPER32" },
245 { 0, 0x2c, 4, "PREF_LIMIT_UPPER32" },
246 { 0, 0x30, 2, "IO_BASE_UPPER16" },
247 { 0, 0x32, 2, "IO_LIMIT_UPPER16" },
248 { 0, 0x38, 4, "BRIDGE_ROM_ADDRESS" },
249 { 0, 0x3e, 2, "BRIDGE_CONTROL" },
250 { 0, 0x10, 4, "CB_CARDBUS_BASE" },
251 { 0, 0x14, 2, "CB_CAPABILITIES" },
252 { 0, 0x16, 2, "CB_SEC_STATUS" },
253 { 0, 0x18, 1, "CB_BUS_NUMBER" },
254 { 0, 0x19, 1, "CB_CARDBUS_NUMBER" },
255 { 0, 0x1a, 1, "CB_SUBORDINATE_BUS" },
256 { 0, 0x1b, 1, "CB_CARDBUS_LATENCY" },
257 { 0, 0x1c, 4, "CB_MEMORY_BASE_0" },
258 { 0, 0x20, 4, "CB_MEMORY_LIMIT_0" },
259 { 0, 0x24, 4, "CB_MEMORY_BASE_1" },
260 { 0, 0x28, 4, "CB_MEMORY_LIMIT_1" },
261 { 0, 0x2c, 2, "CB_IO_BASE_0" },
262 { 0, 0x2e, 2, "CB_IO_BASE_0_HI" },
263 { 0, 0x30, 2, "CB_IO_LIMIT_0" },
264 { 0, 0x32, 2, "CB_IO_LIMIT_0_HI" },
265 { 0, 0x34, 2, "CB_IO_BASE_1" },
266 { 0, 0x36, 2, "CB_IO_BASE_1_HI" },
267 { 0, 0x38, 2, "CB_IO_LIMIT_1" },
268 { 0, 0x3a, 2, "CB_IO_LIMIT_1_HI" },
269 { 0, 0x40, 2, "CB_SUBSYSTEM_VENDOR_ID" },
270 { 0, 0x42, 2, "CB_SUBSYSTEM_ID" },
271 { 0, 0x44, 4, "CB_LEGACY_MODE_BASE" },
272 { 0x10001, 0, 0, "CAP_PM" },
273 { 0x10002, 0, 0, "CAP_AGP" },
274 { 0x10003, 0, 0, "CAP_VPD" },
275 { 0x10004, 0, 0, "CAP_SLOTID" },
276 { 0x10005, 0, 0, "CAP_MSI" },
277 { 0x10006, 0, 0, "CAP_CHSWP" },
278 { 0x10007, 0, 0, "CAP_PCIX" },
279 { 0x10008, 0, 0, "CAP_HT" },
280 { 0x10009, 0, 0, "CAP_VNDR" },
281 { 0x1000a, 0, 0, "CAP_DBG" },
282 { 0x1000b, 0, 0, "CAP_CCRC" },
283 { 0x1000c, 0, 0, "CAP_HOTPLUG" },
284 { 0x1000d, 0, 0, "CAP_SSVID" },
285 { 0x1000e, 0, 0, "CAP_AGP3" },
286 { 0x1000f, 0, 0, "CAP_SECURE" },
287 { 0x10010, 0, 0, "CAP_EXP" },
288 { 0x10011, 0, 0, "CAP_MSIX" },
289 { 0x10012, 0, 0, "CAP_SATA" },
290 { 0x10013, 0, 0, "CAP_AF" },
291 { 0x20001, 0, 0, "ECAP_AER" },
292 { 0x20002, 0, 0, "ECAP_VC" },
293 { 0x20003, 0, 0, "ECAP_DSN" },
294 { 0x20004, 0, 0, "ECAP_PB" },
295 { 0x20005, 0, 0, "ECAP_RCLINK" },
296 { 0x20006, 0, 0, "ECAP_RCILINK" },
297 { 0x20007, 0, 0, "ECAP_RCECOLL" },
298 { 0x20008, 0, 0, "ECAP_MFVC" },
299 { 0x2000a, 0, 0, "ECAP_RBCB" },
300 { 0x2000b, 0, 0, "ECAP_VNDR" },
301 { 0x2000d, 0, 0, "ECAP_ACS" },
302 { 0x2000e, 0, 0, "ECAP_ARI" },
303 { 0x2000f, 0, 0, "ECAP_ATS" },
304 { 0x20010, 0, 0, "ECAP_SRIOV" },
311 const struct reg_name
*r
;
313 printf("cap pos w name\n");
314 for (r
= pci_reg_names
; r
->name
; r
++)
316 if (r
->cap
>= 0x20000)
317 printf("%04x", r
->cap
- 0x20000);
319 printf(" %02x", r
->cap
- 0x10000);
322 printf(" %02x %c %s\n", r
->offset
, "-BW?L"[r
->width
], r
->name
);
326 static void NONRET
PCI_PRINTF(1,2)
327 usage(char *msg
, ...)
333 fprintf(stderr
, "setpci: ");
334 vfprintf(stderr
, msg
, args
);
335 fprintf(stderr
, "\n\n");
338 "Usage: setpci [<options>] (<device>+ <reg>[=<values>]*)*\n"
341 "-f\t\tDon't complain if there's nothing to do\n"
343 "-D\t\tList changes, don't commit them\n"
344 "--dumpregs\tDump all known register names and exit\n"
346 "PCI access options:\n"
349 "Setting commands:\n"
350 "<device>:\t-s [[[<domain>]:][<bus>]:][<slot>][.[<func>]]\n"
351 "\t\t-d [<vendor>]:[<device>]\n"
352 "<reg>:\t\t<base>[+<offset>][.(B|W|L)]\n"
353 "<base>:\t\t<address>\n"
354 "\t\t<named-register>\n"
355 "\t\t[E]CAP_<capability-name>\n"
356 "\t\t[E]CAP<capability-number>\n"
357 "<values>:\t<value>[,<value>...]\n"
359 "\t\t<hex>:<mask>\n");
364 parse_options(int argc
, char **argv
)
366 char *opts
= GENERIC_OPTIONS
;
369 if (argc
== 2 && !strcmp(argv
[1], "--version"))
371 puts("setpci version " PCIUTILS_VERSION
);
374 if (argc
== 2 && !strcmp(argv
[1], "--dumpregs"))
380 while (i
< argc
&& argv
[i
][0] == '-')
382 char *c
= argv
[i
++] + 1;
403 if (e
= strchr(opts
, *c
))
419 if (!parse_generic_option(*e
, pacc
, arg
))
434 static int parse_filter(int argc
, char **argv
, int i
, struct pci_filter
*filter
)
439 if (!c
[1] || !strchr("sd", c
[1]))
442 d
= (c
[2] == '=') ? c
+3 : c
+2;
450 if (d
= pci_filter_parse_slot(filter
, d
))
454 if (d
= pci_filter_parse_id(filter
, d
))
464 static const struct reg_name
*parse_reg_name(char *name
)
466 const struct reg_name
*r
;
468 for (r
= pci_reg_names
; r
->name
; r
++)
469 if (!strcasecmp(r
->name
, name
))
474 static int parse_x32(char *c
, char **stopp
, unsigned int *resp
)
481 unsigned long int l
= strtoul(c
, &stop
, 16);
497 static void parse_register(struct op
*op
, char *base
)
499 const struct reg_name
*r
;
502 op
->cap_type
= op
->cap_id
= 0;
503 if (parse_x32(base
, NULL
, &op
->addr
) > 0)
505 else if (r
= parse_reg_name(base
))
507 switch (r
->cap
& 0xff0000)
510 op
->cap_type
= PCI_CAP_NORMAL
;
513 op
->cap_type
= PCI_CAP_EXTENDED
;
516 op
->cap_id
= r
->cap
& 0xffff;
517 op
->addr
= r
->offset
;
518 if (r
->width
&& !op
->width
)
519 op
->width
= r
->width
;
522 else if (!strncasecmp(base
, "CAP", 3))
524 if (parse_x32(base
+3, NULL
, &cap
) > 0 && cap
< 0x100)
526 op
->cap_type
= PCI_CAP_NORMAL
;
532 else if (!strncasecmp(base
, "ECAP", 4))
534 if (parse_x32(base
+4, NULL
, &cap
) > 0 && cap
< 0x1000)
536 op
->cap_type
= PCI_CAP_EXTENDED
;
542 usage("Unknown register \"%s\"", base
);
545 static void parse_op(char *c
, struct pci_dev
**selected_devices
)
547 char *base
, *offset
, *width
, *value
;
552 /* Split the argument */
554 if (value
= strchr(base
, '='))
556 if (width
= strchr(base
, '.'))
558 if (offset
= strchr(base
, '+'))
561 /* Look for setting of values and count how many */
566 usage("Missing value");
568 for (e
=value
; *e
; e
++)
573 /* Allocate the operation */
574 op
= xmalloc(sizeof(struct op
) + n
*sizeof(struct value
));
575 op
->dev_vector
= selected_devices
;
578 /* What is the width suffix? */
582 usage("Invalid width \"%s\"", width
);
583 switch (*width
& 0xdf)
586 op
->width
= 1; break;
588 op
->width
= 2; break;
590 op
->width
= 4; break;
592 usage("Invalid width \"%c\"", *width
);
598 /* Find the register */
599 parse_register(op
, base
);
601 usage("Missing width");
607 if (parse_x32(offset
, NULL
, &off
) <= 0 || off
>= 0x1000)
608 die("Invalid offset \"%s\"", offset
);
613 if (op
->addr
>= 0x1000 || op
->addr
+ op
->width
*(n
? n
: 1) > 0x1000)
614 die("Register number out of range!");
615 if (op
->addr
& (op
->width
- 1))
616 die("Unaligned register address!");
618 /* Parse the values */
621 unsigned int ll
, lim
;
622 e
= strchr(value
, ',');
625 if (parse_x32(value
, &f
, &ll
) < 0 || *f
&& *f
!= ':')
626 usage("Invalid value \"%s\"", value
);
627 lim
= max_values
[op
->width
];
628 if (ll
> lim
&& ll
< ~0UL - lim
)
629 usage("Value \"%s\" is out of range", value
);
630 op
->values
[j
].value
= ll
;
633 if (parse_x32(f
+1, NULL
, &ll
) <= 0)
634 usage("Invalid mask \"%s\"", f
+1);
635 if (ll
> lim
&& ll
< ~0UL - lim
)
636 usage("Mask \"%s\" is out of range", f
+1);
637 op
->values
[j
].mask
= ll
;
638 op
->values
[j
].value
&= ll
;
641 op
->values
[j
].mask
= ~0U;
650 static void parse_ops(int argc
, char **argv
, int i
)
652 enum { STATE_INIT
, STATE_GOT_FILTER
, STATE_GOT_OP
} state
= STATE_INIT
;
653 struct pci_filter filter
;
654 struct pci_dev
**selected_devices
= NULL
;
662 if (state
!= STATE_GOT_FILTER
)
663 pci_filter_init(pacc
, &filter
);
664 i
= parse_filter(argc
, argv
, i
-1, &filter
);
665 state
= STATE_GOT_FILTER
;
669 if (state
== STATE_INIT
)
671 if (state
== STATE_GOT_FILTER
)
672 selected_devices
= select_devices(&filter
);
673 if (!selected_devices
[0] && !force
)
674 fprintf(stderr
, "setpci: Warning: No devices selected for `%s'.\n", c
);
675 parse_op(c
, selected_devices
);
676 state
= STATE_GOT_OP
;
679 if (state
== STATE_INIT
)
680 usage("No operation specified");
684 main(int argc
, char **argv
)
690 i
= parse_options(argc
, argv
);
695 parse_ops(argc
, argv
, i
);