Difference between revisions of "Controlling a DATVExpress"

From BATC Wiki
Jump to navigation Jump to search
 
(18 intermediate revisions by 3 users not shown)
Line 1: Line 1:
Software versions 201702060 and later include the additional capability to control a DATV Express exciter board from a Portsdown transmitter system without the filter modulator card.  Here are the full details.
+
Software versions 201702100 and later include the additional capability to control a DATV-Express exciter board from a Portsdown transmitter system without the filter modulator card.  If you have an earlier Portsdown software version, please update to the latest version to provide these capabilities.  Here are the full details.
  
The Portsdown Software running on an RPi 3 will control a DATV Express board directly via the USB port, without the need for any PC or other computer.  There are some limitations on functionality, due to the state of development of the DATV Express server software, and also limitations in the RPi 3 hardware and Portsdown software.  The system gives a compact touchscreen interface to DATV Express but you cannot expect the full functionality that you would get using a Windows PC to control DATV Express.
+
The Portsdown Software running on an RPi 3 will control a DATV-Express board directly via the USB port, without the need for any PC or other computer.  The system gives a compact touchscreen interface to DATV Express and provides some of the features for DVB-S transmission that you would get using a Windows PC to control DATV Express.  DVB-S2 and DVB-T are not available, although there is hope for DVB-S2 capability in the future.
  
 
===Equipment Required===
 
===Equipment Required===
  
For a usable Portsdown and DATV Express transmitter, you will need a Raspberry Pi 3, a Waveshare touchscreen, a DATV Express board, suitable power supplies, and transmitter filters and linear amplifiers.  Connect the DATV Express to the RPi 3 using a USB lead.
+
[[File:Portsdown-DATV-Express-RPi3_Block-Diagram.jpg|800px]]
 +
 
 +
'''A Block Diagram of a Typical Portsdown set-up for using the DATV-Express board for DVB-S modulator.'''
 +
'''The LCD Touchscreen is the normal GUI'''
 +
 
 +
For a usable Portsdown and DATV-Express transmitter, you will need a Raspberry Pi 3, a Waveshare touchscreen, a DATV Express board, suitable power supplies, and transmitter filters and linear amplifiers.  Connect the DATV Express to the RPi 3 using a USB lead.  Thanks to W6HHC for the diagram.
  
 
===Capability===
 
===Capability===
Line 11: Line 16:
 
Using the touchscreen, the following capabilities can be controlled:
 
Using the touchscreen, the following capabilities can be controlled:
  
DVB-S H264 transmissions using the Pi Camera at Symbol Rates from 125 KS to 4 MS.
+
DVB-S H264 transmissions using the Pi Camera at Symbol Rates from 125 KS to 4 MS (but see limitations).
  
DVB-S MPEG-2 transmissions using the Pi Camera at Symbol Rates from 125 KS to 4 MS.
+
DVB-S MPEG-2 transmissions with sound using the Pi Camera and an external USB Microphone at Symbol Rates from 125 KS to 4 MS (but see limitations).
 +
 
 +
DVB-S H264 transmissions from composite video captured with a Fushicai EasyCap at Symbol Rates from 125 KS to 4 MS.
 +
 
 +
DVB-S MPEG-2 transmissions with sound from composite video captured with a Fushicai EasyCap at Symbol Rates from 125 KS to 4 MS.
  
 
Carrier transmission.
 
Carrier transmission.
  
Successful encoding from the Pi Camera has been demonstrated between 125 KS and 8 MS, but these symbol rates are only selectable from the Console interface.
+
IPTS Streaming input from vMix and an ffmpeg batch file for H264 and MPEG-2 transmissions.
 +
 
 +
All FEC modes are available, and using the Console any frequency can be selected.
 +
 
 +
The output level can be set independently for each of  5 bands (71 MHz, 146 MHz, 437 MHz, 1255 MHz and 2400 MHz) from Advanced Settings, option 5.  The power level calibration (0 - 47) is the same as the Windows V1.23 DATV Express software.
  
The FileTS (playing a pre-recorded TS file) and PATERNAUDIO (test card) and Desktop modes do not function properly.  Work is ongoing to improve this capability.  Analogue Capture does work with some EasyCap dongles, but not with others.  I have seen successful encoding at between 333 and 1000 KS with one dongle, but only intermittent pictures with another.
+
The PTT switching is implemented similarly to the Windows version.
  
