Primary Git Repository for the Zephyr Project. Zephyr is a new generation, scalable, optimized, secure RTOS for multiple hardware architectures.
Go to file
David B. Kinder 4cac31b298 doc: fix doxygen error for BUILD_ASSERT_MSG
Similar to #8042, doxygen has issues with function macros (those that
don't end with a semicolon). Workaround is to have doxygen treat these
as predefined by the doxygen preprocessor.  Fixes a problem showing up
in PR #9140.

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>
2018-07-26 18:12:42 -04:00
.known-issues doc: known issues: Fix regexes for Windows 2018-07-12 23:11:46 -04:00
arch arch: st_stm32: Fix IRQs number of various SoCs 2018-07-26 08:24:04 -05:00
boards drivers: wifi: simplelink: enable Fast Connect policy 2018-07-26 13:57:34 +03:00
cmake nsim: add run target 2018-07-19 18:59:07 -04:00
doc doc: fix doxygen error for BUILD_ASSERT_MSG 2018-07-26 18:12:42 -04:00
drivers drivers: serial: Add power management to nRF UART driver 2018-07-26 12:11:17 -04:00
dts drivers: i2c: stm32: add support for STM32F7 2018-07-25 07:19:12 -04:00
ext ext: hal: cmsis: Remove headers from old CMSIS import 2018-07-20 08:59:13 -05:00
include net: tls: Add socket option to set peer verification level 2018-07-26 12:13:15 -04:00
kernel userspace: compartmentalized app memory organization 2018-07-25 12:02:01 -07:00
lib lib: newlib: add read/write syscalls 2018-07-25 14:57:51 -04:00
misc kconfig: decouple realmode boot from CONFIG_JAIHOUSE 2018-07-24 15:37:09 -07:00
samples net: samples: Add TLS support to socket echo_client/echo_server 2018-07-26 12:13:15 -04:00
scripts gen_syscalls.py: do not output data to stdout 2018-07-26 00:53:45 -04:00
subsys net: tls: Add socket option to set peer verification level 2018-07-26 12:13:15 -04:00
tests tests: pipe: Add description and RTM links 2018-07-26 14:59:02 -04:00
.checkpatch.conf
.codecov.yml
.gitattributes
.gitignore doc: update .gitignore file list 2018-06-14 18:01:36 -04:00
.gitlint
.mailmap mailmap: add entry for ruuddw 2018-07-05 09:57:23 -04:00
.shippable.yml ci: handle documentation errors in ci 2018-07-24 19:26:52 -04:00
.uncrustify.cfg
CMakeLists.txt gen_syscalls.py: do not output data to stdout 2018-07-26 00:53:45 -04:00
CODEOWNERS codeowners: Assign doc CMake and scripts to me 2018-07-19 08:44:41 -04:00
CONTRIBUTING.rst
Kconfig
Kconfig.zephyr
LICENSE
Makefile doc: Makefile: Switch to Ninja as a generator 2018-07-19 08:44:41 -04:00
README.rst doc: fix misspellings in docs 2018-05-23 16:57:33 -04:00
VERSION release: Post-release patch level update 2018-06-11 12:34:01 -05:00
version.h.in
zephyr-env.cmd
zephyr-env.sh

README.rst

Zephyr Project
##############

.. raw:: html

   <a href="https://bestpractices.coreinfrastructure.org/projects/74"><img
   src="https://bestpractices.coreinfrastructure.org/projects/74/badge"></a>
   <img
   src="https://api.shippable.com/projects/58ffb2b8baa5e307002e1d79/badge?branch=master">


The Zephyr Project is a scalable real-time operating system (RTOS) supporting
multiple hardware architectures, optimized for resource constrained devices,
and built with security in mind.

The Zephyr OS is based on a small-footprint kernel designed for use on
resource-constrained systems: from simple embedded environmental sensors and
LED wearables to sophisticated smart watches and IoT wireless gateways.

The Zephyr kernel supports multiple architectures, including ARM Cortex-M,
Intel x86, ARC, NIOS II, Tensilica Xtensa, and RISC V, and a large number of
`supported boards`_.

