I've edited this message to provide a Step-by-Step install procedure for Puppy Linux 4.3.1. This is a DESTRUCTIVE install that will wipe all existing files on your WebDT.
1 ) Download the ISO for Puppy Linux 4.3.1 from puppylinux.org.I actually chose to install the "small" version from http://distro.ibiblio.org/pub/linux/distributions/puppylinux/puppy-4.3.1/special-puppies/pup-431-small.iso EDIT: I don't think the "small" version has the necessary drivers
2 ) Burn to CD and boot your WebDT with the CD. You'll need a USB hub so that you can attach a USB CD drive and keyboard+mouse.
If you don't have a USB CD ROM available, you can use a USB flash drive in a round-about-fashion. The way I achieved this was to install the syslinux bootloader on my USB flash drive following STEP 2 onwards of these instructions: http://www.pendrivelinux.com/all-in-one-usb-dsl/ This made my USB flash drive bootable. I was then able to extract the puppy.iso contents to my USB flash drive. If you do this on a Windows machine, you MUST read the "Warning to MS Windows Users" at this link: http://www.puppylinux.com/flash-puppy.htm. Finally, when you boot from this USB stick, syslinux won't find your kernel. You'll need to type: vmlinuz initrd=initrd.gz pmedia=usbflash
3 ) Answer the prompts regarding which keyboard and locale you want your Puppy to use (english, US, etc.). When it asks you whether you want to use Xorg or Xvesa for the video, choose "Xorg".
4 ) Choose 800x600 for the LCD panel size. And 800x600x16 for the video depth on the next screen.
5 ) Puppy should now boot for the first time. It may take about 5 minutes or so to get to a desktop.
6 ) Click the "Install" icon on the desktop. It's the fourth icon in the top row of icons.
7 ) Click the button marked "Universal Installer". This will launch an installation GUI.
8 ) At the media selection, choose "Internal IDE/SATA Flash drive (eg: CF card in IDE adaptor)".
9 ) A dialog box will confirm your drive selection as "sda - 500MiB". Choose OK.
10) Installer will now probe the drive and inform you which filesystems it found. If your drive is already formatted with the ext3 filesystem then it will read something like "sda1: ext3, size 494.2 MiB" at the top of the next dialog box. If this is not the case, you'll need to click the second button to launch the partition editor and reformat your drive as ext3 before proceeding to the next step.
11) Click the top button "Install Puppy to sda1".
12) Puppy will now confirm your intention to install. Press OK.
13) Bootloader selection. I chose the 3rd option "mbr.bin". Worked for me.
14) "Absolute Final Sanity Check". Press ENTER
15) Press any alphanumeric key to wipe the drive.
16) Press any alphanumeric key to confirm you want Puppy to run in RAM at boottime (faster).
17) Wait. It will copy the files. Takes less than 10 minutes.
18) Choose reboot from the bottom left menu. Don't bother with the 'save session' option.
19) Before your WebDT completes booting, disconnect the CD drive [or USB stick] so that the next boot will be from the internal drive.
20) Puppy will now boot. You should see 3 lines of text, the last one saying "copying to ram". Takes a few minutes.
21) Again you have to answer keyboard layout and locale questions. Last time, I promise!
22) You have now booted into Puppy from your internal drive. At this stage, however, puppy is still running in live CD mode. We need to make a few more adjustments....
23) Reboot. Yes - so soon! This is to prompt Puppy to ask us questions about session files...
24) Puppy now gives you choices about session files. The concept here is that puppy has run from a compressed image and wants to save your changes/sessions to compressed images called '2fs' files. I prefer NOT to do this, since puppy will want to pre-allocate all the remaining drive space. Instead - I chose the "SAVE TO sda1" option. EDIT: saving to '2fs' is actually the better option, since this allows easy backups, upgrades, and the possiblity of moving the compressed image to another drive (eg: the compact flash slot.... . hopefully)
25) Puppy now reboots, after telling you that it will create a 100MB swapfile called "pupswap.swp". You could probably risk deleting this later if you were desperate for more space... I haven't tried.
26) This time you'll get lots of warnings about "Calling INT 0x15 (F000:69DA) EAX is 0xBF01"... I don't know how to suppress this... Kind of annoying, since it happens every reboot... If anyone can help with this I would appreciate.
27) Cool! I just noticed that that puppy 4.3.1 has fixed a bug about the modules not being installed properly.... so we can skip step 27!
28) To get your wireless working, go to the 'start' menu (bottom left) and choose setup->network wizard. If you have the Cisco card then the airo_cs module will have already loaded... Other wireless cards work too under ndiswrapper.
29) Okay! That's puppy installed.... but now for the Penmount Touchscreen....
30) Download and extract the Penmount 9000 drivers for Ubuntu 7.10 from
http://www.penmount.com/down_2_1.php
31) Edit the 'install.sh' file and delete every occurence of "sudo -u root ", since puppy has no sudo command.
32) Open a terminal in the same folder as your penmount driver (right-click in the folder and choose Window->Terminal Here). Type
Code: Select all
./install.sh
33) Reboot
34) Touchscreen should now work, but to calibrate you'll need to open a terminal and type
Code: Select all
./gCalib 25
Code: Select all
Option "SwapY" "1"
36) At this stage, there are a whopping 243 Megabytes free on the drive! However, I chose to install a newer version of the SeaMonkey browser from http://murga-linux.com/puppy/viewtopic.php?t=47076 and install the grabanddrag plugin as per http://webdt.org/index.php?topic=312 This left me with 199 Megabytes free.
37) Finally, edit the 'extlinux.conf' file at the root of your drive by adding 'acpi=force' to the end. This enables the front panel buttons....
38) Front panel buttons can be key binded by editing the /root/.jwm/jwmrc-personal file on your install drive. The section entitled "Key bindings" allows you to link keycodes to actions... The keycodes for the WebDT are: 220 for the power button, 74 = Right, 73 = Left, 72 = Down, 71 = Up, and 67 - 70 for the front buttons. If you want to remap these buttons to mimick actual keyboard keys, then read this post: http://webdt.org/forum/viewtopic.php?t=9 Otherwise, if you just want the buttons to launch a particular action, then editing the jwmrc-personal file will suffice. An example entry that I added is:
Code: Select all
<Key keycode="222">exec:acpitool -s</Key>