From 206b8f59f1a0ba7f903f1f2a43e2425a9c22b81f Mon Sep 17 00:00:00 2001 From: Bill Somerville Date: Thu, 11 Jun 2020 14:29:09 +0100 Subject: [PATCH] Updated Mac Read Me file, thanks to John, G4KLA --- Darwin/ReadMe.txt | 98 ++++++++++++++++++++++------------------------- 1 file changed, 45 insertions(+), 53 deletions(-) diff --git a/Darwin/ReadMe.txt b/Darwin/ReadMe.txt index 3a2afdc19..3adf32f21 100644 --- a/Darwin/ReadMe.txt +++ b/Darwin/ReadMe.txt @@ -5,40 +5,24 @@ If you have already downloaded a previous version of WSJT-X then I suggest you change the name in the Applications folder from WSJT-X to WSJT-X_previous before proceeding. -If you have installed a previous version of WSJT-X before then there is no -need to change anything on your system so proceed to NEXT. +If you have installed a previous version of WSJT-X before, then there is no +need to change anything on your system so proceed to NEXT. If you upgrade macOS +it is possible that you might need to re-install the sysctl.conf file. BEGIN: -There are some system matters you must deal with first. Open a Terminal window -by going to Applications->Utilities and clicking on Terminal. +Double-click on the wsjtx-...-Darwin.dmg file you have downloaded from K1JT's web-site. -Along with this ReadMe file there is a file: sysctl.conf. Drag this file to your Desktop. +Now open a Terminal window by going to Applications->Utilities and clicking on Terminal. -WSJT-X makes use of a block of memory which is shared between different parts of -the code. The normal allocation of shared memory on a Mac is insufficient and this -has to be increased. You should use a Mac editor to examine sysctl.conf. +Along with this ReadMe file there is a file: sysctl.conf which must be copied to a +system area by typing this line in the Terminal window and then pressing the Return key. -There are two important parameters that you need to consider. shmmax determines the -amount of shared memory that must be allocated for WSJT-X to operate. This is 14680064 (14MB) -and this is defined in the sysctl.conf file and should not be changed. + sudo cp /Volumes/WSJT-X/sysctl.conf /etc -It is possible to run more than one instance of WSJT-X simultaneously. See -"Section 14. Platform Dependencies" in the User Guide. The second important parameter -shmall=17920 determines how many instances are permitted. This is calculated as: - (shmall x 4096/14680064) = 5. -The sysctl.conf file is configured to permit up to 5 instances of wsjtx to run simultaneously. -If this limitation is acceptable then you can continue to install the sysctl.conf file without making any -alterations. Otherwise you must edit the file to increase shmall according to this calculation. - -Now move this file into place for the system to use by typing: (Note this assumes that -you really did drag this file to your Desktop as required earlier.) - - sudo cp "$HOME/Desktop/sysctl.conf" /etc/ - sudo chmod 664 /etc/sysctl.conf - sudo chown root:wheel /etc/sysctl.conf - -and then reboot your Mac. This is necessary to install the changes. After the +you will be asked for your normal password because authorisation is needed to copy this file. +(Your password will not be echoed but press the Return key when completed.) +Now re-boot your Mac. This is necessary to install the changes. After the reboot you should re-open the Terminal window as before and you can check that the change has been made by typing: @@ -47,11 +31,10 @@ change has been made by typing: If shmmax is not shown as 14680064 then contact me since WSJT-X will fail to load with an error message: "Unable to create shared memory segment". -You are now finished with system changes. You should make certain that NO error messages -have been produced during these steps. You can now close the Terminal window. It will -not be necessary to repeat this procedure again, even when you download an updated -version of WSJT-X. - +You can now close the Terminal window. It will not be necessary to repeat this procedure +again, even when you download an updated version of WSJT-X. It might be necessary if you +upgrade macOS. + NEXT: Drag the WSJT-X app to your preferred location, such as Applications. @@ -65,11 +48,8 @@ under the WSJT-X Menu and fill in various station details on the General panel. I recommend checking the 4 boxes under the Display heading and the first 4 boxes under the Behaviour heading. -IMPORTANT: If you are using macOS 10.14 (Mojave) it is important to note that the default setting -for audio input is "block". In order to receive audio from WSJT-X you must visit -System Preferences > Security & Privacy > Privacy and, with WSJT-X launched, select "Microphone" -under Location Services and wsjtx should appear in the panel. Check the "Allow" box. You will -have to quit WSJT-X for this change to take effect. +Depending on your macOS you might see a pop-up window suggesting that wsjtx wants to use the +microphone. What this means is that audio input must be allowed. Agree. Next visit the Audio panel and select the Audio Codec you use to communicate between WSJT-X and your rig. There are so many audio interfaces available that it is not @@ -77,31 +57,43 @@ possible to give detailed advice on selection. If you have difficulties contact Note the location of the Save Directory. Decoded wave forms are located here. Look at the Reporting panel. If you check the "Prompt me" box, a logging panel will appear -at the end of the QSO. Two log files are provided in Library/Application Support/WSJT-X. -These are a simple wsjtx.log file and wsjtx_log.adi which is formatted for use with -logging databases. The "File" menu bar items include a button "Open log directory" -to open the log directory in Finder for you, ready for processing by any logging -application you use. +at the end of the QSO. Visit Section 11 of the User Guide for information about log files +and how to access them. Finally, visit the Radio panel. WSJT-X is most effective when operated with CAT -control. You will need to install the relevant Mac driver for your rig. This must -be located in the device driver directory /dev. You should install your driver -and then re-launch WSJT-X. Return to the the Radio panel in Preferences and in -the "Serial port" panel select your driver from the list that is presented. If -for some reason your driver is not shown, then insert the full name -of your driver in the Serial Port panel. Such as: /dev/cu.PL2303-00002226 or -whatever driver you have. The /dev/ prefix is mandatory. Set the relevant -communication parameters as required by your transceiver and click "Test CAT" to -check. +control. You will need to install the relevant Mac device driver for your rig, +and then re-launch WSJT-X. Return to the Radio panel in Preferences and in +the "Serial port" panel select your driver from the list that is presented. If you +do not know where to get an appropriate driver, contact me. WSJT-X needs the Mac clock to be accurate. Visit System Preferences > Date & Time -and make sure that date and time are set automatically. The drop-down menu will +and make sure that Date and Time are set automatically. The drop-down menu will normally offer you several time servers to choose from. On the Help menu, have a look at the new Online User's Guide for operational hints -and tips. +and tips and possible solutions to any problem you might have. Please email me if you have problems. --- John G4KLA (g4kla@rmnjmn.co.uk) +Addendum: Information about sysctl.conf and multiple instances of wsjt-x. + +WSJT-X makes use of a block of memory which is shared between different parts of +the code. The normal allocation of shared memory on a Mac is insufficient and this +has to be increased. The sysctl.conf file is used for this purpose. You can +use a Mac editor to examine sysctl.conf. (Do not use another editor - the file +would be probably be corrupted.) + +There are two important parameters that you need to consider. shmmax determines the +amount of shared memory that must be allocated for WSJT-X to operate. This is 14680064 (14MB) +and this is defined in the sysctl.conf file and should not be changed. + +It is possible to run more than one instance of WSJT-X simultaneously. See +"Section 16.2 Frequently asked Questions" in the User Guide. The second important parameter +shmall=17920 determines how many instances are permitted. This is calculated as: + (shmall x 4096/14680064) = 5. +The sysctl.conf file is configured to permit up to 5 instances of wsjtx to run simultaneously. +If this limitation is acceptable then you can continue to install the sysctl.conf file without making any +alterations. Otherwise you must edit the file to increase shmall according to this calculation. +