All FEC modes are available, and using the Console any frequency can be selected.
+
The settings for Ports A through D can be selected for each band in Advanced Settings, Option 5.  
  
The output level can be set independently for each band from Advanced Settings, option 5. The power level calibration (0 - 47) is very close that that set in the Windows V1.23 DATV Express software.
+
Further details of the DATV Express functionality and pin assignments can be found on page 65 of this User Guide: [https://datv-express.com/uploads/UserGuide/DATV-Express%20Users%20Guide%20for%20Windows-draft14.pdf DATV-Express Users Guide for Windows-draft14]
  
 
===Warnings and Limitations===
 
===Warnings and Limitations===
Line 29: Line 42:
 
-  The DATV Express board should connected to the RPi and powered on before the RPi is booted.
 
-  The DATV Express board should connected to the RPi and powered on before the RPi is booted.
  
With an SR of 1000 KS selected, there are spurious emissions about 35 dB below the main transmission at plus and minus 6 MHzOther SRs do not seem to be so badly affected.
+
The Portsdown capability of booting straight to transmit is not available with the DATV Express board.
 +
 
 +
-  Please be do not rely on the PTT pin sequencing to protect your pre-amps and PAsThe software is just not robust enough for the Portsdown team to give any guarantees of its functionality.  You have been warned!
 +
 
 +
-  There is no means of putting a callsign caption on H264 transmissions.
  
The Portsdown capability of booting straight to transmit is not available with the DATV Express board.
+
There is a delay of 5 seconds before the first transmission after switch-on.  This delay is to allow the DATV Express firmware to be downloaded from the RPi.
  
The PTT pins on the DATV Express board that are activated in the Windows version of DATV Express are inactive in this versionThe PTT and band select lines on the Portsdown transmitter are functional as normal.
+
H264 transmissions from the Test Card or Contest Card only display the upper part of the picture at symbol rates over 250 KSIt is hoped to cure this within the next few releases.
  
There is a delay of 5 seconds before the first transmission after switch-on and after any change of SRThis delay is to allow the DATV Express firmware to be downloaded from the RPi.
+
MPEG-2 transmissions from the Test Card or Contest Card at 4 MS occasionally break upIt is hoped to cure this within the next few releases.
  
 
===How It Works===
 
===How It Works===
Line 47: Line 64:
 
In both cases the system sleeps for 5 seconds while the DATV Express server application starts up.
 
In both cases the system sleeps for 5 seconds while the DATV Express server application starts up.
  
It is stopped (killed) whenever the Symbol Rate is changed in either the console menu or the GUI, as it needs to be re-loaded with or without the -nb parameter.
+
The express_server is controlled by sending commands to a file /tmp/expctrl.  The transmission parameters and the start transmit, or start carrier messages are sent by a.sh.  a.sh is called to transmit from both the console menu and the gui.  Note that 5 band-dependent power levels can be pre-set in the Menu (Advanced Set-up).
 +
 
 +
The cease transmit or cease carrier commands are sent by the stop_transmit routines in either the menu.sh or in the gui.
 +
 
 +
Thanks to Charles G4GUO and Chris MW0LLK for their help in delivering this capability.
 +
 
 +
===Port Switching From the Touchscreen===
  
The express_server is controlled by sending commands to a file /tmp/expctrl.  The transmission parameters and the start transmit, or start carrier messages are sent by a.sha.sh is called to transmit from both the console menu and the gui.  Note that 4 band-dependent power levels can be pre-set in the Menu (Advanced Set-up).
+
Ports A through D can now be set up to switch for each band from the touchscreen however, a number is requestedHere is the decode:
  
The cease transmit or cease carrier commands are sent by the stop_transmit routines in either the menu.sh or in the gui.
+
{| class="wikitable"
 +
|-
 +
! Number !! Port A J6 pin 5 !! Port B J6 pin 6 !! Port C J6 pin 7 !! Port D J6 pin 10
 +
|-
 +
| 0 || Off || Off || Off || Off
 +
|-
 +
| 1 || On || Off || Off || Off
 +
|-
 +
| 2 || Off || On || Off || Off
 +
|-
 +
| 3 || On || On || Off || Off
 +
|-
 +
| 4 || Off || Off || On || Off
 +
|-
 +
| 5 || On || Off || On || Off
 +
|-
 +
| 6 || Off || On || On || Off
 +
|-
 +
| 7 || On || On || On || Off
 +
|-
 +
| 8 || Off || Off || Off || On
 +
|-
 +
| 9 || On || Off || Off || On
 +
|-
 +
| 10 || Off || On || Off || On
 +
|-
 +
| 11 || On || On || Off || On
 +
|-
 +
| 12 || Off || Off || On || On
 +
|-
 +
| 13 || On || Off || On || On
 +
|-
 +
| 14 || Off || On || On || On
 +
|-
 +
| 15 || On || On || On || On
 +
|}
 +
 
 +
Portsdown software 201906060 (currently only a Dev release) introduces the facility to set the RPi GPIO Band Select and Transverter pins, independently of the transmitted frequency, by setting the ExpressPort to values between 16 and 31:
 +
 
 +
{| class="wikitable"
 +
|-
 +
! Number !! Port A J6 pin 5 !! Port B J6 pin 6 !! Port C J6 pin 7 !! Port D J6 pin 10 !! Band LSB pin 28 !! Band MSB pin 35 !! Tverter Bit pin 7
 +
|-
 +
| 16 || Off || Off || Off || Off || Off || Off || Off
 +
|-
 +
| 17 || On || Off || Off || Off || On || Off || Off
 +
|-
 +
| 18 || Off || On || Off || Off || Off || On || Off
 +
|-
 +
| 19 || On || On || Off || Off || On || On || Off
 +
|-
 +
| 20 || Off || Off || On || Off || Off || Off || On
 +
|-
 +
| 21 || On || Off || On || Off || On || Off || On
 +
|-
 +
| 22 || Off || On || On || Off || Off || On || On
 +
|-
 +
| 23 || On || On || On || Off || On || On || On
 +
|-
 +
| 24 || Off || Off || Off || On || Off || Off || Off
 +
|-
 +
| 25 || On || Off || Off || On || On || Off || Off
 +
|-
 +
| 26 || Off || On || Off || On || Off || On || Off
 +
|-
 +
| 27 || On || On || Off || On || On || On || Off
 +
|-
 +
| 28 || Off || Off || On || On || Off || Off || On
 +
|-
 +
| 29 || On || Off || On || On || On || Off || On
 +
|-
 +
| 30 || Off || On || On || On || Off || On || On
 +
|-
 +
| 31 || On || On || On || On || On || On || On
 +
|}
 +
 
 +
The DATVExpress user guide available here https://datv-express.com/uploads/UserGuide/DATV-Express%20Users%20Guide%20for%20Windows-draft14.pdf gives more details on the DATVExpress GPIO pinout including this table on page 65:
  
Thanks to Chris MW0LLK for his help in delivering this capability.
+
[[File:express pinouts.JPG|800px]]

Latest revision as of 09:35, 1 June 2019

Software versions 201702100 and later include the additional capability to control a DATV-Express exciter board from a Portsdown transmitter system without the filter modulator card. If you have an earlier Portsdown software version, please update to the latest version to provide these capabilities. Here are the full details.

The Portsdown Software running on an RPi 3 will control a DATV-Express board directly via the USB port, without the need for any PC or other computer. The system gives a compact touchscreen interface to DATV Express and provides some of the features for DVB-S transmission that you would get using a Windows PC to control DATV Express. DVB-S2 and DVB-T are not available, although there is hope for DVB-S2 capability in the future.

Equipment Required

Portsdown-DATV-Express-RPi3 Block-Diagram.jpg

A Block Diagram of a Typical Portsdown set-up for using the DATV-Express board for DVB-S modulator. The LCD Touchscreen is the normal GUI

For a usable Portsdown and DATV-Express transmitter, you will need a Raspberry Pi 3, a Waveshare touchscreen, a DATV Express board, suitable power supplies, and transmitter filters and linear amplifiers. Connect the DATV Express to the RPi 3 using a USB lead. Thanks to W6HHC for the diagram.

Capability

Using the touchscreen, the following capabilities can be controlled:

DVB-S H264 transmissions using the Pi Camera at Symbol Rates from 125 KS to 4 MS (but see limitations).

DVB-S MPEG-2 transmissions with sound using the Pi Camera and an external USB Microphone at Symbol Rates from 125 KS to 4 MS (but see limitations).

DVB-S H264 transmissions from composite video captured with a Fushicai EasyCap at Symbol Rates from 125 KS to 4 MS.

DVB-S MPEG-2 transmissions with sound from composite video captured with a Fushicai EasyCap at Symbol Rates from 125 KS to 4 MS.

Carrier transmission.

IPTS Streaming input from vMix and an ffmpeg batch file for H264 and MPEG-2 transmissions.

All FEC modes are available, and using the Console any frequency can be selected.

The output level can be set independently for each of 5 bands (71 MHz, 146 MHz, 437 MHz, 1255 MHz and 2400 MHz) from Advanced Settings, option 5. The power level calibration (0 - 47) is the same as the Windows V1.23 DATV Express software.

The PTT switching is implemented similarly to the Windows version.

The settings for Ports A through D can be selected for each band in Advanced Settings, Option 5.

Further details of the DATV Express functionality and pin assignments can be found on page 65 of this User Guide: DATV-Express Users Guide for Windows-draft14

Warnings and Limitations

- The DATV Express board should connected to the RPi and powered on before the RPi is booted.

- The Portsdown capability of booting straight to transmit is not available with the DATV Express board.

- Please be do not rely on the PTT pin sequencing to protect your pre-amps and PAs. The software is just not robust enough for the Portsdown team to give any guarantees of its functionality. You have been warned!

- There is no means of putting a callsign caption on H264 transmissions.

- There is a delay of 5 seconds before the first transmission after switch-on. This delay is to allow the DATV Express firmware to be downloaded from the RPi.

- H264 transmissions from the Test Card or Contest Card only display the upper part of the picture at symbol rates over 250 KS. It is hoped to cure this within the next few releases.

- MPEG-2 transmissions from the Test Card or Contest Card at 4 MS occasionally break up. It is hoped to cure this within the next few releases.

How It Works

DATV Express Server needs to be started at least 4 seconds or so before trying to send it any content, so it is started in the following places:

- On entering the Menu (console) system with DATV Express selected as an output mode.

- In a.sh if it is not detected as running.

In both cases the system sleeps for 5 seconds while the DATV Express server application starts up.

The express_server is controlled by sending commands to a file /tmp/expctrl. The transmission parameters and the start transmit, or start carrier messages are sent by a.sh. a.sh is called to transmit from both the console menu and the gui. Note that 5 band-dependent power levels can be pre-set in the Menu (Advanced Set-up).

The cease transmit or cease carrier commands are sent by the stop_transmit routines in either the menu.sh or in the gui.

Thanks to Charles G4GUO and Chris MW0LLK for their help in delivering this capability.

Port Switching From the Touchscreen

Ports A through D can now be set up to switch for each band from the touchscreen however, a number is requested. Here is the decode:

Number Port A J6 pin 5 Port B J6 pin 6 Port C J6 pin 7 Port D J6 pin 10
0 Off Off Off Off
1 On Off Off Off
2 Off On Off Off
3 On On Off Off
4 Off Off On Off
5 On Off On Off
6 Off On On Off
7 On On On Off
8 Off Off Off On
9 On Off Off On
10 Off On Off On
11 On On Off On
12 Off Off On On
13 On Off On On
14 Off On On On
15 On On On On

Portsdown software 201906060 (currently only a Dev release) introduces the facility to set the RPi GPIO Band Select and Transverter pins, independently of the transmitted frequency, by setting the ExpressPort to values between 16 and 31:

Number Port A J6 pin 5 Port B J6 pin 6 Port C J6 pin 7 Port D J6 pin 10 Band LSB pin 28 Band MSB pin 35 Tverter Bit pin 7
16 Off Off Off Off Off Off Off
17 On Off Off Off On Off Off
18 Off On Off Off Off On Off
19 On On Off Off On On Off
20 Off Off On Off Off Off On
21 On Off On Off On Off On
22 Off On On Off Off On On
23 On On On Off On On On
24 Off Off Off On Off Off Off
25 On Off Off On On Off Off
26 Off On Off On Off On Off
27 On On Off On On On Off
28 Off Off On On Off Off On
29 On Off On On On Off On
30 Off On On On Off On On
31 On On On On On On On

The DATVExpress user guide available here https://datv-express.com/uploads/UserGuide/DATV-Express%20Users%20Guide%20for%20Windows-draft14.pdf gives more details on the DATVExpress GPIO pinout including this table on page 65:

Express pinouts.JPG