Linux Audio

Check our new training course

Loading...
v5.4
  1// SPDX-License-Identifier: GPL-2.0
  2/*
  3 * PCI VPD support
  4 *
  5 * Copyright (C) 2010 Broadcom Corporation.
  6 */
  7
  8#include <linux/pci.h>
  9#include <linux/delay.h>
 10#include <linux/export.h>
 11#include <linux/sched/signal.h>
 
 12#include "pci.h"
 13
 14/* VPD access through PCI 2.2+ VPD capability */
 
 
 
 
 15
 16struct pci_vpd_ops {
 17	ssize_t (*read)(struct pci_dev *dev, loff_t pos, size_t count, void *buf);
 18	ssize_t (*write)(struct pci_dev *dev, loff_t pos, size_t count, const void *buf);
 19	int (*set_size)(struct pci_dev *dev, size_t len);
 20};
 21
 22struct pci_vpd {
 23	const struct pci_vpd_ops *ops;
 24	struct bin_attribute *attr;	/* Descriptor for sysfs VPD entry */
 25	struct mutex	lock;
 26	unsigned int	len;
 27	u16		flag;
 28	u8		cap;
 29	unsigned int	busy:1;
 30	unsigned int	valid:1;
 31};
 32
 33/**
 34 * pci_read_vpd - Read one entry from Vital Product Data
 35 * @dev:	pci device struct
 36 * @pos:	offset in vpd space
 37 * @count:	number of bytes to read
 38 * @buf:	pointer to where to store result
 39 */
 40ssize_t pci_read_vpd(struct pci_dev *dev, loff_t pos, size_t count, void *buf)
 41{
 42	if (!dev->vpd || !dev->vpd->ops)
 43		return -ENODEV;
 44	return dev->vpd->ops->read(dev, pos, count, buf);
 45}
 46EXPORT_SYMBOL(pci_read_vpd);
 47
 48/**
 49 * pci_write_vpd - Write entry to Vital Product Data
 50 * @dev:	pci device struct
 51 * @pos:	offset in vpd space
 52 * @count:	number of bytes to write
 53 * @buf:	buffer containing write data
 54 */
 55ssize_t pci_write_vpd(struct pci_dev *dev, loff_t pos, size_t count, const void *buf)
 56{
 57	if (!dev->vpd || !dev->vpd->ops)
 58		return -ENODEV;
 59	return dev->vpd->ops->write(dev, pos, count, buf);
 60}
 61EXPORT_SYMBOL(pci_write_vpd);
 62
 63/**
 64 * pci_set_vpd_size - Set size of Vital Product Data space
 65 * @dev:	pci device struct
 66 * @len:	size of vpd space
 67 */
 68int pci_set_vpd_size(struct pci_dev *dev, size_t len)
 69{
 70	if (!dev->vpd || !dev->vpd->ops)
 71		return -ENODEV;
 72	return dev->vpd->ops->set_size(dev, len);
 73}
 74EXPORT_SYMBOL(pci_set_vpd_size);
 75
 76#define PCI_VPD_MAX_SIZE (PCI_VPD_ADDR_MASK + 1)
 
 77
 78/**
 79 * pci_vpd_size - determine actual size of Vital Product Data
 80 * @dev:	pci device struct
 81 * @old_size:	current assumed size, also maximum allowed size
 82 */
 83static size_t pci_vpd_size(struct pci_dev *dev, size_t old_size)
 84{
 85	size_t off = 0;
 86	unsigned char header[1+2];	/* 1 byte tag, 2 bytes length */
 87
 88	while (off < old_size &&
 89	       pci_read_vpd(dev, off, 1, header) == 1) {
 90		unsigned char tag;
 
 
 91
 92		if (header[0] & PCI_VPD_LRDT) {
 93			/* Large Resource Data Type Tag */
 94			tag = pci_vpd_lrdt_tag(header);
 95			/* Only read length from known tag items */
 96			if ((tag == PCI_VPD_LTIN_ID_STRING) ||
 97			    (tag == PCI_VPD_LTIN_RO_DATA) ||
 98			    (tag == PCI_VPD_LTIN_RW_DATA)) {
 99				if (pci_read_vpd(dev, off+1, 2,
100						 &header[1]) != 2) {
101					pci_warn(dev, "invalid large VPD tag %02x size at offset %zu",
102						 tag, off + 1);
103					return 0;
104				}
105				off += PCI_VPD_LRDT_TAG_SIZE +
106					pci_vpd_lrdt_size(header);
107			}
 
 
 
 
 
108		} else {
109			/* Short Resource Data Type Tag */
110			off += PCI_VPD_SRDT_TAG_SIZE +
111				pci_vpd_srdt_size(header);
112			tag = pci_vpd_srdt_tag(header);
 
 
 
 
 
 
 
113		}
 
 
114
115		if (tag == PCI_VPD_STIN_END)	/* End tag descriptor */
116			return off;
 
 
 
 
117
118		if ((tag != PCI_VPD_LTIN_ID_STRING) &&
119		    (tag != PCI_VPD_LTIN_RO_DATA) &&
120		    (tag != PCI_VPD_LTIN_RW_DATA)) {
121			pci_warn(dev, "invalid %s VPD tag %02x at offset %zu",
122				 (header[0] & PCI_VPD_LRDT) ? "large" : "short",
123				 tag, off);
124			return 0;
 
 
 
 
 
125		}
126	}
127	return 0;
 
128}
129
130/*
131 * Wait for last operation to complete.
132 * This code has to spin since there is no other notification from the PCI
133 * hardware. Since the VPD is often implemented by serial attachment to an
134 * EEPROM, it may take many milliseconds to complete.
 
135 *
136 * Returns 0 on success, negative values indicate error.
137 */
138static int pci_vpd_wait(struct pci_dev *dev)
139{
140	struct pci_vpd *vpd = dev->vpd;
141	unsigned long timeout = jiffies + msecs_to_jiffies(125);
142	unsigned long max_sleep = 16;
143	u16 status;
144	int ret;
145
146	if (!vpd->busy)
147		return 0;
148
149	do {
150		ret = pci_user_read_config_word(dev, vpd->cap + PCI_VPD_ADDR,
151						&status);
152		if (ret < 0)
153			return ret;
154
155		if ((status & PCI_VPD_ADDR_F) == vpd->flag) {
156			vpd->busy = 0;
157			return 0;
158		}
159
160		if (fatal_signal_pending(current))
161			return -EINTR;
162
163		if (time_after(jiffies, timeout))
164			break;
165
166		usleep_range(10, max_sleep);
167		if (max_sleep < 1024)
168			max_sleep *= 2;
169	} while (true);
170
171	pci_warn(dev, "VPD access failed.  This is likely a firmware bug on this device.  Contact the card vendor for a firmware update\n");
172	return -ETIMEDOUT;
173}
174
175static ssize_t pci_vpd_read(struct pci_dev *dev, loff_t pos, size_t count,
176			    void *arg)
177{
178	struct pci_vpd *vpd = dev->vpd;
179	int ret;
 
180	loff_t end = pos + count;
181	u8 *buf = arg;
182
 
 
 
183	if (pos < 0)
184		return -EINVAL;
185
186	if (!vpd->valid) {
187		vpd->valid = 1;
188		vpd->len = pci_vpd_size(dev, vpd->len);
189	}
190
191	if (vpd->len == 0)
192		return -EIO;
193
194	if (pos > vpd->len)
195		return 0;
196
197	if (end > vpd->len) {
198		end = vpd->len;
199		count = end - pos;
200	}
201
202	if (mutex_lock_killable(&vpd->lock))
203		return -EINTR;
204
205	ret = pci_vpd_wait(dev);
206	if (ret < 0)
207		goto out;
208
209	while (pos < end) {
210		u32 val;
211		unsigned int i, skip;
212
 
 
 
 
 
213		ret = pci_user_write_config_word(dev, vpd->cap + PCI_VPD_ADDR,
214						 pos & ~3);
215		if (ret < 0)
216			break;
217		vpd->busy = 1;
218		vpd->flag = PCI_VPD_ADDR_F;
219		ret = pci_vpd_wait(dev);
220		if (ret < 0)
221			break;
222
223		ret = pci_user_read_config_dword(dev, vpd->cap + PCI_VPD_DATA, &val);
224		if (ret < 0)
225			break;
226
227		skip = pos & 3;
228		for (i = 0;  i < sizeof(u32); i++) {
229			if (i >= skip) {
230				*buf++ = val;
231				if (++pos == end)
232					break;
233			}
234			val >>= 8;
235		}
236	}
237out:
238	mutex_unlock(&vpd->lock);
239	return ret ? ret : count;
240}
241
242static ssize_t pci_vpd_write(struct pci_dev *dev, loff_t pos, size_t count,
243			     const void *arg)
244{
245	struct pci_vpd *vpd = dev->vpd;
 
246	const u8 *buf = arg;
247	loff_t end = pos + count;
248	int ret = 0;
249
 
 
 
250	if (pos < 0 || (pos & 3) || (count & 3))
251		return -EINVAL;
252
253	if (!vpd->valid) {
254		vpd->valid = 1;
255		vpd->len = pci_vpd_size(dev, vpd->len);
256	}
257
258	if (vpd->len == 0)
259		return -EIO;
260
261	if (end > vpd->len)
262		return -EINVAL;
263
264	if (mutex_lock_killable(&vpd->lock))
265		return -EINTR;
266
267	ret = pci_vpd_wait(dev);
268	if (ret < 0)
269		goto out;
270
271	while (pos < end) {
272		u32 val;
273
274		val = *buf++;
275		val |= *buf++ << 8;
276		val |= *buf++ << 16;
277		val |= *buf++ << 24;
278
279		ret = pci_user_write_config_dword(dev, vpd->cap + PCI_VPD_DATA, val);
280		if (ret < 0)
281			break;
282		ret = pci_user_write_config_word(dev, vpd->cap + PCI_VPD_ADDR,
283						 pos | PCI_VPD_ADDR_F);
284		if (ret < 0)
285			break;
286
287		vpd->busy = 1;
288		vpd->flag = 0;
289		ret = pci_vpd_wait(dev);
290		if (ret < 0)
291			break;
292
 
293		pos += sizeof(u32);
294	}
295out:
296	mutex_unlock(&vpd->lock);
297	return ret ? ret : count;
298}
299
300static int pci_vpd_set_size(struct pci_dev *dev, size_t len)
301{
302	struct pci_vpd *vpd = dev->vpd;
 
303
304	if (len == 0 || len > PCI_VPD_MAX_SIZE)
305		return -EIO;
 
306
307	vpd->valid = 1;
308	vpd->len = len;
 
 
 
309
310	return 0;
 
 
 
 
 
 
 
 
 
311}
 
