xref: /freebsd/share/man/man4/bcma.4 (revision 05ed3f9063415c85e3d15f11904bac28e285e9f9)
1148ed571SAdrian Chadd.\" Copyright (c) 2015 Landon Fuller
2148ed571SAdrian Chadd.\" Copyright (c) 2010 Weongyo Jeong
3148ed571SAdrian Chadd.\" All rights reserved.
4148ed571SAdrian Chadd.\"
5148ed571SAdrian Chadd.\" Redistribution and use in source and binary forms, with or without
6148ed571SAdrian Chadd.\" modification, are permitted provided that the following conditions
7148ed571SAdrian Chadd.\" are met:
8148ed571SAdrian Chadd.\" 1. Redistributions of source code must retain the above copyright
9148ed571SAdrian Chadd.\"    notice, this list of conditions and the following disclaimer.
10148ed571SAdrian Chadd.\" 2. Redistributions in binary form must reproduce the above copyright
11148ed571SAdrian Chadd.\"    notice, this list of conditions and the following disclaimer in the
12148ed571SAdrian Chadd.\"    documentation and/or other materials provided with the distribution.
13148ed571SAdrian Chadd.\"
14148ed571SAdrian Chadd.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15148ed571SAdrian Chadd.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16148ed571SAdrian Chadd.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17148ed571SAdrian Chadd.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18148ed571SAdrian Chadd.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19148ed571SAdrian Chadd.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20148ed571SAdrian Chadd.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21148ed571SAdrian Chadd.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22148ed571SAdrian Chadd.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23148ed571SAdrian Chadd.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24148ed571SAdrian Chadd.\" SUCH DAMAGE.
25148ed571SAdrian Chadd.\"
26148ed571SAdrian Chadd.\" $FreeBSD$
27148ed571SAdrian Chadd.\"
2857484262SLandon J. Fuller.Dd June 3, 2016
29148ed571SAdrian Chadd.Dt BCMA 4
30148ed571SAdrian Chadd.Os
31148ed571SAdrian Chadd.Sh NAME
32148ed571SAdrian Chadd.Nm bcma
33148ed571SAdrian Chadd.Nd Broadcom AMBA Backplane driver
34148ed571SAdrian Chadd.Sh SYNOPSIS
35*05ed3f90SLandon J. FullerTo compile this driver into the kernel, add the following lines to the
36*05ed3f90SLandon J. Fullerkernel configuration file:
37148ed571SAdrian Chadd.Bd -ragged -offset indent
38148ed571SAdrian Chadd.Cd "device bhnd"
39148ed571SAdrian Chadd.Cd "device bcma"
40148ed571SAdrian Chadd.Ed
41148ed571SAdrian Chadd.Pp
42*05ed3f90SLandon J. FullerTo load the driver as a module at boot, add this line to
43148ed571SAdrian Chadd.Xr loader.conf 5 :
44148ed571SAdrian Chadd.Bd -literal -offset indent
45148ed571SAdrian Chaddbcma_load="YES"
46148ed571SAdrian Chadd.Ed
47148ed571SAdrian Chadd.Sh DESCRIPTION
48148ed571SAdrian ChaddThe
49148ed571SAdrian Chadd.Nm
50148ed571SAdrian Chadddriver provides
51148ed571SAdrian Chadd.Xr bhnd 4
52148ed571SAdrian Chaddsupport for devices using the ARM AMBA-based backplane architecture found
53*05ed3f90SLandon J. Fullerin later Broadcom Home Networking Division's network chipsets and embedded
54*05ed3f90SLandon J. Fullersystems.
55148ed571SAdrian Chadd.Pp
56148ed571SAdrian ChaddA common interconnect connects all of the backplane's functional
5725972509SEdward Tomasz Napieralablocks.
5825972509SEdward Tomasz NapieralaThese functional blocks, known as cores, use the ARM AMBA AXI or
59148ed571SAdrian ChaddAPB interface to communicate with devices attached to the interconnect.
60148ed571SAdrian Chadd.Pp
61148ed571SAdrian ChaddThe IP cores used in
62148ed571SAdrian Chadd.Xr siba 4
63148ed571SAdrian Chadddevices were adapted by Broadcom for compatibility with the new
64148ed571SAdrian Chaddinterconnect.
65148ed571SAdrian Chadd.Sh SEE ALSO
66*05ed3f90SLandon J. Fuller.Xr bhnd 4 ,
67*05ed3f90SLandon J. Fuller.Xr intro 4 ,
68*05ed3f90SLandon J. Fuller.Xr siba 4
69148ed571SAdrian Chadd.Sh HISTORY
70148ed571SAdrian ChaddThe
71148ed571SAdrian Chadd.Nm
72148ed571SAdrian Chadddevice driver first appeared in
73148ed571SAdrian Chadd.Fx 11.0 .
74148ed571SAdrian Chadd.Sh AUTHORS
75148ed571SAdrian Chadd.An -nosplit
76148ed571SAdrian ChaddThe
77148ed571SAdrian Chadd.Nm
78148ed571SAdrian Chadddriver was written by
7957484262SLandon J. Fuller.An Landon Fuller Aq Mt landonf@FreeBSD.org .
80