Skip to content

ChakaZulu/tuxbox_driver

Repository files navigation

#
# $Id: README.firmware,v 1.6 2003/09/30 07:05:56 obi Exp $
#
# This document describes the binary firmware (so called microcode) which
# is needed to have a functional MPEG2 chipset in a dbox2.
#
# Copyright (C) 2002-2003 Andreas Oberritter <obi@tuxbox.org>
#
# Permission is granted to copy, distribute and/or modify this document
# under the terms of the GNU Free Documentation License, Version 1.2
# or any later version published by the Free Software Foundation;
# with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
# A copy of the license is included in common-licenses/FDL-1.2
#
# This document is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
#

Introduction:
-------------
Some drivers need to load binary firmware for the chips to operate.

Those are:
- avia_av (mpeg decoder, C-Cube AViA500/AViA600, "avia500.ux, avia600.ux")
- avia_gt (transport demux, C-Cube AViA-GTX/AViA-eNX, "ucode.bin")
- cam     (conditional access module, BetaResearch SEC, "cam-alpha.bin")

There are lots of different firmware versions available, but not every
difference is known. In fact, almost only the version numbers are known to be
different. See below for more about firmware versions.

Unfortunately, there is no official download location for them and - due to
unknown license terms - we can not provide these binaries next to the driver
sources.

However, there are several ways to get the firmware.


ucodex:
-------
You can use the microcode extraction utility "ucodex" to recursively scan
directories for firmware. You can get it from CVS and build it by using the
commands listed below. You must have openssl development headers installed on
your system to succeed. "ucodex" has been tested on Linux and FreeBSD, but it
should work on any platform which has a c-compiler and openssl.

   cvs -d:pserver:anonymous@cvs.tuxbox.org:/cvs/tuxbox -z3 co hostapps
   cd hostapps
   ./autogen.sh
   ./configure
   cd ucodex
   make
   make install

Syntax for execution is one of:
ucodex <filename>
ucodex <directory>


Extraction:
-----------

1. If you own a dbox2 which still has its original operating system or if you
   own a backup of it, then you can extract alle three files from it. See
   http://www.dietmar-h.net for details. This is the only way to get the cam
   firmware. Ensure that you have the latest and greatest version by doing a
   software update via cable or satellite before extracting. The current
   software version (2.01) contains the following firmware versions:
   avia500v110, avia600v022, cam_01_02_05[DEF], ucode_B107


2. Some other dvb receivers are equipped with the same mpeg chipset as the
   various versions of the dbox2. Some of them offer the possibility to perform
   software updates using a serial interface. For those, manufacturers provide
   updates to be downloaded via internet. Examples are:

   -------------------------------------------------------------------------
 
   http://www.media-com.com/downloads/vortec/downloadfiles/VS96PL500.exe
   (avia500v093, ucode_0014)
   
   http://www.media-com.com/downloads/vortec/downloadfiles/VS96PL600.exe
   (avia600vb017, ucode_0014)
 
   -------------------------------------------------------------------------

   http://www.micronik.de/software/MK12133.zip
   http://www.micronik.de/software/MK13133.zip
   (avia500v093, avia600vb028, ucode_001A)

   http://www.micronik.de/software/v12-111.zip
   http://www.micronik.de/software/v13-111.zip
   (avia500v093, avia600vb022, ucode_001A)

   These links are dead at the moment, but they are still on their web site,
   so maybe they will be working again in the future.

   You can still get the files from www.dvb-portal.de -> Downloads ->
   Micronik -> Firmware. Newer versions, at least up to 1.52a, contain the
   same microcodes as 1.33 does.

   -------------------------------------------------------------------------

   http://eubnet.de/sat/firmware/Radix/3ci17b.zip
   (avia500v083, ucode_0014)

   http://eubnet.de/sat/firmware/Radix/fta2ad38.zip
   (avia500v083, ucode_0013)

   -------------------------------------------------------------------------
   
   http://www.freesat.co.kr/service/service.html#direct
 
   There are some receivers which also use the AViA mpeg chipset. I do not
   remember which of them use it and my extraction utility fails. Detailed
   information and bugfixes are welcome.

   -------------------------------------------------------------------------

   You can extract the zip or exe archives using "unzip". Usually they
   contain files with the extesion bin or hex. Just run "ucodex" to extract
   the firmware from them.



Supported firmware status:
--------------------------
avia_av:
   All versions are known to work, but some show strange effects when using
   AC-3 audio output. Using the latest versions (avia500v110, avia600vb028)
   is recommended.

avia_gt:
   ucode_0013, ucode_0014:
   Known to work and hardware section filtering is supported.
   Special thanks go to PentaMedia (www.pentamedia.com) for providing a GPL
   driver for the GTX chipset including almost no source code. They use ucode
   version 0014 which is therefore now built into our driver, too. It is used
   if no other firmware is provided on the filesystem.

   ucode_001A, ucode_B102, ucode_B107, ucode_B121:
   Known to work but hardware section filtering is not supported by the driver.

   All other ucode versions are currently not supported by the driver. Bugfixes
   and documentation are always welcome.

cam:
   All known firmware versions are supported by the driver. However, command
   handling is done in userspace, thus userspace applications might need to
   change some bits depending on the used firmware version.
   Version strings usually have one of three suffixes: D, E or F.
   Each suffix matches special series of smart cards:

   cam_xx_yy_zzD: betacrypt D .... .... ... Z,
                  Nagravision K02

   cam_xx_yy_zzE: betacrypt C .... .... ... Z,
                  Nagravision A02,
                  Nagravision S02,
                  Nagravision P02

   cam_xx_yy_zzF: betacrypt F .... .... ... Z

betacrypt is a trademark of BetaResearch GmbH Germany. Nagravision is a
trademark of Kudelski S.A. Switzerland. The names of actual companies and
products mentioned herein may be the trademarks of their respective owners.

About

mirror of the tuxbox project: module driver

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published