Portsdown software

From BATC Wiki
Jump to: navigation, search

Latest News: Software Update 201707221 soon to be available: This is a major update - please read the Release Note here 201707221 Release Note

Important note - the Portsdown transmitter has been designed to "work out of the box" - You do not need to do anything other than read this page and then follow the initial set up guide.

  • Do not connect a mouse, keyboard or monitor to the RPi
  • Do not load any device drivers including the Waveshare screen drivers
  • Do not update the RPi firmware or Linux - the installer takes care of this
  • Do not tinker with Linux commands

If you do, we don't have time to support you and will just advise you to reformat your SD card and start again!


The core software for the Portsdown transmitter has been written by Evariste, F5OEO. Other contributions have been made by numerous developers and it is a great example of an open-source project. Most of the source code is available on the BATC GitHub repository, but some of the code is downloaded from other sources.

The potential capabilities of the hardware and software combination are very diverse and maintenance of the totality of the software is beyond the resources of the project team, so only a subset of capabilities will be actively supported. As most of us are TV enthusiasts rather than software enthusiasts, every effort has been made to make the configuration menu-driven.

The software will be supported by the BATC for as long as possible, as stated in the BATC Portsdown Transmitter Support Statement.

Micro-SD cards with the latest software are available from the BATC Shop, and if you buy one of the cards you can skip the rest of this page and go straight to the initial setup section of the user guide.


This page describes how to program a blank SD card with the Portsdown software - the process is not difficult but there are a few operations that require the use of the Linux Command Line. Do not be alarmed – these are simple cut and paste exercises, and full instructions are provided.

Note - We DO NOT recommend using Samsung Evo cards as we have seen problems where they are not compatible with the Rpi 3 due to timing errors.

The detail is available on the BATC GitHub (Git Hub is an open-source software collaboration website) along with the latest version of software at https://github.com/BritishAmateurTelevisionClub/rpidatv

Downloading and Installing the Latest Software

  • You will need a computer connected to the same network running to find the IP address of your RPi when it first boots up, such as Advanced IP Scanner
  • You will then need to run an SSH Terminal application such as Putty.
  • You will need a computer with a means of writing an image to a Micro-SD Card. The use of Win32DiskImager is recommended for writing to the card.