You are here

MSHV Amateur Radio Software

MSHV Supported working modes: MSK144 JTMS FSK441 FSK315 ISCAT JT6M FT8 JT65 PI4

 
 

Subscribe to MSHV group

Link to the MSHV group

 

NEW MSHV version 1.60

Download MSHV for Windows 32-bit and/or 64-bit Installer
Download MSHV for Windows 32 and 64-bit in zip file
Download MSHV Debian Linux binaries 32 and 64-bit compiled by Peter - OZ1PIF
Download MSHV Full Source Code. For Linux, compiling is required
 Project page for developers and source code can be found here:
 
 
Download the full package of sample files
Download the ZAP example files
 
New in version 1.60:
  • Added: In Decode menu for "Max X Decoded Signals JT65" option, every mode saves its own individual settings (JT65 A,B,C).
  • Added: In Decode menu for "Enable Averaging JT65" option, every mode saves its own individual settings (JT65 A,B,C).
  • Added: In Decode menu for "Enable Deep Search JT65" option, every mode saves its own individual settings (JT65 A,B,C).
  • Added: In Decode menu for "Check for VHF/UHF Uncheck for HF Features JT65" option, every mode saves its own individual settings (JT65 A,B,C).  
  • Corrected: JT65 Sh reports decoding, reported by Oguzhan TA2NC.
  • Added: In Auto sequence, when CQ, auto adding locator to label LOCATOR.
  • Added: In Options menu, "Use Two Decode Lists FT8 JT65" for HF works in FT8 and JT65 modes. The second list contains all messages in range +/-10Hz from RX frequency and messages that contain MyCall in whole the bandwidth.
  • Removed: AP Decoding from JT65 modes.
  • Removed: Decode levels from JT65 modes.
MSHV
Developed by LZ2HV - Christo
Tested by SP9HWY - Jurek and G0LFF - Dick
Ideas about appearance OZ2M - Bo
Linux binaries OZ1PIF - Peter
 
Acknowledgements to K1JT Joe Taylor and WSJT Development Group. The algorithms, source code, look-and-feel of WSJT-X and related programs, and protocol specifications for the modes FSK441, FT8, JT4, JT6M, JT9, JT65, JTMS, QRA64, ISCAT, MSK144, are Copyright © 2001-2017 by one or more of the following authors: Joseph Taylor, K1JT; Bill Somerville, G4WJS; Steven Franke, K9AN; Nico Palermo, IV3NWV; Greg Beam, KI7MT; Michael Black, W9MDB; Edson Pereira, PY2SDR; Philip Karn, KA9Q; and other members of the WSJT Development Group.
 
The program was borrowed from the open source software K1JT. Only decoders and generators were used from K1JT - WSJT and were rewritten to C ++. Almost the same location of controls was used for easy operation. The software is fully compatible with the modes in WSJT software. The visual interface is QT4.6.8. All required libraries are compiled statically and are embedded in the body of the software. Additional libraries are not necessary. All settings and configurations happen immediately and do not need to be restarted, for example changing the sound settings or rig control.
 
Information:

Authors of the protocols are: K1JT Joe Taylor, and K9AN Steven Franke - for MSK144 and FT8

  • MSK144 For meteor scatter. Message frame duration is 72 ms and with Sh option 20 ms. Character transmission rate for standard messages is as high as 250 cps.
  • JTMS For meteor scatter. Character transmission rate 197 cps.
  • FSK441 For meteor scatter. Character transmission rate 147 cps.
  • FSK315 For meteor scatter. Character transmission rate 105 cps.
  • ISCAT Optimized for meteor and ionospheric scatter at 6 meters. Character transmission rate 16.15 or 32.3 cps.
  • JT6M Optimized for meteor and ionospheric scatter at 6 meters. Character transmission rate 14.4 cps.
  • FT8 Designed for fast tropospheric QSOs.
  • JT65 VHF/UHF For EME and troposcatter.
  • PI4  PharusIgnis4 A digital modulation (MGM) for beacon purposes.
System Requirements:
  • SSB transceiver and antenna for one or more VHF/UHF/SHF bands.
  • Computer running the Microsoft Windows Xp, Windows 7 32 or 64 Bit.
  • For Linux QT4.8.6 and Alsa librarys.
  • 1 GHz or faster CPU and 128 MB of available RAM.
  • The monitor with minimum resolution 1024x768 or for notebooks 1366x768 (more is better).
  • Computer-to-radio interface using a serial port for T/R switching, or VOX control.
  • Audio input and output devices supported by the operating system (Sound card full duplex).
  • Audio or equivalent USB connections between transceiver and computer.
  • A means for synchronizing the computer clock to UTC within ±1 s.
