High-precision RF Explorer scans using free Python script (demo with Wireless Workbench)

Музыка

Get the script here: github.com/mkupferman/rfexplo...
Shure Wireless Workbench available from: www.shure.com/en-US/products/...
***
This is a free solution to generating high-resolution scans with an RF Explorer, for use with coordination software like Shure Wireless Workbench.
The RF Explorer is limited to 112 steps in a frequency sweep. When coordinating a larger frequency range, the resolution bandwidth (RBW) becomes larger and imprecise.
The script shown here creates scan datafiles with a lower RBW by breaking the sweep into smaller chunks and "stitching" them together for a final dataset. It connects to the RF Explorer over its USB interface and produces CSV files which are suitable for importing into Shure Wireless Workbench.
It can run on any computer with Python (3.5 or later) with an RF Explorer connected via USB. You will also need a UNIX-like environment (e.g. macOS, Linux, Git Bash for Windows) to use the included build script and follow the example.
1. Download or clone the Python script from the Github site.
2. Build it by running "build.sh"
3. Activate the Python virtual environment ("source venv/bin/activate" or "source venv/Scripts/activate" on Windows)
4. Look at the syntax help with "rfexplorerDetailedScan --help"
5. Run it with any options you would like and a destination CSV file name. For example: "rfexplorerDetailedScan -s 470 -e 534 output.csv" will run a scan from 470MHz-534MHz with 10 iterations (averaged) and a resolution bandwidth of about 18 KHz.
6. output.csv can then be imported in Wireless Workbench for coordination.

