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