RF Explorer Touch - User Manual

TouchScreen  

User manual updated to version 1.4.2002


Main menu

The main menu is designed in a easy to use, hierarchical layout on the right-side of the device screen as depicted in below screen.

CW Signal example

Amplitude Menu

Use this menu option to set visual amplitude in spectrum analyzer graph.

Top

Set visual top value for amplitude axis in analyzer graph.

Bottom

Set visual bottom value for amplitude axis in analyzer graph.

Offset

Set Amplitude offset value in dB to compensate the signal shown in analyzer graph, to adjust for external attenuation or gain.

Back

Return to main menu.

Frequency Menu

Use this menu option to set device frequency.

Center

Set center frequency into device. Start/Stop frequency will be recalculated.

Span

Set span (or range) frequency into device

Start

Set start frequency into device. Center frequency will be recalculated.

Stop

Set higher frequency range into device. Center/Start frequency will be recalculated.

Offset

Set device offset frequency in MHz. Use this to compensate for external mixer or frequency converter device.

Back

Return to main menu.

Mode Menu

Use this menu option to choose between different operational mode such as Spectrum Analyzer or Power Channel. Spectrum Analyzer mode is the enabled by default upon application start.

Marker Menu

Use this menu option to configure markers. For more details see section “Markers”.

Back

Return to main menu and current visual mode (such as Spectrum Analyzer).

File Menu

Use this menu option to load or save a file. For more details see section “Files”.

Load…

Load RFE data file.

Save…

Save RFE data file.

Save CSV…

Save file in comma separated values format.

Back

Return to main menu and current visual mode (such as Spectrum Analyzer).

Config Menu

Use this menu option to set display, device and file configuration. For more details see section “Config Screen”.

Display

Configuration for visual parameters of spectrum analyzer graph.

Device

Device configuration parameters. Any settings changed will be sent from application to device.

File

Data file configuration parameters.

CSV File

Comma delimited data file configuration parameters.

Tech Support

Create a compressed ZIP file with activity logs, configuration files and report files in order to diagnose application issues. Only required if requested by RF Explorer Tech Support.

About

Show application, Operating System and, if connected, device details

Back

Return to main menu and current visual mode (such as Spectrum Analyzer).

Presets Menu

Use this menu option to load, save or delete a preset. For more details see section “Presets”.

Connect

Use this menu option to connect the RF Explorer device.

  • For handheld devices connected to a computer, it will automatically connect to the Spectrum Analyzer device if it is the only USB device connected. Otherwise, if there is no connected device or multiple devices are found, it will open a dialog to help user select the right device.
    • In Windows computers, it will display ports with names such as COM3, COM10, etc.
    • In MacOS and Linux computers, it will display ports with names such as USB0, USB5, etc
  • For Raspberry IoT device it will connect to the module directly. This button will be disabled for IoT module if it is already connected, but will be enabled when a file has been loaded.

For specifics, check Release Notes document.

Full Screen

Use this menu option to maximize spectrum analyzer graph. This can be achieved by touch or single click inside spectrum analyzer graph. Note the specific button is only available for Windows version.

Trace

Use this option to go into display configuration directly.

Exit

Use this option to exit application.

Specifically for Raspberry Pi board, the system will automatically shut down.


Spectrum Analyzer screen

CW signal

The main screen includes standard spectrum analyzer graph with captured data from RF Explorer handheld analyzer or IoT module and the right-side menu with all options to use the application easily.

The data screen is a high speed data representation of Spectrum Analyzer Frequency vs Amplitude. The X axis represents frequency in MHZ and Y axis display actual received power in dBm, dBuV or Watt (selectable).

Touch Gestures

You can use two finger gestures in Windows (other platforms are not supported) to zoom and pan frequency or amplitude.

  • Zoom in/out - change Frequency Span: Apply two finger gesture towards the horizontal axis to increase or decrease span.
  • Amplitude pan: Move two fingers up or down to pan amplitude
  • Frequency pan: Move two fingers left or right to pan frequency 

