Skip to content

Latest commit

 

History

History
149 lines (105 loc) · 3.4 KB

README-fast-intro.md

File metadata and controls

149 lines (105 loc) · 3.4 KB
Raw

Get RODOS

Inf you have questions, please contact [email protected]

(By the way, you can format this file using the program okular)

There are two easy ways to get RODOS:

  1. download RODOS here and extract it with:
	tar -jxvf rodos-master.tar.gz
  1. clone it from gitlab with
    git clone https://gitlab.com/rodos/rodos.git
    cd rodos

Take a look to the short introduction in

	https://en.wikipedia.org/wiki/Rodos_%28operating_system%29 
	https://de.wikipedia.org/wiki/Rodos_%28Betriebssystem%29

How to use

All these instructions are only for Linux
and please use the bash shell!

Each directory has one or more *README* files.
For each directory you visit, please read first these files,
and study the "doc" directory.

1 Tools

If you do not have the clang/c++ tools, please install first:

	sudo apt install -y apt-utils
	sudo apt install -y clang clang-format clang-tools gdb
	sudo apt install -y gcc-multilib g++-multilib
	sudo apt install -y gcc-arm-none-eabi binutils-arm-none-eabi libnewlib-arm-none-eabi
	sudo apt install -y cmake

2 Sent shell variables

Every time you start a new session or a new terminal set the environment variables directories and default compiler options by calling

    cd <your rodos root directory>
    source setenvs.sh

3 RODOS libs

Generate the RODOS lib for some target architectures, for example

        rodos-lib.sh linux-x86
        rodos-lib.sh linux-makecontext
        rodos-lib.sh on-posix
        rodos-lib.sh discovery   # you will need the ARM Corsscompiler
    or generate all libraries
        rodos-all-libs.sh

Please not, for some you will need the crosscompiler tools

4 first test

(optional) Test some tutorial examples using different target architectures

    cdrodos     #"cdrodos" is defined as alias in setenvs.sh
    cd tutorials
    cd 20-core

    rodos-executable.sh  linux-x86 semaphore-worm.cpp 
    tst       # terminate with control-c

    rodos-executable.sh  on-posix semaphore-worm.cpp 
    tst

    rodos-executable.sh  linux-makecontext  semaphore-worm.cpp 
    tst

5 Begin learning

To begin, learning rodos

Watch the introduction movies of how to program on RODOS:

Now, please take a look and experiment with all tutorials.

    cdrodos 
    cd tutorials/10-first-steps

Please read all README* files in the root directory of RODOS.

  1. read the *README* files
  2. read the execute-example*.sh scripts
  3. read the corresponding source code
  4. execute the execute-example*.sh scripts
  5. see the results.

6 other tutorials

Go to all other tutorials and to the same.

7 Port to other Hardware

To port to other platforms, see
rodos/src/bare-metal/template see all *REAME* files all pdf and all examples
see infos in
src/bare-metal/template/README-how-to-port

Need help?

If you need help, please contact me.

Cheers Sergio Montenegro [email protected]