312
313static const struct pci_vpd_ops pci_vpd_ops = {
314	.read = pci_vpd_read,
315	.write = pci_vpd_write,
316	.set_size = pci_vpd_set_size,
317};
318
319static ssize_t pci_vpd_f0_read(struct pci_dev *dev, loff_t pos, size_t count,
320			       void *arg)
321{
322	struct pci_dev *tdev = pci_get_slot(dev->bus,
323					    PCI_DEVFN(PCI_SLOT(dev->devfn), 0));
324	ssize_t ret;
325
326	if (!tdev)
327		return -ENODEV;
328
329	ret = pci_read_vpd(tdev, pos, count, arg);
330	pci_dev_put(tdev);
331	return ret;
332}
333
334static ssize_t pci_vpd_f0_write(struct pci_dev *dev, loff_t pos, size_t count,
335				const void *arg)
 
 
 
 
336{
337	struct pci_dev *tdev = pci_get_slot(dev->bus,
338					    PCI_DEVFN(PCI_SLOT(dev->devfn), 0));
339	ssize_t ret;
340
341	if (!tdev)
342		return -ENODEV;
 
 
 
 
 
 
 
 
 
 
 
343
344	ret = pci_write_vpd(tdev, pos, count, arg);
345	pci_dev_put(tdev);
346	return ret;
 
347}
 