Touch Labels

TouchAreas RPi

Some parameters can be easily configured by screen touch or click marked with red areas in picture above.

Press each of these regions to change:

  • Amplitude Top/Bottom – change with numeric dialog
  • Start/Center/Stop frequency – change with numeric dialog
  • Graph title – set current preset. Note this is not available for Full Screen mode
  • Amplitude Offset - change with numeric dialog
  • Amplitude Units - Menu Config -> Display
  • Input Stage - Menu Config -> Device
  • Firmware Version and Device Model - Menu Config -> Device
  • Frequency Offset - change with numeric dialog
  • Span Frequency - change with numeric dialog
  • Sweep Resolution - Menu Config -> Device

Navigation and replay sweep control

navigation toolbar enabled

The navigation bar provides full control to review any past sweep event and also replay sweeps at original captured speed. This can be used with recently captured data or stored data files.

  • [<<] Go back multiple sweeps (about 10%)
  • [ < ] Go back to previous sweep
  • Navigation bar: Point and move to desired sweep. While the scrollbar actuator is being moved, sweep captured date will be updated realtime but spectrum analyzer screen will be updated after releasing the bar.
  • [ > ] Go forward one sweep
  • [>>] Go forward multiple sweeps (about 10%)
  • [Play] Replay captured activity using original captured speed
  • [ || ] Pause spectrum analyzer activity on screen, but the RF Explorer device continues capturing and storing data
  • [ H ]: Hold - Fully stop spectrum analyzer activity and data capture. This is the only valid state when using data from file

Configuration Options

Display

Display Options

Fill Trace

Display a filled area in all signal shapes except Realtime signal.

Smooth

Use soft splines to join data sweep points in order to present a calculated soft curve

Thick Trace

Display trace with extra width

Show Grid

Show grid inside spectrum analyzer graph

Dark Mode

Set a black background skin, closer to desktop instruments and easier to read in certain environments.

Realtime

Raw data as captured with no post-processing.

Average

Arithmetic media of all the last iterations sampled.

Max Peak

Maximum value of all the last iterations sampled.

Max Hold

Maximum value of all captured samples regardless Iterations value.

Minimum

Minimum value of all the last iterations sampled.

Iterations

The number of sweep data iterations to perform calculations on including Average and MaxPeak.

Amplitude Units

Select amplitude units between dBm, dBµV or Watt to display data in analyzer graph.

Device

Device Options

Enable Remote Max Hold Buffer

Enable this to increase chances of fast changing signal capture, such as WiFi. Disable for extra accurate signal capture.

Automatic LCD Off

Automatically switch the LCD off for faster updates and help increase LCD lifetime. This option only will be enabled for RF Explorer devices with screen (Not supported for RF Explorer IoT).

Automatic Amplitude Update

Use this option to force the RF Explorer device to update amplitude visual range, or disable for fast local updates with no need to remote updates. This option is only available for RF Explorer devices with embedded screen (Not supported for RF Explorer IoT).

Enable RF Connector

  • Left SMA: Use this option to enable remote device port on the left RF connector (Main board).
  • Right SMA: Use this option to enable remote device port on the right RF connector (Expansion board). (Not supported for RF Explorer IoT).

Input Stage

Select input stage to enable Direct, Attenuator or LNA (Only supported in PLUS models and IoT).

  • Direct Input: Low loss signal path to standard sensitivity, use for linear measurements up to -25dBm.
  • Attenuator 30 dB: Nominal wideband attenuator, use for linear measurement up to 0dBm.
  • LNA 25 dB: Low noise wideband preamplifier, use for linear measurements up to -40dBm.

Reinitialize Data Buffer

Internally re-initialize the MaxHold buffers used for cache data inside the RF Explorer device.

Sweep Points

Resolution data points for each captured sweep in spectrum analyzer device. This feature is currently supported in PLUS, ProAudio and IoT models only.

