After a lot a retries to get the rigth experience with the Crystal HD on Ubuntu,
1. Install required files
sudo apt-get install checkinstall git-core autoconf build-essential subversion dpkg-dev fakeroot pbuilder build-essential dh-make debhelper devscripts patchutils quilt git-buildpackage pristine-tar git yasm zlib1g-dev zlib-bin libzip-dev libx11-dev libx11-dev libxv-dev vstream-client-dev libgtk2.0-dev libpulse-dev libxxf86dga-dev x11proto-xf86dga-dev git libgstreamermm-0.10-dev libgstreamer0.10-dev automake libtool python-appindicator
2. Ge the source
Get the driver source code from the git repository.
git clone https://github.com/dbason/crystalhd.git
The original repo source is available at git://git.linuxtv.org/jarod/crystalhd.git
3. Compile driver, install libraries, and load driver
Use make command to compile driver. If you have multiple core processor then use the “-j2″ or “-j4″ option (2 or 4 is the number of cores). This will speed up the make process.
cd crystalhd/driver/linux
autoconf
./configure
make -j2
sudo make install
4. Install the libraries.
cd ../../linux_lib/libcrystalhd/
make -j2
sudo make install
5. Load the driver.
sudo modprobe crystalhd
6. Reboot your system , then check if 'crystalhd' is listed in the output of the following commands.
lsmod
dmesg | grep crystalhd
Then you should see something like this:
[ 4.349765] Loading crystalhd v3.10.0
[ 4.349823] crystalhd 0000:02:00.0: Starting Device:0x1615
[ 4.351848] crystalhd 0000:02:00.0: irq 43 for MSI/MSI-X
[ 108.512135] crystalhd 0000:02:00.0: Opening new user[0] handle
[ 258.976583] crystalhd 0000:02:00.0: Closing user[0] handle via ioctl with mode 10200
Now is time to enjoy our FullHD content.
I'm using XMBC , VLC (2.1.0), Mplayer2, GStreamer because they are using (they should) the Crystal HD decoder libraries.
For example , lets try VLC :
vlc --codec=crystalhd ourgreatfullhdmedia.mkv
Now runs smoothly rigth ?
Reinstall the driver.
cd crystalhd/driver/linux
sudo make install
Btw this instructions referred to http://knowledge.evot.biz/documentation/how-to-compile-and-install-the-broadcom-crystal-hd-hardware-decoder-bcm70012-70015-driver-on-ubuntu and fixed some issues appeared using a patch from M25 user at https://bbs.archlinux.org/viewtopic.php?pid=1253622#p1253622
So, the sources on this repository are updated with the fixes and patches in order to make your life easier.
See HISTORY.md for a rough history of the various versions of this driver floating around the web.