348
349static int pci_vpd_f0_set_size(struct pci_dev *dev, size_t len)
350{
351	struct pci_dev *tdev = pci_get_slot(dev->bus,
352					    PCI_DEVFN(PCI_SLOT(dev->devfn), 0));
353	int ret;
354
355	if (!tdev)
356		return -ENODEV;
 
 
357
358	ret = pci_set_vpd_size(tdev, len);
359	pci_dev_put(tdev);
360	return ret;
361}
 
 
 
 
362
363static const struct pci_vpd_ops pci_vpd_f0_ops = {
364	.read = pci_vpd_f0_read,
365	.write = pci_vpd_f0_write,
366	.set_size = pci_vpd_f0_set_size,
367};
368
369int pci_vpd_init(struct pci_dev *dev)
370{
371	struct pci_vpd *vpd;
372	u8 cap;
373
374	cap = pci_find_capability(dev, PCI_CAP_ID_VPD);
375	if (!cap)
376		return -ENODEV;
 
 
377
378	vpd = kzalloc(sizeof(*vpd), GFP_ATOMIC);
379	if (!vpd)
380		return -ENOMEM;
381
382	vpd->len = PCI_VPD_MAX_SIZE;
383	if (dev->dev_flags & PCI_DEV_FLAGS_VPD_REF_F0)
384		vpd->ops = &pci_vpd_f0_ops;
385	else
386		vpd->ops = &pci_vpd_ops;
387	mutex_init(&vpd->lock);
388	vpd->cap = cap;
389	vpd->busy = 0;
390	vpd->valid = 0;
391	dev->vpd = vpd;
392	return 0;
393}
394
395void pci_vpd_release(struct pci_dev *dev)
396{
397	kfree(dev->vpd);
398}
399
400static ssize_t read_vpd_attr(struct file *filp, struct kobject *kobj,
401			     struct bin_attribute *bin_attr, char *buf,
402			     loff_t off, size_t count)
403{
404	struct pci_dev *dev = to_pci_dev(kobj_to_dev(kobj));
 
 
 
 
 
405
406	if (bin_attr->size > 0) {
407		if (off > bin_attr->size)
408			count = 0;
409		else if (count > bin_attr->size - off)
410			count = bin_attr->size - off;
411	}
412
413	return pci_read_vpd(dev, off, count, buf);
414}
415
416static ssize_t write_vpd_attr(struct file *filp, struct kobject *kobj,
417			      struct bin_attribute *bin_attr, char *buf,
418			      loff_t off, size_t count)
419{
420	struct pci_dev *dev = to_pci_dev(kobj_to_dev(kobj));
 
 
 
 
 
421
422	if (bin_attr->size > 0) {
423		if (off > bin_attr->size)
424			count = 0;
425		else if (count > bin_attr->size - off)
426			count = bin_attr->size - off;
427	}
428
429	return pci_write_vpd(dev, off, count, buf);
430}
431
432void pcie_vpd_create_sysfs_dev_files(struct pci_dev *dev)
 
 
 
 
 
 
 
433{
434	int retval;
435	struct bin_attribute *attr;
 
436
437	if (!dev->vpd)
438		return;
 
 
 
 
439
440	attr = kzalloc(sizeof(*attr), GFP_ATOMIC);
441	if (!attr)
442		return;
 
443
444	sysfs_bin_attr_init(attr);
445	attr->size = 0;
446	attr->attr.name = "vpd";
447	attr->attr.mode = S_IRUSR | S_IWUSR;
448	attr->read = read_vpd_attr;
449	attr->write = write_vpd_attr;
450	retval = sysfs_create_bin_file(&dev->dev.kobj, attr);
451	if (retval) {
452		kfree(attr);
453		return;
454	}
455
456	dev->vpd->attr = attr;
457}
458
459void pcie_vpd_remove_sysfs_dev_files(struct pci_dev *dev)
 
 
 
 
 
 
 
460{
461	if (dev->vpd && dev->vpd->attr) {
462		sysfs_remove_bin_file(&dev->dev.kobj, dev->vpd->attr);
463		kfree(dev->vpd->attr);
464	}
465}
 
466
467int pci_vpd_find_tag(const u8 *buf, unsigned int off, unsigned int len, u8 rdt)
 