Installation:
  • No need for special installation, just extract the archive file with its containing folder wherever you want in the PC.
  • Recommended place is a non Operating System drive, for example if OS is in C:\  extract into the D:\MSHV_XXX .
  • Starting software from the *.exe file or create a shortcut on the desktop. Do not copy .exe file to desktop.
  • If you have an old version of software, please delete the existing shortcut on the desktop if there is one. Extract the archive file with its containing folder and then create a new shortcut on the desktop. If you no longer need the old version you can delete it.
 
Configuration of software:
  • On menu Options - Sound Settings and Display Refresh Speed
     
    • Configure your sound card input settings and sound card output settings, choose Input Channel Settings left or right.
    • Refresh function display is made for slow computers. If you use Display Refresh Speed, the update of the displays will vary in speed. This reduces the load on the CPU.
    • Level Meter Refresh Speed, slows down the Level Meter update.
  • On menu Options - Interface Control
     
    • Configure PTT settings via RTS, DTR or Via CAT Command default is RTS.
    • Test with button Start Ptt Test.
  • On menu Options - Macros
     
    • Setup My Call, Grid Locator and TX macros
    • Valid Macros are:
      • MyCall = %M
      • HisCall = %T
      • RST = %R
      • 4 CharactersLocator = %G4 example = KN23
      • 6 CharactersLocator = %G6 example = KN23SF
      • Random QRG = %QRG
      • Serial Number = %N
    • Radio Buttons Kilometers, Miles change distance units.
    • Radio Buttons Region 1, Region 2, Region 3 returns default macros by region.
    • Radio Button Report Macros returns default macros which contain the report.
    • Radio Button Grid Macros returns default macros which contain the grid locator.
    • Radio Button RSQ And Serial Number returns default macros which contain the RSQ report and serial number.
    • Button GEN MESSAGE immediately generates text messages for transmitting.
    • Button SET DEFAULT MACROS returns default macros.
  • On menu Options - Radio And Network Configuration
     
    • Tick "Enable PSK Reporter Spotting" in PSK Reporter Settings box to enable spotting.
    • In this box, you can change server and port, if needed.
    • In the table below it, you should double click on every row to set you personal radio informations.
  • On menu Options:
     
    • Play Control directly accesses the Windows Play Control mixer.
    • When transmitting, this control sets an appropriate level for your transmitter.
    • Record Control as Play Control directly accesses the Windows Record Control mixer. With this control you adjust the noise level from the receiver to reach 0db strength, while monitoring the indicator to the right of the software. It is important for proper decoding.
    • Radio And Network Configuration Menu you have to start PSK Reporter Spotting.
    • Text Highlight marks specific word(s) in message.
    • Using the Generate Messages For Test Tones creates specific messages that generate different tones with the help of which you can set the levels of transmission. The tones are within the 100Hz - 3000Hz, for example, if you type in a message @1000=1000Hz, there are special letter combinations @A=882Hz, @B=1323Hz, C@=1764Hz, @D=2205Hz, which are approximately the frequencies on which the software runs.
    • Menu "Time Synchronization" is a shortcut to Data Time Properties. Follow the instructions on the info window to synchronize computer time. For this purpose, you need to be connected to the Internet.
    • "Monitor ON At Startup" Start monitor automatically at software startup.
    • "View JT65 DF Axis On Display". Change display scale to show DF in mode JT65.
    • "Astronomical Data" View view full data for the Moon.
