SmartSDR for iOS – Tools

Vector Logo (1)


SmartSDR™ for iOS – Tools


1.Tools

This screen, which can be accessed using the Tools Tab at the bottom, provides additional features for SmartSDR for iOS.


Each Icon represents a separate Tool. In order to use a Tool, it must be unlocked (purchased) as described in the Main Manual from Chapter 2.2 onward.

1.1.FlexRadio

The main purpose of this Tool is to enable (unlock) the possibility to connect to your FlexRadio device as explained in the main Manual in Chapter 2.2

flexradio-tool

In addition, this tool offers two features that help to identify issues with or along with your FlexRadio.

The Show all meter values section provides values of all meters of your FlexRadio, not only those meters displayed in the main screen of this App but also Voltages, Power and Temperature value.

If turned on, the App will also log additional information which can be viewed and cleared using the Show device log menu.

1.2.Band Plan

The Band Plan tool provides a frequency overview of all HF HAM Bands for your particular region as well as the modes and maximum bandwidth as suggested by the IARU.

Please note: You need to select your particular IARU region in the General Settings in order to see the correct Band Plan for your region.

band-plan1

The Setting menu at the top allows you to select, whether or not, the Band limits and modes should be visible within the Panadapter as seen below:

band-limits

The “10 Meter >” information represents the Band limits information and the colored line represent the various modes like CW (green), Digimodes (blue), Narrow modes (Cyan), All modes (red), Satellite (yellow), others such as Beacons or guard channels (gray).

Inside the Band Plan tool, you can tap on a Band in order to see the details.

band-plan2

Modes will be displayed in the same colors as described above. From here, you can further tap on a mode (e.g. CW) which will switch to the Panadapter and automatically adjusts the visible Bandwidth accordingly.

1.3.DX-Cluster

The DX-Cluster Tool connects to any of several pre-defined worldwide DX-Cluster Databases or even your local CW-Skimmer and displays results (Spots) directly on the Panadapter or let’s you directly jump to the frequency of a particular Spot by just tapping on an entry in the list.

To start DX-Cluster querying, you need to hit the Icon in the top right hand corner first. The query will be repeated automatically in the given interval.

Tapping once on a line in the list will open a detail screen with details about the Call and Spotter. From here it is also possible to perform a HamQTH or QRZ.com lookup. For this, you need to enter your corresponding HamQTH and QRZ.com credentials on the Settings screen of this App.

Tapping twice on a line will jump to the panadapter and tune the current Slice to the frequency.

To search the list for a particular call, just hit the Spyglass icon in the lower right corner and enter your search term. This can be a call you want to search for. You can also enter itu= or cq= followed by a ITU-Zone or CQ-Zone to search for Calls from that particular ITU or CQ Zone.

Tap Filter in the bottom line to open the filter settings. Here you can select which Bands or modes you like to see – or you don’t like to see – in the list.

MAPS

You can display the whole list on a Map (Globe) or individual Spots from the Spot Detail screen. In this case, you will also get information about the distance between your QTH and the Call as well as bearing in degree.

For gray line DX, you can also see sunup and sundown on this Globe.

Please note: For the Bearing and Distance calculation and to draw the blue line between your QTH and the Call, you will need to enter your Home QTH grid location on the Settings screen of the App (please only use four digits here e.g. JO31)

SETTINGS

There are various Settings available in the DX-Cluster Tool.

With Show Spots on Panadapter you can choose whether or not to see all spots not only in the List but also on the Panadapter like shown below:

dx-cluster-2

Please note, you can tap on any of the Spots displayed in the Panadapter to tune the currently active Slice to that frequency.

The setting Autostart will cause the DX-Cluster Tool to automatically start to connect and query the DX-Cluster Server once the App has been started.

The Max. Spot age setting define, how long Spots should be displayed. Spots older than the selected time will then no longer be displayed. This is useful as the HAM might have switched the frequency or discontinued meanwhile.

Update interval defines how often (in seconds) the DX-Cluster database should be queried.

Server lets you select one of the predefined servers or let you enter your own DX-Cluster (e.g. Skimmer) Server.

