Skip to content
Wireless Display Software For Linux OS (WDS)
Branch: master
Clone or download
laperie Merge pull request #164 from manoj23/add-WDS_INSTALL_TESTS
Add WDS_INSTALL_TESTS option to install test programs
Latest commit ece955a Nov 13, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
data Correct library description Nov 30, 2015
datadumps
desktop_source Merge pull request #164 from manoj23/add-WDS_INSTALL_TESTS Nov 13, 2018
libwds Merge pull request #164 from manoj23/add-WDS_INSTALL_TESTS Nov 13, 2018
mirac_network Add WDS_INSTALL_TESTS option to install test programs Jul 3, 2016
p2p Add WDS_INSTALL_TESTS option to install test programs Jul 3, 2016
sink Add WDS_INSTALL_TESTS option to install test programs Jul 3, 2016
.gitignore
CMakeLists.txt Add WDS_INSTALL_TESTS option to install test programs Jul 3, 2016
COPYING Initial commit Oct 14, 2014
README.md Make libwds compile on Windows Apr 22, 2016
TODO
rtsp-message-exchanges.txt Initial commit Oct 14, 2014

README.md

Wireless Display Software For Linux OS (WDS)

WDS is a set of libraries for developers who want to build Wi-Fi Display applications on linux.

WDS consists of:

  • libwds: Main library implements a Wi-Fi Display dialect of RTSP that includes the parser, actual negotiation logic for sink and source, and the related data structures. It is not tied to any specific connection manager, media framework or main loop. This Library is also compatible with MSVC.
  • network: Supports integration with GLib main loop and GStreamer
  • p2p: Supports integration with Connman Wifi P2P features

The source code includes example implementations:

  • sink: Wi-Fi Display sink that depends on Gstreamer, Connman and GLib mainloop
  • desktop_source: Wi-Fi Display source that depends on Gstreamer, Connman and GLib mainloop

More information can be found on the mailing list and the wiki.

Requirements:

WDS test executables have runtime dependencies on just a few things (mostly GStreamer and GLib), but for successful Wi-Fi Display sessions the following are adviced:

  • Wifi adapter from Intel 7260-family or Atheros ath9k
  • wpa_supplicant: version 2.4 or later, built with CONFIG_P2P=y, CONFIG_WIFI_DISPLAY=y and CONFIG_CTRL_IFACE_DBUS_NEW=y
  • connman: version 1.28 (released Feb 1st 2015) or later.
  • gstreamer: either master branch more recent than Feb 3rd 2015 (commit d0a50be2), or 1.4 branch more recent than Feb 3rd 2005 (commit 1ce3260a638d or release 1.4.6 or later).

Test results with other Wifi adapters are very welcome but be warned that in many cases Wifi-P2P has not had the testing it needs on linux: you may run into problems in surprising places.

Building WDS from git:

cmake .
make

Testing WDS

Pre-requisites

Make sure wpa_supplicant & connmand are running. Running both of them uninstalled is possible (but in that case make sure the system wpa_supplicant and system connection manager are not running):

$ sudo hostap/wpa_supplicant/wpa_supplicant -ddt -u

$ sudo connman/src/connmand -n -d

Use connmanctl to enable Wi-Fi and Wi-Fi P2P:

$ connman/client/connmanctl
connmanctl> enable wifi
Enabled wifi
connmanctl> enable p2p
Enabled p2p

Check that Peer-to-peer functionality is working:

connmanctl> scan p2p
Scan completed for p2p
connmanctl> peers
Nexus 5 (jku) idle peer_0c8bfd5f12fc_8ac9d0c0da67
Push2TV 75AEB2-PTV3000 idle peer_0c8bfd5f12fc_22e52a75aeb2

Enable agent:

connmanctl> agent on
Agent registered

Testing WDS sink with an Android device (e.g. Nexus 5):

  • start sink: sink/sink-test
  • Android: select the sink from the list in "Settings > Display > Cast Screen"
  • connmanctl: when agent asks, accept the connection

In a few seconds, a window should open and a audio/video stream should start playing.

Testing WDS source with another sink:

  • start source: desktop_source/desktop_source
  • Initial scan will be automatic, but scan command will re-scan.
  • After getting scan results, connect with connect N (where N is number from scan result)
  • connmanctl: when agent asks, accept the connection

In a few seconds, the sink should start showing a stream mirroring your desktop.

You can’t perform that action at this time.