468{
469	int i;
470
471	for (i = off; i < len; ) {
472		u8 val = buf[i];
473
474		if (val & PCI_VPD_LRDT) {
475			/* Don't return success of the tag isn't complete */
476			if (i + PCI_VPD_LRDT_TAG_SIZE > len)
477				break;
 
478
479			if (val == rdt)
480				return i;
 
481
482			i += PCI_VPD_LRDT_TAG_SIZE +
483			     pci_vpd_lrdt_size(&buf[i]);
484		} else {
485			u8 tag = val & ~PCI_VPD_SRDT_LEN_MASK;
486
487			if (tag == rdt)
488				return i;
489
490			if (tag == PCI_VPD_SRDT_END)
491				break;
492
493			i += PCI_VPD_SRDT_TAG_SIZE +
494			     pci_vpd_srdt_size(&buf[i]);
495		}
496	}
497
498	return -ENOENT;
499}
500EXPORT_SYMBOL_GPL(pci_vpd_find_tag);
501
502int pci_vpd_find_info_keyword(const u8 *buf, unsigned int off,
503			      unsigned int len, const char *kw)
504{
505	int i;
 
 
 
506
507	for (i = off; i + PCI_VPD_INFO_FLD_HDR_SIZE <= off + len;) {
508		if (buf[i + 0] == kw[0] &&
509		    buf[i + 1] == kw[1])
510			return i;
 
511
512		i += PCI_VPD_INFO_FLD_HDR_SIZE +
513		     pci_vpd_info_field_size(&buf[i]);
514	}
515
516	return -ENOENT;
 
 
 
517}
518EXPORT_SYMBOL_GPL(pci_vpd_find_info_keyword);
519
520#ifdef CONFIG_PCI_QUIRKS
521/*
522 * Quirk non-zero PCI functions to route VPD access through function 0 for
523 * devices that share VPD resources between functions.  The functions are
524 * expected to be identical devices.
525 */
526static void quirk_f0_vpd_link(struct pci_dev *dev)
527{
528	struct pci_dev *f0;
529
530	if (!PCI_FUNC(dev->devfn))
531		return;
532
533	f0 = pci_get_slot(dev->bus, PCI_DEVFN(PCI_SLOT(dev->devfn), 0));
534	if (!f0)
535		return;
536
537	if (f0->vpd && dev->class == f0->class &&
538	    dev->vendor == f0->vendor && dev->device == f0->device)
539		dev->dev_flags |= PCI_DEV_FLAGS_VPD_REF_F0;
540
541	pci_dev_put(f0);
542}
543DECLARE_PCI_FIXUP_CLASS_EARLY(PCI_VENDOR_ID_INTEL, PCI_ANY_ID,
544			      PCI_CLASS_NETWORK_ETHERNET, 8, quirk_f0_vpd_link);
545
546/*
547 * If a device follows the VPD format spec, the PCI core will not read or
548 * write past the VPD End Tag.  But some vendors do not follow the VPD
549 * format spec, so we can't tell how much data is safe to access.  Devices
550 * may behave unpredictably if we access too much.  Blacklist these devices
551 * so we don't touch VPD at all.
552 */
553static void quirk_blacklist_vpd(struct pci_dev *dev)
554{
555	if (dev->vpd) {
556		dev->vpd->len = 0;
557		pci_warn(dev, FW_BUG "disabling VPD access (can't determine size of non-standard VPD format)\n");
558	}
559}
560DECLARE_PCI_FIXUP_FINAL(PCI_VENDOR_ID_LSI_LOGIC, 0x0060, quirk_blacklist_vpd);
561DECLARE_PCI_FIXUP_FINAL(PCI_VENDOR_ID_LSI_LOGIC, 0x007c, quirk_blacklist_vpd);
562DECLARE_PCI_FIXUP_FINAL(PCI_VENDOR_ID_LSI_LOGIC, 0x0413, quirk_blacklist_vpd);
563DECLARE_PCI_FIXUP_FINAL(PCI_VENDOR_ID_LSI_LOGIC, 0x0078, quirk_blacklist_vpd);
564DECLARE_PCI_FIXUP_FINAL(PCI_VENDOR_ID_LSI_LOGIC, 0x0079, quirk_blacklist_vpd);
565DECLARE_PCI_FIXUP_FINAL(PCI_VENDOR_ID_LSI_LOGIC, 0x0073, quirk_blacklist_vpd);
566DECLARE_PCI_FIXUP_FINAL(PCI_VENDOR_ID_LSI_LOGIC, 0x0071, quirk_blacklist_vpd);
567DECLARE_PCI_FIXUP_FINAL(PCI_VENDOR_ID_LSI_LOGIC, 0x005b, quirk_blacklist_vpd);
568DECLARE_PCI_FIXUP_FINAL(PCI_VENDOR_ID_LSI_LOGIC, 0x002f, quirk_blacklist_vpd);
569DECLARE_PCI_FIXUP_FINAL(PCI_VENDOR_ID_LSI_LOGIC, 0x005d, quirk_blacklist_vpd);
570DECLARE_PCI_FIXUP_FINAL(PCI_VENDOR_ID_LSI_LOGIC, 0x005f, quirk_blacklist_vpd);
571DECLARE_PCI_FIXUP_FINAL(PCI_VENDOR_ID_ATTANSIC, PCI_ANY_ID,
572		quirk_blacklist_vpd);
573DECLARE_PCI_FIXUP_FINAL(PCI_VENDOR_ID_QLOGIC, 0x2261, quirk_blacklist_vpd);
574/*
575 * The Amazon Annapurna Labs 0x0031 device id is reused for other non Root Port
576 * device types, so the quirk is registered for the PCI_CLASS_BRIDGE_PCI class.
577 */
578DECLARE_PCI_FIXUP_CLASS_FINAL(PCI_VENDOR_ID_AMAZON_ANNAPURNA_LABS, 0x0031,
579			      PCI_CLASS_BRIDGE_PCI, 8, quirk_blacklist_vpd);
580
581/*
582 * For Broadcom 5706, 5708, 5709 rev. A nics, any read beyond the
583 * VPD end tag will hang the device.  This problem was initially
584 * observed when a vpd entry was created in sysfs
585 * ('/sys/bus/pci/devices/<id>/vpd').   A read to this sysfs entry
586 * will dump 32k of data.  Reading a full 32k will cause an access
587 * beyond the VPD end tag causing the device to hang.  Once the device
588 * is hung, the bnx2 driver will not be able to reset the device.
589 * We believe that it is legal to read beyond the end tag and
590 * therefore the solution is to limit the read/write length.
591 */
592static void quirk_brcm_570x_limit_vpd(struct pci_dev *dev)
593{
594	/*
595	 * Only disable the VPD capability for 5706, 5706S, 5708,
596	 * 5708S and 5709 rev. A
597	 */
598	if ((dev->device == PCI_DEVICE_ID_NX2_5706) ||
599	    (dev->device == PCI_DEVICE_ID_NX2_5706S) ||
600	    (dev->device == PCI_DEVICE_ID_NX2_5708) ||
601	    (dev->device == PCI_DEVICE_ID_NX2_5708S) ||
602	    ((dev->device == PCI_DEVICE_ID_NX2_5709) &&
603	     (dev->revision & 0xf0) == 0x0)) {
604		if (dev->vpd)
605			dev->vpd->len = 0x80;
606	}
607}
608DECLARE_PCI_FIXUP_FINAL(PCI_VENDOR_ID_BROADCOM,
609			PCI_DEVICE_ID_NX2_5706,
610			quirk_brcm_570x_limit_vpd);
611DECLARE_PCI_FIXUP_FINAL(PCI_VENDOR_ID_BROADCOM,
612			PCI_DEVICE_ID_NX2_5706S,
613			quirk_brcm_570x_limit_vpd);
614DECLARE_PCI_FIXUP_FINAL(PCI_VENDOR_ID_BROADCOM,
615			PCI_DEVICE_ID_NX2_5708,
616			quirk_brcm_570x_limit_vpd);
617DECLARE_PCI_FIXUP_FINAL(PCI_VENDOR_ID_BROADCOM,
618			PCI_DEVICE_ID_NX2_5708S,
619			quirk_brcm_570x_limit_vpd);
620DECLARE_PCI_FIXUP_FINAL(PCI_VENDOR_ID_BROADCOM,
621			PCI_DEVICE_ID_NX2_5709,
622			quirk_brcm_570x_limit_vpd);
623DECLARE_PCI_FIXUP_FINAL(PCI_VENDOR_ID_BROADCOM,
624			PCI_DEVICE_ID_NX2_5709S,
625			quirk_brcm_570x_limit_vpd);
626
627static void quirk_chelsio_extend_vpd(struct pci_dev *dev)
628{
629	int chip = (dev->device & 0xf000) >> 12;
630	int func = (dev->device & 0x0f00) >>  8;
631	int prod = (dev->device & 0x00ff) >>  0;
632
633	/*
634	 * If this is a T3-based adapter, there's a 1KB VPD area at offset
635	 * 0xc00 which contains the preferred VPD values.  If this is a T4 or
636	 * later based adapter, the special VPD is at offset 0x400 for the
637	 * Physical Functions (the SR-IOV Virtual Functions have no VPD
638	 * Capabilities).  The PCI VPD Access core routines will normally
639	 * compute the size of the VPD by parsing the VPD Data Structure at
640	 * offset 0x000.  This will result in silent failures when attempting
641	 * to accesses these other VPD areas which are beyond those computed
642	 * limits.
643	 */
644	if (chip == 0x0 && prod >= 0x20)
645		pci_set_vpd_size(dev, 8192);
646	else if (chip >= 0x4 && func < 0x8)
647		pci_set_vpd_size(dev, 2048);
648}
649
650DECLARE_PCI_FIXUP_FINAL(PCI_VENDOR_ID_CHELSIO, PCI_ANY_ID,
651			quirk_chelsio_extend_vpd);
652
653#endif
v6.2
  1// SPDX-License-Identifier: GPL-2.0
  2/*
  3 * PCI VPD support
  4 *
  5 * Copyright (C) 2010 Broadcom Corporation.
  6 */
  7
  8#include <linux/pci.h>
  9#include <linux/delay.h>
 10#include <linux/export.h>
 11#include <linux/sched/signal.h>
 12#include <asm/unaligned.h>
 13#include "pci.h"
 14
 15#define PCI_VPD_LRDT_TAG_SIZE		3
 16#define PCI_VPD_SRDT_LEN_MASK		0x07
 17#define PCI_VPD_SRDT_TAG_SIZE		1
 18#define PCI_VPD_STIN_END		0x0f
 19#define PCI_VPD_INFO_FLD_HDR_SIZE	3
 20
 21static u16 pci_vpd_lrdt_size(const u8 *lrdt)
 22{
 23	return get_unaligned_le16(lrdt + 1);
 24}
 
 25
 26static u8 pci_vpd_srdt_tag(const u8 *srdt)
 27{
 28	return *srdt >> 3;
 29}
 
 
 
 
 
 
 30
 31static u8 pci_vpd_srdt_size(const u8 *srdt)
 
 
 
 
 
 
 
 32{
 33	return *srdt & PCI_VPD_SRDT_LEN_MASK;
 
 
 34}
 
 35
 36static u8 pci_vpd_info_field_size(const u8 *info_field)
 
 
 
 
 
 
 
 37{
 38	return info_field[2];
 
 
 39}
 
 40
 41/* VPD access through PCI 2.2+ VPD capability */
 42
 43static struct pci_dev *pci_get_func0_dev(struct pci_dev *dev)
 
 
 
 44{
 45	return pci_get_slot(dev->bus, PCI_DEVFN(PCI_SLOT(dev->devfn), 0));
 
 
 46}
 
 47
 48#define PCI_VPD_MAX_SIZE	(PCI_VPD_ADDR_MASK + 1)
 49#define PCI_VPD_SZ_INVALID	UINT_MAX
 50
 51/**
 52 * pci_vpd_size - determine actual size of Vital Product Data
 53 * @dev:	pci device struct
 
 54 */
 55static size_t pci_vpd_size(struct pci_dev *dev)
 56{
 57	size_t off = 0, size;
 58	unsigned char tag, header[1+2];	/* 1 byte tag, 2 bytes length */
 59
 60	while (pci_read_vpd_any(dev, off, 1, header) == 1) {
 61		size = 0;
 62
 63		if (off == 0 && (header[0] == 0x00 || header[0] == 0xff))
 64			goto error;
 65
 66		if (header[0] & PCI_VPD_LRDT) {
 67			/* Large Resource Data Type Tag */
 68			if (pci_read_vpd_any(dev, off + 1, 2, &header[1]) != 2) {
 69				pci_warn(dev, "failed VPD read at offset %zu\n",
 70					 off + 1);
 71				return off ?: PCI_VPD_SZ_INVALID;
 
 
 
 
 
 
 
 
 
 72			}
 73			size = pci_vpd_lrdt_size(header);
 74			if (off + size > PCI_VPD_MAX_SIZE)
 75				goto error;
 76
 77			off += PCI_VPD_LRDT_TAG_SIZE + size;
 78		} else {
 79			/* Short Resource Data Type Tag */
 
 
 80			tag = pci_vpd_srdt_tag(header);
 81			size = pci_vpd_srdt_size(header);
 82			if (off + size > PCI_VPD_MAX_SIZE)
 83				goto error;
 84
 85			off += PCI_VPD_SRDT_TAG_SIZE + size;
 86			if (tag == PCI_VPD_STIN_END)	/* End tag descriptor */
 87				return off;
 88		}
 89	}
 90	return off;
 91
 92error:
 93	pci_info(dev, "invalid VPD tag %#04x (size %zu) at offset %zu%s\n",
 94		 header[0], size, off, off == 0 ?
 95		 "; assume missing optional EEPROM" : "");
 96	return off ?: PCI_VPD_SZ_INVALID;
 97}
 98
 99static bool pci_vpd_available(struct pci_dev *dev, bool check_size)
