USB support for MOL ?

[Samuel Rydh]

On Fri, Feb 07, 2003 at 12:58:03PM +0100, Laurent Vivier wrote:
> So, I will try, but I'm not an USB expert ;-)
> (I need this feature to use my printer and my webcam with MOL)
> 
> Do you know where I can find OHCI specs used for Macs ?

http://www.usb.org carries all the official specifications.

> Some hints about developping in MOL ?

Well, MOL is highly modular so you shouldn't have to get your hands
too dirty :-). Here is a brief overview of the different
parts of MOL:


------------------------------------------------------------------
 The Source
------------------------------------------------------------------

src/main
--------
Provides services to the rest of mol, in paticular:
	
	async.c		asynchronous I/O
	thread.c	thread handling
	timer.c		timer services
	res_manager.c	interface to the molrc config file
	os_interface.c	mol <-> guest OS communication
	memory.c	handles the RAM
	promif.c	interface to the OpenFirmware device tree

src/cpu
-------
Userspace part of the mol engine. This part of mol contains the
mainloop. It also handles transitions from the virtualization 
mode to the mol userspace process.

src/drivers
-----------
Responsible for I/O (and hardware emulation).

src/lib
-------
A few useful library type functions (e.g. strncpy0).

src/kmod
--------
MOL kernel module. Handles the virtualization (MMU, emulation
of supervisor instructions and other things).

src/netdriver
-------------
Kernel modules for MOL networking. The tun and ethertap
modules are copies of the kernel ones (included for
convenience).

src/booter
----------
Responsible for loading the boot-loader and for boot-loader
interaction. The loaders themselves are stand alone ELF binaries
and run within the MOL engine. The following boot-loaders are
available:

	of		Minimal OF implementation, used to boot
			MacOS or yaboot

	bootx		Slightly modified version of Apple's
			bootx loader (user to boot MacOS X)
	
	keyremap	The keyboard configuration program
	
	selftest	The 'startmol --test' program

Note that the source to the 'of' and 'bootx' loaders are not
in the main mol source tree (they have BitKeeper repositories of
their own).

src/molelf
----------
Source of the 'keyremap' and 'selftest' programs (runs within
the MOL engine).

src/vconfig
-----------
The stand alone 'molvconfig' program, used to configure the
full-screen modes.

src/debugger
------------
Provides a nub to the MOL debugger. Logging etc. are also
done from here. It also contains a useful interface for
adding debugger commands.

src/debugger/deb, src/debugger/mon
----------------------------------
Stand alone MOL-debugger (invoked through startmol --debug).

src/shared
----------
Header files included both by the mol userspace process and
by the kernel module (mostly low-level stuff).

src/include
-----------
Header files with a global scope (most subdirectories
have include directories of their own for headers that are
more local).


--------------------------------------------------------------
 Other stuff
------------------------------------------------------------------

util/		debugging utilities (mostly obsolete stuff)
scripts/	build helpers
mollib/		config and binary support files
libimport/	'make libimport' cache. The contents
		of this directory is integrated into mollib/.

The following mollib/ files are of particular interest:

oftrees/oftree.nw:
------------------
The OpenFirmware device tree for NewWorld booting. MOL uses this
file to configure the virtual machine. (For instance, when MOL sees
the mol-audio node, it initializes the audio driver and so on. The
device tree is also exported to MacOS.)

oftrees/oftree.x:
-----------------
Same as above (but for MacOS X).

config/molrc.{sys,post}
-----------------------
Config files (parsed before/after /etc/mol/*).


/Samuel