Skip to content

Silicon Laboratories WFx Wi-Fi tools for all supported platforms

License

Notifications You must be signed in to change notification settings

SiliconLabs/wfx-common-tools

Repository files navigation


Silicon Laboratories WFx Wi-Fi tools for all supported platforms

Related Parts

Select the proper Wi-Fi product for your application from here.

Read the documentation on docs.silabs.com


Support

Please use the Silicon Labs Support Portal for all support requests.


wfx-common-tools

This repository contains WFX tools which are not platform-specific, and can be used on several platforms.

Installation

It would be a best practice to install packages in a virtual environment using pip & venv for different projects as the guideline here.

Basically, some basic steps as the following commands:

$ mkdir -p my_project && cd my_project
$ python -m venv .my_env
$ source ./my_env/bin/activate

Installing the package from PyPI (Stable version)

Still under the "my_project" from the above commands:

$ pip install wfx-common-tools
$ pip list # see a list of just installed packages

Installing the package from Github repository (Latest version)

You also can install the package from this repo to test the latest code.

$ pip install wfx_common_tools@git+https://github.com/SiliconLabs/wfx-common-tools.git

Typical Usage

After installing "wfx_common_tools" package, we can import the library into our script as below:

See README of connection package for SSH connection setup.

# Using the "test_feature" package
from wfx_common_tools.test_feature import wfx_test_dut

# Control the DUT via SSH connection by using "root" user & authentication by SSH keys (not using the password)
dut = wfx_test_dut.WfxTestDut('Pi_111', host='192.168.2.111', user='pi', password='default_password', port=22)
dut.test_conditions()

Repository Sub-Packages

Typically, Python resources can be used to run tests on WFX devices, and such tools can be running on any Python-capable platform.

Packages Usage Documentation
connection Python communication resources imported from other tools, accessed using from wfx_common_tools.connection import * README
pta Python scripts for PTA (Packet Traffic Arbitration), when several radio standards use shared RF resources README
test_feature Pythons scripts used to test the RF performance tests

NB: Prior to running RF testing, make sure you must stop any WLAN use of your product.
For instance: $ sudo ip link set dev wlan0 down
README

Please refer to the corresponding README files for details on using the tools.

Related resources

Whenever a tool is only valid for a single platform, it is stored in a corresponding platform-specific repository.

Platform-specific repositories are:

About

Silicon Laboratories WFx Wi-Fi tools for all supported platforms

Resources

License

Stars

Watchers

Forks

Packages

No packages published