2014-02-11 18:15:43 +01:00
|
|
|
ZZZZZZ
|
|
|
|
|
ZZZZZZZZZZZZ
|
|
|
|
|
ZZZZZZZZZZZZZZZZ
|
|
|
|
|
ZZZZZZZ ZZZZZZ
|
|
|
|
|
ZZZZZZ ZZZZZ
|
|
|
|
|
ZZZZZ ZZZZ
|
|
|
|
|
ZZZZ ZZZZZ
|
|
|
|
|
ZZZZ ZZZZ
|
|
|
|
|
ZZZZ ZZZZZ
|
|
|
|
|
ZZZZ ZZZZZZ
|
|
|
|
|
ZZZZ ZZZZZZZZ 777 7777 7777777777
|
|
|
|
|
ZZ ZZZZ ZZZZZZZZ 777 77777777 77777777777
|
|
|
|
|
ZZZZZZZ ZZZZ ZZZZZZZ 777 7777 7777 777
|
|
|
|
|
ZZZZZZZZZ ZZZZ Z 777 777 777 777
|
|
|
|
|
ZZZZZZ ZZZZ 777 777 777 777
|
|
|
|
|
ZZZZZ ZZZZ 777 777 777 777
|
|
|
|
|
ZZZZZ ZZZZZ ZZZZ 777 777 777 777
|
|
|
|
|
ZZZZ ZZZZZ ZZZZZ 777 777 777 777
|
|
|
|
|
ZZZZ ZZZZZ ZZZZZ 777 777 777 777
|
|
|
|
|
ZZZZ ZZZZ ZZZZZ 777 777 777 777
|
|
|
|
|
ZZZZZ ZZZZZ ZZZZZ 777 777 777 777
|
|
|
|
|
ZZZZZZ ZZZZZZ ZZZZZ 777 7777777777 777
|
|
|
|
|
ZZZZZZZZZZZZZZZ ZZZZ 777 77777777 777
|
|
|
|
|
ZZZZZZZZZZZ Z
|
|
|
|
|
ZZZZZ
|
|
|
|
|
|
2013-03-21 17:13:01 +01:00
|
|
|
The friendly Operating System for IoT!
|
2012-12-29 21:42:26 +01:00
|
|
|
|
2016-05-31 13:10:51 +02:00
|
|
|
RIOT is a real-time multi-threading operating system that supports a range of
|
|
|
|
|
devices that are typically found in the Internet of Things (IoT):
|
2016-05-31 19:23:35 +02:00
|
|
|
8-bit, 16-bit and 32-bit microcontrollers.
|
2016-05-31 13:10:51 +02:00
|
|
|
|
|
|
|
|
RIOT is based on the following design principles: energy-efficiency, real-time
|
|
|
|
|
capabilities, small memory footprint, modularity, and uniform API access,
|
|
|
|
|
independent of the underlying hardware (this API offers partial POSIX
|
|
|
|
|
compliance).
|
|
|
|
|
|
|
|
|
|
RIOT is developed by an international open source community which is
|
2016-05-31 15:25:04 +02:00
|
|
|
independent of specific vendors (e.g. similarly to the Linux community).
|
|
|
|
|
RIOT is licensed with LGPLv2.1, a copyleft license which fosters
|
2016-05-31 13:10:51 +02:00
|
|
|
indirect business models around the free open-source software platform
|
2016-05-31 15:25:04 +02:00
|
|
|
provided by RIOT, e.g. it is possible to link closed-source code with the
|
|
|
|
|
LGPL code.
|
2016-05-31 13:10:51 +02:00
|
|
|
|
2013-08-15 17:15:24 +02:00
|
|
|
## FEATURES
|
2012-12-29 21:42:26 +01:00
|
|
|
|
2016-06-13 12:03:03 +02:00
|
|
|
RIOT is based on a microkernel architecture, and provides features including,
|
|
|
|
|
but not limited to:
|
2016-05-31 13:10:51 +02:00
|
|
|
|
2012-12-29 21:42:26 +01:00
|
|
|
* a preemptive, tickless scheduler with priorities
|
2014-01-13 11:19:45 +01:00
|
|
|
* flexible memory management
|
2016-02-29 18:46:36 +01:00
|
|
|
* high resolution, long-term timers
|
|
|
|
|
* support for AVR, MSP430, ARM7, and ARM Cortex-M on over 50 boards
|
2016-06-13 12:03:03 +02:00
|
|
|
* the native port allows to run RIOT as-is on Linux, BSD, and MacOS. Multiple
|
|
|
|
|
instances of RIOT running on a single machine can also be interconnected via
|
|
|
|
|
a simple virtual Ethernet bridge
|
2012-12-29 21:42:26 +01:00
|
|
|
* IPv6
|
2016-02-29 18:46:36 +01:00
|
|
|
* 6LoWPAN (RFC4944, RFC6282, and RFC6775)
|
2015-08-06 12:08:58 +02:00
|
|
|
* UDP
|
2016-05-31 19:23:35 +02:00
|
|
|
* RPL (storing mode, P2P mode)
|
2016-02-29 18:46:36 +01:00
|
|
|
* CoAP
|
|
|
|
|
* CCN-Lite
|
2016-05-31 19:23:35 +02:00
|
|
|
|
2014-02-11 18:15:43 +01:00
|
|
|
|
2013-08-15 13:07:27 +02:00
|
|
|
## GETTING STARTED
|
2016-06-13 12:03:03 +02:00
|
|
|
* You want to start the RIOT? Just follow our [Getting started
|
|
|
|
|
documentation](https://github.com/RIOT-OS/RIOT/wiki/Introduction)
|
|
|
|
|
* The RIOT API itself can be built from the code using doxygen. The latest
|
|
|
|
|
version is uploaded daily to http://riot-os.org/api.
|
2013-08-08 20:36:59 +02:00
|
|
|
|
2013-08-15 13:07:27 +02:00
|
|
|
### USING THE NATIVE PORT WITH NETWORKING
|
2016-06-13 12:03:03 +02:00
|
|
|
If you compile RIOT for the native cpu and include the `netdev2_tap` module,
|
|
|
|
|
you can specify a network interface like this: `PORT=tap0 make term`
|
2013-08-15 13:07:27 +02:00
|
|
|
|
|
|
|
|
#### SETTING UP A TAP NETWORK
|
2016-06-13 12:03:03 +02:00
|
|
|
There is a shellscript in `RIOT/dist/tools/tapsetup` called `tapsetup` which
|
|
|
|
|
you can use to create a network of tap interfaces.
|
2013-08-15 13:07:27 +02:00
|
|
|
|
|
|
|
|
*USAGE*
|
|
|
|
|
To create a bridge and two (or count at your option) tap interfaces:
|
2015-06-14 01:29:55 +02:00
|
|
|
|
|
|
|
|
./dist/tools/tapsetup/tapsetup [-c [<count>]]
|
2013-08-15 13:07:27 +02:00
|
|
|
|
2013-08-15 17:15:24 +02:00
|
|
|
## CONTRIBUTE
|
|
|
|
|
|
2016-06-13 12:03:03 +02:00
|
|
|
To contribute something to RIOT, please refer to the [development
|
|
|
|
|
procedures](https://github.com/RIOT-OS/RIOT/wiki/Development-procedures) and
|
|
|
|
|
read all notes for best practice.
|
2013-08-15 17:15:24 +02:00
|
|
|
|
2013-08-15 13:07:27 +02:00
|
|
|
## MAILING LISTS
|
2013-08-08 20:36:59 +02:00
|
|
|
* RIOT OS kernel developers list
|
|
|
|
|
* devel@riot-os.org (http://lists.riot-os.org/mailman/listinfo/devel)
|
|
|
|
|
* RIOT OS users list
|
|
|
|
|
* users@riot-os.org (http://lists.riot-os.org/mailman/listinfo/users)
|
|
|
|
|
* RIOT commits
|
|
|
|
|
* commits@riot-os.org (http://lists.riot-os.org/mailman/listinfo/commits)
|
|
|
|
|
* Github notifications
|
2016-06-13 12:03:03 +02:00
|
|
|
* notifications@riot-os.org
|
|
|
|
|
(http://lists.riot-os.org/mailman/listinfo/notifications)
|
2013-08-08 20:36:59 +02:00
|
|
|
|
2013-08-15 13:07:27 +02:00
|
|
|
## LICENSE
|
2013-03-21 17:13:01 +01:00
|
|
|
* All sources and binaries that have been developed at Freie Universität Berlin are
|
2015-04-07 23:56:09 +02:00
|
|
|
licensed under the GNU Lesser General Public License version 2.1 as published by the
|
2013-03-21 17:13:01 +01:00
|
|
|
Free Software Foundation.
|
|
|
|
|
* Some external sources, especially files developed by SICS are published under
|
|
|
|
|
a separate license.
|
2014-02-11 18:15:43 +01:00
|
|
|
|
2013-03-21 17:13:01 +01:00
|
|
|
All code files contain licensing information.
|
2013-03-27 11:01:48 +01:00
|
|
|
|
|
|
|
|
For more information, see the RIOT website:
|
|
|
|
|
|
|
|
|
|
http://www.riot-os.org
|
