SR20cntrl, receiver control software, ver. 0.7


The SR20cntrl software allows to control a subset of the AOR-SR2000A receiver functions from a MS-Windows based pc. Installing the software on other OS such as Mac OSX or Linux should be possible provided that the serial communication works properly (I hope to probe all this in the near future).


For the moment, only a part of the AOR-SR2000A receiver functions are supported, but work is in progress and each new SW version includes more functionalities. Some functions still not supported are: search & scan, priority channels, and waterfall spectrum plots.

New to this version (0.7) is the management of memory banks and channels:
Now, it is possible to:
- write, modify, select, copy, paste, etc, channels and groups of channels,
- save memory banks to files, or load channels from them,
- tune to a memory channel or save a tuned frequency information to a receiver channel,
- display bank channels information sorted (in ascending or descending order),
- customize column disposition in the viewed displayed information,

all this can be done concurrently, letting you work, at the same time, with other receiver operations.

addtionally in this version:
- SW can be now configured for, alternatively, using USB communication (instead of RS232 one),
- Some minor bugs have also been corrected.
 



Installation instructions (WINDOWS)

Installation requirements:
This software has been developed for the AOR-SR2000A receiver (it could also work with other AOR receivers, particularly with the AOR-SR2000, at this moment there are some users that are trying to use the software with this last receiver, and I will try to maximize the compatibility of the soft., but I am not able to test all on a SR2000 as I do not have access to one of those receivers).
Installation:
The SR20cntrl receiver control software is distributed as a set of files and directories packed in an unique zip file (SR20cntrl_vxx.zip).

The result of unzipping the previous file will be the directory: SR20cntrl_vxx, inside it the following files can be found:

- SR20cntrl_vxx.jar  (the application java file)
- rxtxSerial.dll  (dll library needed for serial communication)
- conf (directory including configuration files such as for language version, etc.)
- help (directory including help files, even this one)
-
images (directory where spectrum jpg images will be saved)
- memBanks (directory where memory banks information will be saved)
- log.txt (application log file, with a list of changes)

Tick two times the file SR20cntrl_vxx.jar for executing the software. It is also possible to execute the software using the command line in the Windows System window (via a java -jar SR20cntrl_vxx.jar command). Also, it is possible to create a link to the SR20cntrl_vxx.jar file and execute the application through it.

When initiated the first time, you should configure the serial communication. For a SR2000A it will be sufficient to configure the serial port to which the receiver is connected and the databit speed transfer. The software recognize the serial ports in your system (even the USB associated one, if any) and lets you try one of them. For other receivers, particularly the SR2000, you will also need to configure other RS232 comm. parameters, such as parity, stopbits or flow control.

Obviously, the communication configuration should be the same for the receiver as for the control software. The receiver shoud be switched on and connected to the computer. In my configuration, I currently use 115 kbits databits speed and the communication works flawlessly. I have also tested all the other databit transmission speeds without any communication problem.

Once the transmission parameters are configured, the control of the receiver should be innitiated using the menu item: Application/Connect & GO

If all is ok, the aplication terminal window will show a message about the status of the connection and the three vfos windows should appear in the desktop. From this point on, the use of the software should be evident. Please note that ticking with the mouse one of the spectrum lines in the spectrum window tunes the current vfo to the new frequency immediantly.

If something is wrong, the aplication terminal window will probably show some kind of error, and you will not able to continue. Try reconfiguring the communications parameters and double check connections between computer and receiver. Also try to stop and relaunch the application.

Configuring the language and help:
It is possible (and easy) to configure the language of the application (menus, buttons, messaages, etc). For doing so, it is necessary that the LANG_FILENAME option in the file FILECONS.ini (in the conf directory), points to the corresponding language file. For example, for configuring the application in Spanish you should change the following line of  FILECONS.ini :

LANG_FILENAME = "./conf/lng_english.ini"

for the new one:

