xref: /freebsd/share/man/man4/fdtbus.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 FDTBUS 4
3042c8cbe1SRafal Jaworowski.Os
3142c8cbe1SRafal Jaworowski.Sh NAME
3242c8cbe1SRafal Jaworowski.Nm fdtbus
3342c8cbe1SRafal Jaworowski.Nd Flattened Device Tree bus driver
3442c8cbe1SRafal Jaworowski.Sh SYNOPSIS
3542c8cbe1SRafal Jaworowski.Cd "options FDT"
3642c8cbe1SRafal Jaworowski.Sh DESCRIPTION
3742c8cbe1SRafal JaworowskiThe
3842c8cbe1SRafal Jaworowski.Nm
3942c8cbe1SRafal Jaworowskiabstract bus driver is the primary connection and translation layer between
4042c8cbe1SRafal Jaworowski.Xr fdt 4
4142c8cbe1SRafal Jaworowskihardware resources description and
4242c8cbe1SRafal Jaworowski.Fx
43*25972509SEdward Tomasz Napieralanative newbus device drivers framework.
44*25972509SEdward Tomasz NapieralaFor an embedded system
4542c8cbe1SRafal Jaworowski.Nm
4642c8cbe1SRafal Jaworowskirepresents peripherals typically found on a highly integrated chip
4742c8cbe1SRafal Jaworowski(system-on-chip).
4842c8cbe1SRafal Jaworowski.Pp
4942c8cbe1SRafal JaworowskiThe
5042c8cbe1SRafal Jaworowski.Nm
5142c8cbe1SRafal Jaworowskidriver provides generic, common infrastructure for all
5250d922a0SGlen Barber.Xr fdt 4
5350d922a0SGlen Barberoriented device drivers, and its main responsibilities are the
5442c8cbe1SRafal Jaworowskifollowing:
5542c8cbe1SRafal Jaworowski.Bl -bullet
5642c8cbe1SRafal Jaworowski.It
5742c8cbe1SRafal JaworowskiCreating newbus children that reflect
5842c8cbe1SRafal Jaworowski.Xr fdt 4
5942c8cbe1SRafal Jaworowskinodes in the flattened device tree.
6042c8cbe1SRafal Jaworowski.It
6142c8cbe1SRafal JaworowskiManaging SYS_RES_IRQ resources.
6242c8cbe1SRafal Jaworowski.It
6342c8cbe1SRafal JaworowskiManaging SYS_RES_MEMORY, SYS_RES_IOPORT resources.
6442c8cbe1SRafal Jaworowski.El
6542c8cbe1SRafal Jaworowski.Sh SEE ALSO
6642c8cbe1SRafal Jaworowski.Xr fdt 4 ,
6742c8cbe1SRafal Jaworowski.Xr openfirm 4 ,
6850d922a0SGlen Barber.Xr simplebus 4
6942c8cbe1SRafal Jaworowski.Sh STANDARDS
7042c8cbe1SRafal JaworowskiIEEE Std 1275: IEEE Standard for Boot (Initialization Configuration) Firmware:
7142c8cbe1SRafal JaworowskiCore Requirements and Practices
7242c8cbe1SRafal Jaworowski.Pq Vt Open Firmware .
7342c8cbe1SRafal Jaworowski.Pp
7442c8cbe1SRafal JaworowskiPower.org Standard for Embedded Power Architecture Platform Requirements
7542c8cbe1SRafal Jaworowski.Pq Vt ePAPR .
7642c8cbe1SRafal Jaworowski.Sh HISTORY
7742c8cbe1SRafal JaworowskiThe
7842c8cbe1SRafal Jaworowski.Nm
7942c8cbe1SRafal Jaworowskisupport first appeared in
8042c8cbe1SRafal Jaworowski.Fx 9.0 .
8142c8cbe1SRafal Jaworowski.Sh AUTHORS
8242c8cbe1SRafal JaworowskiThe
8342c8cbe1SRafal Jaworowski.Nm
8442c8cbe1SRafal Jaworowskisupport was developed by Semihalf under sponsorship from the FreeBSD
85*25972509SEdward Tomasz NapieralaFoundation.
86*25972509SEdward Tomasz NapieralaThis manual page was written by
8742c8cbe1SRafal Jaworowski.An Rafal Jaworowski .
88