The VMWos -- an operating system by Vincent M. Weaver


History:
~~~~~~~~
	This project originated from code written for the
	ECE598 Advanced Operating System class
	at the University of Maine.

Building:
~~~~~~~~~

	You will either need to build natively on an ARM
	machine or cross compile.

	Quickstart Debian:
		apt-get install genromfs gcc-arm-none-eabi

	To build natively, edit Makefile.inc and make
	the CROSS variable be empty.

	Otherwise, edit Makefile.inc to point to your
	cross compiler.

	It is possible to build this on OSX and Windows,
	I should update with instructions.

	Running "make" should build kernel/kernel.img
	
Installing:
~~~~~~~~~~~
	You need an SD card with an existing OS install
	that you don't care about (raspbian works great).

	Mount the boot directory on that SD card, and copy
	the existing kernel.img to a safe place.

	Now copy your vmwos kernel/kernel.img overtop
	of the existing kernel.img


Required Hardware:
~~~~~~~~~~~~~~~~~~

	Currently VMWos runs on any Raspberry Pi 
	Model A, B, B+ or A+.

	It will not run on a Raspberry Pi 2 without some
	changes to the OS (but it should be possible).

	Running on a Pi 3 will be a lot harder.

	It will drive an HDMI screen, but has no support
	for USB input.

	To get full input/output you will need to buy a USB/Serial
	adapter and connect to another machine running a terminal
	program such as minicom.


Using:
~~~~~~
	It is currently fairly limited.
	
	Assuming you have booted properly into the shell, you can
	run "help" to get a list of supported commands.

	Also "ls" should work.

Compiling user programs:
~~~~~~~~~~~~~~~~~~~~~~~~
	See the examples in ./userspace

	Right now you need to create a binary with -fPIC and use
	objcopy to create a RAW binary.
	I can't seem to find a working ARM binflt toolchain.

	There is a simple C library included ("vlibc")


For more information:
~~~~~~~~~~~~~~~~~~~~~

	See http://www.deater.net/weave/vmwprod/vmwos


Vince Weaver
vince@deater.net
20 May 2016