Skip to content
Embedded Base Boot Requirements Specification
Branch: master
Clone or download
Latest commit 24b1b3c Mar 31, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
source v1.0 Mar 31, 2019
.gitignore Add PDF output May 14, 2018
.travis.yml v0.6-pre2 Jul 6, 2018
CONTRIBUTING.rst Update regular EBBR meeting series Mar 12, 2019
LICENSE Elaborate on DCO process and add full text of CC-BY-SA 4.0 May 14, 2018
Makefile Move contributing details to CONTRIBUTING file May 17, 2018
README.rst

README.rst

Embedded Base Boot Requirements (EBBR) specification

The Embedded Base Boot Requirements specification defines requirements for embedded systems to enable inter-operability between SoCs, hardware platforms, firmware implementations, and operating system distributions. The aim is to establish consistent boot ABIs and behaviour so that supporting new hardware platforms does not require custom engineering work.

The first formal v1.0 release of EBBR was made in March 2019. You can find the current draft text in this repository, but be aware that everything in the draft text is subject to change. Official pdfs can be found in the "Releases" tab of this GitHub project.

Released EBBR PDFs can be found here:

https://github.com/ARM-software/ebbr/releases

Contributing

Anyone may contribute to EBBR. Discussion is on the boot-architecture@lists.linaro.org mailing list, and there is a weekly conference call. See CONTRIBUTING.rst for details.

Build Instructions

Requirements

On Debian and Ubuntu

# apt-get install python-sphinx texlive texlive-latex-extra libalgorithm-diff-perl \
                  texlive-humanities texlive-generic-recommended texlive-generic-extra \
                  latexmk

If the version of python-sphinx installed is too old, then an additional new version can be installed with the Python package installer:

$ apt-get install python-pip
$ pip install --user --upgrade Sphinx
$ export SPHINXBUILD=~/.local/bin/sphinx-build

Export SPHINXBUILD (see above) if Sphinx was installed with pip --user, then follow Make commands below

On Fedora

# dnf install python2-sphinx texlive texlive-capt-of texlive-draftwatermark \
              texlive-fncychap texlive-framed texlive-needspace \
              texlive-tabulary texlive-titlesec texlive-upquote \
              texlive-wrapfig

It is also possible to use python3-sphinx; this requires SPHINXBUILD=sphinx-build-3 to be passed on the Make command line.

On Mac OS X

  • Install MacTeX

  • Install pip if you do not have it:

    $ sudo easy_install pip
    
  • Install Sphinx:

    $ pip install --user --upgrade Sphinx
    

Make Targets

To generate PDF:

$ make latexpdf

To generate hierarchy of HTML pages:

$ make html

To generate a single HTML page:

$ make singlehtml

Output goes in ./build subdirectory.

License

This work is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License (CC-BY-SA-4.0). To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/4.0/ or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.

Contributions are accepted under the same with sign-off under the Developer's Certificate of Origin. For more on contributing to EBBR, see CONTRIBUTING.rst.

A copy of the license is included in the LICENSE file.

Creative Commons License

Writers Guide

All documentation in this repository uses reStructuredText markup with Sphinx extensions.

All files in this project must include the relevant SPDX license identifier tag. Generally this means each .rst file should include the line

.. SPDX-License-Identifier: CC-BY-SA-4.0

Original Document

Prior to being relicensed to CC-BY-SA 4.0, this specification was released by Arm. The original Draft v0.5 text can be found here:

EBBR Draft v0.5

You can’t perform that action at this time.