Functions of Software:
  • On menu File
    • "Open" You can open files previously stored from the software, for decoding and display. The software opens files with the extension *.WAV, sample rate 11025 KHz, mono.
    • Drag and Drop function. You can drag and drop a *.wav file from Windows Explorer to Display 1 and they will automatically open and decode. You can drag and drop *.wav files only one by one.
    • "View Log" You can open open simple log program.
    • "Overwrite Locator Database" Overwrite the existing locator database. For example, when a new software version is released, you can overwrite database from your old software. The locator database are in the file MSHV_XXX/settings/database/msloc_db.dbmh of your old version.
  • On menu Palette
     
    • Palette menu changes the colors of the decoder displays.
  • On menu Mode
     
    • Mode menu changes the working type.
  • On Menu Decode
     
    • Fast MSK144, is used for slow CPU speed PC.
    • Norman MSK144, is used for more sensitive decoding.
    • Deep MSK144, is used for fast CPU PC.
    • MSK144 RX Equalization Off.
    • MSK144 RX Equalization Static, static coefficients for equalization.
    • MSK144 RX Equalization Dynamic, coefficients for equalization from you receiver.
    • MSK144 RX Equalization S And D, Static and Dynamic together.
    • Single Decoded Signal JT65, is used for synchronize only one signal.
    • Max 4,8,16,32 Decoded Signals JT65, is used for multy signals synchronization.
    • Enable Averaging JT65, is used for very weak signals need minimum 3 periods to activate average decoding.
  • Displays area
     
    1. The program contains two displays which show the received signal. When display 1 is filled for the period of 30 seconds the information is automatically moved to display 2. Then display 1 starts filling again with new information. A line graph for the time in seconds is being shown at the top of the display. The middle part of the display presents the signal as a waterfall. The graph below presents the signal strength indicator.
    2. To decode the received signals from the display, click with the mouse in the center of the received ping. When you press the display, two lines appear that show the region of decoding. Pressing the right mouse button makes the region twice larger than pressing the left one. No matter which display you decode, both are always active.
    3. To the right there is a slider to adjust display settings. Please, in the Windows Record Control mixer, first adjust the noise level from the receiver by positioning the stretch indicator at 0db strength . Secondly, adjust the displays using the Tune Displays slider to show dark blue color with small green dots, as shown in the picture "Displays area".
    4. Under each display there is a button to help you save the data in file. Files are stored in the directory RxWavs. The button displays the file name. The file name contains information about the correspondent's callsign, working type, year and time. There is an exception if the callsign is (/), it is replaced with the word SLASH, for example LZ2HV/P will be saved as LZ2HV_SLASH_P. This is necessary because (/) means the creation of computer path to directory and you cannot save the file.
    5. For small display resolutions (eg. 800x600 pix) in lefthand display area, button 2D/1D - changes application to work with two or one displays or shortcut F10 for this function, and button D1/D2 - switches displays, if working on one display or shortcut F11 for this function.
  • Info Panel
     
    • In the information panel indications of the state of the software are placed.
    • Label mode shows the working type of the software.
    • Checkbox Auto Decode (Auto Dec) is used for decoding automatically after receiving period or opening a file. Can be activated or not.
    • Checkbox Real-Time Decode (RT Dec) is used for decoding in real-time. Can be activated or not.
    • Decode label indicates when the software is busy decoding if red light is currently on.
    • Label Receive in green color means that the software is currently recording.
    • Txing label shows the current text to be transmitted and its red color indicates that it is currently being transmitted.
    • Strength indicator of the received signal must be set so that the normal noise of the radio shows 0db, for example .
  • Display List
     
    • The display shows the message being decoded . You can copy the message as you left-click once to select the row, then Ctrl+C to copy info and then with Ctrl+V you can paste it to put into the text document. The copied message is specially formatted, for example, FSK441 103330 11.6 s 320 ms 7 dB 26 -18 Hz > ON5VW R26 R26 SP9HWY ON5VW. If you double-click with the left mouse button on the row, you will be able to enter the selected row and then again if you press twice in the middle of the continuous text, it will automatically be transferred into the cell TO RADIO and then will automatically generate all text messages.
    • If you want to add TX RPT, just double click the row from column dB or Rpt. If you double-click the row from column Messages with the left mouse button, you will be able to enter the selected row and then again if you press twice in the middle of the continuous text, it will automatically be transferred into the cell TO RADIO, same refers to grid locator.
  • Buttons Panel
     
    • Buttons control the receiving and transmission of the software. The special thing about them is that once the monitor is on, it does not stop until you disconnect it with the stop button. In AUTO IS ON, if you press the STOP TX button, AUTO IS ON will be canceled and will be changed to AUTO IS OFF.
    • Button RESET QSO clear labels TO RADIO and HIS LOCATOR, and updates the Text Messages Panel.
    • Button CLEAR MESSAGES erases all messages in the message list display.
    • Button TUNE TX 1000 Hz tone for tuning transmitter.
  • Info Clock, Database Panel and Add to log QSOs
     
    • This Panel displays your callsign, locator, date, time and the database for other stations and their locators. On entering the correct locator, the software calculates the direction and distance to the correspondent. When you enter the callsign of your correspondent, if it is in the database, it will be displayed next to the LOOKUP button, after pressing the LOOKUP button, the locator will be automatically placed in the box LOCATOR. Then you will get the data for the direction and distance to the correspondent. If you know the exact locator correspondent, you can enter it into the database manually by pressing ADD button .
    • The correspondent's callsign appears in TO RADIO. You can add or copy it onto the list manually or by double-clicking in the list.
    • The button ADD TO LOG adds QSO in the simple log program. You can view the log from the file menu or press Ctrl+L.
    • You can set the receiving report in the RX RPT box .
    • Monitor Radio 1 (R1:), Monitor Radio 2 (R2:) option to monitor others, if they support "MSK144 + Sh" option. In all modes, these labels work as "Text Highlight" option as well.
  • Squelch Df Callsign Rst Tx Panel
     
    • Squelch is displayed on the top and it can be adjusted as recommended according to default value.
    • DF indicates possible differences in frequencies in order to find correspondent signal and it can be adjusted as recommended according to default value.
    • RST or RSQ is the estimation of the signal.
    • TX SN contest serial number.
    • Radio buttons TX FIRST TX SECOND set the period of transmission.
    • Button GEN MSG generates the messages from macros and enters texts to the TX messages.
    • Button AUTO IS ON / OFF controls if the software runs in automatic mode or not. In AUTO IS ON mode, it begins to work in synchronized pre-defined period (30 s).
    • RANDOM QRG is the offset for random contacts in 3 digits max.
    • ZAP function: Filter out birdies (narrowband signals of approximately constant amplitude) before attempting to decode. This function requires 10s. of receiving period before beginning to work properly. The filtering period does not show in the display area.
    • TX/RX 30s is a period of work 5s, 10s, 15s and 30s.
    • Sh option in MSK144 mode (e.g. MSK144 + Short Reporting).
    • Label "RXF/RXS" - when the Label "RXF/RXS" or key F9 is pressed, RXing works only during the first or second period.
  • Text Messages Panel
     
    • All text messages long 1-28 characters are in this panel. You can write them by hand or generate them by macros. When you press any of the buttons TX1... TX7 its message transmission begins immediately.
    • When changing the radio buttons, the message is not transmitted immediately and only shows which of them will be transmitted in the next period.
    • Slider "RX Level Correction" change input sound card level +/-12dB.
    • Slider "TX Level Correction" change output sound card level.
  • Log program:
    • In the simple log program you can add, edit, delete, find and sort QSOs. You can set the receiving report in the RX RPT box . From menu Band, you can choose the band so it is correctly written in the simple log. Sorting of logs in simple log can be done by clicking on the headers of the columns. To return to the default view, click the Default Sort button.
    • From the "Add Log" menu you can add contacts to your log. For example, when a new software version is released, you can add the contacts from your old software. The contacts are in the file MSHV_XXX/log/mshv.edil of your old version.
    • In Log Menu there is Export QSOs in ADIF format ("Export Selected In ADIF" or "Export All In ADIF"). Destination of exported files is in ExportLog directory.
  • Keyboard Shortcuts:
    • Ctrl+H MSHV Help
    • Ctrl+K Keyboard Shortcuts
    • Ctrl+O File Open
    • Alt+F4 Exit
    • Ctrl+S Sound Settings
    • Ctrl+I Interface Control
    • Ctrl+M Macros
    • Ctrl+P Play Control
    • Ctrl+R Record Control
    • Ctrl+L View Log
    • Alt+L Add Qso To Log
    • Alt+M Start Monitor
    • Alt+S Stop Monitor
    • F1 to F7 Tx1 to Tx7
    • Esc TX Stop
    • Ctrl+A Toggle Auto On/Off
    • Ctrl+G Generate Messages
    • Ctrl+1 Save Dislay 1 Data as *.WAV
    • Ctrl+2 Save Dislay 2 as Data *.WAV
    • Ctrl+Z Toggle ZAP On/Off
    • F12 Screenshot
    • F9 RX Only First Or Second Period
    • F10 Switches number of displays from two to one and vice versa
    • F11 Switches displays, if working on one display
Directories and files:
  • Directory AllTxtMonthly
    • Text files for each month are collected in directory AllTxtMonthly containing all TX and RX messages. You can open them with text editor and search content from your connections.
    • Do not delete the directory.
    • You can delete text files periodically if they are no longer needed.
  • Directory ExportLog
    • Do not delete the directory ExportLog and its content. It contains all exported log files.
  • Directory log
    • Do not delete the directory settings and content. They keep you log data.
  • Directory RxWavs
    • It contains all recorded files during all your work.
    • Do not delete the directory.
    • Periodically, you can delete files that you do not need.
  • Directory Screenshots
    • Do not delete the directory. It contains all screenshot files during all your work.
    • You can delete screenshot files periodically if they are no longer needed.
  • Directory settings
    • Do not delete the directory settings and content. They keep all software settings.

LZ2HV 2015