Lines Matching +full:address +full:- +full:width

1 .\" Copyright (c) 2015-2016 Landon Fuller <landonf@FreeBSD.org>
260 .Fa "device_t dev" "bus_size_t offset" "void *value" "u_int width"
264 .Fa "device_t dev" "bus_size_t offset" "const void *value" "u_int width"
392 .Bd -literal
398 .Bd -literal
406 .Bd -literal
414 .Bd -literal
417 .Bd -literal
421 .Ss "DMA Address Translation Functions"
424 .Fa "device_t dev" "u_int width" "uint32_t flags" "bus_dma_tag_t *dmat"
427 .Bd -literal
435 .Bd -literal
442 .Bd -literal
480 .Fa "device_t dev" "const char *name" "void *value" "int width"
490 .Fa "device_t dev" "const char *name" "void *value" "int width"
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
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.
701 device-specific CSRs, and SSB-specific per-core device management
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
718 Host access to SoC address space is provided via a set of register windows
719 (e.g., a set of configurable windows into SoC address space mapped via PCI BARs)
721 DMA is supported by the bridge core's sparse mapping of host address space into
722 the backplane address space.
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).
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.
791 The start address of the resource.
793 The end address of the resource.
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
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.
1018 .Fa width
1021 from the backplane-specific agent/config space of the device
1027 .Fa width
1032 from the backplane-specific agent/config space of the device
1035 .Fa width
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.
1115 .Bl -tag -width "enum_addr" -offset indent
1133 The backplane enumeration address.
1134 On SSB devices, this will be the base address of the first SSB core.
1135 On BCMA devices, this will be the address of the enumeration ROM (EROM) core.
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).
1361 board-level device attributes.
1477 .Bl -tag -width "Fn BHND_MATCH_BOARD_VENDOR vendor" -offset indent
1501 .Bd -literal -offset indent
1513 .Bl -tag -width "Fn BHND_MATCH_CHIP_IPR id pkg hwrev" -offset indent
1549 .Bd -literal -offset indent
1559 .Bl -tag -width "Fn BHND_MATCH_CORE_VENDOR vendor" -offset indent
1587 .Bd -literal -offset indent
1605 .Bd -literal -offset indent
1618 .Bl -tag -width "Fn BHND_HWREV_RANGE start end" -offset indent -compact
1666 .Bl -tag -width "quirks_table" -offset indent -compact
1684 .Bl -tag -width ".Dv BHND_DF_ADAPTER" -offset indent -compact
1704 .Bl -ohang -offset indent
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
1786 .Bd -literal -offset indent
1793 .Ss "DMA Address Translation Functions"
1796 function is used to request a DMA address translation descriptor suitable
1797 for use with a maximum DMA address width of
1798 .Fa width ,
1802 If a suitable DMA address translation descriptor is found, it will be stored in
1804 and a bus DMA tag specifying the DMA translation's address restrictions will
1816 .Bl -ohang -width ".Dv BHND_DMA_TRANSLATION_BYTESWAPPED" -offset indent
1818 The translation remaps the device's physical address space.
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.
1830 embedded MIPS SoCs executing in big-endian mode.
1833 The following symbolic constants are defined for common DMA address widths:
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.
1850 This may be added to a host physical address to produce a device DMA address.
1852 Device-addressable address mask.
1853 This defines the device DMA address range, and excludes any bits reserved for
1854 mapping the address within the translation window at
1857 Device-addressable extended address mask.
1858 If a the per-core BHND DMA engine supports the 'addrext' control field, it can
1859 be used to provide address bits excluded by
1862 Support for DMA extended address changes \(em including coordination with the
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)
1869 base address to map the target address prior to performing a DMA transaction.
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
2038 .Fa width
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.
2151 function is used to determine the base address and size of the memory
2159 The region's base device address will be written to
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
2234 .Bl -tag -width ".Dv BHND_CLOCK_DYN" -offset indent
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
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
2487 .Bl -tag -width Er
2493 The requested width is not one of 1, 2, or 4 bytes.
2497 The requested offset or width exceeds the bounds of the mapped agent/config
2515 .Ss "DMA Address Translation Functions"
2519 .Bl -tag -width Er
2523 No DMA translation matching the requested address width and translation flags
2527 If fetching the requested DMA address translation otherwise fails, an
2557 .Bl -tag -width Er
2583 or -1 if the port or region are invalid, or do not have an assigned resource ID.
2605 .Bl -tag -width Er
2660 .An -nosplit