$Id: README,v 1.9 2003/04/26 20:17:42 dick Exp $
======================================================================
mmtools - Command line tools for the Nokia Mediamaster running DVB2000
======================================================================


=====> Overview <=====

This package contains a number of tools that can be used in combination
with the Nokia Mediamaster 92XX, 95XX/D-Box or 96XX satellite receivers
running the DVB2000 firmware (see http://www.dominance.net/overflow/).
It will not work with the Nokia 9800. Make sure to use DVB2000 version
1.77.0 or higher. The CBEG D command doesn't seem to work on lower
versions, at least version 1.76.6 hangs if you try. The following tools
are included in this package:

mmlink
    The primary purpose of this tool is to upload or download the
    channel settings and the configuration options of DVB2000. You
    can also use it to upgrade the DVB2000 firmware, or to upload
    or download memory. Of course, this requires a null-modem cable
    between the PC and the Mediamaster.

mmchan
    Converts the (binary) channel settings file to a readable ASCII
    representation, or vice versa. You can edit the ASCII file with
    your favorite editor, convert it back to the binary format with
    this tool, and upload it to the Mediamaster with mmlink. Mmchan
    can also be used to update your channel settings with another
    settings file, such as the one from Rehtec:
    http://rehtec.com/set/dvb1.zip

mmset
    Converts the (binary) file with DVB2000 configuration options to
    a readable ASCII representation, or vice versa.

Note that installing the DVB2000 firmware with 'mmlink -U' is only
possible when another version of DVB2000 (>= 1.77.0) is already
installed. For the first-time installation, you have to use the -B
option, which uses the B2.00UnS bootloader to download the firmware.
This method is slower (19200 bps versus 38400 bps), and you have to
pull the power plug, but works regardless of the installed firmware.
Is also allows you to download firmware larger than 700kb. The -U
option limits the firmware size to 700kb, because the data is
buffered in RAM before it is written to Flash ROM for safety.


=====> Required tools <=====

The GNU assembler configured for m68k is required to build the tools.
You can use the RPM spec file "68kutils.spec" in this directory to
build an RPM from the "binutils" sources. You can extract these
sources from the binutils-2.9.1.0.23-1.src.rpm package (Red Hat 6.0),
or grab them from:

    ftp://ftp.kernel.org/pub/linux/devel/binutils/2.9.1/

Assuming a Red Hat Linux installation, you can build the assembler by
copying the .tar.gz file to /usr/src/redhat/SOURCES, copy the file
68kutils.spec to /usr/src/redhat/SPECS. Now use the following commands
to build and install the RPM:

    rpm -bb --clean /usr/src/redhat/SPECS/68kutils.spec
    rpm -i /usr/src/redhat/RPMS/i386/68kutils-2.9.1.0.23-1.i386.rpm


=====> Build & Install <=====

make
make install
ln -s ttyS0 /dev/mediamaster	# replace ttyS0 by the appropriate device

Make sure that the baudrate of DVB2000 is set to 38400, because that
is the default communication speed used by mmlink. The upper speed limit
of the serial port should not be modified by setserial: the command
"setserial -a /dev/mediamaster" should show "spd_normal".


=====> Examples <=====

Display the DVB2000 version number to test the connection with
the Mediamaster:

    mmlink -V

Make a backup of your channel settings and DVB2000 settings:

    mmlink -c -o backup.dvb
    mmlink -s -o backup.set

Upload new channel settings:

    mmlink -C new.dvb

Use vi to modify your channel settings:

    mmlink -c -o cur.dvb
    mmchan cur.dvb > temp
    vi temp
    mmchan -u temp > new.dvb
    mmlink -C new.dvb

Update your channels settings with the latest settings from Rehtec:

    wget http://rehtec.com/set/dvb1.zip
    unzip dvb1.zip
    mmchan cur.dvb 00may24.dvb > temp
    vi temp
    mmchan -u temp > new.dvb

Install a new version of DVB2000:

    mmlink -U dvb2000.bin

You don't have to remove the power cable to upgrade DVB2000.
You can even continue to watch TV during the upgrade, although
the Mediamaster will not respond to the remote control.

For the first-time installation, or for the installation of
firmware larger than 700kb:

    mmlink -B dvb2001.bin

You have to pull the power plug of the Mediamaster and reconnect
it to start the download in this case.


=====> License <=====

Copyright (C) 1999-2003 Dick Streefland <dicks@xs4all.nl>

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version. See the file COPYING for details.


=====> Homepage <=====

http://www.xs4all.nl/~dicks/mmtools/
