Difference between revisions of "Portsdown transmitter FAQ"

From BATC Wiki
Jump to navigation Jump to search
 
(14 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
* '''The Portsdown software update deoes not work '''
 +
If you get the message "Unable to contact GitHub for update" "Internet connection to Google seems OK" when trying to perform a software update, it means that the Portsdown cannot download the new software due to a problem with your router or internet connection.  The Portsdown can see Google so knows that it is connected to the internet.  Check whether you can see this page on another computer on the same network: https://github.com/BritishAmateurTelevisionClub/portsdown4/raw/master/scripts/latest_version.txt
 +
 +
* '''Why can't I download or update the software?'''
 +
We have had reports of problems with downloading software and updates from members with Virgin Media and BT internet connections.  The work-round for Virgin Media is described on the GitHub page.  BT users should make sure that they have "Web Protect" turned off for the download.
 +
 +
* '''I've just changed my Callsign and now nothing works'''
 +
If you have entered text with spaces in the callsign field, the software will crash (I've tried to cure this, but it's a very difficult problem).  The cure is to open an SSH session (using Putty or Kitty), exit to the command line, and then do a factory reset by entering:
 +
 +
cp -f /home/pi/rpidatv/scripts/configs/portsdown_config.txt.factory /home/pi/rpidatv/scripts/portsdown_config.txt
 +
 +
If your software has not been updated since 1 February 2018, then the line that you should enter is:
 +
 +
cp -f /home/pi/rpidatv/scripts/configs/rpidatvconfig.txt.factory /home/pi/rpidatv/scripts/rpidatvconfig.txt
 +
 +
Afterwards, restart the console menu with the command:
 +
 +
/home/pi/rpidatv/scripts/menu.sh menu
 +
 +
* '''How do I prevent regular clicks/thumps on Streamed audio?'''
 +
Check the following:  1.  A valid video signal must be present at the input to the EasyCap before you turn the streaming on.  2.  The supply voltage, measured on the GPIO pins, should be between 5.0 and 5.1 volts during streaming.  3.  The EasyCap should be plugged directly into the RPi or connected by a short, good quality, USB lead.
 +
 +
* '''How do I reduce the background noise/hum on Streamed audio?'''
 +
The poor quality USB leads supplied with the EasyCaps should not be used.  The EasyCap should be plugged directly into the RPi or connected by a short, good quality, USB lead.
 +
 +
* '''Why do I get occasional dropouts of the received or streamed picture at 16:9 or 720p?'''
 +
The Raspberry Pi 3 is working at its processing limit at these higher resolutions and occasionally runs out of resources.  16:9 is particularly bad because it is generated by down-scaling 720p, or stretching SD.
 +
 +
* '''Can I use the new Raspberry Pi 3+?'''
 +
Yes.  The "Portsdown 2020" software build works on a Raspberry Pi 3+ or a Raspberry Pi 3.  Details here: https://github.com/BritishAmateurTelevisionClub/portsdown .
 +
 
* '''How do I turn the transmitter off in Touchscreen mode?'''
 
* '''How do I turn the transmitter off in Touchscreen mode?'''
In transmit, the touchscreen is used to monitor outgoing video and so the buttons are no longer visible - to turn the transmitter off, simply touch the screen in the same area as the TX button.
+
In transmit, the touchscreen is used to monitor outgoing video and so the buttons are no longer visible - to turn the transmitter off, simply touch the screen anywhere.
  
 
* '''What do I need to receive a Portsdown transmitter?'''
 
* '''What do I need to receive a Portsdown transmitter?'''
 
When a Portsdown transmitter is fitted with a filter / modulator card and running in normal bandwidth modes (above 1 Msymbol/sec) you will be able receive it on any Free to Air (or FreeSat but not Sky or Freeview) satellite Set top box  - if you have a High Definition STB you will be able to receive  MPEG-2 and MPEG-4.   
 
When a Portsdown transmitter is fitted with a filter / modulator card and running in normal bandwidth modes (above 1 Msymbol/sec) you will be able receive it on any Free to Air (or FreeSat but not Sky or Freeview) satellite Set top box  - if you have a High Definition STB you will be able to receive  MPEG-2 and MPEG-4.   
  
  However, when it is running in RB-TV modes OR in Ugly mode without the Filter Modulator card, you can only receive it using the Minitiouner USB receiver.  This is a BATC supported project with some home construction needed - the hardware components are available from [https://batc.org.uk/shop/minitiouner the BATC shop] and the software is a free download from F6DZP [[MiniTioune|see here for more details]].
+
  However, when it is running in RB-TV modes OR in Ugly mode without the Filter Modulator card, you can only receive it using the MiniTiouner USB receiver.  This is a BATC supported project with some home construction needed - the hardware components are available from [https://batc.org.uk/shop/minitiouner the BATC shop] and the software is a free download from F6DZP [[MiniTioune|see here for more details]].
  
 
*'''Can I use another touchscreen LCD?'''
 
*'''Can I use another touchscreen LCD?'''
Maybe!  The Portsdown project only supports the Waveshare screen - that doesn't mean to say others won't work but we can't help you if it doesn't.
+
The Portsdown project only supports the 3.5" Waveshare screen - that doesn't mean to say others won't work but we can't help you if it doesn't.  The Official Raspberry Pi 7" touchscreen (often referred to as a "7 inch Element 14 touchscreen") https://www.element14.com/community/docs/DOC-78156/l/raspberry-pi-7-touchscreen-display is the only recommended alternative.  HDMI-connected touchscreens are not suitable.
  
 
*'''Can I use a Raspberry Pi 2?'''
 
*'''Can I use a Raspberry Pi 2?'''
Line 14: Line 45:
  
 
*'''Who are the Portsdown team?'''
 
*'''Who are the Portsdown team?'''
The Portsdown team are just BATC members doing this as volunteers to support the ATV community.  As such, it is not their full time job and they are not being paid.  If you have a problem, question or comment, please do not contact them directly but use the [http://www.batc.org.uk/forum/viewforum.php?f=103&sid=cf0e59d13b08cb6b74f6fc878bee9999 BATC members forum] but there may not always be an instant response!   
+
The Portsdown team are just BATC members doing this as volunteers to support the ATV community.  As such, it is not their full time job and they are not being paid.  If you have a problem, question or comment, please do not contact them directly but use the [https://forum.batc.org.uk/viewforum.php?f=103 BATC members forum] but there may not always be an instant response!   
  
 
And yes we are looking for people to help with the project - if you can write Linux, update Wiki pages or reply to forum posts we want to hear from you!
 
And yes we are looking for people to help with the project - if you can write Linux, update Wiki pages or reply to forum posts we want to hear from you!
Line 24: Line 55:
 
*Do not tinker with Linux commands
 
*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!'''
 
If you do, we don't have time to support you and will just advise you to reformat your SD card and start again!'''
 
*'''Does Portsdown mean BATC will stop selling the DTX1 like they did DATVexpress?'''
 
NO - The DTX1 is designed for those who do not want to "build their own" and will still be available in the BATC shop and supported by Antennair through the [http://www.dtx1.info/ DTX1 support website].  DATVexpress is still available from the [https://datv-express.com/ DATVexpress website] - the reason we stopped selling is in the BATC shop is because the Express team wanted to offer it directly to end users.
 
  
 
*'''Is Portsdown MPEG-2 or MPEG-4?'''
 
*'''Is Portsdown MPEG-2 or MPEG-4?'''
Both - The Rpi hardware encoder runs MPEG-4 and the Portsdown software has an MPEG-2 encoder both of which are used in the Portsdown transmitter.
+
Both - The RPi hardware encoder runs MPEG-4 and the Portsdown software has an MPEG-2 encoder both of which are used in the Portsdown transmitter.
 
 
* '''Why doesn't MPEG2 mode work?'''
 
MPEG2 mode currently does not work if you have an analog capture device connected (it upsets the numbering of video devices).  If you want MPEG2 mode, unplug the analog capture USB and reboot - it should work.  It is hoped to overcome this issue with a software change shortly.
 
 
 
* '''Why can't I download or update the software?'''
 
We have had reports of problems with downloading software and updates from members with Virgin Media and BT internet connections.  The work-round for Virgin Media is described on the GitHub page.  BT users should make sure that they have "Web Protect" turned off for the download.  
 
  
 
* '''When I type my password, the cursor does not move.  Is this right?'''
 
* '''When I type my password, the cursor does not move.  Is this right?'''
Line 45: Line 67:
 
The process is very similar to initial set up and is done by using an external PC with 2 pieces of software - the first application is to find the IP address of your RPi when it first boots up, such as [http://www.advanced-ip-scanner.com/ Advanced IP Scanner] and an SSH Terminal application such as [http://www.chiark.greenend.org.uk/~sgtatham/putty/ Putty].   
 
The process is very similar to initial set up and is done by using an external PC with 2 pieces of software - the first application is to find the IP address of your RPi when it first boots up, such as [http://www.advanced-ip-scanner.com/ Advanced IP Scanner] and an SSH Terminal application such as [http://www.chiark.greenend.org.uk/~sgtatham/putty/ Putty].   
  
*Connect the RPi to the same network as your PC, and use the IP Scanner to find the IP address of your RPi.
+
*Connect the RPi to the same network as your PC, and either check on the touchscreen "info" page (on Menu 3) or use the IP Scanner to find the IP address of your RPi.
  
 
*Open Putty and enter the IP address of your RPi and open a connection.  At the logon prompt enter the default username of pi and the password given to you with the card.   
 
*Open Putty and enter the IP address of your RPi and open a connection.  At the logon prompt enter the default username of pi and the password given to you with the card.   
  
As the Portsdown transmitter is still in touchscreen mode, the putty window will be showing the keyboard commands - try pressing a button on the Touchscreen and you will see the command displayed.
+
The console menu should start automatically and the touchscreen will display the BATC logo.
 
 
[[File:Monitor.JPG|600px]]
 
 
 
To exit Touchscreen mode press the "Ctrl" and "C" keys on the PC keyboard simultaneously  - the Touchscreen will go blank, the console menu will start automatically and you will see the following screen:
 
  
 
Note, if the console menu does not appear and you end up at the Linux Command Line, you can get back to the Main Console Menu by typing:
 
Note, if the console menu does not appear and you end up at the Linux Command Line, you can get back to the Main Console Menu by typing:
/home/pi/rpidatv/scripts/menu.sh menu
 
  
*'''Why do I get an Error Message when I try to change my password?'''
+
  /home/pi/rpidatv/scripts/menu.sh menu
 
 
Prior to Software version 201702100, if you had just exited from the touchscreen, attempts to change the password failed.  This has now been rectified. Type passwd, press enter and it should work.
 
  
 
*'''When I Log-on or start the Console Menu, it goes Straight to the Exit Screen.  How do I recover?'''
 
*'''When I Log-on or start the Console Menu, it goes Straight to the Exit Screen.  How do I recover?'''
  
If you accidentally enter a space character when entering the frequency or symbol rate, the Menu software fails and tries to exit.  Future software versions (after 201703060) will not let you get into this situation.  You can recover by typing the command:
+
If you accidentally enter a space character when entering the frequency or symbol rate, the Menu software fails and tries to exit.  You can recover by typing the command:
  
  cp -f /home/pi/rpidatv/scripts/configs/rpidatvconfig.txt.factory /home/pi/rpidatv/scripts/rpidatvconfig.txt
+
  cp -f /home/pi/rpidatv/scripts/configs/portsdown_config.txt.factory /home/pi/rpidatv/scripts/portsdown_config.txt
  
 
at the Linux command line, and then restarting the console menu with the command:
 
at the Linux command line, and then restarting the console menu with the command:
  
 
  /home/pi/rpidatv/scripts/menu.sh menu
 
  /home/pi/rpidatv/scripts/menu.sh menu
 +
 +
*'''How Can I update my Portsdown Software?'''
 +
 +
As long as you have an internet connection, you can update your Portsdown Software to the latest version from the Console Menu or the touchscreen Menu 3.  Full instructions are here: [[Updating your Portsdown Software]]
  
 
*'''Where can I get a diagram of all the RPi GPIO pins?'''
 
*'''Where can I get a diagram of all the RPi GPIO pins?'''
Line 76: Line 95:
 
The full wiring listing for the RPi GPIO is here
 
The full wiring listing for the RPi GPIO is here
  
[[File:GPIO pinout.JPG|600px]]
+
[[PTT and band switching#Summary_of_GPIO_connections]]
 +
 
 +
*'''The lock LED on the AD4351 board does not come on'''
 +
 
 +
The lock light only comes on when in Portsdown/IQ mode and you are on Transmit

Latest revision as of 12:23, 19 March 2023

  • The Portsdown software update deoes not work

If you get the message "Unable to contact GitHub for update" "Internet connection to Google seems OK" when trying to perform a software update, it means that the Portsdown cannot download the new software due to a problem with your router or internet connection. The Portsdown can see Google so knows that it is connected to the internet. Check whether you can see this page on another computer on the same network: https://github.com/BritishAmateurTelevisionClub/portsdown4/raw/master/scripts/latest_version.txt

  • Why can't I download or update the software?

We have had reports of problems with downloading software and updates from members with Virgin Media and BT internet connections. The work-round for Virgin Media is described on the GitHub page. BT users should make sure that they have "Web Protect" turned off for the download.

  • I've just changed my Callsign and now nothing works

If you have entered text with spaces in the callsign field, the software will crash (I've tried to cure this, but it's a very difficult problem). The cure is to open an SSH session (using Putty or Kitty), exit to the command line, and then do a factory reset by entering:

cp -f /home/pi/rpidatv/scripts/configs/portsdown_config.txt.factory /home/pi/rpidatv/scripts/portsdown_config.txt

If your software has not been updated since 1 February 2018, then the line that you should enter is:

cp -f /home/pi/rpidatv/scripts/configs/rpidatvconfig.txt.factory /home/pi/rpidatv/scripts/rpidatvconfig.txt

Afterwards, restart the console menu with the command:

/home/pi/rpidatv/scripts/menu.sh menu
  • How do I prevent regular clicks/thumps on Streamed audio?

Check the following: 1. A valid video signal must be present at the input to the EasyCap before you turn the streaming on. 2. The supply voltage, measured on the GPIO pins, should be between 5.0 and 5.1 volts during streaming. 3. The EasyCap should be plugged directly into the RPi or connected by a short, good quality, USB lead.

  • How do I reduce the background noise/hum on Streamed audio?

The poor quality USB leads supplied with the EasyCaps should not be used. The EasyCap should be plugged directly into the RPi or connected by a short, good quality, USB lead.

  • Why do I get occasional dropouts of the received or streamed picture at 16:9 or 720p?

The Raspberry Pi 3 is working at its processing limit at these higher resolutions and occasionally runs out of resources. 16:9 is particularly bad because it is generated by down-scaling 720p, or stretching SD.

  • Can I use the new Raspberry Pi 3+?

Yes. The "Portsdown 2020" software build works on a Raspberry Pi 3+ or a Raspberry Pi 3. Details here: https://github.com/BritishAmateurTelevisionClub/portsdown .

  • How do I turn the transmitter off in Touchscreen mode?

In transmit, the touchscreen is used to monitor outgoing video and so the buttons are no longer visible - to turn the transmitter off, simply touch the screen anywhere.

  • What do I need to receive a Portsdown transmitter?

When a Portsdown transmitter is fitted with a filter / modulator card and running in normal bandwidth modes (above 1 Msymbol/sec) you will be able receive it on any Free to Air (or FreeSat but not Sky or Freeview) satellite Set top box - if you have a High Definition STB you will be able to receive MPEG-2 and MPEG-4.

However, when it is running in RB-TV modes OR in Ugly mode without the Filter Modulator card, you can only receive it using the MiniTiouner USB receiver.  This is a BATC supported project with some home construction needed - the hardware components are available from the BATC shop and the software is a free download from F6DZP see here for more details.
  • Can I use another touchscreen LCD?

The Portsdown project only supports the 3.5" Waveshare screen - that doesn't mean to say others won't work but we can't help you if it doesn't. The Official Raspberry Pi 7" touchscreen (often referred to as a "7 inch Element 14 touchscreen") https://www.element14.com/community/docs/DOC-78156/l/raspberry-pi-7-touchscreen-display is the only recommended alternative. HDMI-connected touchscreens are not suitable.

  • Can I use a Raspberry Pi 2?

You can try it, but some capabilities will not work. For example, the RPi 2 does not seem to be capable of handling analogue capture properly and puts streaks across the picture. The Pi Camera is less demanding and has been demonstrated to work with an RPi 2 in some circumstances. The project team will not support the RPi 2 - please just buy an RPi 3.

  • Who are the Portsdown team?

The Portsdown team are just BATC members doing this as volunteers to support the ATV community. As such, it is not their full time job and they are not being paid. If you have a problem, question or comment, please do not contact them directly but use the BATC members forum but there may not always be an instant response!

And yes we are looking for people to help with the project - if you can write Linux, update Wiki pages or reply to forum posts we want to hear from you!

  • Do I need to know about Linux or other clever computer stuff to get Portsdown running?

NO - the Portsdown transmitter has been designed to "work out of the box":

  • You do not need to do anything other than follow the initial set up guide
  • Do not load any device drivers
  • 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!

  • Is Portsdown MPEG-2 or MPEG-4?

Both - The RPi hardware encoder runs MPEG-4 and the Portsdown software has an MPEG-2 encoder both of which are used in the Portsdown transmitter.

  • When I type my password, the cursor does not move. Is this right?

Yes. Passwords typed at the command line in Linux do not cause the cursor to move. You just have to type carefully; if you make a mistake just backspace lots of times and then start the password again.

  • How do I get out of touch screen back in to console mode?

The process is very similar to initial set up and is done by using an external PC with 2 pieces of software - the first application is to find the IP address of your RPi when it first boots up, such as Advanced IP Scanner and an SSH Terminal application such as Putty.

  • Connect the RPi to the same network as your PC, and either check on the touchscreen "info" page (on Menu 3) or use the IP Scanner to find the IP address of your RPi.
  • Open Putty and enter the IP address of your RPi and open a connection. At the logon prompt enter the default username of pi and the password given to you with the card.

The console menu should start automatically and the touchscreen will display the BATC logo.

Note, if the console menu does not appear and you end up at the Linux Command Line, you can get back to the Main Console Menu by typing:

/home/pi/rpidatv/scripts/menu.sh menu
  • When I Log-on or start the Console Menu, it goes Straight to the Exit Screen. How do I recover?

If you accidentally enter a space character when entering the frequency or symbol rate, the Menu software fails and tries to exit. You can recover by typing the command:

cp -f /home/pi/rpidatv/scripts/configs/portsdown_config.txt.factory /home/pi/rpidatv/scripts/portsdown_config.txt

at the Linux command line, and then restarting the console menu with the command:

/home/pi/rpidatv/scripts/menu.sh menu
  • How Can I update my Portsdown Software?

As long as you have an internet connection, you can update your Portsdown Software to the latest version from the Console Menu or the touchscreen Menu 3. Full instructions are here: Updating your Portsdown Software

  • Where can I get a diagram of all the RPi GPIO pins?

The full wiring listing for the RPi GPIO is here

PTT and band switching#Summary_of_GPIO_connections

  • The lock LED on the AD4351 board does not come on

The lock light only comes on when in Portsdown/IQ mode and you are on Transmit