100{
101	struct pci_vpd *vpd = &dev->vpd;
102
103	if (!vpd->cap)
104		return false;
105
106	if (vpd->len == 0 && check_size) {
107		vpd->len = pci_vpd_size(dev);
108		if (vpd->len == PCI_VPD_SZ_INVALID) {
109			vpd->cap = 0;
110			return false;
111		}
112	}
113
114	return true;
115}
116
117/*
118 * Wait for last operation to complete.
119 * This code has to spin since there is no other notification from the PCI
120 * hardware. Since the VPD is often implemented by serial attachment to an
121 * EEPROM, it may take many milliseconds to complete.
122 * @set: if true wait for flag to be set, else wait for it to be cleared
123 *
124 * Returns 0 on success, negative values indicate error.
125 */
126static int pci_vpd_wait(struct pci_dev *dev, bool set)
127{
128	struct pci_vpd *vpd = &dev->vpd;
129	unsigned long timeout = jiffies + msecs_to_jiffies(125);
130	unsigned long max_sleep = 16;
131	u16 status;
132	int ret;
133
 
 
 
134	do {
135		ret = pci_user_read_config_word(dev, vpd->cap + PCI_VPD_ADDR,
136						&status);
137		if (ret < 0)
138			return ret;
139
140		if (!!(status & PCI_VPD_ADDR_F) == set)
 
141			return 0;
 
 
 
 
142
143		if (time_after(jiffies, timeout))
144			break;
145
146		usleep_range(10, max_sleep);
147		if (max_sleep < 1024)
148			max_sleep *= 2;
149	} while (true);
150
151	pci_warn(dev, "VPD access failed.  This is likely a firmware bug on this device.  Contact the card vendor for a firmware update\n");
152	return -ETIMEDOUT;
153}
154
155static ssize_t pci_vpd_read(struct pci_dev *dev, loff_t pos, size_t count,
156			    void *arg, bool check_size)
157{
158	struct pci_vpd *vpd = &dev->vpd;
159	unsigned int max_len;
160	int ret = 0;
161	loff_t end = pos + count;
162	u8 *buf = arg;
163
164	if (!pci_vpd_available(dev, check_size))
165		return -ENODEV;
166
167	if (pos < 0)
168		return -EINVAL;
169
170	max_len = check_size ? vpd->len : PCI_VPD_MAX_SIZE;
 
 
 
171
172	if (pos >= max_len)
 
 
 
173		return 0;
174
175	if (end > max_len) {
176		end = max_len;
177		count = end - pos;
178	}
179
180	if (mutex_lock_killable(&vpd->lock))
181		return -EINTR;
182
 
 
 
 
183	while (pos < end) {
184		u32 val;
185		unsigned int i, skip;
186
187		if (fatal_signal_pending(current)) {
188			ret = -EINTR;
189			break;
190		}
191
192		ret = pci_user_write_config_word(dev, vpd->cap + PCI_VPD_ADDR,
193						 pos & ~3);
194		if (ret < 0)
195			break;
196		ret = pci_vpd_wait(dev, true);
 
 
197		if (ret < 0)
198			break;
199
200		ret = pci_user_read_config_dword(dev, vpd->cap + PCI_VPD_DATA, &val);
201		if (ret < 0)
202			break;
203
204		skip = pos & 3;
205		for (i = 0;  i < sizeof(u32); i++) {
206			if (i >= skip) {
207				*buf++ = val;
208				if (++pos == end)
209					break;
210			}
211			val >>= 8;
212		}
213	}
214
215	mutex_unlock(&vpd->lock);
216	return ret ? ret : count;
217}
218
219static ssize_t pci_vpd_write(struct pci_dev *dev, loff_t pos, size_t count,
220			     const void *arg, bool check_size)
221{
222	struct pci_vpd *vpd = &dev->vpd;
223	unsigned int max_len;
224	const u8 *buf = arg;
225	loff_t end = pos + count;
226	int ret = 0;
227
228	if (!pci_vpd_available(dev, check_size))
229		return -ENODEV;
230
231	if (pos < 0 || (pos & 3) || (count & 3))
232		return -EINVAL;
233
234	max_len = check_size ? vpd->len : PCI_VPD_MAX_SIZE;
 
 
 
 
 
 
235
236	if (end > max_len)
237		return -EINVAL;
238
239	if (mutex_lock_killable(&vpd->lock))
240		return -EINTR;
241
 
 
 
 
242	while (pos < end) {
243		ret = pci_user_write_config_dword(dev, vpd->cap + PCI_VPD_DATA,
244						  get_unaligned_le32(buf));
 
 
 
 
 
 
245		if (ret < 0)
246			break;
247		ret = pci_user_write_config_word(dev, vpd->cap + PCI_VPD_ADDR,
248						 pos | PCI_VPD_ADDR_F);
249		if (ret < 0)
250			break;
251
252		ret = pci_vpd_wait(dev, false);
 
 
253		if (ret < 0)
254			break;
255
256		buf += sizeof(u32);
257		pos += sizeof(u32);
258	}
259
260	mutex_unlock(&vpd->lock);
261	return ret ? ret : count;
262}
263
264void pci_vpd_init(struct pci_dev *dev)
265{
266	if (dev->vpd.len == PCI_VPD_SZ_INVALID)
267		return;
268
269	dev->vpd.cap = pci_find_capability(dev, PCI_CAP_ID_VPD);
270	mutex_init(&dev->vpd.lock);
271}
272
273static ssize_t vpd_read(struct file *filp, struct kobject *kobj,
274			struct bin_attribute *bin_attr, char *buf, loff_t off,
275			size_t count)
276{
277	struct pci_dev *dev = to_pci_dev(kobj_to_dev(kobj));
278
279	return pci_read_vpd(dev, off, count, buf);
280}
281
282static ssize_t vpd_write(struct file *filp, struct kobject *kobj,
283			 struct bin_attribute *bin_attr, char *buf, loff_t off,
284			 size_t count)
285{
286	struct pci_dev *dev = to_pci_dev(kobj_to_dev(kobj));
287
288	return pci_write_vpd(dev, off, count, buf);
289}
290static BIN_ATTR(vpd, 0600, vpd_read, vpd_write, 0);
291
292static struct bin_attribute *vpd_attrs[] = {
293	&bin_attr_vpd,
294	NULL,
 
295};
296
297static umode_t vpd_attr_is_visible(struct kobject *kobj,
298				   struct bin_attribute *a, int n)
299{
300	struct pci_dev *pdev = to_pci_dev(kobj_to_dev(kobj));
 
 
301
302	if (!pdev->vpd.cap)
303		return 0;
304
305	return a->attr.mode;
 
 
306}
307
308const struct attribute_group pci_dev_vpd_attr_group = {
309	.bin_attrs = vpd_attrs,
310	.is_bin_visible = vpd_attr_is_visible,
311};
312
313void *pci_vpd_alloc(struct pci_dev *dev, unsigned int *size)
314{
315	unsigned int len;
316	void *buf;
317	int cnt;
318
319	if (!pci_vpd_available(dev, true))
320		return ERR_PTR(-ENODEV);
321
322	len = dev->vpd.len;
323	buf = kmalloc(len, GFP_KERNEL);
324	if (!buf)
325		return ERR_PTR(-ENOMEM);
326
327	cnt = pci_read_vpd(dev, 0, len, buf);
328	if (cnt != len) {
329		kfree(buf);
330		return ERR_PTR(-EIO);
331	}
332
333	if (size)
334		*size = len;
335
336	return buf;
337}
338EXPORT_SYMBOL_GPL(pci_vpd_alloc);
339
340static int pci_vpd_find_tag(const u8 *buf, unsigned int len, u8 rdt, unsigned int *size)
341{
342	int i = 0;
 
 
343
344	/* look for LRDT tags only, end tag is the only SRDT tag */
345	while (i + PCI_VPD_LRDT_TAG_SIZE <= len && buf[i] & PCI_VPD_LRDT) {
346		unsigned int lrdt_len = pci_vpd_lrdt_size(buf + i);
347		u8 tag = buf[i];
348
349		i += PCI_VPD_LRDT_TAG_SIZE;
350		if (tag == rdt) {
351			if (i + lrdt_len > len)
352				lrdt_len = len - i;
353			if (size)
354				*size = lrdt_len;
355			return i;
356		}
357
358		i += lrdt_len;
359	}
 
 
 
360
361	return -ENOENT;
362}
 
 
363
364int pci_vpd_find_id_string(const u8 *buf, unsigned int len, unsigned int *size)
365{
366	return pci_vpd_find_tag(buf, len, PCI_VPD_LRDT_ID_STRING, size);
367}
368EXPORT_SYMBOL_GPL(pci_vpd_find_id_string);
369
370static int pci_vpd_find_info_keyword(const u8 *buf, unsigned int off,
371			      unsigned int len, const char *kw)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
372{
373	int i;
374
375	for (i = off; i + PCI_VPD_INFO_FLD_HDR_SIZE <= off + len;) {
376		if (buf[i + 0] == kw[0] &&
377		    buf[i + 1] == kw[1])
378			return i;
379
380		i += PCI_VPD_INFO_FLD_HDR_SIZE +
381		     pci_vpd_info_field_size(&buf[i]);
 
 
 
382	}
383
384	return -ENOENT;
385}
386
387static ssize_t __pci_read_vpd(struct pci_dev *dev, loff_t pos, size_t count, void *buf,
388			      bool check_size)
 
