xref: /freebsd/share/man/man4/simplebus.4 (revision 50d922a02e3e29501689308a8c842e27f078faf3)
142c8cbe1SRafal Jaworowski.\"
242c8cbe1SRafal Jaworowski.\" Copyright (c) 2010 The FreeBSD Foundation
342c8cbe1SRafal Jaworowski.\" All rights reserved.
442c8cbe1SRafal Jaworowski.\"
542c8cbe1SRafal Jaworowski.\" This software was developed by Semihalf under sponsorship from
642c8cbe1SRafal Jaworowski.\" the FreeBSD Foundation.
742c8cbe1SRafal Jaworowski.\"
842c8cbe1SRafal Jaworowski.\" Redistribution and use in source and binary forms, with or without
942c8cbe1SRafal Jaworowski.\" modification, are permitted provided that the following conditions
1042c8cbe1SRafal Jaworowski.\" are met:
1142c8cbe1SRafal Jaworowski.\" 1. Redistributions of source code must retain the above copyright
1242c8cbe1SRafal Jaworowski.\"    notice, this list of conditions and the following disclaimer.
1342c8cbe1SRafal Jaworowski.\" 2. Redistributions in binary form must reproduce the above copyright
1442c8cbe1SRafal Jaworowski.\"    notice, this list of conditions and the following disclaimer in the
1542c8cbe1SRafal Jaworowski.\"    documentation and/or other materials provided with the distribution.
1642c8cbe1SRafal Jaworowski.\"
1742c8cbe1SRafal Jaworowski.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
1842c8cbe1SRafal Jaworowski.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
1942c8cbe1SRafal Jaworowski.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
2042c8cbe1SRafal Jaworowski.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
2142c8cbe1SRafal Jaworowski.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
2242c8cbe1SRafal Jaworowski.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
2342c8cbe1SRafal Jaworowski.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2442c8cbe1SRafal Jaworowski.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2542c8cbe1SRafal Jaworowski.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2642c8cbe1SRafal Jaworowski.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
2742c8cbe1SRafal Jaworowski.\" SUCH DAMAGE.
2842c8cbe1SRafal Jaworowski.\"
2942c8cbe1SRafal Jaworowski.\" $FreeBSD$
3042c8cbe1SRafal Jaworowski.\"
3142c8cbe1SRafal Jaworowski.Dd July 12, 2010
3242c8cbe1SRafal Jaworowski.Dt SIMPLEBUS 4
3342c8cbe1SRafal Jaworowski.Os
3442c8cbe1SRafal Jaworowski.Sh NAME
3542c8cbe1SRafal Jaworowski.Nm simplebus
3642c8cbe1SRafal Jaworowski.Nd ePAPR simple-bus driver
3742c8cbe1SRafal Jaworowski.Sh SYNOPSIS
3842c8cbe1SRafal Jaworowski.Cd "options FDT"
3942c8cbe1SRafal Jaworowski.Sh DESCRIPTION
4042c8cbe1SRafal JaworowskiThis bus driver is dedicated for the
4142c8cbe1SRafal Jaworowski.Pa simple-bus
4242c8cbe1SRafal Jaworowskinode of a flattened device tree compliant with the
4342c8cbe1SRafal Jaworowski.Pa ePAPR
4442c8cbe1SRafal Jaworowskispecification.
4542c8cbe1SRafal Jaworowski.Pp
4642c8cbe1SRafal JaworowskiThe
4742c8cbe1SRafal Jaworowski.Nm
4842c8cbe1SRafal Jaworowskientity does not represent any physical element by itself, it is rather an
4942c8cbe1SRafal Jaworowskiumbrella node grouping integrated on-chip peripherals like interrupt
5042c8cbe1SRafal Jaworowskicontroller, connectivity controllers, accelerating engines and so on.
5142c8cbe1SRafal Jaworowski.Pp
5242c8cbe1SRafal JaworowskiThe driver is generic and common for all flattened device tree nodes claiming
5342c8cbe1SRafal Jaworowski.Pa simple-bus
5442c8cbe1SRafal Jaworowskicompatibility. It iterates over direct descendants of the
5542c8cbe1SRafal Jaworowski.Pa simple-bus
5642c8cbe1SRafal Jaworowskinode, instantiates newbus children and assigns resources to them, based on the
5742c8cbe1SRafal Jaworowskiconfiguration data retrieved from the nodes properties in
5842c8cbe1SRafal Jaworowski.Xr fdt 4 .
5942c8cbe1SRafal Jaworowski.Pp
6042c8cbe1SRafal JaworowskiNote the
6142c8cbe1SRafal Jaworowski.Nm
6242c8cbe1SRafal Jaworowskidoes not manage device resources and passes through any requests to the
63*50d922a0SGlen Barber.Xr fdtbus 4
64*50d922a0SGlen Barberlayer.
6542c8cbe1SRafal Jaworowski.Sh SEE ALSO
6642c8cbe1SRafal Jaworowski.Xr fdt 4 ,
6742c8cbe1SRafal Jaworowski.Xr fdtbus 4 ,
68*50d922a0SGlen Barber.Xr openfirm 4
6942c8cbe1SRafal Jaworowski.Sh STANDARDS
7042c8cbe1SRafal JaworowskiPower.org Standard for Embedded Power Architecture Platform Requirements
7142c8cbe1SRafal Jaworowski.Pq Vt ePAPR .
7242c8cbe1SRafal Jaworowski.Sh HISTORY
7342c8cbe1SRafal JaworowskiThe
7442c8cbe1SRafal Jaworowski.Nm
7542c8cbe1SRafal Jaworowskisupport first appeared in
7642c8cbe1SRafal Jaworowski.Fx 9.0 .
7742c8cbe1SRafal Jaworowski.Sh AUTHORS
7842c8cbe1SRafal JaworowskiThe
7942c8cbe1SRafal Jaworowski.Nm
8042c8cbe1SRafal Jaworowskisupport was developed by Semihalf under sponsorship from the FreeBSD
8142c8cbe1SRafal JaworowskiFoundation. This manual page was written by
8242c8cbe1SRafal Jaworowski.An Rafal Jaworowski .
83