Difference between revisions of "Controlling a DATVExpress"

From BATC Wiki
Jump to navigation Jump to search
 
(23 intermediate revisions by 3 users not shown)
Line 1: Line 1:
Work is ongoing to introduce the capability to control a DATV Express exciter board from the Portsdown transmitter.  The capability will be included in the core build once it is robustIn preparation, here are some 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 cardIf you have an earlier Portsdown software version, please update to the latest version to provide these capabilitiesHere are the full details.
  
The Portsdown Software running on an RPi 3 will control a DATV Express board directly, 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.  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]]
  
Capability
+
'''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:
 
Using the touchscreen, the following capabilities can be controlled:
  
DVB-S H264 transmissions using the Pi Camera at Symbol Rates from 333 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 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 MPEG-2 transmissions using the Pi Camera at Symbol Rates from 333 KS to 4 MS.
+
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 250 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 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: [https://datv-express.com/uploads/UserGuide/DATV-Express%20Users%20Guide%20for%20Windows-draft14.pdf 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.
  
The FileTS (playing a pre-recorded TS file) and PATERNAUDIO (test card) and Desktop modes do not function properlyWork 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.
+
-   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.
  
All FEC modes are available, and using the Console any frequency can be selected.
+
-  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
+
===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:
 
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:
Line 31: Line 62:
 
-  In a.sh if it is not detected as running.
 
-  In a.sh if it is not detected as running.
  
In both cases the system sleeps for 5 seconds while it 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 express_server is controlled by send 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 4 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.
  
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:
 +
 
 +
{| 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:
 +
 
 +
[[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