Lines Matching +full:on +full:- +full:chip

1 .\" Copyright (c) 2015-2016 Landon Fuller <landonf@FreeBSD.org>
24 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
334 .Fa "const struct bhnd_chipid *chip" "const struct bhnd_chip_match *desc"
375 .Fa "chip" "hwrev" "flags"
390 .Fa "chip" "pkg" "flags"
392 .Bd -literal
398 .Bd -literal
406 .Bd -literal
414 .Bd -literal
417 .Bd -literal
427 .Bd -literal
435 .Bd -literal
442 .Bd -literal
512 .Bd -literal
568 .Bd -literal
609 .Bd -literal
635 .Bd -literal
683 .Bd -literal
690 on-chip interconnects and IP cores found in Broadcom Home Networking Division
693 The BHND device family consists of MIPS/ARM SoCs (System On a Chip) and
694 host-connected chipsets based on a common library of Broadcom IP cores,
695 connected via one of two on-chip backplane (hardware bus) architectures.
699 backplane architecture, based on Sonics Silicon's interconnect IP.
700 Each core on the Sonics backplane vends a 4 KiB register block, containing both
701 device-specific CSRs, and SSB-specific per-core device management
704 Subsequent hardware is based on Broadcom's
706 backplane, based on ARM's AMBA IP.
707 The IP cores used in earlier SSB-based devices were adapted for compatibility
710 cores providing per-core device management functions in place of the SSB
711 per-core management registers.
713 When BHND hardware is used as a host-connected peripheral (e.g., in a PCI Wi-Fi
714 card), the on-chip peripheral controller core is configured to operate as
716 .Bl -dash -offset indent
723 These address regions may be used as a target for the on-chip DMA engine.
726 bridge to host interrupts (e.g., PCI INTx/MSI/MSI-X).
742 resources that, on
744 bridged chipsets, may require on-demand remapping of address windows
748 drivers that, on host-connected peripherals, must share a small set of register
761 .Bl -tag -width indent
767 The bus-specific handle that identifies the resource being activated.
780 .Bl -tag -width indent
789 The bus-specific handle identifying the resource being allocated.
828 .Bl -tag -width indent
837 The bus-specific handle identifying the resource being allocated.
853 .Bl -tag -width indent
872 .Bl -tag -width indent
878 The bus-specific handle identifying the resource.
888 .Bl -tag -width indent
894 The bus-specific handle identifying the resource.
904 .Bl -tag -width indent
917 .Bl -tag -width "direct"
932 .Bl -ohang -offset indent -compact
943 Drivers that do not rely on
968 .Bl -tag -width ".Dv BHND_IOCTL_CLK_FORCE" -offset indent
970 Initiate a built-in self-test (BIST).
984 The mask of IOCTL bits reserved for additional core-specific I/O control flags.
994 .Bl -tag -width ".Dv BHND_IOST_BIST_DONE" -offset indent
1010 Set if this core supports 64-bit DMA.
1012 The mask of IOST bits reserved for additional core-specific I/O status flags.
1021 from the backplane-specific agent/config space of the device
1032 from the backplane-specific agent/config space of the device
1042 is backplane-specific, and these functions should only be used for functionality
1083 Any outstanding per-device PMU requests made using
1098 .Bl -hang -width ".Dv BHND_ATTACH_ADAPTER" -offset indent
1100 The bus is resident on a bridged adapter, such as a PCI Wi-Fi device.
1102 The bus is resident on the native host, such as the primary or secondary bus of
1108 function returns chip information from the parent
1115 .Bl -tag -width "enum_addr" -offset indent
1117 The chip identifier.
1119 The chip's hardware revision.
1121 The chip's semiconductor package identifier.
1124 chip, each of which may require driver workarounds for hardware errata,
1127 The interconnect architecture used by this chip.
1131 capability flags supported by this chip.
1137 The number of cores on the chip backplane, or 0 if unknown.
1143 .Bl -tag -width ".Dv BHND_CHIPTYPE_BCMA_ALT" -offset indent -compact
1149 BCMA-compatible variant found in Broadcom Northstar ARM SoCs.
1152 This BCMA-derived interconnect is found in Broadcom BCM33xx DOCSIS SoCs, and
1161 .Bl -tag -width ".Dv BHND_CAP_BP64" -offset indent -compact
1163 The backplane supports 64-bit addressing.
1190 .Bl -tag -width ".Dv BHND_DEVCLASS_SOC_ROUTER"  -offset indent -compact
1251 .Bl -tag -width "core_idx" -offset indent -compact
1253 Vendor identifier (JEP-106, ARM 4-bit continuation encoded)
1268 .Bl -tag -width ".Dv BHND_MFGID_MIPS" -offset indent -compact
1318 .Bl -tag -width "board_srom_rev" -offset indent
1320 Vendor ID of the board manufacturer (PCI-SIG assigned).
1360 The bhnd device matching functions are used to match against core, chip, and
1361 board-level device attributes.
1387 .Fa chip
1388 matches the chip match descriptor
1440 The returned descriptor will match only on core attributes identical to those
1477 .Bl -tag -width "Fn BHND_MATCH_BOARD_VENDOR vendor" -offset indent
1479 Match on boards with a vendor equal to
1482 Match on boards with a type equal to
1486 Match on boards with a sromrev that matches
1490 Match on boards with hardware revisions that match
1501 .Bd -literal -offset indent
1513 .Bl -tag -width "Fn BHND_MATCH_CHIP_IPR id pkg hwrev" -offset indent
1515 Match on chips with an ID equal to
1519 Match on chips with hardware revisions that match
1523 Match on chips with a package ID equal to
1527 Match on chips with a chip type equal to
1549 .Bd -literal -offset indent
1559 .Bl -tag -width "Fn BHND_MATCH_CORE_VENDOR vendor" -offset indent
1561 Match on cores with a vendor ID equal to
1564 Match on cores with a device ID equal to
1567 Match on cores with hardware revisions that match
1571 Match on cores with a core device class equal to
1574 Match on cores with a core index equal to
1577 Match on cores with a core unit equal to
1587 .Bd -literal -offset indent
1596 match descriptor supports matching on all board, chip, and core attributes,
1605 .Bd -literal -offset indent
1618 .Bl -tag -width "Fn BHND_HWREV_RANGE start end" -offset indent -compact
1636 value, will match on any revision equal to or greater than
1666 .Bl -tag -width "quirks_table" -offset indent -compact
1684 .Bl -tag -width ".Dv BHND_DF_ADAPTER" -offset indent -compact
1686 Match on any device.
1704 .Bl -ohang -offset indent
1706 Match on devices with a vendor ID equal to
1715 argument, a pointer to the device-specific quirks table is specified by the
1731 .Bd -literal -offset indent
1742 .Bl -tag -width "quirks_table" -offset indent -compact
1753 .Bl -tag -width "Fn BHND_CHIP_QUIRK chip hwrev flags" -offset indent
1760 .It Fn BHND_CHIP_QUIRK "chip" "hwrev" "flags"
1763 on devices with a chip ID equal to
1765 .Fa chip
1766 and chip hardware revision that matches
1769 .It Fn BHND_PKG_QUIRK "chip" "pkg" flags"
1772 on devices with a chip ID equal to
1774 .Fa chip
1775 and chip package equal to
1776 .Dv BHND_ ## chip ##
1786 .Bd -literal -offset indent
1816 .Bl -ohang -width ".Dv BHND_DMA_TRANSLATION_BYTESWAPPED" -offset indent
1823 on big-endian MIPS SoCs.
1825 The translation provides a byte-swapped mapping; write requests will be
1826 byte-swapped before being written to memory, and read requests will be
1827 byte-swapped before being returned.
1829 This is primarily used to perform efficient byte swapping of DMA data on
1830 embedded MIPS SoCs executing in big-endian mode.
1835 .Bl -tag -width ".Dv BHND_DMA_ADDR_64BIT" -offset indent -compact
1837 30-bit DMA
1839 32-bit DMA
1841 64-bit DMA
1847 .Bl -tag -width "addrext_mask"
1849 Host-to-device physical address translation.
1852 Device-addressable address mask.
1857 Device-addressable extended address mask.
1858 If a the per-core BHND DMA engine supports the 'addrext' control field, it can
1863 core providing device-to-host DMA address translation \(em is handled
1866 For example, on PCI Wi-Fi devices, the Wi-Fi core's DMA engine will (in effect)
1892 Interrupt vector assignments are backplane-specific: On BCMA devices, this
1952 .Bl -tag -width ".Dv BHND_NVRAM_TYPE_UINT64_ARRAY" -offset indent -compact
1954 unsigned 8-bit integer
1956 unsigned 16-bit integer
1958 unsigned 32-bit integer
1960 signed 64-bit integer
1962 signed 8-bit integer
1964 signed 16-bit integer
1966 signed 32-bit integer
1968 signed 64-bit integer
1970 UTF-8 character
1972 UTF-8 NUL-terminated string
1996 array of UTF-8 characters
1998 array of UTF-8 NUL-terminated strings
2052 coerced to a signed or unsigned 8, 16, or 32-bit integer type.
2058 coerced to a NUL-terminated string.
2088 Per-device interconnect memory mappings are identified by a combination of
2099 .Bl -tag -width ".Dv BHND_PORT_DEVICE" -offset indent
2147 or -1 if the port or region are invalid, or do not have an assigned resource ID.
2195 function is used to allocate per-device PMU state and enable PMU request
2213 function releases the per-device PMU state previously allocated for device
2224 be powered up and routed to the backplane on behalf of device
2234 .Bl -tag -width ".Dv BHND_CLOCK_DYN" -offset indent
2236 Dynamically select an appropriate clock source based on all outstanding clock
2241 Idle Low-Power (ILP) Clock.
2245 Active Low-Power (ALP) Clock.
2246 Supports low-latency register access and low-rate DMA.
2249 Supports high bus throughput and lowest-latency register access.
2274 latency value is suitable for use as the D11 Wi-Fi core
2280 function is used to request that the external PMU-managed resource assigned to
2283 identified by device-specific identifier
2291 for the PMU-managed resource identified by device-specific identifier
2308 .Bl -tag -width ".Dv BHND_SERVICE_INVALID" -offset indent
2327 Matches on any service type.
2397 function is used to fetch the human-readable name, if known, for the BHND core
2420 function writes a NUL-terminated human-readable representation of the BHND
2427 .Fa size-1
2458 function returns the human-readable name for the JEP-106, ARM 4-bit
2471 functions return 0 on success, otherwise an appropriate error code is returned.
2486 functions return 0 on success, or one of the following values on error:
2487 .Bl -tag -width Er
2508 functions return 0 on success, otherwise an appropriate error code is returned.
2513 function returns 0 on success, otherwise an appropriate error code is returned.
2518 function returns 0 on success, or one of the following values on error:
2519 .Bl -tag -width Er
2534 0 on success, or
2541 function returns 0 on success, otherwise an appropriate error code is returned.
2556 functions return 0 on success, or one of the following values on error:
2557 .Bl -tag -width Er
2578 0 on success, or an appropriate error code if no matching port/region is found.
2583 or -1 if the port or region are invalid, or do not have an assigned resource ID.
2588 0 on success, or an appropriate error code if no matching port/region is found.
2593 function returns 0 on success, otherwise an appropriate error code is returned.
2597 function returns 0 on success, otherwise an appropriate error code is returned,
2604 functions return 0 on success, or one of the following values on error:
2605 .Bl -tag -width Er
2614 function returns 0 on success, or
2620 function returns 0 on success, or
2628 functions return 0 on success, otherwise an appropriate error code is returned.
2633 function returns 0 on success,
2640 function returns 0 on success, or
2653 function returns the total number of bytes written on success, or a negative
2654 integer on failure.
2660 .An -nosplit