Directions for upgrading the IVTV drivers on your KnoppMyth system and doing related reconfiguration.

To upgrade KnoppMyth R5A22 through R5C7 to 0.4.7 or 0.4.8 - Follow all the numbered steps below unless otherwise indicated.

To upgrade KnoppMyth R5D1 to 0.7.1 or 0.7.2 - Only do steps 1, 2, 3, and 10, substituting the appropriate kernel and driver versions.

To upgrade systems using kernel 2.6.18 to 0.8.2 - Only do steps 1, 2, 3, and 10, substituting the appropriate kernel and driver versions.

To upgrade systems using kernel 2.6.18 or later to 0.10.0 - See the CompileIvtv-0.10.0 page.

If you want to use an another ivtv driver which is compatible with your kernel, just substitute it's version for "0.4.7" below, however, older drivers may not compile with newer kernels and vice-versa.

• If your kernel is 2.6.15 or older you must use one of the 0.4.x series drivers.

• If your kernel is 2.6.16 you must use one of the 0.6.x series drivers.

• If your kernel is 2.6.17 you must use one of the 0.7.x series drivers.

• If your kernel is 2.6.18 you must use one of the 0.8.x or 0.10.x series drivers.

You can not mix and match, ivtv 0.8.x does not work with kernel 2.6.17 and vice-versa.

For more details of what has been fixed and changed between the release you are currently using and the newer ones in that series, see the appropriate change logs for your driver version here:

• http://dl.ivtvdriver.org/ivtv/stable/ChangeLog-0.4
• http://dl.ivtvdriver.org/ivtv/stable/ChangeLog-0.6
• http://dl.ivtvdriver.org/ivtv/stable/ChangeLog-0.7
• http://dl.ivtvdriver.org/ivtv/stable/ChangeLog-0.8

All of the following commands must be run as root.

1. Find and unpack the Linux kernel source if this hasn't already been done. If you don't see a directory called kernel-source-2.6.13.2-chw-3 (or kernel-source-2.6.15-chw-2, or something else like that) when you do the "ls" command below, then unpack the archive using the "tar" command shown. Note that the name of the kernel "tar ball" may include a different version. If so, "Don't Panic!" Just go with it using that name.

    cd /usr/src/
    ls -ald kernel-source*
    tar jxvf kernel-source-2.6.15-chw-2.tar.bz2  # Change this name to match what you have!
    

2. Download the new driver code. For other versions, adjust the file and directory names below appropriately. (e.g "0.4.x" -> "0.7.x" or "ivtv-0.4.7.tar.gz" -> "ivtv-0.7.1.tar.gz")

    cd /usr/src
    ls -al ivtv-0.4.7.tar.gz    # Make sure it's not already there
    wget http://dl.ivtvdriver.org/ivtv/archive/0.4.x/ivtv-0.4.7.tar.gz
    

3. Unpack the new driver code, make any patches then build and install the module. Again, adjust the file and directory names below to match the version that you're installing.

    cd /usr/src
    tar zxvf ivtv-0.4.7.tar.gz
    cd ivtv-0.4.7/
    # This is where you would make any needed patches to the driver code!
    make
    make install
    

4. The 0.4.6 and 0.4.7 drivers install new cx25840.ko, saa7127.ko, tda9887.ko, tuner.ko and tveeprom.ko modules in /lib/modules/2.6.15-chw-2/ivtv. The version number in this directory name may differ based on which kernel you're using. Rename the generic v4l versions (note the different directory) to avoid using the wrong ones. Remember, these changes won't take effect until you reboot.

    cd /lib/modules/2.6.15-chw-2/kernel/drivers/media/video
    # If the "cd" command fails, fix the version number above
    for module in cx25840/cx25840.ko saa7127.ko tda9887.ko tuner.ko tveeprom.ko ; do
        mv $module $module.orig
    done
    

5. Get the recommended firmware in the hotplug directory where the current drivers expect it. The firmware listed here should work for most of the 0.4.x, 0.7.x, and 0.8.x series drivers. You should check here http://ivtvdriver.org/index.php/Firmware to make sure that there isn't a more recent version recommended. Remember, you may need to turn the machine off completely, and leave it off for several minutes, for the old firmware to be cleared from the PVR cards memory.

    cd /usr/src
    wget http://dl.ivtvdriver.org/ivtv/firmware/firmware.tar.gz
    cd /usr/lib/hotplug/firmware/
    tar zxvf /usr/src/firmware.tar.gz
    

6. Check the file signatures to make sure they're right. Note that if you follow a recommendation on the IVTV Firmware page to use a newer version, the MD5 sums will likely be different than these. In that case, make sure that they match the ones listed on the IVTV page. These may also be different for releases of KnoppMyth newer than R5D1.

    md5sum /usr/lib/hotplug/firmware/v4l-*
    

They should be:

    305dba74bbe5905447add8883f3ecb68 /usr/lib/hotplug/firmware/v4l-cx2341x-dec.fw
    d85cb08382395390dc95ac6ebc2205f9 /usr/lib/hotplug/firmware/v4l-cx2341x-enc.fw
    0661f8b2693fe3123e6234557353eacc /usr/lib/hotplug/firmware/v4l-cx2341x-init.mpg
    99836e41ccb28c7b373e87686f93712a /usr/lib/hotplug/firmware/v4l-cx25840.fw
    34d213394328adf78e2fc9f1411691b0 /usr/lib/hotplug/firmware/v4l-pvrusb2-24xxx-01.fw
    3b7288416144467369ed2b5b10cf931d /usr/lib/hotplug/firmware/v4l-pvrusb2-29xxx-01.fw
    

8. Edit your /etc/mythtv/modules/ivtv file and remove the "simple=1" option for msp3400. If it has already been done, the following command is a harmless "no-op".

    sed -i.orig -e '/options msp3400/s/simple=1//' /etc/mythtv/modules/ivtv
    

9. Edit your /etc/modules file and remove the line that says "ivtv" around line 45. If it has already been done, the following command is a harmless "no-op".

    sed -i.orig -e '/ivtv/d' /etc/modules
    

10. Reboot the system. Do not skip this step!!!

11. After the system comes back up you will need to drop and recreate your cards definitions in mythtv-setup. See the directions for GettingBackIntoMytTVsetup for more detail. Do not skip this step!!!

• Stop the backend (as root, /etc/init.d/mythtv-backend stop)
• Run mythtv-setup
• Clear all of your capture card settings by choosing the option to "(Delete all capture cards)" under "2. Capture cards"
• Restablish them using the "(New capture card)" option under "2. Capture cards"
• Setup the correct mappings from capture card input to video source under "4. Input connections".
• Exit mythtv-setup
• Restart the backend (as root, /etc/init.d/mythtv-backend start)

Note that because of the changes in the drivers you may see a different set of input names for your cards. The changes to the names and internal numbering of the inputs on each card are why you must do this after an upgrade, so that the DB isn't pointing to the old numbers.