blob: 17e6e0b4a707d6b7743890ab8f883bd4894f33a8 [file] [log] [blame]
Rodrigo Caballeroa4a50fa2015-05-15 11:38:34 -05001..
Anas Nashif5a7de142015-06-13 12:51:09 -07002 Zephyr Project documentation master file
Rodrigo Caballeroa4a50fa2015-05-15 11:38:34 -05003
David B. Kinder9d04f032019-04-10 14:57:51 -07004.. _zephyr-home:
5
Rodrigo Caballero26bd7d62016-02-05 10:06:00 -06006Zephyr Project Documentation
7############################
8
Anas Nashif13ce2d62016-04-21 11:23:57 -04009.. only:: release
10
David B. Kinderb3790302019-04-03 15:40:19 -070011 Welcome to the Zephyr Project's documentation for version |version|.
Anas Nashif13ce2d62016-04-21 11:23:57 -040012
David B. Kinderb3790302019-04-03 15:40:19 -070013 Documentation for the latest (master) development branch of Zephyr
14 can be found at https://docs.zephyrproject.org/
Anas Nashif13ce2d62016-04-21 11:23:57 -040015
Anas Nashif457ae382017-01-04 09:39:45 -050016.. only:: (development or daily)
Anas Nashif13ce2d62016-04-21 11:23:57 -040017
David B. Kinderb3790302019-04-03 15:40:19 -070018 Welcome to the Zephyr Project's documentation
19 for the master tree under development (version |version|).
20
21Use the version selection menu on the left to view
22documentation for a specific version of Zephyr.
Anas Nashif13ce2d62016-04-21 11:23:57 -040023
David B. Kinder6e221752017-12-05 10:49:31 -080024For information about the changes and additions for releases, please
25consult the published :ref:`zephyr_release_notes` documentation.
Anas Nashif3e4efa02017-08-17 23:10:16 -040026
David B. Kinderb03ed2b2017-08-21 13:46:43 -070027The Zephyr OS is provided under the `Apache 2.0 license`_ (as found in
28the LICENSE file in the project's `GitHub repo`_). The Zephyr OS also
29imports or reuses packages, scripts, and other files that use other
30licensing, as described in :ref:`Zephyr_Licensing`.
Anas Nashif3e4efa02017-08-17 23:10:16 -040031
David B. Kinderb03ed2b2017-08-21 13:46:43 -070032.. _Apache 2.0 license:
33 https://github.com/zephyrproject-rtos/zephyr/blob/master/LICENSE
34
35.. _GitHub repo: https://github.com/zephyrproject-rtos/zephyr
36
David B. Kindera2bb0fa2017-08-03 07:15:58 -070037
Anas Nashif63bdb802019-01-06 22:56:29 -050038.. raw:: html
39
40 <ul class="grid">
41 <li class="grid-item">
Anas Nashif2b9458c2019-02-03 17:29:46 -050042 <a href="introduction/index.html">
Anas Nashif63bdb802019-01-06 22:56:29 -050043 <img alt="" src="_static/images/kite.png"/>
44 <h2>Introduction</h2>
45 </a>
David B. Kinder77441012019-02-05 10:42:09 -080046 <p>Introducing the Zephyr Project: overview, architecture, features, and licensing</p>
Anas Nashif63bdb802019-01-06 22:56:29 -050047 </li>
48 <li class="grid-item">
Anas Nashif2b9458c2019-02-03 17:29:46 -050049 <a href="getting_started/index.html">
David B. Kinder77441012019-02-05 10:42:09 -080050 <span class="grid-icon fa fa-map-signs"></span>
Anas Nashif63bdb802019-01-06 22:56:29 -050051 <h2>Getting Started Guide</h2>
52 </a>
53 <p>Follow this guide to set up a Zephyr development environment on your
54 system, and then build and run a sample application.</p>
55 </li>
56 <li class="grid-item">
Anas Nashif2b9458c2019-02-03 17:29:46 -050057 <a href="contribute/index.html">
David B. Kinder77441012019-02-05 10:42:09 -080058 <span class="grid-icon fa fa-github"></span>
Anas Nashif63bdb802019-01-06 22:56:29 -050059 <h2>Contribution Guidelines</h2>
60 </a>
61 <p>As an open-source project, we welcome and encourage the community
62 to submit patches directly to the project.</p>
63 </li>
64 <li class="grid-item">
Anas Nashif2b9458c2019-02-03 17:29:46 -050065 <a href="samples/index.html">
David B. Kinder77441012019-02-05 10:42:09 -080066 <span class="grid-icon fa fa-cogs"></span>
Anas Nashif63bdb802019-01-06 22:56:29 -050067 <h2>Samples and Demos</h2>
68 </a>
69 <p>A list of samples and demos that can run on a variety of boards supported
70 by Zephyr</p>
71 </li>
72 <li class="grid-item">
Anas Nashif2b9458c2019-02-03 17:29:46 -050073 <a href="reference/index.html">
David B. Kinder77441012019-02-05 10:42:09 -080074 <span class="grid-icon fa fa-sign-in"></span>
Anas Nashif4d93a972019-02-01 07:08:06 -050075 <h2>API Reference</h2>
Anas Nashif63bdb802019-01-06 22:56:29 -050076 </a>
David B. Kinder77441012019-02-05 10:42:09 -080077 <p>API Documentation, Zephyr configuration, and subsystem Reference</p>
Anas Nashif63bdb802019-01-06 22:56:29 -050078 </li>
79 <li class="grid-item">
Anas Nashif2b9458c2019-02-03 17:29:46 -050080 <a href="security/index.html">
David B. Kinder77441012019-02-05 10:42:09 -080081 <span class="grid-icon fa fa-lock"></span>
Anas Nashif63bdb802019-01-06 22:56:29 -050082 <h2>Security</h2>
83 </a>
84 <p>Requirements, processes, and developer guidelines for ensuring security is addressed within the Zephyr project.</p>
85 </li>
86 <li class="grid-item">
Anas Nashif2b9458c2019-02-03 17:29:46 -050087 <a href="boards/index.html">
David B. Kinder77441012019-02-05 10:42:09 -080088 <span class="grid-icon fa fa-object-group"></span>
Anas Nashif63bdb802019-01-06 22:56:29 -050089 <h2>Supported Boards</h2>
90 </a>
David B. Kinder77441012019-02-05 10:42:09 -080091 <p>List of supported boards and platforms.</p>
Anas Nashif63bdb802019-01-06 22:56:29 -050092 </li>
93 <li class="grid-item">
Anas Nashif2b9458c2019-02-03 17:29:46 -050094 <a href="guides/index.html">
David B. Kinder77441012019-02-05 10:42:09 -080095 <span class="grid-icon fa fa-puzzle-piece"></span>
Anas Nashif4d93a972019-02-01 07:08:06 -050096 <h2>User and Developer Guides</h2>
Anas Nashif63bdb802019-01-06 22:56:29 -050097 </a>
David B. Kinder77441012019-02-05 10:42:09 -080098 <p>User and Developer Guides, including tools and tips</p>
Anas Nashif63bdb802019-01-06 22:56:29 -050099 </li>
100 </ul>
101
Daniel Leung9945e7f2018-08-23 11:11:11 -0700102.. only:: html
103
104 Sections
105 ********
Rodrigo Caballero5753b6e2015-08-17 16:04:22 -0500106
Anas Nashif06d380c2015-05-13 14:05:30 -0400107.. toctree::
Anas Nashif3f5eb3b2015-08-29 09:14:50 -0400108 :maxdepth: 1
Anas Nashif06d380c2015-05-13 14:05:30 -0400109
Anas Nashif2b9458c2019-02-03 17:29:46 -0500110 introduction/index.rst
111 getting_started/index.rst
Anas Nashif276c5892019-01-05 10:23:34 -0500112 contribute/index.rst
Anas Nashif960de8c2019-01-08 10:29:13 -0500113 development_process/index.rst
Anas Nashif2b9458c2019-02-03 17:29:46 -0500114 application/index.rst
Anas Nashifd6f72a62019-02-02 11:06:11 -0500115 reference/index.rst
116 guides/index.rst
Anas Nashif2b9458c2019-02-03 17:29:46 -0500117 security/index.rst
118 samples/index.rst
119 boards/index.rst
120 releases/index.rst
Rodrigo Caballerob6e41a72016-04-15 11:14:55 -0500121
Daniel Leung9945e7f2018-08-23 11:11:11 -0700122.. only:: html
123
124 Indices and Tables
125 ******************
Anas Nashif06d380c2015-05-13 14:05:30 -0400126
Anas Nashife381a612017-08-17 22:46:19 -0400127* :ref:`glossary`
Anas Nashif06d380c2015-05-13 14:05:30 -0400128
Anas Nashife381a612017-08-17 22:46:19 -0400129* :ref:`genindex`