DisplayCasting

Differences between revisions 1 and 37 (spanning 36 versions)
Revision 1 as of 2015-12-02 12:28:52
Size: 1882
Editor: morphis
Comment:
Revision 37 as of 2016-08-23 08:25:41
Size: 2764
Editor: morphis
Comment:
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
'''WARNING: THIS IS FOR DEVELOPERS ONLY FOR NOW. DON't EXPECT ANYTHING TO JUST WORK OR BE USER FRIENDLY''' This page describes the WiFi Display feature of Ubuntu Touch.
Line 5: Line 5:
This page describes how you setup the current in-development work for our display casting work also known as Miracast/WiFi Display. == Supported Devices ==
Line 7: Line 7:
== Install necessary silos ==  * Meizu MX Pro 5 Ubuntu Edition (since OTA 11)
 * BQ M10 Tablet Ubuntu Edition (since OTA 12)
Line 9: Line 10:
Install silo 0 == Known working Sink devices ==
Line 11: Line 12:
{{{
$ citrain device-upgrade 0 <your pin>
}}}

After the silo is installed install silo 40 for an update for wpa-supplicant

{{{
$ citrain device-upgrade 40 <your pin>
}}}

After your device has installed both silos you're read to go.
 * Microsoft Wireless Display Dongle (v1)
 * Microsoft Wireless Display Dongle (v2)
 * Mii Box
Line 25: Line 18:
All necessary steps are documented [[https://bazaar.launchpad.net/~morphis/miracast-service/trunk/view/head:/docs/usage.txt|here]] but we will describe this a bit more in detail here. First of all you need a Miracast / WiFi display capable sink device. Most modern Smart TVs support this or you can buy a dongle from Amazon like the Microsoft Wireless Display one.
Line 27: Line 20:
First of all you need a Miracast / WiFi display captable sink device. Most modern Smart TVs support this or you can buy a dongle from Amazon like the Microsoft Wireless Display one. The first step to discover available display is through the settings application.
Line 29: Line 22:
Search for available display devices:  1. Open settings application
 2. Navigate to the new WiFi Displays page which sits under the Brightness / Displays page
 3. Wait for your display device being discovered
 4. Once you have one you want to connect to press the connect button
 5. The display will be now connected and you should see the Unity8 desktop

If you want to disconnect from the external display just pull down from the top of the display on the phone display. This will give you a disconnect button.

You can control the user interface either by the virtual touchpad the phone display shows once an external display is connected or by connected a bluetooth mouse and keyboard.

On the other side we have a small utility called ''aethercastctl'' which helps you to deal with the service.

You can scan for available devices
Line 32: Line 37:
$ gdbus call -y -d org.wds -o / -m org.wds.Manager.Scan # aethercastctl
aethercastctl> scan
aethercastctl>
[CHG] Manager Scanning changed: true
Device 4e:74:03:64:86:9e 'Aquaris_E4.5' added
Device 4e:0b:be:f9:78:75 'MicrosoftDisplayAdapter_75' added
Line 35: Line 45:
After the search is done you can connect with found devices. As of right now there is no way to list available devices which will change soon. You have to know the MAC address of the remote device until we're able to list them. You can stop the miracast-service and start it manually to get some more verbose output also showing the MAC address of found devices or by running these commands After the search is done you can connect to one of the found devices.

To list all available devices you can use the ''devices'' command.
Line 38: Line 50:
$ wpa_cli -p/var/run/p2p0_supplicant
# p2p_peers
aethercastctl> devices
Device 4e:0b:be:f9:78:75 'MicrosoftDisplayAdapter_75'
Device 4e:74:03:64:86:9e 'Aquaris_E4.5'
Line 42: Line 55:
This will list all found WiFi Direct devices. Pick the one you want to connect to and run Once you know which device you want to connect to you can simply issue the ''connect'' command and wait for the device to get connected.
Line 45: Line 58:
$ gdbus call -y -d org.wds -o / -m org.wds.Manager.ConnectSink \
    'aa:bb:cc:dd:ee'
aethercastctl> connect 4e:74:03:64:86:9e
aethercastctl>
[CHG] Manager Scanning changed: false
[CHG] Manager State changed: connected
Line 49: Line 64:
where you use the MAC address of your device. Once the device is connected you should see the Ubuntu UI on the remote display device. If you run into any issues, logging details are at: /var/log/upstart/aethercast.log
Line 51: Line 66:
Now the connection should be established and the screen output should appear on your remote display. == Troubleshooting ==

 * If connections fails make sure you connected an Android device first to the Microsoft WiFi Display Dongle
 * If connections fails power cycle WiFi or reboot the device

== Bugs ==

If you found a bug please file it on https://bugs.launchpad.net/aethercast but please check first if the bug doesn't already exist.

Overview

This page describes the WiFi Display feature of Ubuntu Touch.

Supported Devices

  • Meizu MX Pro 5 Ubuntu Edition (since OTA 11)
  • BQ M10 Tablet Ubuntu Edition (since OTA 12)

Known working Sink devices

  • Microsoft Wireless Display Dongle (v1)
  • Microsoft Wireless Display Dongle (v2)
  • Mii Box

Connect with a remote display

First of all you need a Miracast / WiFi display capable sink device. Most modern Smart TVs support this or you can buy a dongle from Amazon like the Microsoft Wireless Display one.

The first step to discover available display is through the settings application.

  1. Open settings application
  2. Navigate to the new WiFi Displays page which sits under the Brightness / Displays page

  3. Wait for your display device being discovered
  4. Once you have one you want to connect to press the connect button
  5. The display will be now connected and you should see the Unity8 desktop

If you want to disconnect from the external display just pull down from the top of the display on the phone display. This will give you a disconnect button.

You can control the user interface either by the virtual touchpad the phone display shows once an external display is connected or by connected a bluetooth mouse and keyboard.

On the other side we have a small utility called aethercastctl which helps you to deal with the service.

You can scan for available devices

# aethercastctl
aethercastctl> scan
aethercastctl> 
[CHG] Manager Scanning changed: true
Device 4e:74:03:64:86:9e 'Aquaris_E4.5' added
Device 4e:0b:be:f9:78:75 'MicrosoftDisplayAdapter_75' added

After the search is done you can connect to one of the found devices.

To list all available devices you can use the devices command.

aethercastctl> devices
Device 4e:0b:be:f9:78:75 'MicrosoftDisplayAdapter_75'
Device 4e:74:03:64:86:9e 'Aquaris_E4.5'

Once you know which device you want to connect to you can simply issue the connect command and wait for the device to get connected.

aethercastctl> connect 4e:74:03:64:86:9e
aethercastctl> 
[CHG] Manager Scanning changed: false
[CHG] Manager State changed: connected

Once the device is connected you should see the Ubuntu UI on the remote display device. If you run into any issues, logging details are at: /var/log/upstart/aethercast.log

Troubleshooting

  • If connections fails make sure you connected an Android device first to the Microsoft WiFi Display Dongle

  • If connections fails power cycle WiFi or reboot the device

Bugs

If you found a bug please file it on https://bugs.launchpad.net/aethercast but please check first if the bug doesn't already exist.

Touch/DisplayCasting (last edited 2016-08-23 08:25:41 by morphis)