Google Git
Sign in
chromium / external / github.com / 01org / wds / 589bcd945686032b0ef95adfebfcf189ca3f18fe
commit589bcd945686032b0ef95adfebfcf189ca3f18fe[log] [tgz]
authorAlexander Shalamov <alexander.shalamov@intel.com>Fri Sep 16 09:17:26 2016
committerGitHub <noreply@github.com>Fri Sep 16 09:17:26 2016
treeb3883e44aa778ab2fa5c04991b7a62edbca23d72
parentac3d8210d95f3000bf5c8e16a79dbbbf22d554a5 [diff]
parent1216ab10cb1ae1d094dc531e8dceaa9766a9aca2 [diff]
Merge pull request #167 from pozdnyakov/Fix_166

Fixes #166: add missing 'break' statements
tree: b3883e44aa778ab2fa5c04991b7a62edbca23d72
  1. data/
  2. datadumps/
  3. desktop_source/
  4. libwds/
  5. mirac_network/
  6. p2p/
  7. sink/
  8. .gitignore
  9. CMakeLists.txt
  10. COPYING
  11. README.md
  12. rtsp-message-exchanges.txt
  13. TODO
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.