How to use Screen Mirroring in Device Hub

Screen Mirroring is the newest emteria.OS feature - it allows you to see what is happening on the screen of your devices. This is ideal if you have devices in the field to which you need on demand remote access, for example, for maintenance, debugging and troubleshooting.

Or, when your end-user can not fix the issue by themself, because, for example, the device is in Kiosk Mode. This way no more on-site maintenance is needed. You can remotely see what is happening on your device and perform the needed actions.

We continuously work on the security of this feature, next thing to be implemented is the access authorization dialog.

Note: This feature is currently not available for all users, please contact sales for more information.

 

Article overview
How to use Screen Mirroring in Device Hub
How to enable or disable the Screen Mirroring feature for your device
Troubleshooting

How to use Screen Mirroring in Device Hub

  1. Log in to your Device Hub.
  2. Go to Management.
    Header-Management-marked
  3. Click on the arrow next to your device group for a drop down menu of all your devices.
  4. Click on the device that you want to access remotely.
  5. On the Device Overview page navigate to the System tab.
    device-system-tab-marked
  6. Scroll down to Administration. Here you can see the Play button for Screen Mirroring.
    device-system-tab-administration-marked
  7. Press the Play button to start.
    screen-mirroring-connecting
    screen-mirroring-connected

How to enable or disable the Screen Mirroring functionality for your device

  1. Log in to your Device Hub.
  2. Navigate to Management.
    Header-Management-marked
  3. In the Devices overview select the device for which you want to enable Screen mirroring.
    Install-App-1
  4. Navigate to the Commands tab. Now you're in the main MDM page of your device or device group.
  5. Click on Add.
  6. Now the New Command window opens.
    NewCommandsMDM2
  7. Go to the Commands tab and select the command type Change system property.
    screen-mirroring-command-filled-3
  8. To enable the feature, fill in the following values:
    Property name: persist.sys.vncr.enabled
    New value: 1
  9. Click Create.

To disable the Screen Mirroring feature, use the following values:
Property name: persist.sys.vncr.enabled
New value: 0

Once you've disabled Screen Mirroring for your device, the blue Play button will turn grey:
screen-mirroring-disabled

Troubleshooting

Screen rotation

If you're using a Raspberry Pi 4, you might experience image distortion if you rotate the screen when using Screen Mirroring. The best way forward is to close your current Screen Mirroring session and open a new one. The distortion will be gone after that.