RAy Tools app for Mobile devices

Print version

7. RAy Tools app for Mobile devices

RAy Tools is a stand-alone application designed to perform all steps of establishing a new link and operate it. It is optimised for use on mobile devices with smaller displays and especially in challenging conditions.

RAy Tools supports the following functions:

  • Link Calculation – to calculate or verify the link budget

  • Antenna Alignment – indicates current RSS and MSE values, optionally with acoustique indication, for convenient antenna alignment

  • Link Management – standard web-based unit management

Antenna Alignment and Link Management functions require a WiFi connection to the RAy unit. It has to be established by the user before those 2 functions can be used.

RAy WiFi network name is “RAy Code + RAy Serial Number” (for example “RAy3-24-1234567890”).

[Note]Note

WiFi on the RAy unit is active only if RAy WiFi module is present and its functionality is allowed in RAy management (permanently or only during air link loss – for WiFi setup see Section 1.4.2, “Service WiFi – optional (using USB „S“)”).

Every RAy3 shipped from the factory is equipped by a WiFi module and the WiFi is allowed with no password (one should be set immediately by the user).

7.1. Menu options

7.1.1. Calculation

 

        iOS version

        Android version

 

Can be used in conjunction with all RACOM microwave products and compatible antennas. Available parameters to input that affect link budget are:

  • Modulation

  • Throughput

  • Tx Power

  • Link distance

  • Antenna specifications

RAy Tools calculation outputs are:

  • Free Space Loss (FSL)

  • 1st Fresnel Zone radius

  • RSS

  • Sensitivity

  • Fade margin (shown to be acceptable/marginal/inadequate)

 

The calculation assumes a clear line of sight and makes no allowance for precipitation. A more accurate calculation can be performed using the tool available on RACOM web pages (see
https://www.racom.eu/eng/products/microwave-link.html#calculation). Precise link calculation should be performed using dedicated tools (e.g. Pathloss).

 

7.1.2. Alignment

This function behaves like a digital voltmeter with values in dBm (instead of Volts). When activated, the biggest number on the display (the main value) is RSS dBm value (with 0,1 dBm precision), refreshed 10x per second.

Smaller 4 lines in lower part of the diplay show 4 key metrics (local RSS and MSE and once the link is established also remote RSS and remote MSE) and their best values (in right column). Any of those can be chosen to become the main one (the biggest number on the display), just by taping on it by a finger.

Additionally the sound can be switched on. Then tones or pulses related to the main value are produced, with coarse or fine sensitivity (corase at the beginning, fine for finetuning). Additionally every 5 seconds the current value is told in English, so the absolute value of main parameter could be heard even without looking to the display. The sound can be used with a big advantage in situations, when both hands are needed and the mobile has to be in the pocket (in such a case Bluetooth ears are the best choice).

 
 Antenna Alignment Tool is accessed using this menu. See Section 5.6.2 Live data for detailed description.
This function works only if WiFi connection with RAy unit is established.

7.1.3. Configuration

 
 

Links to web management of RAy unit as described in Chapter 5, Configuration. User authentication is required.
This function works only if WiFi connection with RAy unit is established.

7.1.4. About

  
 This item shows the application version and its Release notes.
[Note]Note

If gloves are used it is strongly recommended to activate smartphone option for “work in gloves”, which increase the sensitivity of touch screen display (quite common option for modern smartphones).

7.2. Application availability

RAy Tools application version 2.xx requires RAy3 unit with firmware version 1.0.0.0 or later. The same application and same version of RAyTools works also with all RAy2 units (with WiFi module and firmware version 2.1.28.0 or later).

RAy Tools version 2.xx or later is available for mobile operating systems Android (Google compatible devices) and iOS (Apple devices). All display sizes are supported on both operating systems. Android version can be downloaded from Google Play (https://play.google.com/store), iOS version is available for download on AppStore (https://www.apple.com/ios/app-store) or their local versions.

[Note]Note

RAy Tools application contains an automatic crash report feature; Firebase tool is used to report the crash. Any data transmitted is for the exclusive use of RACOM developers to analyze the problem. It will not be used in any other way by Apple, Google, Firebase or RACOM. For more info see RACOM Privacy policy on our web.

7.3. Feedback to RACOM

Any feedback for this application is welcome. Please contact us on email address:

We would also like to hear from any who would like to become a beta tester of upcoming versions of RAy Tools.