Пікірлер: 67

  • @mashzmash
    @mashzmash14 күн бұрын

    New version on Github with several bugfixes that have cropped up in recent versions of Python. github.com/mkupferman/rfexplorer-detailed-scan

  • @gmailcal
    @gmailcal4 жыл бұрын

    This sounds like exactly what I need, will try it out soon. Much thanks! Cal.

  • @joshuadriscoll7094
    @joshuadriscoll7094 Жыл бұрын

    This is awesome. Installed on Mac today and did a bunch of scans. I had no idea what Python was before seeing this so I started by searching "running Python on Mac". I updated the version that was installed. Followed your instructions.Had to pause and read some of what you were typing in the terminal on the video. Thanks so much. When you say "if you're savvy and want to make a batch script executable file etc..." What should I be creating a script in on a Mac? I need to be that savvy. 🤣

  • @mashzmash

    @mashzmash

    Жыл бұрын

    Look up "shell scripting" or "bash script". You might make a script that runs the command for a specific frequency range and maybe save a timestamp'd file. That might look something like this, depending on where you have things on your Mac: #!/bin/sh EXECUTABLE=~/rf/venv/bin/rfexplorerDetailedScan DESTINATION=~/Desktop FILENAME="scan-$(date +%Y-%m-%d-%H.%M.%S).csv" $EXECUTABLE -e 600 -a average -i 10 -v $DESTINATION/$FILENAME

  • @jorgesastron7242

    @jorgesastron7242

    Жыл бұрын

    @@mashzmash Thanks for your work, it works great!

  • @joshuadriscoll7094

    @joshuadriscoll7094

    Жыл бұрын

    Hey MashZMash, After using this on my Mac for a month across the US, I am very happy to have found it and want to thank you again. My RFexplorer detailed scans from hotel rooms or at venue pre load in were very good. I had an AXT600 and Rohde and Schwarz to compare to. Different tools of the trade, but your script made the RFExplorer a very reliable point from which to build my inventory and, even though I couldn't help but scan from the AXT600 after load in, I am confident when operating with the scans that I'm getting from the RFexporerDetailedScan. Thanks again. I'm currently migrating to a Windows Laptop for my Live Tech Work and making strides. I'm sure I'll get it sorted out, but I might have some questions.

  • @OzzyScuba
    @OzzyScuba5 ай бұрын

    Great tips! Thanks!

  • @MikeHageman
    @MikeHageman Жыл бұрын

    I made a batch/shell script to run this Python script. Great! Thanks for this Python script! I had completely had it with RF Explorer in Windows and Touchstone Pro in Mac. So this is a very welcome gift! I made a script for this script ( 🙂 ) to run from the desktop in Mac Terminal. It asks the user questions for the frequency input and other parameters. It runs as a shell script and is executable from the desktop (or any folder) without opening Terminal or inputting commands. Just double clicking it and answering a few questions. No more CLI stuff, haha. Let me know of anyone is interested.

  • @mashzmash

    @mashzmash

    Жыл бұрын

    Glad you're getting use of it. I still use it at every show myself. Feel free to submit your wrapper in a pull request and I'll include it as a contributed script!

  • @MikeHageman

    @MikeHageman

    Жыл бұрын

    @@mashzmash Hi, it's not a wrapper, but a simple batch shell script/file to give Terminal on Mac the commands automatically. It's about 100 lines of 'code'. It saves you a lot of typing. Still very useful in my opinion. Life on the road is busy enough ;-)

  • @TheWilliampp

    @TheWilliampp

    Жыл бұрын

    This sounds great! Having issues coding this so would love to have the shell.

  • @MikeHageman

    @MikeHageman

    Жыл бұрын

    @@TheWilliampp Thanks for your reaction. I'm currently translating the script and help-file from Dutch to English. I'll leave a message when it's done and ready to distribute.

  • @MikeHageman

    @MikeHageman

    11 ай бұрын

    @@TheWilliampp I'm sorry I did not react any earlier. I'm still in the process of translating and improving the script. I hope to have it ready for 'shipping' at the end of this month. I will let you know.

  • @ayoadeife
    @ayoadeife6 ай бұрын

    Nice work.

  • @andreaslorunser4112
    @andreaslorunser41125 ай бұрын

    thank you!

  • @evilmaiskolf
    @evilmaiskolf2 жыл бұрын

    Great script! Couldn't get it to work on Windows (keep getting the message "Python not found" even though I installed it and all), but on Mac it works like a charm! Quick question, I'm using the script with a RF Explorer WSUB1G (the basic model), does the script also work with other models? The RF Explorer 6G Combo for example? Thanks in advance!

  • @mashzmash

    @mashzmash

    2 жыл бұрын

    no luck with the Manage App Execution Aliases option in Windows? I usually run it in Windows 10 on a MS Surface at gigs with no issues. It works great on a 6G Combo (that's what I have). The script uses the python RFExplorer library (pypi.org/project/RFExplorer/) so as long as it works with that, it should be fine.. and I think the protocol is pretty standard among models.

  • @mashzmash

    @mashzmash

    2 жыл бұрын

    On a new Windows installation the other day, I realized I needed to install Git for Windows (i.e. "git bash", which I use extensively) BEFORE installing Python, in order for the python executable to properly make it into git bash's PATH.

  • @Cletusaz
    @Cletusaz2 жыл бұрын

    I've got the project close to working on windows using gitbash and python 3.9 I'm stuck and unable to produce the *.csv file. rfexplorerDetailedScan -s 240 -e 960 -r 2 -i 10 -v C:\output.csv I see python.exe start in win10 tasks but after waiting an eternity it is still not producing any output csv. Any help would be appreciated.

  • @abdulalrovi683
    @abdulalrovi6833 жыл бұрын

    Will it works with LTDZ 35-4400m spectrum analyzer?

  • @brianbash
    @brianbash Жыл бұрын

    Hey this is great! Talk about high resolution! Any chance you can help me create a .bat file?! 😀

  • @drennenanderson142
    @drennenanderson1425 ай бұрын

    So when I start a scan in the script, it's not seeing the Scan Library Module. Any solutions for that? running on Mac OS Catalina Terminal

  • @mashzmash

    @mashzmash

    14 күн бұрын

    Just published a new version on GitHub which should fix this

  • @user-qi8oy4mp8e
    @user-qi8oy4mp8e6 ай бұрын

    hi there I keep running into the issue of missing an output_file could you let me know what I need to do to correct this?

  • @branofabry7314

    @branofabry7314

    6 ай бұрын

    The basic syntax is "rfexplorerDetailedScan filename.ext".

  • @MassimoManunza-yg5pc
    @MassimoManunza-yg5pc27 күн бұрын

    i have a problem.. at the end when write rfexplorerDetailedScan -s 450 -e 650 -r 2 -i 10 -v -a average demo.csv return this..ModuleNotFoundError: No module named 'rfexplorerDetailedScanLib' (MAC OS Sonoma 14.5 M3 Silicon)

  • @mashzmash

    @mashzmash

    14 күн бұрын

    Just published a new version on GitHub which should fix this

  • @Oneloudest
    @Oneloudest3 жыл бұрын

    Does this work for RF Explorer Pro Audio Edition? I got everything working, but when I run the scan I get this error: $ rfexplorerDetailedScan -s 470 -e 534 output.csv Not Connected Analyzer not initialized properly. Not proceeding with sweep. Sweeps did not complete. Not writing data to file. Detected COM ports: * COM3 Detected OS: Windows Error in RFCommunicator - IsConnectedPort()could not open port 'COM3': PermissionError(13, 'Access is denied.', None, 5) Error: not found valid COM Ports User COM port: void Error: select a different COM port (venv) If I keep trying to scan, after the third attempt my RF Explorer will flash off like it does when I connect with the software, but come right back on, and then Bash just hangs.

  • @mashzmash

    @mashzmash

    3 жыл бұрын

    I use an RF Explorer Pro (6G combo) and I'm pretty sure the library should work on yours. I guess I would make sure you're using an account with admin privileges. Might want to check out the python library's website, since that's what this script leans on to do the heavy lifting: github.com/RFExplorer/RFExplorer-for-Python/wiki

  • @Oneloudest

    @Oneloudest

    3 жыл бұрын

    @@mashzmash Bash is running as admin. I tried running the example scripts from the wiki through a command prompt as admin, and it would connect, then crash. Guess my more expensive version is not supported. Wonderful

  • @Leo-Benjamin

    @Leo-Benjamin

    2 ай бұрын

    @@Oneloudest Initiale I had the same issue. but a quick install of the apple driver form the website fixed it.

  • @ProceedRaeyoung
    @ProceedRaeyoung3 жыл бұрын

    Thanks for your video. I watched the video and followed it and I had a hard time succeeding. But I don't know how to make "scanRF.bat" in the last scene. I'm sorry, but can you tell me? FYI I am not a programmer. It's just an ordinary person. I wish you good luck.

  • @mashzmash

    @mashzmash

    3 жыл бұрын

    Here is my batch script, with parameters that are specific to my computer and needs. Remember to change it to work for you. C: cd \users\mashzmash\desktop fexplorer-detailed-scan\venv\scripts . fexplorerDetailedScan -e 600 -a average -i 10 -v "..\.. f-scans\scan-%date:/=-%-%time::=-%.csv"

  • @righteyeball
    @righteyeball9 ай бұрын

    Hello there. I know it's a long shot, but by any chance you know the solution to ' from rfexplorerDetailedScanLib import DetailedScanner ModuleNotFoundError: No module named 'rfexplorerDetailedScanLib' ' error? happens when I try to run the scanning prompt mac os Big Sur, python 3.12, pip 23.3 thanks in advance!

  • @mashzmash

    @mashzmash

    9 ай бұрын

    by any chance did you move the location of the directory after building it? sometimes this can cause issues with the python virtual environment being able to resole paths. also just a sanity check: make sure you've installed it in a virtualenv and that you activate it before running. did you use the included "build.sh"? if so did you use the command it prints at the end.. something along the lines of "source venv/bin/activate" before running? I would try deleting the "venv" folder, re-running build.sh, then "source ./venv/bin/activate", and see if you have any luck at that point running rfexplorerDetailedScan (it should be in your $PATH at that point)

  • @righteyeball

    @righteyeball

    9 ай бұрын

    @@mashzmash actually I just reinstalled it in different name "git clone " did try everything again, still getting the same error

  • @mashzmash

    @mashzmash

    9 ай бұрын

    @@righteyeballhmm. with the virtualenv activated, run this: python -c 'import sys; print(sys.path)' Does the output contain an item that's along the lines of /venv/lib/python3.*/site-packages/ ? do a directory listing ("ls") on that path and see if it contains a file called rfexplorer-detailed-scan.egg-link

  • @righteyeball

    @righteyeball

    9 ай бұрын

    @@mashzmash ran the first command, it does output bunch of lines including /venv/lib/python3.*/site-packages/ ls to the "/venv/lib/python3.*/site-packages/" , it gives me list of things, not including "rfexplorer-detailed-scan.egg-link"

  • @branofabry7314

    @branofabry7314

    6 ай бұрын

    @@mashzmash Hi, I am getting the same error, I'm on Win10. When I run the command to print sys.path like you advise above, I get these two paths: 'D:\\Downloads\ fexplorer-detailed-scan\\venv', 'D:\\Downloads\ fexplorer-detailed-scan\\venv\\Lib\\site-packages' . So there is a "site-packages" folder but not in "python3.*" parent folder. If I run ls on that folder, it does not contain the .egg-link file.

  • @manuotero6462
    @manuotero64622 жыл бұрын

    how do you create a bat file? is not too much clear as you say in comments

  • @mashzmash

    @mashzmash

    2 жыл бұрын

    It's really outside the scope of the script, but first, figure out the full command you want to run. This might involve creating a folder to save your scan CSVs into, and calling the script with the appropriate arguments for your RF Explorer's radio/antenna. Once you have this: In Windows, create a new text document (e.g. in Notepad), paste your command(s) into it, and name the file with a .bat extension (not .txt). Windows will recognize it as a script you can run. On a Mac, you will need to create a shell script. Open TextEdit, start with the line, #!/bin/sh, and then paste your command. From the Format menu, select Make plain text, and save it with a .sh extension. Then "Get Info", change it to open with Terminal. If you plan to run it from terminal, make it executable with: chmod +x FILE.sh

  • @dresound7585
    @dresound75852 жыл бұрын

    I paste the link on Python 3.9.7 and it doesnt run

  • @mashzmash

    @mashzmash

    2 жыл бұрын

    What OS? Is there a specific error you get?

  • @markwinslow1423
    @markwinslow14232 жыл бұрын

    Just get a plus model, they have 4096 data points

  • @seleldjdfmn221
    @seleldjdfmn2214 жыл бұрын

    Here Before 100K subs. Whats your favourite type of music? Oh, and happy save your Hearing day! x3

  • @markwinslow1423
    @markwinslow14232 жыл бұрын

    instead of wasting time showing how to get useless scan you should spend more time detailing how to install all the necessary components on windows. Followed the directions to a tee but the directions obviously are inadaquate.

  • @mashzmash

    @mashzmash

    2 жыл бұрын

    Running scripts at a command-line - with operating system and interpreter versions that constantly evolve/change - requires some fundamental understanding of how to set up the underlying environment. I've gone through a typical setup, demonstrating a way that does work for many, but there are many great resources on the internet for getting Python installed and running scripts on your operating system. Instead, I chose to focus on demonstrating the value-add of the script itself so someone can see why this can be a useful tool to them. Having said that, I'm more than happy to try to resolve your issues, if you care to elaborate a little more on where you're stuck.

Келесі