LANG_FILENAME = "./conf/lng_spanish.ini"

Moreover, it is easy to prepare a language configuration file for other language; for doing so, it is sufficient to copy one of the already existent language files and substitute all the translations for the terms on the left side for the desired terms (translations go between quotations marks) on the right; once done, save the file with a new name and subtitute the corresponding reference in the FILECONS.ini for letting the application know where it is the new language file.

It is also possible to configure the help file that will be used in the application (changing the corresponding line in FILECONS.ini).

Memory bank management:
I believe that its use should be rather obvious (at least, I hope so). But, some relevant aspects are the following:

- For working with a bank it is first needed to load it from the receiver memory (clicking the correspondent tab). Once done, every change of the content of a channel will be transmitted to the receiver. So, receiver and application are always synchronized.

- Some operations take more than a bit (for example loading a bank from memory). As there is a unique RS232 channel communication between the receiver and the application, it is possible that other consuming bandwidth functions (as for example the graph fft window) slow done while executing the memory bank operation. Obviously, trying to load all receiver banks simultaneously will take some time (but still, you will be able to look to the progress of the different loading operations in the associated progress bar for each bank).

-  Once the channels in a bank are, at least partially, displayed, it is possibe to:
> Write and modify information for a channel (for doing so it is necessary to click on the corresponding channel cell),
> Select a group of channels (continuous or not -using shift or ctrl keys-) for copying, cutting (deleting) and pasting this channel group from a place to another (it is possible to copy -or cut- a non continous group of channels, even following some sorting criteria, and then paste these group into another, possibly non continous, group of channels in the same or another bank -perhaps with another sorting criteria-),
> Sort (ticking the column head) in ascending or descending order, the displayed information. This will not modify the receiver information, but it will be possible to save the viewed information in a file using the "Save (as seen) option",
> Rearrange the displayed column order (dragging the column header from a place to a different one),
> Tune the receiver to the first channel in a selection. Conversely, it is possible to save the tuned receiver information to the first channel in a selection,
> Most operations are done concurrently. Moreover, it is possible to work with channels for a bank partially loaded (for example when loading bank X it is possible to tune the receiver to one of the first loaded channels while the application is still loading the remaining channels).

NOTE: For helping the user and speeding things a bit, the "channel" menu will also appear (contextually) when a selection has been done, right-clicking the mouse when the cursor is in the displayed channel table. For example: if you need to tune the receiver to some memory channel, you first select the channel (clicking on it) then right-click the mouse and select the "to vfo" option of the contextual menu that will appear.

About files containing channels information:
- Each file is written in plain text format in the directory selected by the user (by deafult the one in the FILECONS.ini file),
For each file containing channel information:
- Every line of the file beginning with a "#" character will be considered a comment,
- For each channel (lines without "#" beginning) the following information is written/readed:
  - Channel number,
  - Frequency in hertzs,
  - Mode (as for the corresponding receiver command),
  - Attenuation (idem),
  - Rf. amplification (idem),
  - Selected channel (idem),
  - Comment (only first 12 chars will be taken into account),
- The order of the columns is relevant,
- The number of white spaces between values (columns) is irrelevant, but at least should be one,
- White lines in the file are also irrelevants.



About the software:
When I purchased the SR2000A some months ago from the UK distributor (AOR-UK), I was a bit shocked when I realized that remote control software for it simply did not exist. The main objective of the SR20cntrl software is to let  the user gain the best possible control of the radio. The multitasking environment, remote connexion programming possibilities together with a nice user graph interface implicit in the Java language environment, let me think that the application could be (easily) programmed using this language. For the moment, I am having a lot of fun doing so.

Licence:
The software is free and it will remain free. It is possible that the source code will be published in the future under some kind of free software licence (perhaps GPL).


In any doubt, don't hesitate to drop me some lines, I will try to answer you as soon as possible.

Regards,

> quito at enredant dot com  - www.enredant.com -