xref: /freebsd/share/man/man4/bcma.4 (revision fa9896e082a1046ff4fbc75fcba4d18d1f2efc19)
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.\"
2657484262SLandon J. Fuller.Dd June 3, 2016
27148ed571SAdrian Chadd.Dt BCMA 4
28148ed571SAdrian Chadd.Os
29148ed571SAdrian Chadd.Sh NAME
30148ed571SAdrian Chadd.Nm bcma
31148ed571SAdrian Chadd.Nd Broadcom AMBA Backplane driver
32148ed571SAdrian Chadd.Sh SYNOPSIS
33*05ed3f90SLandon J. FullerTo compile this driver into the kernel, add the following lines to the
34*05ed3f90SLandon J. Fullerkernel configuration file:
35148ed571SAdrian Chadd.Bd -ragged -offset indent
36148ed571SAdrian Chadd.Cd "device bhnd"
37148ed571SAdrian Chadd.Cd "device bcma"
38148ed571SAdrian Chadd.Ed
39148ed571SAdrian Chadd.Pp
40*05ed3f90SLandon J. FullerTo load the driver as a module at boot, add this line to
41148ed571SAdrian Chadd.Xr loader.conf 5 :
42148ed571SAdrian Chadd.Bd -literal -offset indent
43148ed571SAdrian Chaddbcma_load="YES"
44148ed571SAdrian Chadd.Ed
45148ed571SAdrian Chadd.Sh DESCRIPTION
46148ed571SAdrian ChaddThe
47148ed571SAdrian Chadd.Nm
48148ed571SAdrian Chadddriver provides
49148ed571SAdrian Chadd.Xr bhnd 4
50148ed571SAdrian Chaddsupport for devices using the ARM AMBA-based backplane architecture found
51*05ed3f90SLandon J. Fullerin later Broadcom Home Networking Division's network chipsets and embedded
52*05ed3f90SLandon J. Fullersystems.
53148ed571SAdrian Chadd.Pp
54148ed571SAdrian ChaddA common interconnect connects all of the backplane's functional
5525972509SEdward Tomasz Napieralablocks.
5625972509SEdward Tomasz NapieralaThese functional blocks, known as cores, use the ARM AMBA AXI or
57148ed571SAdrian ChaddAPB interface to communicate with devices attached to the interconnect.
58148ed571SAdrian Chadd.Pp
59148ed571SAdrian ChaddThe IP cores used in
60148ed571SAdrian Chadd.Xr siba 4
61148ed571SAdrian Chadddevices were adapted by Broadcom for compatibility with the new
62148ed571SAdrian Chaddinterconnect.
63148ed571SAdrian Chadd.Sh SEE ALSO
64*05ed3f90SLandon J. Fuller.Xr bhnd 4 ,
65*05ed3f90SLandon J. Fuller.Xr intro 4 ,
66*05ed3f90SLandon J. Fuller.Xr siba 4
67148ed571SAdrian Chadd.Sh HISTORY
68148ed571SAdrian ChaddThe
69148ed571SAdrian Chadd.Nm
70148ed571SAdrian Chadddevice driver first appeared in
71148ed571SAdrian Chadd.Fx 11.0 .
72148ed571SAdrian Chadd.Sh AUTHORS
73148ed571SAdrian Chadd.An -nosplit
74148ed571SAdrian ChaddThe
75148ed571SAdrian Chadd.Nm
76148ed571SAdrian Chadddriver was written by
7757484262SLandon J. Fuller.An Landon Fuller Aq Mt landonf@FreeBSD.org .
78