Supported values:

  • Windows, Linux and MacOS: 112, 240, 512, 1024, 2048, 3072 and 4096 points
  • Raspberry Pi: 112, 240, 432, 1024, 2048, 3072 and 4096 points

File

File Configuration

Save RFE Data File on Close

Save a RFE data file every time application is closed. If “Enable Continuous Log” option is enabled, this feature will be enabled automatically.

Enable

Enable continuous log to save RFE data or CSV files periodically in seconds as selected in “Auto Save Delay (s)” option. Also this option save a RFE data file in each configuration change in device and when application is closed.

Auto Save RFE Data

If “Enable” option checked, save a RFE data file every number of seconds selected in “Auto Save Delay (s)” option.

Auto Save CSV

If “Enable” option checked, save a CSV data file every number of seconds selected in “Auto Save Delay (s)” option.

Auto Save Delay (s)

Number of second for Auto-Save feature.

Auto Delete (Days)

Number of days for Auto-Delete old and unused files in user folder

Auto Save Folder Path

Directory where .RFE and CSV files will be stored if Auto Save feature is active

CSV File

config CSVfile

Field Separator

Delimiter to use for CSV file generation. Supported separators: Comma, Division, Semicolon, Space or Tabulator.

Decimal Separator

Delimiter to use as decimal separator. Supported separators: Comma or Dot.

End of Line

End of line to use in for CSV file generation. Supported end of lines: Line Feed (\n) or Carriage Return and Line Feed (\r\n).

WSM Sennheiser Compatible

When option is checked, CSV files generated can be imported directly in WSM Sennheiser software.

CSV Trace

Selected data trace on which the data will be stored.

CSV Header

Insert descriptive header inside generated CSV files.

Fields included are: 

  • Receiver
  • Date/Time      
  • RFUnit
  • Owner
  • ScanCountry 
  • CRC

Techical Support

Create a compressed ZIP file with activity logs, configuration files and report files in order to diagnose application issues. Only required if requested by RF Explorer Tech Support. 

About

Show application, Operating System and, if connected, device details

How to change application appearance

  1. In main menu, click on [Config]
  2. Click on [Display] button to see display options.
  3. Check or uncheck “Dark Mode” option.
  4. The software will change its appearance with a black theme or white theme including background screen.

Note: In macOS, appearance will change after [Back] button is clicked and returned to main screen.

     Dark Theme       Clear Theme

     config display dark       config display


Power Channel

Show power measured within channel defined by start/stop frequency.

Power Channel

Power Data Mode

Trace from which measurements are performed.

Channel Power

Power received in the frequency band represented in dBm and Watt units.

Channel Power Density

Represents how the signal power is distributed in dBm/Hz unit.

Channel Center

Center frequency of the channel in MHz unit.

Channel Bandwidth

Bandwidth of the channel in MHz unit.

Captured

Date and time when sweep was captured.


Frequency and Amplitude configuration

Set frequency and amplitude values for device. This can be modified if RF Explorer device is connected only.

Change Frequency

Click on [Frequency] and click on desired parameter to set in device. (See “Main Menu” section for more details).

Span Frequency

Change Amplitude

Click on [Amplitude] and click on desired parameter to set in device. (See “Main Menu” section for more details).

Top Amplitude


Markers

Configuration parameters to display markers in spectrum analyzer graph and markers panel.

Markers

Overview:

  • Marker 1: It is special marker. It will search for peak trace point on screen and will track automatically. Therefore, frequency point for Marker 1 cannot be defined, will be dynamically updated by the application every sweep.
  • Markers 2 to 10: These markers are defined for a specific frequency point, and will show amplitude values for all enabled traces on that frequency.
  • Delta markers: This markers will be a reference of other marker, that is, it will be linked with a particular marker.

Main Marker ID

Marker Identification number. Check “Enable Marker” option to set a marker.

Frequency (MHz)

Marker frequency (Only allowed for markers 2 to 10).

Delta Marker ID

