- 1 Introduction
- 2 Version information
- 3 Before you begin
- 4 Installing the NVIDIA Driver
- 5 Common problems and solutions
- 5.1 Blue line(s) surrounding picture
- 5.2 Black-and-White output
- 5.3 Annoying NVIDIA logo?
- 5.4 Small (unreadable) fonts or too big fonts?
- 5.5 System instability
- 5.6 Choppy video/High CPU Usage
- 5.7 Half vertical resolution on video playback/Blurry OSD
- 6 Configure the monitor!
- 7 User experience with NVidia cards
- 8 Links to additional info
NVIDIA does not provide the documentation for their hardware, which is necessary in order for programmers to write appropriate and effective open source drivers for NVIDIA's products. Instead, NVIDIA provides their own binary graphics drivers for X.Org. This closed source driver is referred to as the NVidia Proprietary Video Driver.
This document describes how to use the NVIDIA Proprietary Video driver. The latest driver can be downloaded from the NVIDIA download site
Released on 17 June 2008
Latest release version more
Released on February 26, 2008
Latest release version more
Released on January 29, 2008
Latest legacy GPU version more
Released on January 29, 2008
Latest (additional) legacy GPU version for staggeringly old cards more
To determine your current version try
$ cat /proc/driver/nvidia/version NVRM version: NVIDIA UNIX x86 Kernel Module 173.14.09 Wed Jun 4 23:43:17 PDT 2008 GCC version: gcc version 4.1.2 20070925 (Red Hat 4.1.2-33)
Resolutions supported by the driver depend on the card in use. But most cards have a TV-encoder onboard (the actual IC making the TV-Out connector(s) work) with only support for a few (lower) resolutions... all 4x3 aspect ratio :-(
Here's the list:
- 720x576 (actually a very very good resolution for (european) TVs using the PAL TV-standard!)
Before you begin
Is your card supported?
Check if your card is supported by the driver, a list of supported hardware can be found in Appendix A of the README file.
Make sure you check the hardware list from the lastest version of the driver. As an example, (here is Appendix A from version 100.14.11) Also check the specs of your card, some integrated cards do not support dual screen. (pc screen and TV-out)
There are no published plans by Nvidia to support XvMC in the 8xxx series, which may make hardware assisted high def playback problematic.
How is your TV connected? (TV-Out)
The type of output your video card can do, and the type of inputs your display device can handle are primarily what dictates what you should use to connect them. From highest- to lowest-quality, the order of consideration is: HDMI, DVI (both of which are digital), VGA, Component, S-Video and finally Composite (all of the rest are analog). Suggest you to read this http://www.mythtv.org/wiki/index.php/Highly_Technical_Details
What's your Television Broadcast Standard
Depending on your country, you use NTSC, (National Television Standards Committee) or PAL, (Phase Alternating Line) for you Television Broadcast Standard.
PAL-B used in Australia, Belgium, Denmark, Finland, Germany, Guinea, Hong Kong, India, Indonesia, Italy, Luxembourg, Malaysia, The Netherlands, New Zealand, Norway, Portugal, Singapore, Spain, Sweden, and Switzerland
PAL-D used in China and North Korea
PAL-G Denmark, Finland, Germany, Italy, Luxembourg, Malaysia, The Netherlands, Norway, Portugal, Spain, Sweden, and Switzerland
PAL-H used in Belgium
PAL-I used in Hong Kong and The United Kingdom
PAL-K1 used in Guinea
PAL-M used in Brazil
PAL-N used in France, Paraguay, and Uruguay
PAL-NC used in Argentina
NTSC-J used in Japan
NTSC-M Canada, Chile, Colombia, Costa Rica, Ecuador, Haiti, Honduras, Mexico, Panama, Puerto Rico, South Korea, Taiwan, United States of America, and Venezuela
Installing the NVIDIA Driver
Some distributions come with the NVidia driver in their package management system, however mostly this is NOT the current version. If your distribution does not ship the driver, or you have other reasons to install the latest driver from NVidia, everything you need to get this working you will find in the README file from the driver; read the chapter Configuring TV-Out.
openSUSE is a distribution which has packages for the driver. Please see the opensuse NVIDIA section on how to install the driver.
Debian also has packages available to install the driver. Note that these are in the non-free section. The following command gives an overview of the available packages:
root@mast:~# apt-cache search nvidia | grep ^nvidia nvidia-xconfig - The NVIDIA X Configuration Tool nvidia-cg-toolkit - NVIDIA Cg Toolkit installer nvidia-kernel-common - NVIDIA binary kernel module common files nvidia-settings - Tool of configuring the NVIDIA graphics driver nvidia-glx - NVIDIA binary XFree86 4.x driver nvidia-glx-dev - NVIDIA binary XFree86 4.x / Xorg driver development files nvidia-glx-legacy - NVIDIA binary Xorg driver (legacy version) nvidia-glx-legacy-dev - NVIDIA binary Xorg driver development files nvidia-kernel-2.6-486 - NVIDIA binary kernel module for 2.6 series compiled for 486 nvidia-kernel-2.6-686 - NVIDIA binary kernel module for 2.6 series compiled for 686 nvidia-kernel-2.6-k7 - NVIDIA binary kernel module for 2.6 series compiled for k7 nvidia-kernel-2.6.18-4-486 - NVIDIA binary kernel module for Linux 2.6.18-4-486 nvidia-kernel-2.6.18-4-686 - NVIDIA binary kernel module for Linux 2.6.18-4-686 nvidia-kernel-2.6.18-4-k7 - NVIDIA binary kernel module for Linux 2.6.18-4-k7 nvidia-kernel-2.6.18-5-486 - NVIDIA binary kernel module for Linux 2.6.18-5-486 nvidia-kernel-2.6.18-5-686 - NVIDIA binary kernel module for Linux 2.6.18-5-686 nvidia-kernel-2.6.18-5-k7 - NVIDIA binary kernel module for Linux 2.6.18-5-k7 nvidia-kernel-legacy-2.6-486 - NVIDIA binary kernel module for 2.6 series compiled for 486 nvidia-kernel-legacy-2.6-686 - NVIDIA binary kernel module for 2.6 series compiled for 686 nvidia-kernel-legacy-2.6-k7 - NVIDIA binary kernel module for 2.6 series compiled for k7 nvidia-kernel-legacy-2.6.18-4-486 - NVIDIA binary kernel module for Linux 2.6.18-4-486 (legacy version) nvidia-kernel-legacy-2.6.18-4-686 - NVIDIA binary kernel module for Linux 2.6.18-4-686 (legacy version) nvidia-kernel-legacy-2.6.18-4-k7 - NVIDIA binary kernel module for Linux 2.6.18-4-k7 (legacy version) nvidia-kernel-legacy-2.6.18-5-486 - NVIDIA binary kernel module for Linux 2.6.18-5-486 (legacy version) nvidia-kernel-legacy-2.6.18-5-686 - NVIDIA binary kernel module for Linux 2.6.18-5-686 (legacy version) nvidia-kernel-legacy-2.6.18-5-k7 - NVIDIA binary kernel module for Linux 2.6.18-5-k7 (legacy version) nvidia-kernel-legacy-source - NVIDIA binary kernel module source (legacy version) nvidia-kernel-source - NVIDIA binary kernel module source
You need to install the packages nvidia-glx, nvidia-kernel-common, the package for your running kernel and for easy configuration nvidia-xconfig. Issue the following command:
apt-get install nvidia-glx nvidia-kernel-common nvidia-kernel-`uname -r` nvidia-xconfig
Common problems and solutions
Here is a test image for your TV-Out
click image to enlarge
Blue line(s) surrounding picture
One common symptom is the following: the NVidia driver may (or may not) give one or more blue lines surrounding the display during TV or DVD playback. This is something which is mostly seen on widescreen TV displays. The 'xvattr' command can be used to solve the problem:
xvattr -a XV_COLORKEY -v 66048
Add the command somewhere in the Xorg startup sequence. This may be done in various ways depending on your Linux distribution (need more distribution-specific information on this item!)
Solution for Ubuntu and Debian GNU/Linux 4.0
Create the following file:
and add the following contents:
#!/bin/sh xvattr -a XV_COLORKEY -v 66048
Restart your graphical environment and you're done!
Solution for openSUSE
#disable-blueline: xvattr -a XV_COLORKEY -v 66048
more on openSUSE and NVidia http://www.suse.de/~sndirsch/nvidia-installer-HOWTO.html
There are at least five possible causes:
Make sure the TVStandard option is set to the one valid for your country. Many nVidia cards default to the American TVStandard 'NTSC'. For a mythtv box in the Netherlands use the following option in the 'Device' section in xorg.conf:
Option "TVStandard" "PAL-B"
If you're in the UK, use:
Option "TVStandard" "PAL-I"
Many other variations of PAL and other standards are supported. For a complete list, see the nVidia "readme" for your driver version (see the nVidia Linux driver download page).
Vertical Refresh Frequency
Some televisions will show a black-and-white image if you attempt to display video using an unexpected vertical refresh frequency, e.g. showing PAL-I format video at 60Hz instead of 50Hz. This is because the TV may use the vertical refresh frequency to decide whether it should be decoding PAL (usually 50Hz) or NTSC (60Hz). Either change the TVStandard (see above) to match the frequency, or change the frequency to match the video standard.
Some televisions support multiple video formats on a single SCART or S-VIDEO socket, but without auto-detection of the signal type. If you are seeing a sharp black and white image instead of a colour image, the nVidia card is probably outputting a Composite signal, but your TV is expecting S-Video. Either switch the TV to Composite or "AV" mode (not recommended), or set the following option in xorg.conf:
Option "TVOutFormat" "SVIDEO"
Conversely, to force Composite output (if your TV does not support S-VIDEO), use:
Option "TVOutFormat" "COMPOSITE"
S-Video generally has far superior image quality to composite video, especially from nVidia cards.
Annoyingly, some nVidia card/TV combinations will default to Composite mode at boot-time, meaning that your boot sequence will be in black and white until xorg.conf is loaded. (If anyone knows a fix for this (using different cables perhaps?), please insert it here!)
Television does not support S-Video
Some televisions do not support a S-Video signal on a SCART input. This results in only the luminance signal being used. A hack exists which merges the luminance and chroma signals on the SCART connector which essentially creates a composite signal that the television uses. This is performed by connecting pins 15 (chrominance in) and 20 (luminance in) on the SCART connector. This signal is unfiltered and is at best equal in quality to a direct composite connection. See this thread for further information.
Obvious perhaps, but make sure that the ends of your cables are firmly in place! (especially if you're using SCART/RGB sockets)
Annoying NVIDIA logo?
To disable the nVidia logo splash screen that is displayed when X is first initialized, you may use the following command to automatically edit your xorg.conf correctly:
For older driver versions or installations without nvidia-xconfig installed, one will have to manually edit their xorg.conf and add this line in the 'Device' section:
Option "NoLogo" "True"
Small (unreadable) fonts or too big fonts?
The entire GUI of Mythtv was designed for 100 DPI screens, and the fonts are based on that selection as well.
The first port of call if your graphics card is unstable is the README that is included with your Nvidia driver package. There may be an online version of the README linked from the Nvidia Linux driver page for your system's processor architecture.
You should also have a look at the Linux forums which are linked to from the same page.
Try to reduce the AGP speed down (this seems to be a problem with boards with VIA KT333 and KT400 chipsets and also earlier VIA chipsets). Follow the instructions in the README for configuring the AGP rate. With an MSI KT4 Ultra (MS-6590) and Nvidia GeForce 6200A video card, the default AGP speed of 8x made the system unstable. Once it was set to 4 the system became rock steady. The BIOS changes weren't tried, they may also have helped and avoided the need for the edit/recompile.
It's possible to perform initial testing by disabling AGP entirely using the NvAGP option in your X11 config file. Check the APPENDIX F, AGP section in the README for more details.
As noted in the NVidia release notes there are known issues with some VIA chipsets as found on Athlon XP mainboards; The KT266 and KT333 chipsets are known to have problems. The solution described in the releasenotes did not solve my instability problems. However, booting the system with the 'noapic' option appended to the kernel boot line was enough to get my system stable. --Michel 14:20, 26 March 2007 (UTC)
Choppy video/High CPU Usage
- Choppy video
- CPU usage near 100%
- Xorg using the most CPU time
- mythfrontend using the second most CPU time
- other processes using negligible CPU time
- Sync to VBlank set in nvidia-settings
Solution: Add the line
Option "UseEvents" "True"
to the Screen or Driver section of /etc/X11/xorg.conf.
From NVIDIA docs:
Option "UseEvents" "boolean":
Enables the use of system events in some cases when the X driver is waiting for the hardware. The X driver can briefly spin through a tight loop when waiting for the hardware. With this option the X driver instead sets an event handler and waits for the hardware through the ‘poll()’ system call. Default: the use of the events is disabled.
This goes from using a "busy" wait by default to a less CPU intensive system call: poll, ppoll - wait for some event on a file descriptor
However, this can cause problems on some hardware so if X starts getting flaky and crashing, set UseEvents back to false.
Half vertical resolution on video playback/Blurry OSD
This appears to be a known problem when using interlaced modelines and nVidia's implementation of the XVideo extension. Workarounds are to run mythfrontend with XVideo disabled using the NO_XV environment variable set to 1 (i.e. NO_XV=1 mythfrontend) if you have CPU to burn, or put up with using a software deinterlacer (I recommend Linear Blend, but your tastes may differ).
Configure the monitor!
The NVidiaProprietaryDriver supports monitors as well as TV screen (using TV-Out). To use a (wide-screen) TV as monitor, see XorgConfMonitorSectionForTV. If the basic TV configuration appears correctly, but the image does not fit exactly on your television set, you may need to adjust the overscan settings.
User experience with NVidia cards
- NVIDIA GeForce2 MX AGP: works (Michel: Nov 2006 )
- NVIDIA GeForce4 MX440 AGP: works (Michel: Nov 2006 )
- NVIDIA FX5200 AGP: works (Michel: Nov 2006 )
- NVIDIA FX5700LE AGP: works (MarcT: Jan 2008 )
- NVIDIA 6200LE PCI-e: works (Moosylog: Jan 2007 )
- NVIDIA Riva TNT2 AGP: defunct (Michel: Nov 2006 )
- NVIDIA Riva TNT AGP (also known as AGP-V3400): defunct (Michel: Nov 2006 )
More user experience can be found on the mythTV wiki TV Out page
Links to additional info
Internal mythTV wiki: