diff --git a/Darwin/ReadMe.txt b/Darwin/ReadMe.txt index df24657..d6895bf 100644 --- a/Darwin/ReadMe.txt +++ b/Darwin/ReadMe.txt @@ -1,108 +1,26 @@ +Some versions of Mac OS need special system settings to allow a shared memory +segment to be created (this is how the application communicates with the decoder). - Notes on JS8Call Installation for Mac OS X - (replace all instances of WSJT-X with JS8Call) +Included in this DMG is a sysctl.conf file that you can use to increase the +shared memory that the operating system allows to be allocated. You only have to do this process once. - Notes on WSJT-X Installation for Mac OS X - ----------------------------------------- +To install: - Updated 16 July 2017 - -------------------- +0) Caution! Read through these instructions completely before proceeding. + If you are at all uncomfortable modifying your system, please feel free to + email me and I will help you walk though steps: kn4crd@gmail.com -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. +1) Copy the sysctl.conf file to your desktop -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. +2) Open a Terminal window (Applications -> Utilities -> Terminal.app) -BEGIN: +3) Run these commands in the Terminal window to install the sysctl.conf -There are some system matters you must deal with first. Open a Terminal window -by going to Applications->Utilities and clicking on Terminal. + sudo cp $HOME/Desktop/sysctl.conf /etc/sysctl.conf + sudo chmod 0664 /etc/sysctl.conf + sudo chown root:wheel /etc/sysctl.conf -Along with this ReadMe file there is a file: sysctl.conf. Drag this file to your Desktop. - -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. - -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 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 -reboot you should re-open the Terminal window as before and you can check that the -change has been made by typing: - - sysctl -a | grep sysv.shm - -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. - -NEXT: - -Drag the WSJT-X app to your preferred location, such as Applications. - -You need to configure your sound card. Visit Applications > Utilities > Audio MIDI -Setup and select your sound card and then set Format to be "48000Hz 2ch-16bit" for -input and output. - -Now double-click on the WSJT-X app and two windows will appear. Select Preferences -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. - -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 -possible to give detailed advice on selection. If you have difficulties contact me. -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. - -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/tty.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. - -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 -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. - -Please email me if you have problems. - ---- John G4KLA (g4kla@rmnjmn.co.uk) +4) Reboot your system. +If you run into any problems, feel free to reach out to me and I will help you +walk through the steps: Jordan Sherer