Some of the predefined server or even your own Server may require a login by entering your Call sign. For this, you can enter Your Call sign under Server Login (your call).

When selecting Server, you will see a list of predefined servers. Just tap on the desired entry and a check-mark will indicate your selection. You will have to press the start button (top right) again after selecting a different server.

Custom DX-Cluster Server

To add your own Server, press the + button at the top (or the Wastebasket to delete it). On the following screen you will need to provide a Title and necessary parameters of your Server. These parameters depend on the Software you are running and may be found in the Manual or Settings of the Software or the administrator of the DX-Cluster server you like to add.

Unfortunately, there is no real standard for DX-Cluster Servers. You may need to experiment with the type whether Standard Skimmer or Standard Telnet will work. Some Server also require some initial commands in order to generate DX-Cluster spots. You can enter this command in the corresponding entry field on the “Edit Settings” screen.

Some servers like DB0SUE for instance also require the submission of the your Callsign immediately after connection (before providing the usual information). For this, you can also use the initial command field and enter your call here (or the term {CALL} which will be replaced by the Call you entered on the main DX-Cluster settings screen) to provide this information to the Server right after the connection.

Debugging

If you run into any issues using your preferred or own DX-Cluster I suggest to first try a connection to the server with a standard Telnet program such as Putty or any other Telnet client. You can try to connect to the server address using the corresponding port to see if the connection to your server works in general. This way, you will also see if and what kind of information your server asks for, after connecting.

Next, open the FlexRadio Tool and enable logging in the Settings menu in the top right corner (Debugging can be left off).

Next, you can enter the same information (Address, Port) you have successfully tried before with your Telnet client in the Custom Server settings. Now try to connect to your server. If it doesn’t work, head back to the FlexRadio Tool and tap on “Show device log”. You can now inspect the communication between the App and your custom DX-Cluster server and may find some reasons for the issue and clues how to fix this.

PLEASE NOTE: Don’t forget to turn logging back off as this decreases the overall performance of the App.

1.4.Griffin PowerMate

This Tool allows to configure and use the so called “Griffin PowerMate Multi-Media Control Knob with Bluetooth Connectivity” for controlling the FlexRadio.

Please Note: Only the the Bluetooth LE variant of the  PowerMate is supported. Not the USB variant.

This Controller has no cable and will be connected via Bluetooth LE to your iPhone or iPad.

Please don’t forget to turn Bluetooth on before using the PowerMate.

This Controller has one Wheel, one Button (pressing the Wheel) and an LED. All three can be configured individually by using the “Edit Mapping” function, but to get started, first select “PowerMate default” as Mapping.

Now, you can switch “Activate” on. The first time, you may get the message “Turn on Bluetooth to Allow “SmartSDR” to connect to your Accessories”.

Next, under Status, you will see “Connecting…“. Now, you need to tap once on your PowerMate and the Status should change from “Connecting…” to “Connected”.

With the “PowerMate default” Mapping, the PowerMate is configured to to use the Wheel for tuning the Active Slice frequency and the Button will toggle TX. The LED will indicate the MOX status.

To alter this default Mapping, just tap on “Edit Mapping” and the Mapping Editor will be opened. The Mapping editor is explained in Chapter “Mapping Editor“.

Once you changed the Mapping by using the Mapping Editor, the Mapping Entry on this screen will change from “PowerMate default” to “Custom“. By selecting “PowerMate default” again, you can revert back to the default mapping.

1.5.Behringer CMD Micro - MIDI Controller

This Tool allows the configuration and use of the so called “Behringer CMD Micro MIDI Controller”.

This controller is basically a so-called MIDI Controller which will be connected to your iPhone or iPad using a standard USB MIDI Connection.

Although not tested, other, similar MIDI Controllers, even of different brands may work as well.

The easiest and approved way to connect this Controller to your iPhone or iPad is by using Apples Standard Lightning USB 3.0 Camera Connection kit.

The Lightning plug needs to be connected to your iPhone or iPad, the USB Cable of your Behringer CMD Micro needs to be connected to this Adapter.

