blob: b43a7eab53122149442a936e3a1a1972e2cf77e7 [file] [log] [blame]
Rodrigo Caballeroa4a50fa2015-05-15 11:38:34 -05001..
Kumar Gala3c04f0c2021-05-28 09:41:38 -05002 Zephyr Project documentation main 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
Kumar Gala3c04f0c2021-05-28 09:41:38 -050013 Documentation for the latest (main) development branch of Zephyr
David B. Kinderb3790302019-04-03 15:40:19 -070014 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
Anas Nashif78185972020-05-27 12:24:18 -040018 **Welcome to the Zephyr Project's documentation
Kumar Gala3c04f0c2021-05-28 09:41:38 -050019 for the main tree under development** (version |version|).
David B. Kinderb3790302019-04-03 15:40:19 -070020
Anas Nashifcadd0622021-07-03 11:53:40 -040021Use the version selection menu on the left to view
22documentation for a specific version of Zephyr.
Anas Nashif13ce2d62016-04-21 11:23:57 -040023
Anas Nashifcadd0622021-07-03 11:53:40 -040024For 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
Anas Nashifcadd0622021-07-03 11:53:40 -040027The 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. Kindera2bb0fa2017-08-03 07:15:58 -070032
Anas Nashif63bdb802019-01-06 22:56:29 -050033.. raw:: html
34
35 <ul class="grid">
36 <li class="grid-item">
Anas Nashif2b9458c2019-02-03 17:29:46 -050037 <a href="introduction/index.html">
Anas Nashif63bdb802019-01-06 22:56:29 -050038 <img alt="" src="_static/images/kite.png"/>
39 <h2>Introduction</h2>
40 </a>
David B. Kinder77441012019-02-05 10:42:09 -080041 <p>Introducing the Zephyr Project: overview, architecture, features, and licensing</p>
Anas Nashif63bdb802019-01-06 22:56:29 -050042 </li>
43 <li class="grid-item">
Anas Nashif2b9458c2019-02-03 17:29:46 -050044 <a href="getting_started/index.html">
David B. Kinder77441012019-02-05 10:42:09 -080045 <span class="grid-icon fa fa-map-signs"></span>
Anas Nashif63bdb802019-01-06 22:56:29 -050046 <h2>Getting Started Guide</h2>
47 </a>
48 <p>Follow this guide to set up a Zephyr development environment on your
49 system, and then build and run a sample application.</p>
50 </li>
51 <li class="grid-item">
Anas Nashif2b9458c2019-02-03 17:29:46 -050052 <a href="contribute/index.html">
David B. Kinder77441012019-02-05 10:42:09 -080053 <span class="grid-icon fa fa-github"></span>
Anas Nashif63bdb802019-01-06 22:56:29 -050054 <h2>Contribution Guidelines</h2>
55 </a>
56 <p>As an open-source project, we welcome and encourage the community
57 to submit patches directly to the project.</p>
58 </li>
59 <li class="grid-item">
Anas Nashif2b9458c2019-02-03 17:29:46 -050060 <a href="samples/index.html">
David B. Kinder77441012019-02-05 10:42:09 -080061 <span class="grid-icon fa fa-cogs"></span>
Anas Nashif63bdb802019-01-06 22:56:29 -050062 <h2>Samples and Demos</h2>
63 </a>
64 <p>A list of samples and demos that can run on a variety of boards supported
65 by Zephyr</p>
66 </li>
67 <li class="grid-item">
Anas Nashif2b9458c2019-02-03 17:29:46 -050068 <a href="reference/index.html">
David B. Kinder77441012019-02-05 10:42:09 -080069 <span class="grid-icon fa fa-sign-in"></span>
Anas Nashif4d93a972019-02-01 07:08:06 -050070 <h2>API Reference</h2>
Anas Nashif63bdb802019-01-06 22:56:29 -050071 </a>
David B. Kinder77441012019-02-05 10:42:09 -080072 <p>API Documentation, Zephyr configuration, and subsystem Reference</p>
Anas Nashif63bdb802019-01-06 22:56:29 -050073 </li>
74 <li class="grid-item">
Anas Nashif2b9458c2019-02-03 17:29:46 -050075 <a href="security/index.html">
David B. Kinder77441012019-02-05 10:42:09 -080076 <span class="grid-icon fa fa-lock"></span>
Anas Nashif63bdb802019-01-06 22:56:29 -050077 <h2>Security</h2>
78 </a>
79 <p>Requirements, processes, and developer guidelines for ensuring security is addressed within the Zephyr project.</p>
80 </li>
81 <li class="grid-item">
Anas Nashif2b9458c2019-02-03 17:29:46 -050082 <a href="boards/index.html">
David B. Kinder77441012019-02-05 10:42:09 -080083 <span class="grid-icon fa fa-object-group"></span>
Anas Nashif63bdb802019-01-06 22:56:29 -050084 <h2>Supported Boards</h2>
85 </a>
David B. Kinder77441012019-02-05 10:42:09 -080086 <p>List of supported boards and platforms.</p>
Anas Nashif63bdb802019-01-06 22:56:29 -050087 </li>
88 <li class="grid-item">
Anas Nashif2b9458c2019-02-03 17:29:46 -050089 <a href="guides/index.html">
David B. Kinder77441012019-02-05 10:42:09 -080090 <span class="grid-icon fa fa-puzzle-piece"></span>
Anas Nashif4d93a972019-02-01 07:08:06 -050091 <h2>User and Developer Guides</h2>
Anas Nashif63bdb802019-01-06 22:56:29 -050092 </a>
David B. Kinder77441012019-02-05 10:42:09 -080093 <p>User and Developer Guides, including tools and tips</p>
Anas Nashif63bdb802019-01-06 22:56:29 -050094 </li>
95 </ul>
96
Anas Nashifcadd0622021-07-03 11:53:40 -040097Sections
98********
Rodrigo Caballero5753b6e2015-08-17 16:04:22 -050099
Anas Nashif06d380c2015-05-13 14:05:30 -0400100.. toctree::
Anas Nashif3f5eb3b2015-08-29 09:14:50 -0400101 :maxdepth: 1
Gerard Marull-Paretas89aa9c82021-03-12 14:35:28 +0100102 :caption: Contents
Anas Nashif06d380c2015-05-13 14:05:30 -0400103
Anas Nashif2b9458c2019-02-03 17:29:46 -0500104 introduction/index.rst
105 getting_started/index.rst
Anas Nashif276c5892019-01-05 10:23:34 -0500106 contribute/index.rst
Anas Nashif960de8c2019-01-08 10:29:13 -0500107 development_process/index.rst
Anas Nashif5342bc62021-05-06 09:48:14 -0400108 guides/build/index.rst
Anas Nashif2b9458c2019-02-03 17:29:46 -0500109 application/index.rst
Anas Nashifd6f72a62019-02-02 11:06:11 -0500110 reference/index.rst
111 guides/index.rst
Anas Nashif2b9458c2019-02-03 17:29:46 -0500112 security/index.rst
113 samples/index.rst
114 boards/index.rst
115 releases/index.rst
Rodrigo Caballerob6e41a72016-04-15 11:14:55 -0500116
Anas Nashifcadd0622021-07-03 11:53:40 -0400117Indices and Tables
118******************
Daniel Leung9945e7f2018-08-23 11:11:11 -0700119
Anas Nashifcadd0622021-07-03 11:53:40 -0400120* :ref:`glossary`
121* :ref:`genindex`
Anas Nashif9960dac2021-07-01 11:27:57 -0400122
123.. _Apache 2.0 license:
124 https://github.com/zephyrproject-rtos/zephyr/blob/main/LICENSE
125
126.. _GitHub repo: https://github.com/zephyrproject-rtos/zephyr