genode

mirror of https://github.com/genodelabs/genode.git synced 2024-12-21 22:47:50 +00:00

History

Josef Söntgen 35239b84df dde_kit: remove jiffies alias The alias is rather Linux-specific and also prevents particularly tailored jiffies implementations. For the existing dde_linux ports (usb and lxip) we just define jiffies to be dde_kit_timer_ticks with a preprocessor macro.		2014-10-21 11:05:15 +02:00
..
include/lxip	Move repositories to 'repos/' subdirectory	2014-05-14 16:08:00 +02:00
lib/mk	dde_linux: Update to Linux 3.14.5	2014-08-28 12:35:55 +02:00
patches	dde_linux: Update to Linux 3.14.5	2014-08-28 12:35:55 +02:00
ports	dde_linux: USB SOF IRQ filter for Raspberry Pi	2014-10-13 14:53:00 +02:00
run	Log name of exiting child from Child::exit()	2014-09-11 10:23:39 +02:00
src	dde_kit: remove jiffies alias	2014-10-21 11:05:15 +02:00
files.list	dde_linux: Update to Linux 3.14.5	2014-08-28 12:35:55 +02:00
lxip_header.list	dde_linux: Update to Linux 3.14.5	2014-08-28 12:35:55 +02:00
Makefile	Enable hash checks for ports mechanism	2014-05-27 13:45:03 +02:00
README	Move repositories to 'repos/' subdirectory	2014-05-14 16:08:00 +02:00

README

Device drivers ported from the Linux kernel

USB
###

Controller configuration
~~~~~~~~~~~~~~~~~~~~~~~~

The driver can be started using different or all USB controller types a platform
offers (USB 1.0/2.0/3.0). Note that not all controllers are supported by all
platforms.  Controllers can be enabled as attribute in the config node of the
driver.  Supported attributes are: 'uhci', 'ehci', and 'xhci'.


Configuration snippet to enable UHCI and EHCI

! <config uhci="yes" ehci="yes">

HID
~~~

Supports keyboard and mouse. A run script can be found under 'run/usb_hid.run'.

Configuration snippet:

!<start name="usb_drv">
!  <resource name="RAM" quantum="3M"/>
!  <provides><service name="Input"/></provides>
!  <config uhci="yes" ehci="yes" xhci="yes">
!    <hid/>
!  </config>
!</start>

Note: It has been observed that certain 1.0 versions of Qemu do not generate
mouse interrupts. The mouse driver should work correctly on Qemu 1.0.93 and
above.

Storage
~~~~~~~

Currently supports one USB storage device. Hot plugging has not been tested. A
run script can be found under 'run/usb_storage.run'.

Configuration snippet:

!<start name="usb_drv">
!  <resource name="RAM" quantum="2M"/>
!  <provides> <service name="Block"/> </provides>
!  <config><storage /></config>
!</start uhci="yes">


Network (Nic)
~~~~~~~~~~~~~

Configuration snippet:

!<start name="usb_drv">
!  <resource name="RAM" quantum="3M"/>
!  <provides>
!    <service name="Nic"/>
!    <service name="Input"/>
!  </provides>
!  <config ehci="yes" xhci="yes">
!    <nic mac="2e:60:90:0c:4e:01" />
!    <hid/>
!  </config>
!</start>

Please observe that this setup starts the HID and Nic service at the same time.
Also there is the 'mac' attribute where one can specify the hardware address of
the network interface. This is necessary in case the EEPROM of the network card
cannot be accessed via the host controller making it impossible to retrieve the
devices hardware address. If this is the case and no 'mac' attribute is given a
fallback address will be assigned to the network device. Note that the fallback
address will always be the same.

LXIP
####

LXIP is a port of the Linux TCP/IP stack to Genode. It is build as a shared
library named 'lxip.lib.so'. The IP stack can be interfaced using Genode's
version of 'libc' by linking your application to 'lxip_libc' plugin in your
'target.mk' file.