Finally, it is important to connect either a Lightning Power source or the PC/Mac Cable (which you would usually connect to your device directly) into the Lightning Socket of this Adapter.

This is important because the Behringer CMD Micro will also be powered by this connection.

In some cases, you may see the message that “The connected USB Device cannot be used due to high power consumption”. In that case, please try another power Supply. The original Apple power supply that came along with your iPhone/iPad should work.

Once you attached everything as described before and once you unlocked this Tool, you can configure the controller connection.

First, you need to select your MIDI Device. Once you tap on “MIDI Device” you should see “CMD Micro” in the displayed list and just need to tap on this entry. If you don’t see the CMD Micro in that list, please check your Cable connections and the power supply as explained before.

The CMD Micro has three Wheels, five sliders, two Level controls, 20 Buttons and six LEDs. Everything can be configured individually by using the “Edit Mapping” function, but to get started, first select “CMD Micro default” as “Mapping“.

If you then switch on “Activate” the Status should change to “Connected“.

With the “CMD Micro default” Mapping, you can now use the left Wheel to tune the Slice A frequency whereas the right Wheel will control Slice B frequency. Buttons and Sliders are also assigned to different FlexRadio settings.

To alter this default Mapping, just tap on “Edit Mapping” and the Mapping Editor will be opened. The Mapping editor is explained in  Chapter “Mapping Editor” in the Appendix of this Manual.

Once you changed the Mapping by using the Mapping Editor, the Mapping Entry on this screen will change from “CMD Micro default ” to “Custom“. By selecting ” CMD Micro default” again, you can revert back to the default mapping.

1.6.Logbook

The Logbook has been implemented with the idea in mind that you will keep using your main PC, Mac or Web based logging Program for general Log-Maintenance, Awards and QSLs, eQSL.cc, LOTW Submissions etc.

This internal App logging feature should be an easy, quick and convenient solution for entering Logs while working with the App for later submission to your main Logging Software. For this, it supports ADIF Im- and Export. It also Synchronizes Logs across multiple iPhones/iPads via iCloud Drive.

Limited Contest support is also included (assuming you will rather use SmartSDR for Windows for your contests).

The Logbook also helps to complete the Log Entries by integrating HamQTH and QRZ.com lookups. Also, an internal Call sign Prefix database is included to identify DXCC, CQ-Zone, ITU-Zone etc. based on the Call Prefix.

It can also display all or individual Logs on a Map (Globe).

LOGBOOK SETTINGS

Before using the Logbook, please double check the Settings inside the Logbook Tool.

If “Sync Logbook with other Devices” is set to On, your Logbook will be available and Synchronized with all other devices you may have which is using the same Apple ID. To use this feature, iCloud Drive needs to be enabled on your device. For further details, see the separate Chapter iCloud Drive in the Appendix of the manual.

For “Operator“, you can enter your Call or the Call which should be used as OPERATOR in the Log. (Please the content of the STATION of the Log is the Call you have entered under “My Call” in the main Settings of the App).

Close Log Screen after Save” means that the small logging window will be closed if you tap on Save. Otherwise it will remain visible on the Screen.

The ADIF Log Format doesn’t define a Mode called DIGL or DIGU. By using the “DIGL/DIGU Mode Replacement” you can enter a Mode which will be used for the ADIF Log whenever DIGL or DIGU has been selected in your FlexRadio.

Contest Mode” means that you can use Serial Numbers to be counted upwards whenever you save a Log entry. Once selected, you can enter the official ADIF “Contest ID” for the particular Contest and for the RST generation, you can enter a Prefix and Suffix which will be put before and after the Serial number and the current Serial Number Value. Alternatively, you can also enter a “Fixed RST Text” if you don’t want to use a counting Serial.

If not in Contest Mode, RST Sent and Received will automatically filled with 599 or 59 (depending of the Mode).

LOGGING A CALL

To log a new Call, you have the following three options:

  • Tap on + at the top of the Loogbook Tool Screen

While on the Panadapter you can:

  • Open the left Menu and tap on Log
  • Double Tap with two fingers on the Panadapter