Delta Marker Identification number. Check “Enable Marker” option to set a delta marker.

Offset (MHz)

Frequency difference in MHz between delta marker and its reference marker.

Offset Locked

Enable a dynamic follow-up of the Delta ID to the Marker ID selected. It will follow the reference Marker if it changes position.

Track Marker 1

Define trace that marker 1 follow in visual representation

Marker 1 Peak Text

Show peak frequency and amplitude values for marker 1

Marker Panel

Show or hide markers panel to display visible markers table.

MarkerPanel

How to set up a peak marker

  1. Go to Marker menu.
  2. Select marker ID 1.
  3. Check “Enable Marker” option.
  4. In “Track Marker 1” options, click on [Real Time] button (Marker 1 will detect peaks in RealTime trace).
  5. Click on [Back] button to apply changes.

How to set up a manual marker

  1. Go to Marker menu.
  2. Select a marker ID from 2 to 10.
  3. Check “Enable Marker” option.
  4. Set frequency for selected marker, such as 1250Mhz
  5. Click on [Back] button to apply changes.

How to set up a Delta marker

  1. Go to Marker menu
  2. To define a Marker Delta, you first need a standard marker enabled. As an example, enable Marker 1, we will use it as Delta marker later.
  3. Increase “Main Marker ID” to go to Marker 2, enable it at any arbitrary frequency.
  4. Set “Delta Marker ID” to 1 and check “Enable Marker”.
  5. At this point, Marker 2 is linked to Marker 1 and will display Delta calculations automatically
  6. Define offset in MHz you want Marker 2 to be from Marker 1. For instance, set it to 100 MHz. Changing the offset will redefine position for Marker 2 based on current position of Marker 1.
  7. Click on [Back] button to apply changes.

Notes:

  • Special Marker 1 can be Delta Marker of any other, but it cannot have associated any Delta Marker by Offset. The reason for this is Marker 1 works as auto-peak therefore cannot be defined as reference of any other.
  • Markers defined by Offset use the value at the time of Marker definition, but does not update or keep that offset fixed if the Delta Marker changes frequency. For instance if you define Marker 5 at an offset of 5MHz of Marker 1, and marker 1 is currently at 100MHz, then Marker 5 will be located at 105MHz. If Marker 1 moves to a different frequency later, Marker 5 will remain at 105MHz, you can see the current frequency offset any time in the marker display panel.
  • Future upgrades will allow for optional dynamic markers where offset will be locked so Main Marker absolute frequency value can change accordingly to the Delta Marker.

Presets are predefined configuration stored by name in the application to easily recall commonly used setups. Parameters persisted are frequency, amplitude, enabled traces and markers.

Note: For handheld models, these presets in the application are not the same presets as can be defined inside the device. A future version will include and help to coordinate both kinds: application and device presets.

Presets

Load

Action option to load stored preset values into current configuration.

Note: Load Presets only will be effective while device is capturing data, not when a file has been loaded.

Save

Action option to save current configuration into the selected preset. This option cannot be undone, care should be taken to not overwrite another valid preset.

Delete

Remove selected preset configuration. “Default” preset cannot be deleted.

Back

Return to main menu and current visual mode (Such as Spectrum Analyzer).

How to create a new preset

  1. Set device configuration to store as frequency, amplitude, traces and markers.
  2. Go to “Presets” menu.
  3. Click on edit box and type a name for this preset.
  4. Click on [Save]

Files

Contain different actions for files as Load, Save RFE data and Save CSV.

  • RFE data files are binary, compact data files with multiple sweeps. These files are compatible with RF Explorer for Windows.
  • CSV data files can capture a single trace and can be used to share data to external applications such as WWB, Excel, Matlab or IAS.

Load file

To load RFE file, go to File -> Load… and select desired file navigating through directories. Click on [Load] button to finish action.

Load File

Save file

To save RFE file, go to File -> Save… and select desired directory to store file, typing a name for it. Click on [Save] button to finish action.

