This is a quick start guide to using microcomputer emulators which implement a teletext adapter and support a live teletext packet source on Microsoft Windows. Currently this is only the Stardot fork of BeebEm for Windows. Emulation of the TTX2000S adapter will hopefully be available in Fuse in the near future.
Setting up a teletext packet server
The following instructions will get a single packet server running on port 19761, outputting the community run Teefax service. Other services can be created using vbit2, or an off-air packet stream from a digital TV capture card could be used, but that is outside the scope of this guide.
- Download the latest vbit2 binary from github
- Download the latest teletext-packet-server binary from github and place in the same directory as vbit2.exe
- Download and install a command-line subversion client if you don't already have one.
Use it to check out the Teefax teletext service in your vbit2 directory using:
svn checkout http://teastop.plus.com/svn/teletext/ teefax
- Run the following command in the same directory:
vbit2.exe --dir ./teefax | packet-server.exe -p 19761 -l 16
[Configure::Configure] Pages directory is ./teefax
[Service::run] Lines per field: 16
Windows will ask for permission to open the firewall.
To check for updates to Teefax run
svn up in the teefax directory.
A batch file that regularly checks for updates can be made something like this:
timeout /T 300 /NOBREAK >NUL
The packet server is primarily intended for use on localhost. It will also work across a fast LAN, but struggles on slower wifi networks. Serving packets over the internet is not recommended.
- Download and install the latest build of BeebEm from github
- Start BeebEm and go to Hardware->Edit ROM Configuration
Select BBC B and the
13 (D)row. (By default this is empty).
Click Select ROM and choose the ATS-3.0-1.rom file from the BBC directory and OK the dialogs.
- Select Hardware->Teletext Data->IP:Localhost:19761-19764 and enable Hardware->Teletext Adapter On/Off
- Reset the emulator (File->Reset). A connection message should appear in the packet-server console.
- Enter the command
*TELETEXTon the emulated BBC. The Advanced Teletext System terminal should start up on and acquire the Teefax index page.
For further information, refer to the Advanced Teletext System manual.
Currently only the ATS ROM is supported. The earlier Acorn TFS ROM will not work.
If Hardware->Teletext Data->IP:Custom destination is selected, BeebEm will use the IP address and port numbers specified in preferences.cfg. This enables connections over the network, on alternative ports, and ‘tuning’ the same packet source on more than one ‘channel’ preset.
Hardware->Teletext Data->Capture files reads from four static files as in previous versions of BeebEm.