.. below included in doc/introduction/introduction.rst

.. start_include_here

Community Support
*****************

The Zephyr Project Developer Community includes developers from member
organizations and the general community all joining in the development of
software within the Zephyr Project. Members contribute and discuss ideas,
submit bugs and bug fixes, and provide training. They also help those in need
through the community's forums such as mailing lists and IRC channels. Anyone
can join the developer community and the community is always willing to help
its members and the User Community to get the most out of the Zephyr Project.

Welcome to the Zephyr community!

Resources
*********

Here's a quick summary of resources to find your way around the Zephyr Project
support systems:

* **Zephyr Project Website**: The https://zephyrproject.org website is the
  central source of information about the Zephyr Project. On this site, you'll
  find background and current information about the project as well as all the
  relevant links to project material.  For a quick start, refer to the
  `Zephyr Introduction`_ and `Getting Started Guide`_.

* **Releases**: Source code for Zephyr kernel releases are available at
  https://zephyrproject.org/developers/#downloads. On this page,
  you'll find release information, and links to download or clone source
  code from our GitHub repository.  You'll also find links for the Zephyr
  SDK, a moderated collection of tools and libraries used to develop your
  applications.

* **Source Code in GitHub**: Zephyr Project source code is maintained on a
  public GitHub repository at https://github.com/zephyrproject-rtos/zephyr.
  You'll find information about getting access to the repository and how to
  contribute to the project in this `Contribution Guide`_ document.

* **Samples Code**: In addition to the kernel source code, there are also
  many documented `Sample and Demo Code Examples`_ that can help show you
  how to use Zephyr services and subsystems.

* **Documentation**: Extensive Project technical documentation is developed
  along with the Zephyr kernel itself, and can be found at
  http://docs.zephyrproject.org.  Additional documentation is maintained in
  the `Zephyr GitHub wiki`_.

* **Cross-reference**: Source code cross-reference for the Zephyr
  kernel and samples code is available at
  https://elixir.bootlin.com/zephyr/latest/source.

* **Issue Reporting and Tracking**: Requirements and Issue tracking is done in
  the Github issues system: https://github.com/zephyrproject-rtos/zephyr/issues.
  You can browse through the reported issues and submit issues of your own.

* **Security-related Issue Reporting and Tracking**: For security-related
  inquiries or reporting suspected security-related bugs in the Zephyr OS,
  please send email to vulnerabilities@zephyrproject.org.  We will assess and
  fix flaws according to our security policy outlined in the Zephyr Project
  `Security Overview`_.

  Security related issue tracking is done in JIRA.  The location of this JIRA
  is https://zephyrprojectsec.atlassian.net.

* **Mailing List**: The `Zephyr Development mailing list`_ is perhaps the most convenient
  way to track developer discussions and to ask your own support questions to
  the Zephyr project community.  There are also specific `Zephyr mailing list
  subgroups`_ for announcements, builds, marketing, and Technical
  Steering Committee notes, for example.
  You can read through the message archives to follow
  past posts and discussions, a good thing to do to discover more about the
  Zephyr project.

* **IRC Chatting**: You can chat online with the Zephyr project developer
  community and other users in our IRC channel #zephyrproject on the
  freenode.net IRC server. You can use the http://webchat.freenode.net web
  client or use a client-side application such as pidgin.


.. _supported boards: http://docs.zephyrproject.org/boards/boards.html
.. _Zephyr Introduction: http://docs.zephyrproject.org/introduction/introducing_zephyr.html
.. _Getting Started Guide: http://docs.zephyrproject.org/getting_started/getting_started.html
.. _Contribution Guide: http://docs.zephyrproject.org/contribute/contribute_guidelines.html
.. _Zephyr GitHub wiki: https://github.com/zephyrproject-rtos/zephyr/wiki
.. _Zephyr Development mailing list: https://lists.zephyrproject.org/g/devel
.. _Zephyr mailing list subgroups: https://lists.zephyrproject.org/g/main/subgroups
.. _Sample and Demo Code Examples: http://docs.zephyrproject.org/samples/samples.html
.. _Security Overview: http://docs.zephyrproject.org/security/security-overview.html