Skip to content

NilsRo/usteer-ng

 
 

Repository files navigation

usteer-ng

usteer-ng is a client steering daemon written for OpenWrt and the a fork of the famous usteer steering deamon.

Its goal is to optimize roaming/band steering behavior of wireless clients (STAs) in a ESS consisting of multiple BSS / APs.

Functions

  • Synchronization of Neighbor Reports between multiple APs
  • Policy-based decisions for probe- / association- / authentication requests received from STAs
  • Requesting clients to roam to a different BSS based on SNR / signal-level
  • Channel-load based client steering to different BSS
  • Band steering to higher bands if possible
  • Using different level of aggressiveness

Installation

usteer-ng is available as OpenWrt package and can be installed on devices running OpenWrt 21.02+ using opkg or 25.12+ using apk. Usteer-ng conflicts to Usteer as it actually based on the same code. Also it does not really make sense to have two Wifi controllers installed.

Download package matching your router architecture, place it to e.g. /root/usteer/ and use the following command to remove usteer and install usteer-ng with luci-app-usteer. You can find all assets here.

opkg update;opkg remove --force-depends usteer;opkg install /root/usteer/*.ipk luci-app-usteer

You can find the complete documentation for setting everything up and getting it running here:OpenWRT documentation.

Config recommendation

The default settings are the best in most environments (many users overdo optimizations to it) to support roaming and band steering. At best nothing has to be configured but take care that usteer-ng communication is not done on a public network.

Submitting patches

usteer-ng is fully managed in Github. Please contribute via Pull-Requests to the "development" branch.

About

OpenWrt AP service for client steering - Usteer next generation

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • C 96.8%
  • Shell 1.7%
  • Other 1.5%