389{
390	ssize_t ret;
391
392	if (dev->dev_flags & PCI_DEV_FLAGS_VPD_REF_F0) {
393		dev = pci_get_func0_dev(dev);
394		if (!dev)
395			return -ENODEV;
396
397		ret = pci_vpd_read(dev, pos, count, buf, check_size);
398		pci_dev_put(dev);
399		return ret;
 
 
400	}
401
402	return pci_vpd_read(dev, pos, count, buf, check_size);
403}
404
405/**
406 * pci_read_vpd - Read one entry from Vital Product Data
407 * @dev:	PCI device struct
408 * @pos:	offset in VPD space
409 * @count:	number of bytes to read
410 * @buf:	pointer to where to store result
411 */
412ssize_t pci_read_vpd(struct pci_dev *dev, loff_t pos, size_t count, void *buf)
413{
414	return __pci_read_vpd(dev, pos, count, buf, true);
415}
416EXPORT_SYMBOL(pci_read_vpd);
417
418/* Same, but allow to access any address */
419ssize_t pci_read_vpd_any(struct pci_dev *dev, loff_t pos, size_t count, void *buf)
420{
421	return __pci_read_vpd(dev, pos, count, buf, false);
422}
423EXPORT_SYMBOL(pci_read_vpd_any);
424
425static ssize_t __pci_write_vpd(struct pci_dev *dev, loff_t pos, size_t count,
426			       const void *buf, bool check_size)
427{
428	ssize_t ret;
429
430	if (dev->dev_flags & PCI_DEV_FLAGS_VPD_REF_F0) {
431		dev = pci_get_func0_dev(dev);
432		if (!dev)
433			return -ENODEV;
434
435		ret = pci_vpd_write(dev, pos, count, buf, check_size);
436		pci_dev_put(dev);
437		return ret;
 
 
438	}
439
440	return pci_vpd_write(dev, pos, count, buf, check_size);
441}
442
443/**
444 * pci_write_vpd - Write entry to Vital Product Data
445 * @dev:	PCI device struct
446 * @pos:	offset in VPD space
447 * @count:	number of bytes to write
448 * @buf:	buffer containing write data
449 */
450ssize_t pci_write_vpd(struct pci_dev *dev, loff_t pos, size_t count, const void *buf)
451{
452	return __pci_write_vpd(dev, pos, count, buf, true);
 
 
 
453}
454EXPORT_SYMBOL(pci_write_vpd);
455
456/* Same, but allow to access any address */
457ssize_t pci_write_vpd_any(struct pci_dev *dev, loff_t pos, size_t count, const void *buf)
458{
459	return __pci_write_vpd(dev, pos, count, buf, false);
460}
461EXPORT_SYMBOL(pci_write_vpd_any);
 
