<?xml version="1.0" encoding="UTF-8"?>
<!--DOCTYPE component PUBLIC "-//OCERA//DTD component XML V1.0//EN" "file:component.dtd"-->
<component id="lincan" name="Linux CAN Driver" >
<!-- id = id of the component (candev,canmon,canvca,lincan,ethanal,ethdev,verbus or versched) -->
<!-- name = short title of the component -->
	<title>Linux CAN Driver (LinCAN)</title>
	
	<info>
		<authorgroup>
			<author>
				<firstname>Pavel</firstname>
				<surname>Pisa</surname>
				<affiliation>
					<orgname>CTU</orgname>
				</affiliation>
				<email>
					<!-- url = mailto:your_email -->
					<ulink url="mailto:pisa@cmp.felk.cvut.cz">pisa@cmp.felk.cvut.cz</ulink>
				</email>
			</author>
			<author>
				<firstname>Arnaud</firstname>
				<surname>Westenberg</surname>
				<affiliation>
					<orgname>Unknown</orgname>
				</affiliation>
				<email>
					<!-- url = mailto:your_email -->
					<ulink url="mailto:arnaud@wanadoo.nl">arnaud@wanadoo.nl</ulink>
				</email>
			</author>
			<author>
				<firstname>Tomasz</firstname>
				<surname>Motylewski</surname>
				<affiliation>
					<orgname>BFAD GmbH</orgname>
				</affiliation>
				<email>
					<!-- url = mailto:your_email -->
					<ulink url="mailto:T.Motylewski@bfad.de">T.Motylewski@bfad.de</ulink>
				</email>
			</author>
		</authorgroup>
		<copyright>
			<year>2004</year>
			<holder>OCERA Consortium</holder>
		</copyright>
		<!-- id = number of workpackage -->
		<deliverable file="ms4-month24/WP7/D7.4.pdf" />
                <doc src="doc/lincandoc-0.3.pdf">PDF</doc>
    <workpackage id="WP7"></workpackage>
		<!-- release = release date -->
		<!-- start = 01/07/2002 -->
		<date release="28/05/2006" start="01/07/2002"></date>
		<!-- value = version number -->
		<version value="0.3.3" 
                         cvs="comm/can/lincan"></version>
		<notice>
		 This component can be used outside of the OCERA framework.
		</notice>
		<license value="GPL"></license>
		<!-- value = status (Analysis, Design, Alpha, Beta, Testing or Stable) -->
		<status value="Stable"></status>
		<home-page url="http://www.ocera.org">OCERA</home-page>
		<home-page url="http://freshmeat.net/projects/lincan/">FreshMeat</home-page>
		<home-page url="http://sourceforge.net/project/showfiles.php?group_id=51629&amp;package_id=108731">Sourceforge</home-page>
		<!-- processor = target procesor (i386, PowerPC, ARM or Independent) -->
		<!-- board = optional attribute - board model -->
		<hardware processor="Independent"></hardware>
		<!-- rtlinux = version of target OS -->
		<!-- linux = version of target OS -->
		<platform rtlinux="3.1"></platform>
		<!-- value = type of the component (LowLevel, HighLevel or Application) -->
		<componenttype value="HighLevel"></componenttype>		
		<keywords>CAN, Linux, device driver</keywords>
		<!-- reviewer info -->
		<reviewergroup>
			<author>
				<firstname>Frantisek</firstname>
				<surname>Vacek</surname>
				<affiliation>
					<orgname>CTU</orgname>
				</affiliation>
				<!-- url = mailto:his/her_email -->
				<email><ulink url="milto:vacek@rtime.felk.cvut.cz">vacek@rtime.felk.cvut.cz</ulink>
				</email>
			</author>
		</reviewergroup>
	</info>
	<!-- ================================================== Description -->
	<description>
		The LinCAN is an implementation of the Linux device driver supporting
		more CAN controller chips and many CAN interface boards. The driver
		roots can be traced to LDDK project. The OCERA version of the LinCAN driver
		adds new features, continuous enhancements and reimplementation of
		structure of the driver. The usage of the driver is tightly coupled to
		the virtual CAN API interface component which hides driver low level
		interface to the application programmers. Driver enables multiple opens
		of each communication objects from more Linux and RT-Linux applications.
		The message processing is based on the oriented graph of FIFOs concept.
	</description>
	<!-- ================================================== Readme -->
	<readme>
		The LinCAN version 0.3.x has been successfully tested with 
		  - PC104 Advantech PCM3680 dual channel board on 2.4 RT-Linux enabled kernel
  		  - PiKRON ISA card on 2.4.and 2.6 Linux kernels
  		  - PiKRON CAN extension board for PiMCX1 ARM BCC on 2.6 Linux kernels
  		  - BfaD DIMM PC card on 2.4 RT-Linux enabled kernel
		  - KVASER pcican-q on 2.6 Linux kernel
		  - MICROSPACE msmcan on 2.4 Linux kernel with and without RT-Linux support
		  - virtual board tested on all systems as well
		There is included support for more than 15 other boards in the LinCAN driver,
		but we do not possess these cards and cannot test support for these cards.
	</readme>
	<!-- ================================================== Readme -->
	<install>
		<!-- Install info if any. Example:-->
		<!-- The code is distributed as a patch file against rtlinux-3.1 source
    code plus some new files (examples + doc). In order to install,
    please follow next steps:
	(1) Configure Makfile variables.
		edit Makefile and set RTLINUX variable 
		to your RTLinux copy path.
	(2) Type make install
	(3) Change to the RTLinux directory. (3.a) type make xconfig. (3.b) 		 
		enable posix signals.
		(3.c)type make clean ; make-->
		The LinCAN make solutions tries to fully automate native
		kernel out of tree module compilation. Make system recurses through
		kernel Makefile to achieve selection of right
		preprocessor, compiler and linker directives. 
		The cross-compilation is also possible. Read README file, please.
		
		Change current directory into the LinCAN driver source root
                directory ("cd lincan-dir") and invoke "make" and "make install".
		
		Then insert module into the running Linux kernel with parameters
		appropriate to your CAN card ("insmod can.o hw=pip5 irq=4 io=0x8000").
		Please, read associated README file to find full description
		of module parameters.
	</install>
</component>