Then, the following small Log entry screen will open:

Fields like RST, Frequency, Band, Mode and Date/Time will be pre-filled depending on the Active and TX Slices.

After entering the Call, this screen will show the corresponding DXCC, CQ-Zone, ITU-Zone and Country of that call at the bottom.

ALTERING / COMPLETEING LOG ENTRIES

Back on the main Tool Logbook Screen, you can change the Sorting of the list or search for a particular Call or Comment by using the buttons at bottom of the screen.

You can tap each entry to alter or complete a log in the Log-Details screen as shown below:

From here, you can adjust the Time On and Off times and all other Logbook fields as well as additional fields, not available on the small log entry screen.

By tapping on HamQTH or QRC.com Lookup, you will see a list of information available for the particular call. By tapping on “Use this information” this data will be copied to your Log entry.

Please note: For using HamQTH and/or QRZ.com you need an account on each platform. For QRZ.com, in addition, you need an active XML Logbook data subscription (see https://ssl.qrz.com/products/index.html). The Credentials need to be entered in the main settings of the App.

View on QRZ.com” can be used even without an active QRZ.com account. However, here, only the usual QRZ.com website (for the particular Call) with Ads will be displayed.

If the location information is available for a Call, you will see a Map button which will show the location of the Call and your QTH on the map and calculates the distance and bearing to the call.

CWX MACROS

UPDATE 2.2

Log entries can be used in CWX Macros.  The following N1MM compatible Macros are supported:

{CALL}, {LOG}, {SENTRST}, {COMMENT}, {MYCALL}, {TXFREQ}, {RXFREQ}, {TXBAND}, {RXBAND}, {DATE}, {TIME}

When using these Macros in CWX Macros, the text will be replaced by text of the corresponding Log entry. For instance {CALL} will be replaced by the currently entered Call.

The {LOG] Macro will save the current Log and prepares to enter a new entry.

IMPORT / EXPORT

By using the Folder Icon at the top of the Logbook screen, you can Export and Import ADIF Files.

It is possible to Import or Export files via Email or iCloud Drive.

If you select Email, an Email will be generated which includes the ADIF File as attachment. For the opposite Direction, to import an ADIF File via Email, you just need to open the Mail App, open the Inbox with your Mail that contains the ADIF file, next just tap on the file attachment (the ADIF File). Then you will see an App selection of Apps that can be used to open this file. Selecting SmartSDR will open SmartSDR and import the File.

A more convenient Option to Im- and Export ADIF Files is to use iCloud Drive. (For details about iCloud Drive, please see the separate Chapter iCloud Drive in the Appendix of this Manual.)

PLEASE NOTE: All ADIF Files needs to have the extension .adi (e.g. mylog.adi).

After importing a file, you will be asked if you like to “Append” or “Replace” the imported Log to your current Log. If you select “Append”, the content of the file will be appended to the list. If you select “Replace”, your existing Log will be cleared before the file will be imported.

When importing ADIF Files from another Log Program, you may see the message “The File contains Log Entries with non-standard Fields”. This means, that the Log Program has stored additional proprietary information to the Log File which cannot be used or interpreted by this App. It is safe to import such a Log file to this App but keep in mind that the proprietary information will not be available when exporting logs back to that Program.

1.7.Flic

The Flic tool adds support for the so called Flic Smart Bluetooth Buttons (More information can be found here).

You can add as many buttons you like and can assign various Radio functions like PTT, Tune, Mute, CWX Macros for press and release, double click or hold.

After unlocking this tool and purchasing a Button, you need to register an account on flick.io and need to install the flick iOS App from the AppStore. Next Add your new Flic Button to the Flic App. If you have more than one Button, it is recommended to assign names for the Buttons (please see the Flic Manual for details).

No further action is required on the Flic App. You don’t have to assign actions from inside the Flic App unless you want to use the Button for other purposes than for SmartSDR for iOS.

Next, open the Flic tool of SmartSDR for iOS and switch on the Activate setting.

Tap on Add Button to add a new Button to SmartSDR for iOS.

This will take you out of the App to the Flic App on your device. Here you can select the Button and tap Done which takes you back to SmartSDR.

Next, you can decide what should happen, when using the button. For this, tap on Edit.

On this screen, you can assign Button mappings for the three Button options:

  • Single click (which has an Up and Down state)
  • Double click
  • Long press

Please note that Double click and Long press will also always generate a Single click so in most cases, where you want to assign functions for Double click or long press, it makes no sense to also assign functions to single click.

If you want to remove an assignment, you can swipe the line left or just select “Not assigned”.

To delete the whole button, just tap on the wastebasket at the top of the screen.

Details about the possible Mappings can be found in chapter “Mapping Editor“.

2.Appendix

2.1.iCloud Drive

iCloud Drive can be used for Im- and Export functions of the App as well as Logbook Synchronization.

iCloud Drive is a special feature of iCloud but not the same. You can use iCloud Drive even without using other iCloud features like Keychain Synchronization.

To use iCloud Drive, the following needs to be enabled:

  • In your iPhone/iPad Settings: iCloud must be turned on
  • Further below, there is a “iCloud Drive” setting which also needs to be turned on

On this screen AND under iCloud Drive there are additional switches for additional features for iCloud and iCloud drive. All of those are not necessary for the App. You only need iCloud in general and iCloud Drive switched on for SmartSDR.

  • Inside the App, in the App Settings, you will also need to set “Enable iCloud Drive” to on. Below, the Status should say “Available” if your iCloud Settings are correct.

No Software installation is needed on a PC or Mac to use iCloud Drive as it can be used from any Browser like Safari, Internet Explorer, Firefox or Chrome.

However, if you prefer, you can install iTunes and the included iCloud Drive software from Apple on your PC or Mac. In this case, no Browser is needed. In that case, the iCloud Drive Folder will be replicated on your PC or Mac as virtual Directory.

For using your Browser to access iCloud Drive, you just need to visit the https://icloud.com website.

After entering your Apple ID and password you need to click on the iCloud Drive Icon and you should see the special SmartSDR folder like shown below:

This folder contains all your SmartSDR Files after Exporting Files to iCloud Drive. For the opposite direction (e.g. if you like to import ADI Log files), just copy your File from the PC/Mac to this SmartSDR Folder by Drag-and-drop. After a short while (it may take a few seconds until your file has been synched to the Cloud) you will be able to select that file for importing in SmartSDR for iOS.

PLEASE NOTE: If this is the first time you use iCloud or iCloud Drive, it may take several Hours until you will see the SmartSDR folder. Once it is available, files will be transferred within a few seconds between your PC/Mac and the Cloud.

2.2.Mapping Editor

The Mapping Editor allows to assign Controls, Buttons and LEDs to individual FlexRadio functions.

You can start using this Editor in two different ways. You can either previously select a Default Mapping as described before, open the Mapping Editor and alter this Mapping according your requirements.

Alternatively, you can open the Editor and tap on the Trashcan (top right corner) to delete the whole Mapping and start with an empty list.

WHEELS/SLIDERS, BUTTONS and LEDS

The Mapping Editor Screen is separated in the three Sections WHEELS/SLIDERS, BUTTONS and LEDS.

Each section contains a code on the left side and the assigned FlexRadio action on the right side.

You can simply identify the code for a particular control by just using the control (e.g. hit a button or spin a wheel). The corresponding Code line for that control will then be highlighted in the list. Missing controls will be added this way automatically.

To assign a new or alter a FlexRadio action for a control, just tap on the corresponding line.

Depending on the Section (and type of Control), you can select different Actions. For example, a Wheel can be assigned to change the Slice Frequency which makes no sense for a Button. A Button on the other hand can be assigned to Start Macro 1 for example which makes no sense for a Wheel.

You will see a small screen which asks for two or three parameters as follows:

1. The Code.

This is the Code, send from the Controller for the particular Control. Even though it’s possible to enter this code manually, it is more convenient to identify the codes as mentioned before by just using the Control on the Controller.

2. Radio action

This is the function you want to control on your FlexRadio (for instance the Frequency, the PTT or a Macro which should be sent).

Most of the FlexRadio actions are self-explanatory as they are one-by-one identical to FlexRadio functions.

One exception is the Balance A/B action which has no direct FlexRadio counterpart. What this action does is basically to adjust Alice A and B volume. When spinning the Wheel (or moving a slider) to the left (counter clockwise), volume of Slice A will be increased and B decreased. When spinning (or sliding) to the other direction, volume of Slice A will be decreased and for Slice B increased.

For a fill list of available acrtions, please refer to the Controller Actions Table in Appendix of this Manual.

3. Slice (Optional)

Some Radio actions require an additional Slice Parameter which can be selected here.

IMPORT/ EXPORT

By using the Folder Icon at the top, you can export or import individual Mappings (or Backups while trying out different Mapping options). This way, you can even Export and Import your Settings to another Device or share Settings with another OM.

In order to use this Import/Export feature, you need to have iCloud Drive enabled on your Device as all files will be stored on a separate SmartSDR Folder on iCloud Drive (for more information see the separate Chapter “iCloud Drive” further below)

2.3.Controller Actions

In the three tables below, you can find all available actions which can be assigned to Controls by using the Mapping Editor.

Wheel and Slider Mappings:

Name Slice Parameter Description
Slice Frequency a-h,tx or active Changes the frequency of the given Slice
Slice Volume a-h,tx or active Changes the AF-Gain of the given Slice
AGC Threshold a-h,tx or active Changes the AGC-Threshold of the given Slice
RF Power Changes the RF Power
Balance A/B Controls volume balance between Slice A and B

Button Mappings:

Name Slice Parameter Description
Slice new Creates a new Slice
Slice next Selects and activates the next Slice
Slice set active a-h or tx Activate given Slice
Slice set TX a-h or active Set given Slice to TX Mode
Slice Lock a-h,tx or active Lock the given Slice
Mode Next a-h,tx or active Switch to next mode for given Slice
Mode USB a-h,tx or active Set Mode of given Slice to USB
Mode LSB a-h,tx or active Set Mode of given Slice to LSB
Mode CW a-h,tx or active Set Mode of given Slice to CW
Mode AM a-h,tx or active Set Mode of given Slice to AM
Mode DIGL a-h,tx or active Set Mode of given Slice to DIGL
Mode DIGU a-h,tx or active Set Mode of given Slice to DIGU
Mode AM a-h,tx or active Set Mode of given Slice to AM
Mode FM a-h,tx or active Set Mode of given Slice to FM
Mode RTTY a-h,tx or active Set Mode of given Slice to RTTY
PTT Push a-h,tx or active Sets given Slice to TX mode and activates/deactivates PTT
PTT Toggle a-h,tx or active Sets given Slice to TX mode and toggles PTT
TX Ant 1 a-h,tx or active Set ANT1 as TX Antenna for given Slice
TX Ant 2 a-h,tx or active Set ANT2 as TX Antenna for given Slice
TX XVTR a-h,tx or active Set Transverter as TX Antenna for given Slice
RX Ant 1 a-h,tx or active Set ANT1 as RX Antenna for given Slice
RX Ant 2 a-h,tx or active Set ANT2 as RX Antenna for given Slice
RX RX_A a-h,tx or active Set RX_A as RX Antenna for given Slice
RX XVTR a-h,tx or active Set Transverter as RX Antenna for given Slice
RIT a-h,tx or active Toggle RIT for given Slice
XIT a-h,tx or active Toggle XIT for given Slice
VOX Toggle VOX
ATU Start Tuning
Tune Toggle Tune
Bypass Set Tuner to Bypass
MOX Toggle MOX
MEM Toggle Tuner MEM
NB Toggle NB
NR Toggle NR
ANF Toggle ANF
CWX Opens CWX Window
ANF Toggle ANF

LED Mappings:

Name Slice Parameter Description
MOX LED on when MOX on
TX On a-h or active LED on when particular Slice is in TX mode
Slice Active a-h or tx LED on when particular Slice selected
Tune LED on when TUNE on
Suggest Edit