462
463int pci_vpd_find_ro_info_keyword(const void *buf, unsigned int len,
464				 const char *kw, unsigned int *size)
465{
466	int ro_start, infokw_start;
467	unsigned int ro_len, infokw_size;
468
469	ro_start = pci_vpd_find_tag(buf, len, PCI_VPD_LRDT_RO_DATA, &ro_len);
470	if (ro_start < 0)
471		return ro_start;
472
473	infokw_start = pci_vpd_find_info_keyword(buf, ro_start, ro_len, kw);
474	if (infokw_start < 0)
475		return infokw_start;
 
476
477	infokw_size = pci_vpd_info_field_size(buf + infokw_start);
478	infokw_start += PCI_VPD_INFO_FLD_HDR_SIZE;
479
480	if (infokw_start + infokw_size > len)
481		return -EINVAL;
482
483	if (size)
484		*size = infokw_size;
 
 
485
486	return infokw_start;
487}
488EXPORT_SYMBOL_GPL(pci_vpd_find_ro_info_keyword);
489
490int pci_vpd_check_csum(const void *buf, unsigned int len)
 
491{
492	const u8 *vpd = buf;
493	unsigned int size;
494	u8 csum = 0;
495	int rv_start;
496
497	rv_start = pci_vpd_find_ro_info_keyword(buf, len, PCI_VPD_RO_KEYWORD_CHKSUM, &size);
498	if (rv_start == -ENOENT) /* no checksum in VPD */
499		return 1;
500	else if (rv_start < 0)
501		return rv_start;
502
503	if (!size)
504		return -EINVAL;
 
505
506	while (rv_start >= 0)
507		csum += vpd[rv_start--];
508
509	return csum ? -EILSEQ : 0;
510}
511EXPORT_SYMBOL_GPL(pci_vpd_check_csum);
512
513#ifdef CONFIG_PCI_QUIRKS
514/*
515 * Quirk non-zero PCI functions to route VPD access through function 0 for
516 * devices that share VPD resources between functions.  The functions are
517 * expected to be identical devices.
518 */
519static void quirk_f0_vpd_link(struct pci_dev *dev)
520{
521	struct pci_dev *f0;
522
523	if (!PCI_FUNC(dev->devfn))
524		return;
525
526	f0 = pci_get_func0_dev(dev);
527	if (!f0)
528		return;
529
530	if (f0->vpd.cap && dev->class == f0->class &&
531	    dev->vendor == f0->vendor && dev->device == f0->device)
532		dev->dev_flags |= PCI_DEV_FLAGS_VPD_REF_F0;
533
534	pci_dev_put(f0);
535}
536DECLARE_PCI_FIXUP_CLASS_EARLY(PCI_VENDOR_ID_INTEL, PCI_ANY_ID,
537			      PCI_CLASS_NETWORK_ETHERNET, 8, quirk_f0_vpd_link);
538
539/*
540 * If a device follows the VPD format spec, the PCI core will not read or
541 * write past the VPD End Tag.  But some vendors do not follow the VPD
542 * format spec, so we can't tell how much data is safe to access.  Devices
543 * may behave unpredictably if we access too much.  Blacklist these devices
544 * so we don't touch VPD at all.
545 */
546static void quirk_blacklist_vpd(struct pci_dev *dev)
547{
548	dev->vpd.len = PCI_VPD_SZ_INVALID;
549	pci_warn(dev, FW_BUG "disabling VPD access (can't determine size of non-standard VPD format)\n");
 
 
550}
551DECLARE_PCI_FIXUP_HEADER(PCI_VENDOR_ID_LSI_LOGIC, 0x0060, quirk_blacklist_vpd);
552DECLARE_PCI_FIXUP_HEADER(PCI_VENDOR_ID_LSI_LOGIC, 0x007c, quirk_blacklist_vpd);
553DECLARE_PCI_FIXUP_HEADER(PCI_VENDOR_ID_LSI_LOGIC, 0x0413, quirk_blacklist_vpd);
554DECLARE_PCI_FIXUP_HEADER(PCI_VENDOR_ID_LSI_LOGIC, 0x0078, quirk_blacklist_vpd);
555DECLARE_PCI_FIXUP_HEADER(PCI_VENDOR_ID_LSI_LOGIC, 0x0079, quirk_blacklist_vpd);
556DECLARE_PCI_FIXUP_HEADER(PCI_VENDOR_ID_LSI_LOGIC, 0x0073, quirk_blacklist_vpd);
557DECLARE_PCI_FIXUP_HEADER(PCI_VENDOR_ID_LSI_LOGIC, 0x0071, quirk_blacklist_vpd);
558DECLARE_PCI_FIXUP_HEADER(PCI_VENDOR_ID_LSI_LOGIC, 0x005b, quirk_blacklist_vpd);
559DECLARE_PCI_FIXUP_HEADER(PCI_VENDOR_ID_LSI_LOGIC, 0x002f, quirk_blacklist_vpd);
560DECLARE_PCI_FIXUP_HEADER(PCI_VENDOR_ID_LSI_LOGIC, 0x005d, quirk_blacklist_vpd);
561DECLARE_PCI_FIXUP_HEADER(PCI_VENDOR_ID_LSI_LOGIC, 0x005f, quirk_blacklist_vpd);
562DECLARE_PCI_FIXUP_HEADER(PCI_VENDOR_ID_ATTANSIC, PCI_ANY_ID, quirk_blacklist_vpd);
 
 
563/*
564 * The Amazon Annapurna Labs 0x0031 device id is reused for other non Root Port
565 * device types, so the quirk is registered for the PCI_CLASS_BRIDGE_PCI class.
566 */
567DECLARE_PCI_FIXUP_CLASS_HEADER(PCI_VENDOR_ID_AMAZON_ANNAPURNA_LABS, 0x0031,
568			       PCI_CLASS_BRIDGE_PCI, 8, quirk_blacklist_vpd);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
569
570static void quirk_chelsio_extend_vpd(struct pci_dev *dev)
571{
572	int chip = (dev->device & 0xf000) >> 12;
573	int func = (dev->device & 0x0f00) >>  8;
574	int prod = (dev->device & 0x00ff) >>  0;
575
576	/*
577	 * If this is a T3-based adapter, there's a 1KB VPD area at offset
578	 * 0xc00 which contains the preferred VPD values.  If this is a T4 or
579	 * later based adapter, the special VPD is at offset 0x400 for the
580	 * Physical Functions (the SR-IOV Virtual Functions have no VPD
581	 * Capabilities).  The PCI VPD Access core routines will normally
582	 * compute the size of the VPD by parsing the VPD Data Structure at
583	 * offset 0x000.  This will result in silent failures when attempting
584	 * to accesses these other VPD areas which are beyond those computed
585	 * limits.
586	 */
587	if (chip == 0x0 && prod >= 0x20)
588		dev->vpd.len = 8192;
589	else if (chip >= 0x4 && func < 0x8)
590		dev->vpd.len = 2048;
591}
592
593DECLARE_PCI_FIXUP_HEADER(PCI_VENDOR_ID_CHELSIO, PCI_ANY_ID,
594			 quirk_chelsio_extend_vpd);
595
596#endif