SSB_HighSpeed_Modem/README.md

86 lines
4.0 KiB
Markdown
Raw Normal View History

2020-10-27 11:41:16 -04:00
# QO-100-modem
The purpose of this project is to transfer data (pictures...) via a 2,7kHz SSB channel on the narrow band transponder as fast as possible.
# this is work in progress
2020-11-21 13:54:47 -05:00
Version 0.4 is working on:
2020-11-05 13:11:57 -05:00
Windows 10 (should work on Win7, not tested)
linux Desktop PC,
Odroid SBC
Raspberry 4 (3B+)
2020-10-27 11:41:16 -04:00
# Prerequisites
2020-11-05 13:11:57 -05:00
* Windopws 10 Desktop PC ... working
2020-10-27 11:41:16 -04:00
* LINUX Desktop PC ... working
* Raspberry PI 4 ... working
* Raspberry PI 3B+ ... working, but not 100% error free in fullduplex mode (RX only or TX only is working)
* Odroid N2 ... working
* Odroid C2 ... working
* Odroid C4 ... working
* Raspberry: Raspian OS ist NOT working, instead Ubuntu 64bit is required
* Application Software "oscardata.exe" running on Windows, Linux, (possibly MAC-OS, not tested)
2020-11-05 13:18:43 -05:00
# 3rd Party Libraries
this software uses these programs:
2020-11-05 13:23:45 -05:00
* Shifra Reed Solomon code: https://www.schifra.com/ (GPL V.2)
* liquid-SDR: https://github.com/jgaeddert/liquid-dsp (MIT License)
* BASS Audio: https://www.un4seen.com/ (free for non-commercial use)
* fftw3: http://www.fftw.org (GPL V.2 or later)
2020-11-21 13:54:47 -05:00
* libcodec2 (Linux: standard lib, Windows: from freeDV)
2020-10-27 11:41:16 -04:00
# building the software
2020-11-05 13:11:57 -05:00
* Linux
1. go into the folder "hsmodem"
2020-10-27 11:41:16 -04:00
2. run "make"
2020-11-05 13:11:57 -05:00
3. the executable is in folder LinuxRelease
* Windows
1. load hsmodem.sln in VisualStudio-19 and build Release version.
2. the executable is in folder WinRelease
2020-10-27 11:41:16 -04:00
# starting the modem and application
2020-11-05 13:11:57 -05:00
you need to run 2 programs, the first one is "hsmodem" which runs in a termimal without GUI. This is the modem doing all modulation and demodulation staff.
The second program is the user interface "oscardata.exe".
2020-11-21 13:54:47 -05:00
* Windows
copy all files from "WinRelease" into any folder of your choice. Start oscardata.exe by double-clicking.
The application oscardata.exe can also run on a different PC in your home network, see Linux version.
Even a mix between Linux and Windows is possible, so running oscardata.exe on a Windows PC and
running the hsmodem on another computer in the shack.
* Linux
1. go into the folder "LinuxRelease"
2020-11-05 13:11:57 -05:00
2. run the software: ./hs100modem.exe or ./hsmodem
optional command line parameter:
2020-10-27 11:41:16 -04:00
no parameter ... normal usage
-m IP ... specify the V4 IP adress of the device where the application software is running. This is useful if you have more than one qo100modem running simultaneously. Without this parameter the app will search the modem automatically.
3. start the user application on any PC in your home network. It will find the modem automatically
2020-11-05 13:11:57 -05:00
The file is located in oscardata/oscardata/bin/Release
2020-10-27 11:41:16 -04:00
On windows just start oscardata.exe
On Linux start it with: mono oscardata.exe
# tested scenarious
* QO-100 via IC-9700, IC-7300 or IC-7100 ... working
* Short Wave 6m band via IC-7300, IC-7100 ... working. In case of significant noise, use the lowest bit rate (3000 bit/s)
2020-11-05 13:11:57 -05:00
2020-10-27 11:41:16 -04:00
# usage
In the IC-9700 activate the DATA mode and the RX filter FIL1 to full range of 3.6kHz.
In oscardata.exe go to the "BER" tab. Then click START. If you change the bitrate, wait a few seconds before starting again.
The program is now sending test data frames to the default sound card. If your sound card is properly connected to the transceiver then switch the transceiver to TX and the data will be sent to QO-100.
Receive your transmission, feed it to the default soundcard. As soon as oscardata.exe detects a correct data frame it will display status messages on the screen.
(For testing purposes you can just connect Line-Out of your soundcard with Line-IN with a cable.)
To assign the soundcard to the modem I recommend to use pavucontrol. Using the TX volume set a signal level of about 20 to 24 dB over noise floor. You will need about -10dB compared to the BPSK400 beacon. The received audio volume can be adjusted with help of the spectrum display in oscardata.exe-
Now as the transmission is OK, you can go to the "Image RX/TX" tab. First, select a picture quality then load a picture and finally press SEND to send it to QO-100. When you correctly receive your own transmission the RX picture will be displayed line by line.
vy 73, DJ0ABR