This option is only available if there is a RF Explorer connected device and some data is actually received

Save File

Save CSV file

To save single CSV file, go to File -> Save CSV… and select desired directory to store file, typing a name for it. Click on [Save] button to finish action.

To change CSV file configuration parameters, such as field delimiter or end of line type, see Configuration Options.

Save CSV file

Instructions to easily export CSV files to external applications

How to generate CSV File compatible with WSM Sennheiser Software

Go to Config -> CSV File and check “WSM Sennheiser Compatible” option.

How to generate CSV File compatible with Shure Wireless Workbench WWB6 Software

Go to Config -> CSV File and select “Comma” as “Field Separator” and “Dot” as “Decimal Separator”.

How to generate CSV File compatible with IAS Software

Go to Config -> CSV File and select “Comma” as “Field Separator”.


Virtual Touch Keyboards

Numeric Keyboard

NumericKeyboard

This keyboard will appear when application require numeric data. When available, a physical keyboard can be used to edit numeric value as well.

  • [X]: Close keyboard ignoring changes.
  • [<DEL]: Delete a left digit from current cursor position.
  • [CLEAR]: Remove all text in edit box.
  • [dBm], [-dBm], [dBµV], [Watt]: Validate inserted data in the specific units. Other configurations may show GHz, MHz, KHz, etc.

Note: Validation buttons will change depending on parameter to modify.

Alphanumeric Keyboard

AlphaKeyboard

This keyboard will appear when application require text information. When available, a physical keyboard can be used to edit alphanumeric value as well.

  • [CLEAR]: Remove all text in edit box.
  • [ESC]: Close keyboard ignoring changes.
  • [CAPS]: Type with capital letters.
  • [<DEL]: Delete a left character from current cursor position.
  • [DONE]: Close keyboard saving typed text.
  • [<]: Move cursor to the left.
  • [>]: Move cursor to the right.

Advanced Configuration

Some advanced configuration settings are available for expert users tune-up. This should be modified only if you are comfortable changing XML files and understanding XML syntax.

The advanced configuration parameters are stored in file RFETouch.xml. This file can be found in following locations depending on OS:

  • Windows platforms: %APPDATA%\RFExplorer
  • MacOS platforms: /User/<Username>/.RFE
  • Linux platforms: <Home>/.RFE

Only these parameters below should be modified, other RFETouch.xml configuration parameters should not be modified. Note incorrect file update may damage XML structure or values and may lead to configuration loss. It is advisable to backup the RFETouch.xml before any modification is made.

Parameter

Default

Values

Description

IsIOTModule

true

true/false

Use true for IoT module, or false for Handheld Analyzer. This setting is set by default to true in Raspberry Pi SDCard image files, and false otherwise

ShutdownRPiOnCloseApp

true

true/false

Use true to shutdown Linux when RFETouch is closed, other case set to false. This setting is set by default to true in Raspberry Pi SDCard image files, and false otherwise

IoTPortName

/dev/ttyAMA0

/dev/ttyAMA0
/dev/ttyS0

For Raspberry Pi only: Set serial port name either as /dev/ttyAMA0 or /dev/ttyS0 depending on UART configuration (useful in Raspberry Pi 4B). This parameter is ignored for USB devices, only RF Explorer IoT module is affected by this setting in a Raspberry Pi.

Raspberry Pi: How to disable RFETouch auto-start:

In SDCard images provided for Raspberry Pi, the RFETouch application is configured to automatically start after the Raspbian GUI is loaded. If you want to disable this behavior and load RFETouch manually, locate the autostart configuration file which may be in one of the following locations, depending on Raspberry Pi model:

  • /home/pi/.config/lxsession/LXDE-pi/autostart
  • /etc/xdg/lxsession/LXDE-pi/autostart

Edit this file using <sudo nano> or equivalent editor as superuser, and remove this line:

  • @lxterminal -e sudo /home/pi/RFExplorer/RFETouch