DisplayCasting

Differences between revisions 30 and 37 (spanning 7 versions)
Revision 30 as of 2016-04-22 17:19:04
Size: 4369
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, 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.  * Meizu MX Pro 5 Ubuntu Edition (since OTA 11)
 * BQ M10 Tablet Ubuntu Edition (since OTA 12)
Line 9: Line 10:
== Testing on turbo == == Known working Sink devices ==
Line 11: Line 12:
If you're testing this on turbo you need to flash a specific device tarball first. You can find the required device tarball [[https://private-fileshare.canonical.com/~alextu/zhongshan/images/mophis/device.tar.xz|here]].

You also need

 * a recovery image with ADB support enabled. Download it from [[wget https://private-fileshare.canonical.com/~alextu/zhongshan/images/recovery.img|here]]
 * a prebuilt version of ubuntu-device-flash from [[https://private-fileshare.canonical.com/~morphis/ubuntu-device-flash|here]]

Flash it with ubuntu-device-flash

{{{
$ ls -alh
-rw-rw-r-- 1 simon simon 103M Apr 22 19:03 device.tar.xz
-rwxrwxr-x 1 simon simon 137 Apr 22 18:59 disable-gpg.sh
-rw-rw-r-- 1 simon simon 24M Apr 22 19:01 recovery.img
-rw-rw-r-- 1 simon simon 7,0M Apr 22 19:04 ubuntu-device-flash


$ cat disable-gpg.sh
#!/bin/bash
adb shell touch /etc/system-image/skip-gpg-verification
adb shell /sbin/system-image-upgrader /cache/recovery/ubuntu_command

# Boot your device into fastboot boot via Power + Volume down

$ sudo ./ubuntu-device-flash -v touch --device turbo --channel ubuntu-touch/rc-proposed/meizu.en --device-tarball device.tar.xz --run-script disable-gpg.sh --recovery-image recovery.img --bootstrap
}}}

When you see

{{{
Done upgrading: Fri Apr 22 17:16:10 GMT 2016
}}}

run

{{{
$ adb reboot
}}}

== Install necessary silos ==

Install silos 24 and 46

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

After your device has installed the silo you're ready to go.
 * Microsoft Wireless Display Dongle (v1)
 * Microsoft Wireless Display Dongle (v2)
 * Mii Box
Line 63: Line 17:

'''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 71: Line 23:
 2. Navigate to the new WiFi Displays page which sits under the WiFi page
 3. Press the scan button to discover available displays around you
 2. Navigate to the new WiFi Displays page which sits under the Brightness / Displays page
 3. Wait for your display device being discovered
Line 113: Line 65:

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