Getting Started

Linux1394 Web

B. Installation

1. Install the adapter card into your computer and make sure everything is still working before continuing.
2. Download libraw1394.
   You can save this where you choose—your home directory, /tmp, /usr/src, etc.
3. If you have kernel 2.4.18+, skip to point 7.
   If you have kernel 2.4.12+, skip to point 6.
   
   Download the kernel patch. (Only required for kernel 2.2.x).
   Kernel 2.4.2+ users should download this patch.
   Kernel 2.4.0/2.4.1 users should download this patch.
   Save the file to /usr/src.
4. Prepare the kernel. If you are using X, open a terminal.
   cd /usr/src
   su (you need to be root for the remainder of the installation)
   
   The patch assumes you have symbolic links /usr/src/linux-2.2 and /usr/src/linux-2.2.orig. Point /usr/src/linux-2.2 to your kernel source directory:
   ln -s kernel-source-2.2.19 linux-2.2
   
   If you want to keep a known good copy of your custom kernel, then copy it and point /usr/src/linux-2.2.orig to it:
   cp -a kernel-source-2.2.19 kernel-source-2.2.19.orig
   ln - s kernel-source-2.2.19.orig linux-2.2.orig
   
   If you are not concerned about a backup copy, then you should still point linux-2.2.orig to the kernel source:
   ln -s kernel-source-2.2.19 linux-2.2.
    
5. Apply the kernel patch.
   zcat ieee1394-2.2.19-20010527.gz | patch -p0
6. Since this is still beta software, you may need to update the driver from the Subversion repository to get the latest release.
7. Configure the kernel:
   make xconfig, or
   make menuconfig
   1. In Code Maturity Options, enable Prompt for Development/Experimental drivers:
      
       
   2. In Linux IEEE 1394 Subsytem, enable IEEE 1394, OHCI 1394, and Raw 1394 support options either as modules (m):
      
      
      or compiled-in (y):
      
      
      We recommend modules; however, some users have reported the need to compile the drivers into the kernel. Really, you should only need to compile the driver into the kernel if you intend to boot off of a 1394 mass storage; however, no one has reported having done this successfully or even attempted this for that matter!
   3. Click Main Menu.
   4. Save and Exit.
   
   Notes:
   • The Adaptec AIC-5800 driver is no longer being maintained. In fact, newer Linux 1394 versions do not contain it any more.
   • If you do not have an OHCI compliant adapter and you do not have a card based upon the Adaptec AIC- 5800 series chip, then you might have a TI PCILynx adapter. Please check your documentation or with the hardware vendor. If you have the TI PCILynx, then enable that option instead of OHCI.
   • At this time there are no known applications that use or require video1394. You do not need to select this, although it will not be harmful to at least enable it as a module. Do enable this option if you plan to do any development that requires isochronous transmit support.
8. Build the kernel and modules:
   make dep
   make bzImage
   make modules
9. Install the modules and kernel:
   make modules_install
   cp arch/i386/boot/bzImage /boot/vmlinuz-2.2
   lilo
   
   The last two lines are purely an oversimplified example. Install the kernel as you normally do. Remember, an understanding of kernel compilation and installation is a pre-requisite to the installation of ieee1394 and is beyond the scope of this document.

   IMPORTANT: always make sure your lilo.conf contains an entry to a known good kernel before running lilo and rebooting.

10. Compile libraw1394:
    cd /where/you/downloaded/libraw1394
    tar xvfz libraw1394-1.2.1.tar.gz
    cd libraw1394-1.2.1
    ./configure
    make
    make install
11. Create the raw device (/dev/raw1394):
    make dev
12. Reboot:
    shutdown -r now
13. After the system reboots, logon and load the modules:
    modprobe ohci1394
    modprobe raw1394
    
    Module dependencies should ensure that the ieee1394 subsytem module installs automatically. If you receive errors about unresolved symbols, then try the following:
    insmod ieee1394
    insmod ohci1394
    insmod raw1394

Did you run into a problem?

<< Previous: Requirements | Next: Testing >>