lincan/index.mdwn

   1 [[!meta title="LinCAN (CAN bus driver)"]]
   2
   3 LinCAN is a Linux kernel module that implements a CAN driver capable
   4 of working with multiple cards, even with different chips and IO methods.
   5 Each communication object can be accessed from multiple applications concurrently.
   6 It supports RT-Linux, 2.2, 2.4, and 2.6 with fully implemented select,
   7 poll, fasync, O_NONBLOCK, and O_SYNC semantics and multithreaded
   8 read/write capabilities. It works with the common Intel i82527,
   9 Philips 82c200, and Philips SJA1000 (in standard and PeliCAN mode)
  10 CAN controllers. It is part of a set of CAN/CANopen related components
  11 originally developed as part of OCERA framework. The CAN related components
  12 have been separated into its own OrtCAN repository.
  13
  14 [[The list of supported hardware and boards|boards]]
  15
  16 ## LinCAN Quick Build Instructions
  17
  18 There are more options to build LinCAN driver.
  19 The first one is to use standalone driver
  20 module build. The latest version of standalone LinCAN
  21 sources can be obtained from GIT repository and build
  22 by next commands
  23
  24     git clone git://ortcan.git.sourceforge.net/gitroot/ortcan/lincan
  25     cd lincan
  26     ./build-lincan.sh
  27
  28 The other option is to build LinCAN driver as part
  29 of the whole OrtCAN tree
  30
  31     git clone git://ortcan.git.sourceforge.net/gitroot/ortcan/ortcan
  32     cd ortcan/
  33     git submodule update --init
  34     make default-config
  35     make
  36
  37 The default configuration options should be overridden by user specified
  38 options in toplevel "config.omk" file before final "make" invocation.
  39 The choices 'y'/'n' can be specified to enable or disable build
  40 of specified hardware/board support, it would be next line in "config.omk"
  41 file for [[tscan1|boards/tscan1]] card for example
  42
  43     CONFIG_OC_LINCAN_CARD_tscan1=y
  44
  45 If the build should target other then actually running kernel then
  46 *LINUX_DIR* option in "config.omk" file is used to specify location,
  47 where kernel has been build. If a build for non-native architecture
  48 is required then cross-compiler binaries have to be specified
  49
  50     LINUX_DIR=/usr/src/linux-2.6-mpc51200-build
  51     CC=powerpc-linux-gnu-gcc
  52     CXX=powerpc-linux-gnu-g++
  53     AR=powerpc-linux-gnu-ar
  54     LD=powerpc-linux-gnu-ld