xref: /freebsd/share/man/man4/siba.4 (revision e8d8bef961a50d4dc22501cde4fb9fb0be1b2532)
1.\" Copyright (c) 2010 Weongyo Jeong
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\"
13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
25.\" $FreeBSD$
26.\"
27.Dd September 13, 2017
28.Dt SIBA 4
29.Os
30.Sh NAME
31.Nm siba
32.Nd Sonic Inc. Silicon Backplane driver
33.Sh SYNOPSIS
34To compile this driver into the kernel, add the following lines to the
35kernel configuration file:
36.Bd -ragged -offset indent
37.Cd "device bhnd"
38.Cd "device siba"
39.Ed
40.Pp
41To load the driver as a module at boot, add this line to
42.Xr loader.conf 5 :
43.Bd -literal -offset indent
44siba_load="YES"
45.Ed
46.Sh DESCRIPTION
47The
48.Nm
49driver provides
50.Xr bhnd 4
51support for devices based on the Sonic Inc. Silicon Backplane, an
52interblock communications architecture found in earlier Broadcom Home
53Networking Division wireless chipsets and embedded systems.
54.Pp
55A common interconnect connects all of the Silicon Backplane's functional
56blocks.
57These functional blocks, known as cores, use the Open Core Protocol
58(OCP) interface to communicate with agents attached to the Silicon
59Backplane.
60.Pp
61Each core can have an initiator agent that passes read and write
62requests onto the system backplane and a target agent that returns
63responses to those requests.
64Not all cores contain both an initiator and a target agent.
65Initiator agents are present in cores that contain
66host interfaces (PCI, PCMCIA), embedded processors (MIPS),
67or DMA processors associated with communications cores.
68.Sh SEE ALSO
69.Xr bcma 4 ,
70.Xr bhnd 4 ,
71.Xr intro 4
72.Sh HISTORY
73The
74.Nm
75device driver first appeared in
76.Fx 8.0 .
77The driver was rewritten for
78.Fx 11.0
79to support the common Broadcom
80.Xr bhnd 4
81bus interface.
82.Sh AUTHORS
83.An -nosplit
84The
85.Nm
86driver was originally written by
87.An Bruce M. Simpson Aq Mt bms@FreeBSD.org
88and
89.An Weongyo Jeong Aq Mt weongyo@FreeBSD.org .
90The driver was rewritten for
91.Fx 11.0
92by
93.An Landon Fuller Aq Mt landonf@FreeBSD.org .
94