DisplayCasting

Differences between revisions 35 and 36
Revision 35 as of 2016-04-29 06:13:47
Size: 3787
Editor: morphis
Comment:
Revision 36 as of 2016-08-23 08:24:27
Size: 2628
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, DO NOT TRY IT ON YOUR DAILY-USE DEVICE. 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:
'''WARNING: This currently only works on the upcoming Meizu MX Pro 5 aka turbo. There is work in-progress to get this work on other devices as well.''' == Supported Devices ==
Line 7: Line 7:
This page describes how to setup the current in-development work for our display casting work also known as Miracast/WiFi Display.

== Install necessary silos ==

Install silos 24 and 46

{{{
$ citrain device-upgrade 24 <your pin>
...
$ citrain device-upgrade 46 <your pin>
}}}

If citrain for silo 24 hangs with something like https://paste.ubuntu.com/15986810/ do the following:

 1. Kill citrain
 2. Adb into the device, kill pending dpkg and apt-get
 3. Run: sudo dpkg --configure -a on the device
 4. Rerun: citrain 24 <your pin> from the host
 5. Continue with installing silo 46

After your device has installed the silo you need to install lxc-android-config manually by fetch the .deb package from silo 46 and following the steps described on https://wiki.ubuntu.com/Touch/Testing/lxc-android-config

You will need an adb-enabled [[https://private-fileshare.canonical.com/~alextu/zhongshan/images/recovery.img|recovery.img]] for that.
 * Meizu MX Pro 5 Ubuntu Edition (since OTA 11)
 * BQ M10 Tablet Ubuntu Edition (since OTA 12)
Line 32: Line 11:

'''NOTE: To connect with the Microsoft WiFi Display dongle you have to connect it with an Android device currently first before Ubuntu is being able to stream properly to it. Otherwise you will just get a black screen.'''
Line 87: Line 64:

== 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)

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)