Simple_OS documentation

A Simple_OS delivery is bundled in a zip-file, named simple_os_<date>.zip.

This version of Simple_OS can be downloaded using the link

http://theintobooks.com/books/intorealtime/simple_os_2013_03_05.zip

When unzipping this file, the following three directories are created, inside the simple_os_<date> directory:

• simple_os_apps - containing Simple_OS applications, for demonstration purpose, and from which code can be re-used if needed when making your own Simple_OS applications. For additional info, please see the README-file in this directory
• java_gui - containing a graphical user interface, for communication with an executing Simple_OS program. For additional info, please see the README-file in this directory
• simple_os - with the actual RTOS, pre-built as a library, but also including the source code. Here, you can also find makefiles for use on a Linux host for building the library for execution on Linux host (native compilation, running the RTOS as a soft-kernel inside a Linux program), or on ARM target (cross-compilation for ARM on Beagleboard). If you have a Windows host, it is possible to build the library for execution on a Windows host (running the RTOS as a soft-kernel inside a Windows program), using a Visual Studio Express project, stored inside the win subdirectory (some levels down, the project file i.e. the file to be opened in Visual Studio Express is called simple_os.sln)

• start a terminal window
• go to simple_os_<date>/simple_os_apps/barber/gui directory
• run the program using

  ./prog_x86_host
  

• this should result in a printout indicating that the program is waiting for a socket connection
• start another terminal window
• go to simple_os_<date>/java_gui/java
• start the Java GUI program using

   java GUISimpleOS
  

The GUI should now be connected to the running Simple_OS application

Create some customers with File->Send text to Simple_OS and then enter the string new

The customers will visit the barber shop, and after they have had their hair cuts, they will rest for a while, and then come back again

You can close the Simple_OS application (and keeping the GUI running), using File->Exit Simple_OS

Then you can modify the Simple_OS application if you want, and build it. NOTE: this requires that you set the environment variable SIMPLE_OS_DIR.

The variable SIMPLE_OS_DIR shall be set to the simple_os directory inside your installation directory, e.g. like this for tcsh

setenv SIMPLE_OS_DIR /home/ola/simple_os_2013_03_05/simple_os

and like this for bash:

export SIMPLE_OS_DIR=/home/ola/simple_os_2013_03_05/simple_os

If you now try

make -f Makefile_32 

the program will be rebuilt.

Start it again, using

./prog_x86_host

and it will connect to the GUI again.

When tired of running the GUI, close it by using File->Exit

Simple_OS in Windows can be used with Visual C++ Express Edition.

Visual C++ Express Edition can be obtained from

http://www.microsoft.com/visualstudio/en-us/products/2010-editions/visual-cpp-express

It may be possible to use also other C compilers, but that has not been verified.

Supposing that Visual C++ Express Edition is available, the following steps can be taken:

• start a Windows explorer (or My computer application)
• go to simple_os_<date>\simple_os_apps\win\vs_cpp_2010_express\simple_os_prog directory
• double-click or press enter on the file simple_os_prog.sln
• Visual C++ Express Edition should now be open. Ensure that the project is active by clicking once on simple_os_prog (in bold) in the Solution Explorer window.
• In Visual C++ Express Edition, choose Project -> Add Existing Item (or use Shift-Alt-A)
• Then navigate to the directory simple_os_<date>/simple_os_apps/barber/gui/src, and add all c-files and h-files found there to the project
• Build the program using Debug->Build Solution (or use F7 for build, or Ctrl-Alt-F7 for Rebuild)
• Run the program by choosing Debug->Start Debugging (or use Ctrl-F5)
• this should result in a printout indicating that the program is waiting for a socket connection
• start a Windows command window
• go to simple_os_<date>\java_gui\java
• start java GUI program using

   java GUISimpleOS
  

The GUI should now be connected to the running Simple_OS application

Create some customers with File->Send text to Simple_OS and then enter the string new

The customers will visit the barber shop, and after they have had their hair cuts, they will rest for a while, and then come back again

You can close the Simple_OS application (and keeping the GUI running), using File->Exit Simple_OS

Then you can modify the Simple_OS application if you want, and build it.

If you now try

• Debug->Build Solution (or use F7 for build, or Ctrl-Alt-F7 for Rebuild)

the program will be rebuilt.

Start it again, using

• Debug->Start Debugging (or use Ctrl-F5)

and it will connect to the GUI again.

When tired of running the GUI, close it by using File->Exit