SerialDisk Operational Notes

Home » SerialDisk Operational Notes

I use Kyle Owen’s excellent SerialDisk software to run OS/8 on my PDP-8/e.

This page sets out my notes relating to the ongoing care and maintenance of my existing SerialDisk setup. It does not explain how to initially setup SerialDisk.

Configuration information

SerialDisk is installed on a RPi fitted with a WiFi dongle.

My router allocates it the IP address 192.168.2.154 via DHCP.

When the RPi boots up, the IP address is displayed towards the end of the boot-up messages.

The login credentials for the RPi are: pi / raspberry.

For command-line access, connect to the RPi via SSH using PuTTY.

To copy files to/from the RPi, I use WinSCP.

Cautions and limitations

Although RK05 images are used by SerialDisk, OS/8 cannot “see” them as RK05 disks. SerialDisk relies on modifying the disk handlers so that it can read and write to these images.

My images have NOT been fully patched. So commands like PIP and RESORC will apparently NOT work correctly. I hope to fix this in the near future.

When using a KL8E (M8650) configured for 38,400 baud and 1 stop bit, I do not recommend setting SerialDisk (on the RPi) for 1 stop bit (by putting 0 in the second line of the file disk.cfg). Twice this has resulted in my first disk image (diagpack2.rk05) being corrupted on boot up. For some reason SerialDisk thinks that it is being asked to write to the disk image, rather than read from it. This is apparent from the SerialDisk status messages that appear on the RPi’s console display. By instead setting the number of stop bits to 2 on the RPi (by putting 1 in the second line of the file disk.cfg), I have had no further issues. I leave the KL8E set to 1 stop bit.

Disk images

I am using two disk images (click on the links for a full DIR listing):

diagpack2.rk05: This appears as devices SDA0: and SDB0:

diag-games-kermit.rk05: This appears as devices SDA1: and SDB1:

Useful commands

To view the name of the virtual disk file(s) served up by SerialDisk:

pi@rpi-sd:~ $ cat startserialdisk

To view the serial interface parameters used by SerialDisk:

pi@rpi-sd:~ $ cat os8diskserver/SerialDisk/server/disk.cfg

To view available USB-to-RS232 interfaces:

pi@rpi-sd:~ $ ls -l /dev/ttyUSB*

To view current USB-to-RS232 parameters:

pi@rpi-sd:~ $ stty -F /dev/ttyUSB0

To view the network settings and IP address of the WiFi adapter:

pi@rpi-sd:~ $ ifconfig wlan0

To view the wireless access points that are currently in range:

pi@rpi-sd:~ $ sudo iwlist wlan0 scan

To view the WiFi access points that the RPi will attempt to connect to:

pi@rpi-sd:~ $ sudo cat /etc/wpa_supplicant/wpa_supplicant.conf

To view the hostname currently in use by the RPi. This is useful if you want to access the RPi by hostname over SSH using PuTTY (but note that the RPi will need to have the samba package installed. See below for details about how to do this):

pi@rpi-sd:~ $ hostname

To change the hostname you need to edit two files. The first file should have just the hostname in it. The second file will have the hostname to the right of text that says “127.0.0.1” (the local loopback address). Here are the commands needed to edit the two files (use CTRL-X then Y to save and exit):

pi@rpi-sd:~ $ sudo nano /etc/hostname
pi@rpi-sd:~ $ sudo nano /etc/hosts

To install samba, so that the RPi will be visible to a Windows machine using just the RPi’s hostname. Note that no configuration of samba is required for this to work:

pi@rpi-sd:~ $ sudo apt-get update
pi@rpi-sd:~ $ sudo apt-get install samba