Newbie instructions

The 'non-developer' documentation that everyone is asking for ;-)

In order to keep these instructions simple, I'm going to make some assumptions:

    • You're installing the latest (as of writing) Slackware tarball slack13-rootfs-9.txz

    • You've already got linux running on your desktop PC (I've not tried these instructions in VMWare or VirtualBox, but using a LiveCD should work fine)

    • You've got sudo working (allowing you to run commands as root)

    • Your USB flash drive (or USB hard-drive) is at least 1GB and appears on your linux system as /dev/sdd (modify the instructions below as appropriate for different drive letters)

    • You've made a backup of any important content on your USB drive (cos it's gonna be wiped)

    • You're using a 1MB-flash bifferboard, and you're using Ethernet flashing (and you've not disabled your bifferboard's network console in biffboot)

      • Update: if you're using one of the newer 8MB-flash bifferboards, simply use bb_eth_upload8.py instead in step 18 below. Everything else should work the same.

    • You don't blame me if everything goes horribly wrong!

Step by step instructions

    1. Create a temp directory, and change into it: cd $(mktemp -d)

    2. Download the tarball: wget http://downloads.sourceforge.net/project/bifferboard/slack13-rootfs-9.txz?use_mirror=mesh

    3. If necessary, rename or decompress the tarball - as I'm on Ubuntu I renamed the .txz to .tar.xz: mv slack13-rootfs-9.txz slack13-rootfs-9.tar.xz

    4. Plug in your USB flash drive

    5. Run dmesg to see what 'letter' it appeared as - for me it's /dev/sdd

    6. Unmount any auto-mounted partitions: sudo umount /dev/sdd*

    7. Use fdisk (or gparted if you prefer a graphical tool) to delete any existing partitions: sudo fdisk /dev/sdd

    8. Create an ext3 root partition (seems Biff's current slackware kernel doesn't support ext2!) and a swap partition - my USB drive is 2GB, so I allocated 1.5GB for /dev/sdd1 as ext3 and the remainder for /dev/sdd2 as swap.

    9. Format the root partition: sudo mkfs.ext3 /dev/sdd1

    10. Intialize the swap partition: sudo mkswap /dev/sdd2

    11. Create a new directory: mkdir mnt

    12. Mount the root directory here: sudo mount /dev/sdd1 mnt

    13. Change into your mounted root directory: cd mnt

    14. If you now run 'ls' you should see just a directory called "lost+found" (which can be ignored)

    15. Extract the tarball here (see Step 3 regarding filenames): sudo tar -xvf ../slack13-rootfs-9.tar.xz

    16. Change into the boot directory: cd boot

    17. Connect your bifferboard to your network, but don't connect power yet

    18. Flash the kernel to your bifferboard using the appropriate upload script: sudo python bb_eth_upload.py eth0 6a:b3:f6:00:1d:58 bzImage (you'll need to change the MAC address for the one on your bifferboard, and then plug in power to the bifferboard when the script tells you)

    19. Hopefully it'll all go okay, but I've had instances in the past where it doesn't work first time. If this happens to you, unplug your bifferboard from the power and repeat the previous step.

    20. Change directory out of the root partition: cd ../..

    21. Make sure the disk buffers get flushed (which may take a while): sync

    22. Unmount the root partition: sudo umount mnt

    23. Wait for any lights on your USB drive to stop flashing, then unplug it

    24. Unplug power from your bifferboard

    25. Plug your USB drive into your bifferboard

    26. Plug power into your bifferboard

    27. Wait a minute or so for bifferboard to boot up

    28. Follow the instructions on the main Slackware page for connecting to your bifferboard with telnet. If they don't work try checking your router's dhcp logs to see what IP address got assigned to your bifferboard, or you can instead connect using the serial console

That's it! You're now running a fully functional slackware installation on your tiny little bifferboard. See the Slackware page for details on installing extra packages with slapt-get

If you want you can now delete the temp directory you created in Step 1.

If you have an ext2 filesystem that you want to use with this setup, convert it to ext3 as follows:

* unmount the partition

* tune2fs -j [partition]

* edit /etc/fstab, and change ext2 to ext3 for this partition

* mount the partition