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.

Article overview

How to enable or disable Screen Mirroring on your device
How to enable or disable Screen Mirroring via MDM
How to use Screen Mirroring in Device Hub
Troubleshooting

How to enable Screen Mirroring on your device

1. Open emteria settings

2. Got to screen mirroring settings:

3. Allow reverse VNC via Device HUB (Screen Mirroring):

How to enable or disable Screen Mirroring via MDM

1. Log in to the emteria portal
2. Navigate to Management:
   
3. In the Devices overview select the device for which you want to enable Screen mirroring.
4. Navigate to the Commands tab and click on Add:
   
5. Now the New Command window opens.
   
6. Go to the Commands tab and select the command type Change system property.
   
7. To enable the feature, fill in the following values:
   Property name: persist.sys.vncr.enabled
   New value: 1
8. 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:

How to use Screen Mirroring in Device Hub

1. Log in to your Device Hub.
2. Go to Management.
   
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.
   
6. Scroll down to Administration. Here you can see the Play button for Screen Mirroring.
   
7. Press the Play button to start.
   
   

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.