DATV TX Tutorial: Difference between revisions

Revision as of 21:22, 13 September 2026

Home · Start here · All guides · Solve a problem · Radio terms · Developer API

This community guide uses GNU Radio Companion to encode a video as a DVB-S2 signal and sends the IQ output to SimTX. DATV means digital amateur television. Complete Getting Started first; a normal audio-file transmission is a simpler way to check account and server access.

Software and example files

GNU Radio Companion. The original guide linked a Windows radioconda installer; use the radioconda project for current installers.
FFmpeg builds for preparing the video.
Mukhash2012's DVB-S2 flowgraph and SimTX preset. Keep both files together for reference.
A receiver setup from DATV RX Tutorial for checking the result.

1. Prepare the video

The original example converts an MP4 to an MPEG transport stream with low-rate H.264 video and mono AAC audio. Replace the input and output filenames with your own. This preserves the settings supplied by the original tutorial.

ffmpeg -i File_name.mp4 -c:v libx264 -b:v 85k -maxrate:v 85k -bufsize:v 30k -preset slow -profile:v baseline -level 3.0 -vf "scale=320:240,fps=12,format=yuv420p" -c:a aac -b:a 24k -ac 1 -f mpegts -muxrate 140k -mpegts_pmt_start_pid 0x1000 -mpegts_start_pid 0x0100 -pcr_period 20 -pat_period 0.1 File_name.ts

2. Configure GNU Radio and SimTX

Open the supplied .grc flowgraph in GNU Radio Companion.
Open its File Source block and select the converted .ts file. A File Source reads the video; a File Sink writes an output file.
Check the flowgraph's TCP Sink. In the illustrated setup it is a client connecting to 127.0.0.1, port 7355.
In SimTX, use Presets > Load Preset File... to load the supplied .stxpreset.
Review the preset's station, frequency, power, and antenna. Confirm GNU Radio IQ is selected, its IQ Port matches the TCP Sink, and the expected sample rate matches the flowgraph.

GNU Radio DVB-S2 flowgraph with File Source, coding blocks, filter, and TCP Sink to localhost port 7355. — The original flowgraph illustration. It shows a 200000 samples/s output, 100000 symbols/s, QPSK, and code rate 3/4. Current downloaded files should be checked rather than assumed identical.

3. Start and verify

Start the SimTX transmission first so its local IQ input is listening.
Run the GNU Radio flowgraph so the TCP Sink connects to it.
Use DATV RX Tutorial with matching DVB-S2 parameters to check reception.

The illustrated parameters are one example, not settings for every DATV station. If no picture appears, check TCP connectivity first, then sample rate, symbol rate, code rate, receiver frequency, and signal strength. Stop the SimTX session when the test is finished.

@@ Line 1: / Line 1: @@
-First you need to download [https://glare-sable.vercel.app/radioconda/radioconda-installer/radioconda-.*-Windows-x86_64.exe GNU Radio Companion]
+{{Documentation navigation}}
-And [https://github.com/btbn/ffmpeg-builds/releases ffmpeg]
+This community guide uses GNU Radio Companion to encode a video as a DVB-S2 signal and sends the IQ output to SimTX. DATV means digital amateur television. Complete [[Getting Started]] first; a normal audio-file transmission is a simpler way to check account and server access.
-And you need to download [https://github.com/Mukhash2012/DVB-S2-SimTX my (Mukhash's) GNU set and SimTX preset (recommended)]
+== Software and example files ==
-[[File:TX1.png|500px|thumb|right|1 Welcome to GNU Radio Companion]]
+* GNU Radio Companion. The original guide linked a Windows radioconda installer; use the [https://github.com/ryanvolz/radioconda radioconda project] for current installers.
-. The preset has already set the I/Q stuff set, but you need to convert your video to MPEG-TS, using ffmpeg is recommended.
+* [https://github.com/btbn/ffmpeg-builds/releases FFmpeg builds] for preparing the video.
-This is the command used to convert the video into the TS that wont crash SDRangel (RX Tutorial)
+* [https://github.com/Mukhash2012/DVB-S2-SimTX Mukhash2012's DVB-S2 flowgraph and SimTX preset]. Keep both files together for reference.
+* A receiver setup from [[DATV RX Tutorial]] for checking the result.
+== 1. Prepare the video ==
+The original example converts an MP4 to an MPEG transport stream with low-rate H.264 video and mono AAC audio. Replace the input and output filenames with your own. This preserves the settings supplied by the original tutorial.
+<syntaxhighlight lang="bash">
 ffmpeg -i File_name.mp4 -c:v libx264 -b:v 85k -maxrate:v 85k -bufsize:v 30k -preset slow -profile:v baseline -level 3.0 -vf "scale=320:240,fps=12,format=yuv420p" -c:a aac -b:a 24k -ac 1 -f mpegts -muxrate 140k -mpegts_pmt_start_pid 0x1000 -mpegts_start_pid 0x0100 -pcr_period 20 -pat_period 0.1 File_name.ts
+</syntaxhighlight>
+== 2. Configure GNU Radio and SimTX ==
+# Open the supplied <code>.grc</code> flowgraph in GNU Radio Companion.
+# Open its '''File Source''' block and select the converted <code>.ts</code> file. A File Source reads the video; a File Sink writes an output file.
+# Check the flowgraph's '''TCP Sink'''. In the illustrated setup it is a client connecting to <code>127.0.0.1</code>, port <code>7355</code>.
+# In SimTX, use '''Presets''' > '''Load Preset File...''' to load the supplied <code>.stxpreset</code>.
+# Review the preset's station, frequency, power, and antenna. Confirm '''GNU Radio IQ''' is selected, its IQ Port matches the TCP Sink, and the expected sample rate matches the flowgraph.
+[[File:TX1.png|thumb|center|1000px|alt=GNU Radio DVB-S2 flowgraph with File Source, coding blocks, filter, and TCP Sink to localhost port 7355.|The original flowgraph illustration. It shows a 200000 samples/s output, 100000 symbols/s, QPSK, and code rate 3/4. Current downloaded files should be checked rather than assumed identical.]]
+== 3. Start and verify ==
+# Start the SimTX transmission first so its local IQ input is listening.
+# Run the GNU Radio flowgraph so the TCP Sink connects to it.
+# Use [[DATV RX Tutorial]] with matching DVB-S2 parameters to check reception.
-And the load the .ts into the GNU Radio Companion "File Sink"
+The illustrated parameters are one example, not settings for every DATV station. If no picture appears, check TCP connectivity first, then sample rate, symbol rate, code rate, receiver frequency, and signal strength. Stop the SimTX session when the test is finished.
-Start SimTX first and then GNU Radio, and then enjoy!
+[[Category:SimTX]]