mirror of
https://github.com/Telecominfraproject/wlan-lanforge-scripts.git
synced 2025-11-21 12:34:54 +00:00
5056a01e94
Lots of changes to allow this script to scan on existing stations on multiple resources. Add --use_existing_station option. Fix help to show how to properly specify multiple stations with --sta_name Comment out convoluted logic that tried to find radio info for stations. This is not needed for any purpose that I can find, and it did not allow me to specify sta_name with EID format. Start scan on all stations, then do sleep time, then grab results. This allows concurrent scanning on multiple resources/radios. Print more info in text based output, add station resource and name to output so we can decipher multiple radio output. Add note about how .csv output is broken in this case, the logic needs to be improved to append results for all stations and write a single file. Add --scan_time argument to specify sleep time (defaults to 15 seconds to match the original hard-coded value). Signed-off-by: Ben Greear <greearb@candelatech.com>
LANForge Python Scripts
This directory contains python scripts to intract with LANforge Wifi and Ethernet Traffic Generators for testing Access Points and other Wifi networks.
LANforge Python Scripts in py-scripts General Classifications
- create_ - creates network element in LANforge wiphy radio
- lf_ or test_ - performs a test against an Access Point or Wifi network
- other files are various utilities
Still not sure what the script does ?
- LANforge scripts support --help , to provide a more detailed description of scripts functionality
LANforge Python Scripts Directory Structure
- py-scripts - configuration, unit test, module, and library scripts
- cv_examples - bash scripts for ochastrating Chamberview tests
- py-json - core libraries providing direct intraction with LANforge Traffic Generator
- py-json/LANforge - JSON intraction with LANforge Traffic Generator.
- lanforge_client/ - alpha version of JSON interface to LANforge Traffic Generator.
Where is the create_basic_argparse and create_bare_argsparse?
- py-json/LANforge/lfcli_base.py
Updating scripts python library dependencies
- for F27 systems from lanforge-scripts run:
pip3 install --user -r python.3.6.requirements.txt --upgrade - from lanforge-scripts run:
pip3 install --user -r requirements.txt --upgrade
Scripts accessing Serial ports.
- to access serial ports add user to
dialoutandttygroups to gain access to serial ports without needing root access. - Most scripts run in user space to use the installed python package and not affect the os python packages.
References
- https://www.candelatech.com/cookbook/cli/json-python
- http://www.candelatech.com/scripting_cookbook.php
Getting Started
The first step is to make sure all dependencies are installed in your system.
Example of running a chamber view test
example from cv_examples/ferndale_ucentral.bash
- ./create_chamberview_dut.py : Replace arguments with your setup. Separate your ssid arguments with spaces and ensure the names are lowercase
- ./create_chamberview_dut.py --lfmgr
${MGR}--port${MGR_PORT}--dut_name${DUT}
--ssid"ssid_idx=0 ssid=Default-SSID-2g security=WPA2 password=12345678 bssid=c4:41:1e:f5:3f:24"
--ssid"ssid_idx=1 ssid=Default-SSID-5gl security=WPA2 password=12345678 bssid=c4:41:1e:f5:3f:25"
--sw_version"ucentral-01"--hw_versionea8450--serial_num1001--model_num8450
- ./create_chamberview_dut.py --lfmgr
- ./create_chamberview.py : change the lfmgr to your system, set the radio to a working radio on your LANforge system, same with the ethernet port. Create/update chamber view scenario and apply and build it. Easiest way to get these lines is to build it in the GUI and then copy/tweak what it shows in the 'Text Output' tab after saving and re-opening the scenario.
- ./create_chamberview.py --lfmgr
${MGR}--port${MGR_PORT}--delete_scenario
--create_scenarioucentral-scenario
--raw_line"profile_link 1.1 STA-AC 50 'DUT: $DUT Radio-1' NA wiphy0,AUTO -1 NA"
--raw_line"profile_link 1.1 STA-AC 50 'DUT: $DUT Radio-1' NA wiphy2,AUTO -1 NA"
--raw_line"profile_link 1.1 STA-AC 50 'DUT: $DUT Radio-2' NA wiphy1,AUTO -1 NA"
--raw_line"profile_link 1.1 STA-AC 46 'DUT: $DUT Radio-2' NA wiphy3,AUTO -1 NA"
--raw_line"profile_link 1.1 upstream-dhcp 1 NA NA $UPSTREAM,AUTO -1 NA"
--raw_line"profile_link 1.1 uplink-nat 1 'DUT: upstream LAN 192.168.100.1/24' NA $LF_WAN_PORT,$UPSTREAM -1 NA"
--raw_line"profile_link 1.1 STA-AC 1 'DUT: $DUT Radio-2' NA ALL-AX,AUTO -1 NA"
- ./create_chamberview.py --lfmgr
- ./lf_wifi_capacity_test.py : Run capacity test on the stations created by the chamber view scenario.
- ./lf_wifi_capacity_test.py --config_name Custom --pull_report --mgr
${MGR}
--port${MGR_PORT}
--instance_nametesting--upstream1.1.$UPSTREAM--test_rig${TESTBED}--graph_groups${GROUP_FILE}
--batch_size"100"--protocol"TCP-IPv4"--duration20000
- ./lf_wifi_capacity_test.py --config_name Custom --pull_report --mgr