PPP on the Dreambox 5600

This page contains a link to a modified factory Dreambox 5600 image that contains kernel support for a serial console, serial-line PPP and net-aware applications such as telnetd and ftpd.

With this image installed, your Dreambox 5600 can become a fully-fledged member of the Internet with all the risks and benefits that implies!

Before You Start

You need

Assumed skills

It is assumed that you know how to:

You May Want To Read More About:

These instructions assume that the computer that acts a gateway for the dreambox is secured, ideally behind a separate firewall. If your gateway computer is not secured in this way, your dreambox and therefore your network may be exposed to malicious minds on the Internet - you have been warned!

Installing The Modified Image

Verifying That The Modified Image Installed Correctly

These steps help you verify that the image installed correctly and that PPPD is running on the dreambox.

Connecting Your Dreambox Via A Linux Gateway

You will probably want to investigate how best to automate these steps so that you don't have execute them everytime you reboot the gateway.

Connecting Your Dreambox Via A Windows Gateway

These instructions are included as a courtesy of those users who, even at home, remain trapped in the Windows Matrix.

These instructions are based on material found at: http://bwinton.latte.ca/Palm/ppp.html. See that page for screen captures that may guide your setup. Note: that I found that it was best to assign an explicit pool of IP addresses rather than have Windows automatically allocate them. If I leave it to Windows to allocate them, Windows would tend to choose addresses that were already used on my network causing the PPP setup to fail. Also, make sure you reconfigure the maximum speed of the null modem you create to 115200 - you have to do this on the modem object, not on the connection object.

These steps will:

Modify %SystemRoot%\inf\mdmhayes.inf

These steps adds a line to a modem configuration file so that Windows can recognize an incoming PPP connection.

Create The Null Modem

Create The PPP Link

If the connection was successful, you should see a line with the following columns in your "Network And Dialup Connections" folder:

    <Unauthenticated user> | Direct | Connected.

The IP address assigned to the dreambox will be evident by selecting "Status | Details" from the connection's context menu and then looking at the value of the "Client IP address" line.

If It Didn't Work!

If the connection doesn't seem to happen, you can try debugging it using the trace facilities described by this Micro$oft article (google: netsh ras ppp).

It may also be useful to inspect the null-modem's log by selecting the null-modem's definition object and selecting "View log" from its context menu. In the modem log, if you see a line like: "Recv: ~" followed by another which says: "Unknown Response" you almost certainly didn't do the mandatory reboot after editing mdmhayes.inf. Do it now :-)

First Steps

At this point you should have a working PPP connection. Under Linux this will be indicated by a foreground pppd process that hasn't yet terminated. In Windows, this will be indicated by the presence of a line in the "Network and Dialup Connections" folder as described above. If you don't have a working PPP connection you need try and work out why before continuing with the following steps.

These steps help you verify that the PPP connection really is working.

Variants

This image has support for various "pseudo" kernel options. To take advantage of these options, you need to connect to the Dreambox with a 115200 bps serial terminal, reboot it and, when prompted, edit the boot arguments appropriately.

Todo

Provenance

The image above was created by taking an "official" Dreambox 5600 image and modifying it in the following ways:

An idea of exactly which image files were touched can be obtained by untarring the tarball listed above.

Instructions for duplicating the build will be forthcoming as and when I get time to document them.

I don't build, distribute or have any interest in images that contain code that might get me thrown in jail, so don't even ask. You _will_ be ignored.

Feedback, Discussion, etc.

Any comments, discussion, or suggestions can be made to me directly via e-mail or by appending to this discussion forum.